用途：在 React、Vue、Angular、Next.js 等项目中搭建或调试 i18n/l10n，包括库与目录策略选型、ICU 复数与格式化、语言检测、RTL 支持、抽取与翻译流程、TMS 集成，以及修复缺失翻译、混语言回归和错误的回退行为。也处理后端生成文案（如 AI 摘要）交付给本地化客户端，以及原生应用与 Web 共用的目录键值一致性；框架搭建以 Web 为主，平台 API 归 iOS/Android/移动技能。
主要能力：按路由模型、抽取需求、ICU 期望和团队维护习惯选择库（如 i18next、react-intl、next-intl、vue-i18n、@angular/localize、Lingui、typesafe-i18n）。工作流为：确认框架、语言数量、路由策略与翻译流程；选择库与目录模型；分离显式路由解析与首次进入的语言协商及持久化；正确实现 ICU 消息格式化；加入抽取、缺失键与过期翻译控制；按需补充 RTL 与视觉回归覆盖；对可索引或客户可见路由阻止混语言或不安全回退的发布。核心规则包括全程 UTF-8、禁止拼接可翻译字符串、显式 URL 语言优先、定义回退语言、不在可索引非英语路由静默回退英语、CI 运行硬编码与缺失键检查、使用 CSS 逻辑属性并设置 dir="rtl"。
限制：单一语言且无新增计划时不应预建 ICU 目录、TMS 或语言路由；纯文本翻译不属本地化工程；国际 SEO 结构交营销 SEO。ICU MessageFormat 2 虽在规范层面稳定，但工具链未跟上，暂不建议迁移生产目录。不要仅按流行度选库。常用维护命令：python3 scripts/check_urls.py 与 python3 scripts/check_examples.py。