# 国际化专家 ## 概述提供完整的 i18n 设置 + 审核通过：配置 i18n 框架，用键替换面向用户的字符串，确保语言环境奇偶性，并验证 en-US 和 zh-CN 的复数/格式。 ## 核心能力 * 库选择和设置（React、Next.js、Vue）。 * 关键架构和区域设置文件组织。 * 翻译生成和质量策略（人工智能、专业、手动）。 * 路由和语言检测/切换。 * SEO 和元数据本地化（如果适用）。 * RTL 支持（仅当 RTL 区域设置在范围内时）。 ## 范围输入（不清楚时询问） * 框架和路由风格。 * 现有的 i18n 状态（无、部分、遗留）。 * 目标区域设置（默认：en-US + zh-CN）。 * 翻译质量需求（人工智能、专业、手动）。 * 使用的区域设置格式（JSON、YAML、PO、XLIFF）。 * 形式/文化要求（如果有）。 ## 工作流程（审核 -> 修复 -> 验证） 1. 确认范围和区域设置目标 * 确定 i18n 框架和语言环境位置。 * 确认区域设置；指定时默认为 en-US + zh-CN。 2. 设置 i18n 基线（如果缺少） * 选择适合框架的库（例如，React：react-i18next；Next.js：next-intl；Vue：vue-i18n）。 * 安装软件包并创建 i18n 条目/配置文件。 * 在应用程序根目录连接提供程序并加载区域设置资源。 * 根据需要添加语言切换器和持久性（route/param/localStorage）。 * 建立区域设置文件布局和关键命名空间。 * 如果路由是区域设置感知的，请尽早定义区域设置段策略（子路径、子域、查询参数）。 * 如果元数据是面向用户的，请包括标题/描述的翻译。 3. 审核密钥使用情况和区域设置奇偶性 * 运行： python script/i18n_audit.py --src --locale --locale * 将丢失的密钥/奇偶校验间隙视为障碍。 * 手动验证动态密钥 (`t(var)`)。 4. 查找面向用户的原始字符串 * 搜索： rg -n --glob '/**/*.{ts,tsx,js,jsx}' "<[^>]+>[^<{]*[A-Za-z][^<{]*<" rg -n --glob '/**/*.{ts,tsx,js,jsx}' "aria-label=\"[^\"]+\"|标题=\"[^\"]+\"|占位符=\"[^\"]+\"" * 本地化辅助功能标签。 5. 用键替换字符串 * 使用 `t('namespace.key')` 作为 UI 文本。 * 对于复数，请使用 `t('key', { count })` \+ `_one/_other` 键。 * 使用 Intl/app 格式化程序来表示时间/日期/数字。 6. 本地化错误处理（关键） * 将错误代码映射到本地化键；仅显示本地化的 UI。 * 仅记录原始错误详细信息。 * 为未知代码提供本地化回退。 7. 更新语言环境文件 * 添加两个语言环境中缺少的键。 * 保持占位符一致；除非要求，否则避免重命名。 * 使用约定的方法生成翻译；保留占位符和复数规则。 8. 验证 * 重新运行审核，直到缺失/奇偶校验问题为零。 * 验证 JSON（例如，`python -m json.tool `）。 * 更新断言可见文本的测试。 ## 护栏 * 切勿将原始 `error.message` 暴露给 UI；仅显示本地化字符串。 * 除非明确要求，否则不要添加额外的语言环境。 * 更喜欢结构化命名空间（例如，“errors.*”、“buttons.*”、“workspace.*”）。 * 保持翻译简洁、一致。 * 一些技术/品牌术语不应翻译（例如产品名称、API、MCP、Bash）。 ## 可交付成果（预期产出） * i18n 配置/提供商接线。 * 每种目标语言的区域设置文件。 * 用稳定的键替换了 UI 字符串。 * 语言切换器和持久性（如果适用）。 * 更新了可见文本的测试。 ## 架构指导（保持简洁） * 关键结构：更喜欢按区域嵌套命名空间（例如，`common.buttons.save`、`pricing.tier.pro`）。 * 文件布局：每个语言环境或每个语言环境命名空间一个文件；保持密钥在不同区域设置中同步。 * 占位符：准确保留 `{name}`/`{{name}}`；通过语言环境规则验证复数形式。 * 格式化：使用 Intl/app 帮助程序进行日期、时间、数字和列表格式化。 * SEO/元数据：如果应用程序公开了标题和描述，则对其进行本地化。 * RTL：仅 RTL 语言环境需要；使用逻辑 CSS 属性和测试布局。 * 非 Web 界面（Electron 主进程对话框、CLI 提示、本机菜单）也需要本地化。 ## 性能说明（短） * 当应用程序支持时，延迟加载语言环境包。 * 按名称空间分割大型语言环境文件。 ## 故障模式（观察列表） * 缺少翻译：回退到默认区域设置并记录警告。 * RTL 布局问题：验证逻辑 CSS 和测试页面。 * SEO 缺失：确保替代品和元数据在适用时进行本地化。 ## 验证清单（简短） * 没有丢失的按键，也没有原始的 UI 字符串。 * 区域设置切换有效并持续存在。 * 复数和格式在两种语言环境中均经过验证。 * 配置后备区域设置。 ## 资源 ### 脚本/ * `scripts/i18n_audit.py`：提取 `t('key')` 用法并与语言环境 JSON 文件进行比较。

国际化专家

包含技能