将 FastGPT 文档从中文翻译为面向北美用户的英文。当用户提到翻译文档、i18n、国际化、translate docs、新增/修改了中文文档需要同步英文版时,使用此 skill。也适用于用户要求检查文档翻译缺失、批量翻译、或对比中英文文档差异的场景。
复制下面这句话,粘贴给 Claude Code、Codex、Cursor 等 AI 编程工具,它会读取安装说明并在你确认后完成安装。
请阅读 https://ai.atlankj.com/install/asset/gh-i18n-e153a026f5b9 ,按照其中的说明把「doc-i18n」安装到你(当前 AI 工具)中。执行前先告诉我将运行的命令和写入的位置,等我确认。
查看 AI 将读取的安装说明正在读取 GitHub 原文…
内容来自 GitHub 原始文件,由原作者维护。在 GitHub 查看
FastGPT 文档采用双文件 i18n 方案,中文为源语言,英文为目标语言。你的任务是将中文文档翻译为自然流畅的北美英文,而非逐字直译。
开始翻译前,必须完整阅读并遵守以下共享规则:
共享词库是产品术语的唯一事实来源,优先级高于现有英文文档、同类产品用词和通用技术习惯。不要在本 Skill 中维护第二套产品词表。
文档位于 document/content/ 目录下,可能分布在 docs/、self-host/ 等子目录:
{name}.mdx(中文) → {name}.en.mdx(英文)meta.json(中文) → meta.en.json(英文)两种方式确定需要翻译的文件:
自动检测(用户未指定具体文件时):
git diff --name-only 和 git diff --cached --name-only 检测 document/ 下变更的中文文件.mdx(排除 .en.mdx)和 meta.json(排除 meta.en.json)手动指定:用户直接给出文件路径或目录。
无论使用哪种方式,只要翻译范围包含 .mdx 内容文件,都必须把同目录的 meta.json / meta.en.json 纳入检查范围,避免新增英文内容后导航缺失。
对每个中文 .mdx 文件,生成或更新对应的 .en.mdx 文件。
翻译前先按最长中文词组匹配共享词库。例如,知识库引用 必须整体匹配为 Dataset citation(s),不能拆成 知识库 和 引用 分别处理。根据文档语法调整大小写和单复数,但不得改用词库列出的禁用译法。
保持不变的部分:
import { Alert } from '@/components/docs/Alert'))<Alert icon="🤖" context="success">)需要翻译的部分:
title 和 description对每个中文 meta.json,生成或更新对应的 meta.en.json。翻译 .mdx 文件时,也要同步检查其同目录导航文件:
meta.json,检查本次翻译的中文文件 basename(如 41503.mdx → 41503)是否在 pages 数组中。meta.json 未引用,应按目录内现有排序和上下文更新 meta.json;无法可靠判断位置时,先询问用户,不要只创建 .en.mdx 后忽略导航。meta.en.json 的 pages 必须与 meta.json 保持一致,只翻译 title、description 和分隔符字符串,不要翻译或删除页面文件名引用。meta.en.json 缺失,必须创建;如果已存在但 pages 落后于 meta.json,必须同步。meta.json,仍按导航文件翻译规则更新 meta.en.json,并检查 pages 中引用的中文 .mdx 是否有对应 .en.mdx。pages 顺序错误。需要翻译的字段:title、description、分隔符字符串(如 "---入门---" → "---Getting Started---")
保持不变的字段:pages 数组中的文件名引用、icon、root、order
训练 应按功能使用 Indexing、Processing 或 Reindexmeta.json / meta.en.json.mdx 未被同目录 meta.json 引用,且本次未能安全更新导航,明确提醒用户这些原则的核心目标是让北美开发者读起来感觉像是原生英文文档,而不是翻译过来的。
示例:
中文:可轻松导入各式各样的文档及数据,能自动对其开展知识结构化处理工作。
✗:You can easily import various documents and data, which will be automatically processed for knowledge structuring.
✓:Import documents and data with automatic knowledge structuring.
直接使用国际版名称,不保留中文原名:
| 中文 | 英文 |
|---|---|
| 飞书 | Lark |
| 企业微信 | WeCom |
| 钉钉 | DingTalk |
| 公众号 | WeChat Official Account |
| 文心一言 | ERNIE Bot |
| 中国大陆版 | China Mainland |
| 国际版 | International |
FastGPT 产品概念必须使用共享专有名词库,不得因为现有文档或竞品采用其他叫法而替换。例如:
知识库 → Dataset,不是 Knowledge Base数据集 → Collection,不是 Dataset节点、模块 → Node,不是 Module调试 → Debug;试运行 → Test Run引用 → Citation;知识库引用 → Dataset citation(s)问题优化 → Query rewriting索引模型 → Embedding model词库未覆盖的纯技术概念使用业界通用术语,例如 LLM、Vector Store、Low-code。如需参考 n8n 或 Dify,只能比较底层产品含义;FastGPT 共享词库始终优先。