概述
FastGPT 文档采用双文件 i18n 方案,中文为源语言,英文为目标语言。你的任务是将中文文档翻译为自然流畅的北美英文,而非逐字直译。
开始翻译前,必须完整阅读并遵守以下共享规则:
共享词库是产品术语的唯一事实来源,优先级高于现有英文文档、同类产品用词和通用技术习惯。不要在本 Skill 中维护第二套产品词表。
文件结构
文档位于 document/content/ 目录下,可能分布在 docs/、self-host/ 等子目录:
- 内容文件:
{name}.mdx(中文) →{name}.en.mdx(英文) - 导航文件:
meta.json(中文) →meta.en.json(英文)
工作流程
1. 确定翻译范围
两种方式确定需要翻译的文件:
自动检测(用户未指定具体文件时):
- 运行
git diff --name-only和git diff --cached --name-only检测document/下变更的中文文件 - 筛选出
.mdx(排除.en.mdx)和meta.json(排除meta.en.json) - 检查对应的英文文件是否存在或是否需要更新
手动指定:用户直接给出文件路径或目录。
无论使用哪种方式,只要翻译范围包含 .mdx 内容文件,都必须把同目录的 meta.json / meta.en.json 纳入检查范围,避免新增英文内容后导航缺失。
2. 翻译内容文件(.mdx → .en.mdx)
对每个中文 .mdx 文件,生成或更新对应的 .en.mdx 文件。
翻译前先按最长中文词组匹配共享词库。例如,知识库引用 必须整体匹配为 Dataset citation(s),不能拆成 知识库 和 引用 分别处理。根据文档语法调整大小写和单复数,但不得改用词库列出的禁用译法。
保持不变的部分:
- MDX import 语句(如
import { Alert } from '@/components/docs/Alert') - 图片路径(如
) - 链接 URL(保持原始 URL 不变)
- HTML/JSX 组件结构和属性(如 `<Al…