claude-code-hub/docs/i18n-settings-split.zh-CN.md

i18n settings split（拆分说明）

English: i18n-settings-split.md

本仓库将 messages/<locale>/settings.json 拆分为更小的 JSON 文件，存放在 messages/<locale>/settings/ 目录下。

目录结构（Layout）

• messages/<locale>/settings/*.json: settings 顶层对象的各个子模块
• messages/<locale>/settings/strings.json: 直接属于 settings 顶层的字符串 key
• messages/<locale>/settings/providers/*.json: settings.providers 对象拆分后的子模块
• messages/<locale>/settings/providers/strings.json: provider 级别的字符串 key
• messages/<locale>/settings/providers/form/*.json: settings.providers.form 对象拆分后的子模块
• messages/<locale>/settings/providers/form/strings.json: provider form 的字符串 key

运行时拼装发生在 messages/<locale>/settings/index.ts，并由 messages/<locale>/index.ts 引入。

验证（Verification）

• 翻译质量规则与审计命令：

  • docs/i18n-translation-quality.md

• 跨 locale 同步 key（canonical: zh-CN）：

  • node scripts/sync-settings-keys.js

• 单元测试：

  • bun run test

• 针对 split 相关模块的 scoped coverage：

  • bunx vitest run --coverage --coverage.include=scripts/sync-settings-keys.js --coverage.include=messages/**/settings/index.ts

• Typecheck：

  • bun run typecheck

• Lint：

  • bun run lint

• Production build：

  • bun run build