用 AI 翻译和本地化文档

这篇适合谁 / 不适合谁

适合：

• 要翻译资料、文档、产品文案
• 有多语言界面 / i18n 要维护
• 想统一术语、避免同一词翻成好几种

不适合：

• 法律/合同等需认证的正式翻译（人审 + 专业译员）
• 涉密原文（先脱敏再上云）
• 要求"零术语表也能百分百准确"（术语靠你定）

开始前准备什么

1. 术语表：专有名词 / 产品名 / 缩写的中英对照。
2. 目标读者与语气：正式 / 口语 / 营销。
3. 原文格式：Markdown / 文档，尽量保留结构。

操作步骤

1. 装 skill

visa-doc-translate 是文档级翻译技能包，复制目录到客户端技能目录（与一般 Agent Skill 装法一致）：

2. 先给术语表，再翻译

把下面文档译成中文，规则：
- 术语表：API→接口(不翻)、token→令牌、Pipeline→流水线
- 专有名词（产品名/人名）保留原文不翻
- 语气：技术文档风，不口语化
- 保留原有 Markdown 标题与列表结构

3. 产品文案走 i18n

界面/产品多语言用 i18n-localization，按 key 对齐，避免同一词多种译法：

把这些 UI 文案本地化为英文，保持 key 不变，
同一概念全篇统一译法，按钮文案简短（≤3 词）。

4. 你核对关键句

翻译完你抽查术语表和 3 句关键内容，确认没"通顺但走样"。

会踩的坑

FAQ

没有术语表能译吗？

能，但质量看运气；给术语表准确率明显上升。

产品多语言怎么不重复翻？

用 i18n-localization 按 key 对齐，同概念只译一次。

翻译能保留格式吗？

能，要求保留 Markdown / 原结构；文档级翻译会带格式。

合同类能 AI 译吗？

建议只做初稿，正式用途需专业译员 + 人审认证。

怎么查翻译质量？

抽查术语表 + 3 句关键内容，确认没"通顺但走样"。

相关指南

顺着这些场景接着看：

• 用 AI 写技术博客和长文
• 把 100 页 PDF 读成一份能用的笔记
• 用 AI 做播客脚本和语音合成

相关源码

• affaan-m/ECC · visa-doc-translate 源码
• sickn33/agentic-awesome-skills · i18n-localization 源码
• Agent Skill 开放格式规范

一句话结论

结论：翻译先给术语表再翻、专有名词保留，最后你抽查关键句，别盲信"通顺但走样"的全文。