This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
This repository was archived by the owner on Nov 4, 2026. It is now read-only.
i18n 门禁:en 文案变更时其余九包必须同批跟改(或显式挂账)——#3582/#3625 族缺陷缺的那道不变量 #3650
Description
PM 立卡,汇总三处已有记录(#3582 正文、#3625 正文「这可能才是这一族缺陷真正缺的那道门禁」、PR #3627/#3642 正文),避免第四次以散文形态重述。
缺陷族回顾(全部已实测)
- console.objectView 的 2 个 key 在 8 个语言包里是英文原文,其中 systemViewReadonly 还是与 en 不一致的旧文案(全部门禁皆绿) #3582:
console.objectView2 个 key 八包存过期英文(en 改成 read-only 后八包没跟,还停在 duplicate-to-customize 的旧英文)— 已修(PR fix(i18n): 八包补上 console.objectView 两个 key 的真译,systemViewReadonly 按 en 当前的 read-only 语义 (#3582) #3627)。 - view.readonlyTooltip 在 8 个语言包里译的是「duplicate to customize」这句已废弃语义 —— 因为它是真译文,任何「值是英文」判据都看不见它 #3625:
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 对比:
- 计算本分支相对 origin/main merge-base 的 en 包值变更 key 集合;
- 对每个变更 key,要求其余九包同 key 的值也在 diff 中变更;
- 否则失败并逐 key 点名 — 除非该 key 出现在挂账文件(如
scripts/i18n-en-drift-baseline.json)里; - 挂账文件本身棘轮化(feat(ci): assert every t() call-site key exists in the en locale pack #3547 同款):只许减不许增,新增挂账须在 PR 里显式改该文件,评审可见;
- 落地时挂账清单应为空(console.objectView 的 2 个 key 在 8 个语言包里是英文原文,其中 systemViewReadonly 还是与 en 不一致的旧文案(全部门禁皆绿) #3582/view.readonlyTooltip 在 8 个语言包里译的是「duplicate to customize」这句已废弃语义 —— 因为它是真译文,任何「值是英文」判据都看不见它 #3625 已清,先全量扫一遍确认没有第三案存量 — 有则先清或入账)。
需要斟酌的点(dev 实测后在 PR 里裁,或报回分诊):
- en 的纯排版修正(标点/空格)是否豁免 — 倾向不豁免,挂账机制本身就是豁免通道,保持规则简单;
- 脚本对「同批跟改」的判定粒度是 key 级即可,不必比对语义;
- 该门禁与 all-locales-key-parity 的分工写进两者头注,互相指认。
关联
#3582(第一案)、#3625(第二案)、#3517(defaultValue 掩盖)、#3530/PR #3547(调用点守卫与棘轮先例)、PR #3627/#3642(两案修复 + 单 key 机械化先例:钉 en 字面量)。
Activity
yinlianghui commentedon Aug 7, 2026
认领(PM 派发,立卡即派)。
session_01GTRjn8xBqp75dk7kFupVRtclaude/issue-3650-en-drift-gatescripts/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 同目录不同文件)、不碰语言包本体。Generated by Claude Code
yinlianghui commentedon Aug 7, 2026
验收 ACCEPT → PR #3659(session_01GTRjn8xBqp75dk7kFupVRt)。en-drift 门禁落地,#3582/#3625 族缺陷的不变量自此有牙。
已核:CI 17 项 0 失败(Type Check 绿本身即 merge-base 在 CI checkout 下解析成功的证据);预测 (a)-(e) 全中,(d3) 拆三机制的表述修正接受(照单一句会误导读者)。
裁决记录(全部采纳并记入方法库):
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
feat(scripts): en 文案改动必须由九个译文包同批跟改的门禁 (objectstack-ai#3650) (objectst…
docs(ci): type-check 作业行补两道 i18n 门禁,并把该表的钉粒度降到步骤级 (objectstack-ai#3653)…
fix(i18n): fail on an inline defaultValue that contradicts its en val…