用途:翻译 FastGPT 的 i18next 命名空间 JSON 文件。以 packages/web/i18n/zh-CN/<namespace>.json 为语义和结构来源,把用户明确指定的一个、多个或全部命名空间翻译到 packages/web/i18n/ 下除 zh-CN 外的所有同级语言目录,不改变运行时行为。
主要能力:需先完整阅读 references/translation-guidelines.md 与 references/fastgpt-glossary.json。支持传入裸命名空间(如 app 解析为 zh-CN/app.json)或 all(zh-CN 下所有 JSON,按文件名排序)。拒绝 zh-CN 以外的源,要求提供简体中文源。只编辑选中的命名空间文件;目标语言目录已存在时可新建缺失的目标文件,但不新建语言。保留目标文件中无关的用户改动。
翻译原则:先确定产品含义再措辞。用 rg 查 en 目录中同一概念的既有译法,检查调用点判断文本是按钮、标题、状态、描述、toast 还是校验信息。证据顺序为术语表、功能行为与 UI 上下文、邻近翻译风格、n8n 或 Dify 官方英文产品语言、通用技术用法。优先匹配最长术语,禁止使用术语表中的禁用译法;缺少产品概念时报告而非自造。en 用简洁自然的北美产品英语、默认句首大写;zh-Hant 用地区中立的自然繁体而非字符直转;其他语言用该语言的母语产品表达,无法可靠翻译时先询问。
格式要求:保持 JSON 键、嵌套、键序、值类型和格式与中文源一致;原样保留 {{name}} 等插值变量、<bold> 富文本标签、URL、转义序列和有意换行;键集与中文源对齐。
验证:从仓库根运行 node .agents/skills/system/i18n-translate/scripts/validate-namespace.mjs packages/web/i18n/zh-CN/<namespace>.json;all 时对每个源各跑一次,要求零错误零警告。之后仅格式化改动的命名空间 JSON,再次验证,审查 git diff,并检查英文目标中未翻译的汉字(有效中文品牌名或用户可见示例可作为例外)。翻译改动通常不必跑完整测试套件。完成时报告命名空间与语言、创建或更新的文件、验证命令与结果、有意保留的源语言文本或未决术语,不另写总结文档。