Repository navigation
i18n 门禁:en 文案变更时其余九包必须同批跟改(或显式挂账)——#3582/#3625 族缺陷缺的那道不变量 #3650
Description
Activity
认领(PM 派发,立卡即派)。
- Session:
session_01GTRjn8xBqp75dk7kFupVRt - 分支:
claude/issue-3650-en-drift-gate - 文件面:新脚本
scripts/check-i18n-en-drift.mjs+ 挂账文件(如需)+scripts/__tests__/新测试文件 + CI workflow 挂接(仿 control-bytes.yml / 既有 i18n 守卫的挂法,先看 feat(ci): assert every t() call-site key exists in the en locale pack #3547 怎么挂的)+ 两个相邻门禁头注的分工互认。⛔ 不碰scripts/check-doc-links.mjs(在途 check-doc-links 扫描面第四扩 packages/*/README.md：入场价是另外 11 条死链（实测），不是 #3603 正文的 9 条 #3622 同目录不同文件)、不碰语言包本体。 - 正文的「需要斟酌点」授权 dev 实测后裁,取舍写 PR;落地前先全量扫存量(正文第 5 点)— 有第三案存量先报再定。
Generated by Claude Code
- Session:
验收 ACCEPT → PR #3659(session_01GTRjn8xBqp75dk7kFupVRt)。en-drift 门禁落地,#3582/#3625 族缺陷的不变量自此有牙。
已核:CI 17 项 0 失败(Type Check 绿本身即 merge-base 在 CI checkout 下解析成功的证据);预测 (a)-(e) 全中,(d3) 拆三机制的表述修正接受(照单一句会误导读者)。
裁决记录(全部采纳并记入方法库):
- 挂账逐字转写机制:只有做过该改动的人写得出、只豁免那一句、每次运行对 en 现值核对 — 挂账自我过期,(e) 证明不退化成 allowlist。这是挂账类门禁的新标准形态,优于 feat(ci): assert every t() call-site key exists in the en locale pack #3547 的纯棘轮。
- 不豁免排版的实测论证:21 commit 历史回放代价为 0;「标点白名单是披正则外衣的语义主张」— 判词收录。
- 考古发现:两案肇事 commit 不在本仓(30ac2e1 带漂移整体进仓)→ 门禁不可能被历史验证,植入式语料重建 view.readonlyTooltip 在 8 个语言包里译的是「duplicate to customize」这句已废弃语义 —— 因为它是真译文,任何「值是英文」判据都看不见它 #3625 的 should-have-existed commit — 「落地即绿非空绿」的正面证法收录。
- AST 读 git blob + 读不懂即 throw,首跑当场兑现(跨行拼接 key)并折叠钉测;粒度两推论(键集合归 parity、en/zh-only 跳过计数)避免门禁打架。
- 新发现 ci-cd-pipeline.md 的 type-check 行漏了
pnpm check:i18n-keys,而 ci-cd-pipeline-doc.test.ts 的钉子按「作业」而非「步骤」判定,看不见这类漏项 #3653 入池(ci-cd-pipeline 文档钉粒度是作业级非步骤级,feat(ci): assert every t() call-site key exists in the en locale pack #3547 欠的一步 + 本单新步骤都漏 — 两账并清另派)。
Generated by Claude Code
- added a commit that references this issue
on Aug 17, 2026
PM 立卡,汇总三处已有记录(#3582 正文、#3625 正文「这可能才是这一族缺陷真正缺的那道门禁」、PR #3627/#3642 正文),避免第四次以散文形态重述。
缺陷族回顾(全部已实测)
console.objectView2 个 key 八包存过期英文(en 改成 read-only 后八包没跟,还停在 duplicate-to-customize 的旧英文)— 已修(PR fix(i18n): 八包补上 console.objectView 两个 key 的真译,systemViewReadonly 按 en 当前的 read-only 语义 (#3582) #3627)。view.readonlyTooltip八包存地道译文形态的废弃语义 — 已修(PR fix(i18n): 八包按 en 当前的 read-only 语义重译 view.readonlyTooltip (#3625) #3642)。两案共同成因:en 改文案的那个 PR 没有同批更新九个译文包,而现有三道门禁(键集合 parity / 调用点 key 守卫 / 棘轮基线)全部只看键集合,对「值的语义漂移」天生失明。#3582「建议 2」的非拉丁包 ASCII 抽查只能抓第一案(英文原文残留),对第二案(地道译文承载废弃语义)同样失明 — #3625 已证明。
缺的不变量
en 某 key 的值在一个 PR 里变了 → 其余九包该 key 的值必须在同一 PR 里也变,或显式挂账。
建议实现(供 dev 测量后定,非结论)
新门禁脚本(如
scripts/check-i18n-en-drift.mjs),CI 上以 merge-base 对比:scripts/i18n-en-drift-baseline.json)里;需要斟酌的点(dev 实测后在 PR 里裁,或报回分诊):
关联
#3582(第一案)、#3625(第二案)、#3517(defaultValue 掩盖)、#3530/PR #3547(调用点守卫与棘轮先例)、PR #3627/#3642(两案修复 + 单 key 机械化先例:钉 en 字面量)。