Polyglot 国际化与本地化

要解决什么问题

界面里散落着硬编码中文或英文、日期数字按单一 locale 格式化、复数用 if (n === 1) 猜规则——这些做法在多语言上线时会直接变成漏翻、词序错乱和 RTL 布局炸裂。Polyglot 把 国际化（i18n） 与 本地化（l10n） 当成可执行的工程契约，而不是「后期找翻译补文案」。

技能如何工作

它围绕项目既有的标准 i18n 库，按「配方」拆成可重复步骤：

• 字符串提取（extract）：把 UI 里的字面量迁到 t()，变量走插值，禁止拼接翻译片段。
• 键与消息格式（keys / pluralize）：语义嵌套的键名空间；复数、性别、选择模式统一用 ICU MessageFormat，不假设英语复数规则。
• Intl 与区域（intl / locale）：金额、日期、数字等区域敏感展示走 Intl API；BCP 47 与 Accept-Language 做 locale 协商，避免硬编码 en-US。
• RTL（rtl）：通过 dir 与 CSS 逻辑属性支撑从右到左排版。
• 翻译工作流（translate / mobile）：TMS 集成与移动端原生 i18n 有对应参考路径。

核心原则写得很硬：语言即文化、上下文为王（同词不同译要注释给翻译）、渐进采用（先结构后填译）、发布前 每个语言环境 100% 覆盖率；UI 容器要预留约 40% 文本扩展空间。

边界与注意点

始终执行：项目标准库、插值、ICU、Intl、翻译上下文注释、dir 控制书写方向。

绝对禁止：组件内硬编码文案、翻译技术标识符/API 键、滥用 common.text 这类泛化键、拼接已翻译片段、覆盖率不足仍发布。