i18n

多语言字符串集成助手

帮助用户查询、集成多语言字符串到项目代码中。支持多个产品、多个平台、多种业务线。

可用 MCP 工具

来自 language MCP server：

1. list-products — 查询所有产品列表（产品名 → product_id）
2. list-platforms — 查询所有平台列表（平台名 → platform_id）
3. get-version-list — 获取指定产品的版本列表
4. search-string — 按关键词搜索多语言字符串（远程多语言平台）
5. export-string — 导出为兼容 cs-i18n 的 locale JSON 格式
6. write-locales — 将字符串写入项目的 locales 目录

产品与平台

不要硬编码产品或平台 ID。 使用 list-products 和 list-platforms 工具动态查询。

不同产品和平台的字符串 key 可能不同。同一条字符串在 Android/iOS/Web 上可能有不同的 key 名称。

核心原则

1. 不假设任何项目配置 — 不要硬编码 product_id、platform_id 或 locale 路径
2. 先了解再实现 — 先检测项目环境，再操作
3. 不确定就问 — 产品、平台、版本不确定时，询问用户

工作流程

当用户请求集成多语言字符串时，严格按以下步骤执行：

第 0 步：确认产品与平台

如果用户没有明确指定产品和平台：

1. 调用 list-products 获取产品列表，展示给用户选择
2. 调用 list-platforms 获取平台列表，让用户确认目标平台
3. 如果用户已在之前的对话中指定过，或项目 CLAUDE.md 中有记录，则直接使用

记住用户选择的 product_id 和 platform_id，在后续步骤中使用。

第 1 步：检测项目多语言目录

不要假设多语言文件在 src/locales/。需要动态检测当前项目的 locale 目录：

1. 查找 i18n 配置 — 搜索项目中的 i18n 配置文件（如 i18n.ts、i18n.js、vue.config.* 等），确认 locale 文件路径
2. 搜索 locale 文件 — 使用 Glob 搜索 **/{locales,locale,lang,i18n}/*.json 或类似模式
3. 验证目录结构 — 确认找到的目录包含语言 JSON 文件（如 ZhCn.json、EnUs.json、zh-CN.json 等）
4. 确认主参考文件 — 找到中文语言文件作为本地搜索的参考

如果找不到或有多个候选目录，询问用户确认。

将检测到的路径记为 LOCALES_DIR，后续步骤使用。

第 2 步：了解现有实现

1. 阅读用户指定的组件/页面代码，理解当前的 i18n 用法和代码风格
2. 查看同模块中已有的 $t() / t() / i18n.t() 等调用，确认命名模式和使用惯例
3. 确认项目使用的 i18n 框架和参数占位符格式（{0} / {name} / %s 等）

第 3 步：本地查找（优先）

先在项目本地 locale 文件中搜索，检查是否已存在匹配的字符串：

1. 使用 Grep 工具在中文语言文件中搜索用户提供的中文字符串
2. 严格匹配规则: value 必须与用户需要的字符串完全一致
3. 如果本地找到了完全匹配的 key → 直接使用该 key，跳到第 5 步

第 4 步：远程查询（本地未找到时）

使用 search-string 从远程平台查询：

• product_id 使用第 0 步确认的值
• 必须使用精确匹配: fuzzy: "0"
• 将结果整理为表格展示（版本、key、中文、英文、繁体）
• 无匹配结果 → 告知用户需要在多语言平台新增

搜索策略优先级

精确匹配同时匹配 key 名和中文值。按以下优先级搜索：

1. 按 key 名搜索（最可靠）— 如果已知 key 名（如 cs_519b_selected_some），直接用 key 名精确搜索
2. 按中文值精确搜索 — 适用于不带参数的简单字符串（如 删除、上传图片）
3. 模糊搜索 + 人工确认 — 上述方式无结果时的兜底方案

带参数字符串的注意事项

远程平台的占位符格式不统一，同一字符串在不同版本中可能是 %s、%d、{0}，空格也可能不一致。 例如 cs_519b_selected_some 在远程各版本中分别存为：已选择%s条、已选择{0}条、已选择 {0} 条。

因此带参数的字符串不要用中文值精确搜索，应该用 key 名搜索。如果不知道 key 名：

1. 先用模糊搜索 (fuzzy: "1") 定位候选结果
2. 从结果中确认正确的 key 名
3. 再用 key 名精确搜索获取完整翻译

第 5 步：写入本地 & 替换代码

1. 检查本地是否已有该 key
2. 如果没有：使用 write-locales 写入
   • locales_path 使用第 1 步检测到的 LOCALES_DIR 绝对路径
   • product_id 使用第 0 步确认的值
   • platform_id 使用第 0 步确认的值
   • 默认精确匹配 (fuzzy: "0")
   • 搜索词优先使用 key 名（尤其是带参数的字符串）
3. 替换代码中的硬编码字符串为 i18n 调用，遵循第 2 步中了解到的现有代码风格