跳转至

ISSUE-0134 · 号码值里的来源标记 + IDD 未识别

起因:Tony 的截图

手机列表里同一商家(nuo med)出现两行同一个号:

+49 711 39011608 (地图)     来源「地图?」
+49 711 39011608            来源「官网?」   原始写法 004971139011608

Tony 的判断:「第一列去掉括号和地图,只保留纯号码,后边来源标记地图即可」。

缺陷一:来源标记被拼进号码字段

formatPhoneForDisplay 里:

// 原串带 (地图) 标记时,标记跟着走 —— 它是来源信息,不是号码的一部分
const label = ... ? ' (地图)' : '';
return { display: intl + label, ... };

注释自己说对了一半(「它是来源信息,不是号码的一部分」),然后把它拼进了号码。后果:

  • 手机列表第一列显示 +49 711 39011608 (地图),而同一行的「来源」列已经写着「地图」 —— 同一信息占两处
  • 污染了用户要复制去拨号 / WhatsApp 群发的值
  • CSV 导出的电话列同样带标记

raw(原始写法列)与 miss 分支(规范化失败时)也一起带着。三处都剥掉。

⚠️ 标记的真正用途是在合并串内部区分来源(splitMapsHint / labelOf 仍从原串读它) —— 那条路径不动,只剥展示值。有回归锁守住(否则 ISSUE-0128 的 trusted 槽位恒空会复发)。

🔴 缺陷二:真正让它变成两行的不是标记

"+49 711 39011608 (地图)" → key = 49|71139011608
"004971139011608"        → key = 49|04971139011608

两条的 e164 完全相同(+4971139011608),去重键却不同 —— 键用的是原始数字串,而 00 被当成 trunk-0 只剥了一个 0。

00 是国际接入前缀(IDD),不是 trunk-0。ITU 把 00 定为多数国家的 IDD, 国内号不会以 00 开头(会与 IDD 冲突)。

⇒ 影响面比截图那一处大得多:凡是同号用了不同国际写法 (0049… / +49… / 本地写法),全都各占一行。

修法:digits 以 00 开头且剥掉后 matchDialPrefix 认得出前缀时,按国际写法处理。 识别不出前缀就不动 —— 与本函数其余分支同一取舍:宁可漏合并,不错合并 (错合并会静默吞掉真号,不可逆)。

只做用户说的那一半会更糟

先剥标记、不修 IDD 的话,用户看到的是两行一模一样的号码 —— 比带标记更像 bug。两条必须一起修。

🔴 我自己选错了一个反例

给 IDD 判据写「识别不出前缀就不剥」的反例时,我用了 0091234567, 断言它不该被剥 —— 错的:剥掉 00 得 91…,而 91 是印度的国家码, matchDialPrefix 认得出,剥是正确行为。测试红了,但红的原因是我的样本不对,不是代码不对。 真正跟不出前缀的形态是 00 后面接 0(没有以 0 开头的国家码)。已改用 0001234567。

效果

修前:+49 711 39011608 (地图)   sources=maps      ← 两行
      +49 711 39011608         sources=web
修后:+49 711 39011608          sources=maps,web  ← 一行

来源并成 maps,web 是信息增加:这个号既在 Google Maps 登记、又印在官网上 —— 这是最强的可信信号,此前被劈成两行反而看不出来。

证据

全量 967 全绿(新增 4 条后 971);三路变异全咬住, 每路 md5 证明真改到文件、还原逐字节一致,且对照条数 N=137 三次一致(铁律 25):

变异 结果
M1 去掉 00 IDD 判据 红 2
M2 display 把标记拼回去 红 4
M3 miss 分支退回 original 红 1

两条锁旧行为的既有测试(phone-format.test.ts 的「(地图) 标记跟着走」、 phone-merge.test.ts 的「(地图) 后缀保留为来源标注」)真抓到了行为变化 —— 有效守卫,有意更新而非删除,并把新意图写进断言。

证据边界

  • 只改了展示层。mergePhonesWithMapsLabel(写库前合并)仍在合并串里写 (地图) 标记 —— 那是它区分来源的唯一依据,不能动(ISSUE-0128)。库里存的还是带标记的合并串。
  • IDD 判据只认 00。俄罗斯(810)、日本(010)、NANP(011)等其它 IDD 形态未处理 —— 没有语料支撑,且它们与国内号的歧义比 00 大。
  • 截图里另外两行 +49 3901 1608 / +49 3901 1436(原始写法 390 11 608 / 390 11 436) 是 0711 39011608 的片段被当成独立号码 —— 那是抽取层的问题,不在本刀范围, 未修,记在此。
  • 未在真实 Chrome 扩展里端到端跑过。