i18n

/cc-enforcer:i18n

本插件的规则文本与注入文案是多语言的：英文（root）是骨架 （source of truth），每种翻译放在语言码子目录（rules/zh/、 prompts/zh/、rules/<code>/ …）。翻译必须逐节跟随骨架。本命令调用 hooks/scripts/i18n_check.py 检测任何 结构漂移。设计与契约见 docs/I18N.md。

检查什么

对 rules/ 与 prompts/ 下的每个翻译子目录，与其英文骨架比对：

1. 文件集对齐 —— 骨架每个 *.md 都有同名翻译（缺失 = missing_file）， 翻译没有骨架里不存在的文件（多余 = orphan_file）。
2. 章节结构对齐 —— 每个共有文件的 ATX 标题层级序列（如 [1, 2, 2, 3]） 必须逐项相同。只比结构，不比标题文字（文字本来就翻译过了）； 代码围栏（```/~~~）内的 # 注释不算标题。
3. 强制 token 对齐（v0.26）—— 骨架里凡是陈述物理强制结果的行（含 DENY / BLOCK / 拒绝 / 拦截），该行内那些长得像 agent 会敲的命令的反引号 code span，必须在翻译文件里也出现（缺失 = enforcement_tokens）。散文本来 就要翻译、结构上一条已经比过，但"告诉 agent 哪些会被拦"的 token 不是散文， 是契约 —— 中文注入曾只列出 bash_guard 七条拦截模式里的四条，而前两项检查 全绿。两条刻意的边界：只扫强制行（比对全部 code span 会在 rules/ 里冒出 24 处合法的翻译差异），且只认机器形态的 token。它不验证那句强制语句本身 翻没翻，只验证它的 token 在译文里出现过。

你（receiving agent）要做的

python "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/i18n_check.py"

或只要退出码（用于脚本/CI 判定）：

python "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/i18n_check.py" --quiet

参数解释：

• 无参数：打印完整报告，有漂移 → 退出码 1，无漂移 → 退出码 0。
• --quiet：只给退出码，不打印报告。

输出契约

同步时：

cc-enforcer i18n: all translations in sync with the English skeleton.

有漂移时（退出码 1）：

cc-enforcer i18n: <N> drift(s) vs the English skeleton:

  [missing_file] rules/zh/07-task-fidelity.md: skeleton file has no translation here
  [header_structure] prompts/zh/session-start.md: skeleton has 5 headers [1,2,2,2,2], zh has 4 [1,2,2,2]
  ...

English is the skeleton (source of truth). On drift, update the
translation to match the skeleton — see docs/I18N.md.

修漂移的方向

永远改翻译去追骨架，不要改骨架去迁就翻译。 英文是 source of truth：

• missing_file → 在 rules/<lang>/ 补上同名翻译文件。
• orphan_file → 该翻译文件在骨架里没有对应；删除它，或先给骨架补上英文源。
• header_structure → 翻译的章节数/层级/顺序与骨架不一致；对照骨架增删/调整 翻译里的 # 标题（只动结构，标题文字仍用目标语言）。
• enforcement_tokens → 翻译没提到骨架声称会被拦截的某些 token；把 detail 里 列出的每个 token 原样（反引号里的命令 / 标志保持英文）补进译文对应那一行， 别只翻译描述、把 token 省掉。