背景
在开发 go-tour-i18n 多语言翻译项目时,最初希望尽可能减少人工操作,因此设计了一种较为自动化的流程。
原计划:
GitHub
↓
ChatGPT 读取项目文件
↓
生成翻译结果
↓
写入 GitHub
↓
本地执行 validation其中一个设想是:
ChatGPT 完成翻译后,直接将生成的翻译结果写入 GitHub 仓库。
实际验证后的问题
经过实际使用后发现:
- GitHub 连接本身存在,可以读取仓库文件;
- 但是当前这个 ChatGPT 会话实例不能稳定完成仓库写入流程(尤其是生成大量文件、提交 commit、push 这种完整工作流)。
因此继续要求 ChatGPT 直接写入 GitHub,会导致翻译完成后的交付环节出现不稳定。

调整后的职责划分
经过调整后,新的流程如下:
ChatGPT:
读取 GitHub inputs
↓
生成 raw-responses
↓
输出压缩包 artifact
本地环境:
解压 raw-responses
↓
retranslation import
↓
process
↓
candidate
↓
automatic validation
↓
Quality Check
↓
Final Review
↓
review evidence
↓
promotion
↓
git commit
↓
git push新的设计并不是取消自动化,而是重新划分职责:
- ChatGPT 负责翻译内容生成;
- 本地环境负责确定性的文件写入和 Git 操作。
为什么选择压缩包 artifact
如果直接复制 ChatGPT 输出:
ChatGPT 输出文本
↓
手动复制
↓
保存文件容易出现:
- 长文本复制遗漏;
- 特殊字符变化;
present结构破坏。
因此改为:
ChatGPT
↓
raw-responses.zip
↓
本地导入保持完整文件结构。
新增 retranslation import
为了支持新的交付方式,go-tour-i18n 增加了:
retranslation import用于导入 ChatGPT 生成的 raw response artifact。
例如:
go run -mod=readonly ./cmd/tour-i18n retranslation import \
--locale ja-JP \
--batch-id chatgpt-ja-JP-007 \
--archive ~/下载/chatgpt-ja-JP-007-raw-responses.zip执行结果:

导入后继续执行标准流程
artifact 导入后,不改变原有翻译流程。
继续执行:
go run -mod=readonly ./cmd/tour-i18n retranslation process \
--locale ja-JP \
--batch-id chatgpt-ja-JP-007流程:
raw-responses
↓
restore
↓
candidate
↓
automatic validation实际执行结果:

retry 与质量流程保持不变
如果 validation 失败:
validation_failed
↓
retry
↓
重新生成 candidate
↓
重新 validation不会绕过已有质量控制流程。
最终仍然:
automatic validation
↓
Final Review
↓
review evidence
↓
promotion最终流程总结
经过调整后:
ChatGPT
读取 GitHub inputs
生成 raw-responses artifact
本地环境
导入 artifact
执行 process
执行 validation
执行 review
执行 Git 操作完整流程:

总结
这次调整并不是降低自动化程度,而是让 AI 与工程环境承担更适合自己的职责。
AI 更适合:
- 阅读上下文;
- 翻译;
- 分析;
- 生成内容。
而文件写入、Git 提交、发布流程,则交由稳定环境执行。
对于长期维护的多语言项目,这种职责划分更容易保证流程稳定性。
Go 学习与文档多语言本地化项目
本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。
项目源码:
✅ GitHub:shuijingwan/go-tour-i18n
语言版本:
当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。
英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。
- 阿姆哈拉语
- 阿拉伯语
- 孟加拉语
- 葡萄牙语(巴西)
- 保加利亚语
- 加泰罗尼亚语
- 克罗地亚语
- 捷克语
- 丹麦语
- 荷兰语
- 英语(美国)(Go 官方英文站点)
- 英语(澳大利亚)
- 英语(加拿大)
- 英语(印度)
- 英语(新加坡)
- 英语(南非)
- 英语(英国)
- 爱沙尼亚语
- 菲律宾语
- 芬兰语
- 法语(法国)
- 法语(加拿大)
- 德语(德国)
- 德语(奥地利)
- 德语(瑞士)
- 希腊语
- 古吉拉特语
- 希伯来语
- 印地语
- 匈牙利语
- 印度尼西亚语
- 意大利语
- 日语
- 卡纳达语
- 哈萨克语
- 韩语
- 西班牙语(拉丁美洲)
- 拉脱维亚语
- 立陶宛语
- 马来语
- 马拉雅拉姆语
- 马拉地语
- 书面挪威语(Bokmål)
- 波斯语
- 波兰语
- 葡萄牙语(葡萄牙)
- 旁遮普语(果鲁穆奇文,印度)
- 罗马尼亚语
- 俄语
- 塞尔维亚语(西里尔文)
- 简体中文(中国大陆)
- 简体中文(新加坡)
- 斯洛伐克语
- 斯洛文尼亚语
- 西班牙语(西班牙)
- 斯瓦希里语(坦桑尼亚)
- 瑞典语
- 泰米尔语
- 泰卢固语
- 泰语
- 繁体中文(台湾)
- 繁体中文(香港)
- 土耳其语
- 乌克兰语
- 乌尔都语
- 越南语
项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。
本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。
