没有不值得去解决的问题,也没有不值得去学习的技术!

历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

作者:

在

Go 学习与文档多语言本地化项目

图3:访问过去的 Go Tour 简体中文站 tour.go-zh.org 时,当前已经无法正常建立连接。

(1) 从「A Tour of Go 中文版」这个搜索词开始:我决定做一个持续维护的 Go Tour 中文版

本地运行的 A Tour of Go「Methods continued」课程页面,左侧为课程说明,右侧为 Go 代码编辑器及运行结果。

(2) A Tour of Go 中文版项目设计冻结:从 101 页到 103 页,从 Gin 转向 Cobra CLI

A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

(3) A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

go-tour-i18n 项目完成首个简体中文课程页面 welcome/1 的整页翻译、结构校验和本地预览。

(4) A Tour of Go 多语言翻译项目实录:完成首个 zh-CN 页面翻译闭环

图 1:DeepSeek 官方更新日志显示,本次只更新 DeepSeek-V4-Flash,DeepSeek-V4-Pro API 与 APP、Web 模型均未更新

(5) A Tour of Go 中文翻译项目进展:完成前 8 页、修复 present 语法,并暂缓 DeepSeek 对比

图 1:generics/1 简体中文页面本地预览

(6) 一个页面重试五次:使用 GLM-5.2 翻译 A Tour of Go 时遇到的 Token 与 Present 结构问题

图 1:methods/16 简体中文页面浏览器预览

(7) A Tour of Go 中文翻译实录:如何只翻译教学代码注释,而不破坏 Go 代码

图 2:A Tour of Go methods/20「练习:错误」中文候选页面最终渲染效果

(8) A Tour of Go 多语言翻译:当正确的中文语序被受保护标记顺序校验误判

图 3:methods/24 中文页面,静态代码、Bounds 行内代码和链接内的 image.Rectangle 均正确渲染

(9) A Tour of Go 中文翻译完成 7 个代表页校准:最后 3 页又发现了哪些真实问题

图 2:首批 10 个普通页面经过试跑与流程校准后全部进入 ready

(10) A Tour of Go 多语言翻译项目:首批 10 个普通页面试跑,从 2 个 blocked 到全部 ready

图 2:flowcontrol/6 最终中文页面,return 与 v 为适应自然中文语序发生整体换位

(11) A Tour of Go 中文翻译第二批实跑:从 Inline Code 顺序误判到历史响应重新验证

图 1:flowcontrol/6 首次原始输入实验直接通过统一自动校验

(12) A Tour of Go 多语言翻译项目:从 swap 问题重新审视 Token 保护,原始输入与最小保护的一次真实实验

图 7:moretypes/1 最终中文页面预览。左侧课程正文、静态代码块、行内代码和教学注释均正常渲染,右侧官方 Go 示例继续保持原样。

(13) A Tour of Go 多语言翻译实战:第三批 10 页全部 Ready,继续校准 Protected Token 的结构角色

图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0

(14) A Tour of Go 多语言翻译项目:zh-CN 103 个课程页面全部 ready,课程正文翻译阶段完成

图 4:GitHub 与 ChatGPT 已成功连接

(15) ChatGPT 连接 GitHub 实测:让 AI 直接读取 go-tour-i18n 仓库参与译文审核

图 3:中文 Go 术语校准完成后,将确定的译法写入 zh-CN glossary

(16) 为什么 channel 最终选择“通道”:A Tour of Go 中文术语统一的一次实践

图 1:技术含义基本正确,但“返回一个返回……”已经明显影响阅读,因此仍被列入 C 类修订

(17) 103 页逐页审核后,只返修 16 页:A Tour of Go 中文正文发布前质量审计

图 2:中文课程页面以及已经完成本地化的编辑器控制区

(18) A Tour of Go 多语言翻译项目:公共 UI 本地化完成,从课程译文走向完整中文界面

图 2:完整 zh-CN 正式投影成功生成,103 个课程页面被重新组装为 7 个 .article

(19) 从 103/103 ready 到完整站点验收:A Tour of Go 中文版补齐正式投影与课程元数据本地化

图 3:从 production bundle 独立启动的 A Tour of Go 简体中文页面,课程正文、公共 UI 和官方 Go 示例均已进入最终发布形态。

(20) A Tour of Go 多语言翻译项目:103 页全部完成后,我终于生成了可独立部署的 zh-CN Production Bundle

图 1:A Tour of Go 简体中文版正式生产页面,远程运行已经成功输出“Hello, 世界”。

(21) A Tour of Go 多语言翻译项目:zh-CN 正式上线,从生产发布到 go.dev Playground 的完整部署记录

图 1:新生产域名 go-dev.shuijingwanwq.com 已正常访问,Go 示例远程运行成功

(22) A Tour of Go 多语言翻译项目:从 go-tour 到 go-dev,完成 EdgeOne、Nginx 与 HTTPS 生产域名迁移

图 1:A Tour of Go 多语言翻译项目正式生产首页

(23) A Tour of Go 多语言翻译项目正式上线:从项目首页、公共 Footer 到生产发布元数据的完整收尾

图 3:GA4 g/collect 请求返回 HTTP 204,并携带当前课程页面地址,确认 Google Analytics 已产生真实事件上报

(24) A Tour of Go 多语言翻译项目:接入 Google Analytics 与百度统计,从 systemd 注入到 EdgeOne 与真实上报验证

图 1:生产环境 robots.txt 与 sitemap.xml 已正确对外提供,Sitemap 共包含 104 个规范 URL。

(25) A Tour of Go 中文站上线后:补齐 robots.txt、Sitemap,并完成五大搜索引擎提交

图 4:发布生产并刷新 EdgeOne 缓存后,再次通过真实手机访问,顶栏项目名称已经完整保持在一行,最终移动端验收通过。

(26) A Tour of Go 多语言翻译项目:修复手机端首页顶栏标题换行,并完成真机验证

图 3:生产自动部署脚本第一次真实运行时,systemd 已经显示 active,但首次 localhost 探测仍然得到 HTTP 000;随后连续 3 次同时满足 active + HTTP 200 后,脚本才判定部署成功,并继续完成公网 HTTP 200 验收。这次真实运行验证了连续应用层健康检查的必要性。

(27) A Tour of Go 多语言翻译项目:从一次 203/EXEC 故障到生产自动部署脚本落地

图 1:阿里云生产环境访问 go.dev Playground 时出现 TLS 握手超时

(28) A Tour of Go 多语言翻译项目:为 Playground 搭建独立的 ZgoCloud 执行代理

图 3:清除 /tour/script.js 缓存后,Run 已直接请求 ZgoCloud /compile 并返回 HTTP 200

(29) A Tour of Go 多语言翻译项目:将生产 Run / Format 切换到 ZgoCloud 执行节点

【图 1:微信中运行 Go 示例时出现 Error communicating with remote server.】

(30) A Tour of Go 中文版手机端运行与格式化偶发失败排查:从间歇性报错到补强 Nginx 可观测性

【图 4:向 golang-dev 公开邮件列表发送 Playground 使用告知邮件并投递成功】

(31) A Tour of Go 多语言项目:为 Playground 代理增加唯一 User-Agent,并主动告知 Go 官方

【图 3:百度剩余 9 个核心 URL 提交成功,remain 归零】

(32) A Tour of Go 搜索引擎收录实测:从 Google 自然索引到百度主动提交与 Bing IndexNow

【图 1:当前正式中文 methods/24 页面,右侧示例代码运行成功】

(33) A Tour of Go 中文翻译完成后,我为什么重新评估 minimal-protect 翻译模式

【图 3:5 个页面 Request SHA256 完全一致,但 Response SHA256 全部不同】

(34) A Tour of Go 翻译实验:更多原始上下文为什么没有更好?从 157 个保护标记到 30 次重复盲评

图 3:3 个代表页 × 4 个评审模型,共 12 次匿名评审的完整排名与第一名票数。

(35) A Tour of Go 翻译质量再评估:minimal-protect 未达预期后,我开始比较 ChatGPT、Codex 与 GLM-5.2

图 2:GitHub 中的 chatgpt-zh-CN-008 重译批次。一个 Batch 同时保存 inputs、raw-responses、candidates、validation 和 retry 记录,GitHub 成为 ChatGPT 与本地翻译流水线之间的数据交接层。

(36) 没有 OpenAI API,我如何用 ChatGPT + GitHub 完成 A Tour of Go 103 页全量重译

图 1:103 个正式课程页面完成最终语义质量审核,结果为 A=103、B/C/D=0,同时不存在缺失、重复或额外页面。A/B/C/D 是本轮项目内部语义质量分级,并不是自动结构 validator 的结果。

(37) 103 页翻完还不能发布:A Tour of Go ChatGPT 译文的语义审核与 Canonical Promotion

图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。

(38) 103/103 与 7/7 Exact Match:A Tour of Go ChatGPT 新译文的最终线上验收

【图 2:upstream source preview】

(39) A Tour of Go 多语言翻译项目首次实现 upstream 同步机制:从一次性翻译到长期维护

图 2:A/B/C/D 质量评级规则,展示正式质量 rubric 与 Promotion gate。

(40) A Tour of Go 多语言翻译项目引入 Translation Quality Review:从自动验证到 AI 翻译质量控制

图 4:翻译后 Playground Example,展示中文注释与保持不变的 Go 代码结构。

(41) A Tour of Go 多语言翻译项目实现 Playground Example 本地化:从代码注释翻译到完整学习体验

图 5:公网页面验证广告脚本输出

(42) A Tour of Go 多语言翻译项目接入广告系统:从 AdSense 专用配置到通用 HTML 注入架构

图 3:百度统计单页应用设置

(43) go-dev 单页网站接入统计与 Google AdSense Auto Ads 验证记录

图 1:GitHub 仓库中的多语言翻译项目结构

(44) A Tour of Go 多语言翻译项目:选择日语作为第二语言并启动翻译验证

图 5:模型身份描述不一致

(45) A Tour of Go 多语言翻译项目中的 AI 协作异常排查:一次长期工程会话失效分析

【图 1:ChatGPT GitHub 写入流程调整说明截图】

(46) go-tour-i18n 翻译流程调整:从 ChatGPT GitHub 写入到本地 artifact 导入

图 4 展示了本次异常状态。

(47) go-tour-i18n 翻译自动化流程复盘:已验证的 ChatGPT 翻译能力在新任务中的稳定性问题

【图 6:全部评审结束以后才读取 secret key,完成最终揭盲】

(48) A Tour of Go 翻译质量再评估:Codex High 已接近 ChatGPT High,我决定调整默认翻译引擎

图 4:ja-JP 生产课程页实际运行 Go 示例

(49) A Tour of Go 日语版正式上线:第二门语言 ja-JP 完成生产发布

图 1:ja-JP 上线以后,先提交“新增语言标准化流程”

(50) A Tour of Go 多语言扩展复盘:为第三门语言建立标准化流程

图 1:课程正文结束以后,页面左侧仍然存在大块视觉空白,但 AdSense 并没有在这里插入展示广告。

(51) A Tour of Go 明明有大片空白,为什么 AdSense 就是不显示展示广告?

图 2:golang/website 当前的 _content/tour/。课程内容、静态资源和模板都在这个上游目录中持续维护。

(52) 为了 AdSense,要不要放弃 SPA?A Tour of Go 页面架构的一次取舍

图 4:最终的手动课程广告真实展示在课程内容区域内,而不是 footer 之后。

(53) 保留 SPA 以后,广告应该放在哪里?从 AdSense 预览到方案 B

图 1:Google Search Console 中,多个不同的 A Tour of Go 课程 URL 被判断为“重复网页,用户未选定规范网页”。

(54) SPA 的 SEO 老问题:为什么最后还是给 103 个 A Tour of Go 课程页生成了 Prerender HTML

图 2:方案 B 生产环境中,源码已经正常,但课程主体高度异常缩短,footer 提前进入第一屏。

(55) 从源码空白到 AdSense 高度污染:A Tour of Go 方案 B 的生产收尾

图 1:A Tour of Go 德语版 de-DE 已正式运行在生产环境

(56) A Tour of Go de-DE 上线复盘:第三门语言用了约 16 小时,下一门如何压到 8 小时?

图 1:fr-FR 首次 production 验收完成后,我没有立即开始 ko-KR,而是先连续完成新增语言与首次生产流程的优化

(57) 法语版上线后,我没有马上开始韩语:A Tour of Go 新增语言流程的一轮完善与简化

图 1:根据 ko-KR 期间 76 次 Git 提交估算实际工作时间

(58) 原本预计 6 小时,最后用了约 16~18 小时:A Tour of Go 韩语版上线复盘

图 2:英文 source 与当时发生 validation failure 的 ko-KR candidate 对比

(59) Validator 报错,到底该改译文还是改规则?一次 A Tour of Go 韩语翻译实战

图 2:法语 A Tour of Go 仓库目前已经归档,页面仍保留 553 Commits 和 61 Contributors 的历史

(60) 从法语 553 次提交到韩语两代离线:A Tour of Go 社区翻译为什么难以长期维护

【图 4:es-ES 首次 Production 收口后连续完成的流程优化 commit】

(61) 从 es-ES 首次上线复盘:我把 A Tour of Go 新增语言的 Production 流程又收敛了一轮

图 1:旧公网验收链路连续出现 curl 28 超时,最终导致 public-machine 阶段失败

(62) A Tour of Go Production 公网验收踩坑:从跨境 SOCKS 链路改为 zgocloud direct

图 1:两次 Production Machine Acceptance 都已经通过,但 Headless Chrome 分别在 / 和 /tour/ 判定页面没有完成渲染

(63) 页面明明能打开,为什么 Headless Chrome 仍然判定 Production 失败?

图 3:Bing 从 Google Search Console 中识别到新的 it-IT 站点,并同时发现已有的 1 个 sitemap

(64) GSC → Bing Webmaster Tools:多语言站点如何减少重复验证

图 3:英文站 3 小时内出现 565 个 Cloudflare 来源 URL

(65) IndexNow 实战:手工提交长期不显示,Cloudflare Crawler Hints 却很快出现在 Bing Webmaster Tools

【图 1:A Tour of Go 项目首页目前的语言版本列表】

(66) 从 nl-NL 到 tr-TR:A Tour of Go 连续上线三门语言后,我又优化了哪些流程

【图 4:Go local 页面中已经出现 French、German、Korean、Simplified Chinese】

(67) 从邮件无人回复到进入 Go 官方 Go local:我的 4 个 A Tour of Go 翻译站终于被收录

图8:最终只保留一把启用的新 API Key

(68) 腾讯云 EdgeOne API 自动化:从 CAM 子用户到最小权限 API Key 的完整配置

【图 7:Production Release Batch 最终汇总】

(69) 从同步 Go 官方上游到一个命令发布 10 个语言站:A Tour of Go Production 流程的再次收敛

【图 3:Cloudflare Smart Tiered Cache 已启用】

(70) Cloudflare 缓存 HIT 很快,MISS 却不稳定:回源阿里云杭州的一次真实优化

【图 3:简体中文站 Support 页面】

(71) 广告之外,社区项目如何长期活下去?我给 A Tour of Go 多语言项目加了 Support

图5:评论成功发布

(72) 从 Go Weekly 到 Reddit、DEV 和 Go Forum:第一次系统推广 A Tour of Go 多语言项目

【图 4:RTL 桌面课程布局修复后的效果】

(73) 第一次把 A Tour of Go 做成 RTL:阿拉伯语版本上线,以及我踩过的几个坑

多语言项目应该先做哪些语言?我的 66 个语言版本商业优先级排序

(74) 多语言项目应该先做哪些语言?我的 66 个语言版本商业优先级排序

当术语一致性遇到性能瓶颈:Go 多语言翻译项目的一次架构取舍

(75) 当术语一致性遇到性能瓶颈:Go 多语言翻译项目的一次架构取舍

从 A Tour of Go 走向 Go Learning & Documentation:为什么这个多语言项目需要 v2

(76) 从 A Tour of Go 走向 Go Learning & Documentation:为什么这个多语言项目需要 v2

Markdown 明明可以拆成很多段,为什么 v2 仍然坚持一个 Page 就是一个 TranslationUnit

(77) Markdown 明明可以拆成很多段,为什么 v2 仍然坚持一个 Page 就是一个 TranslationUnit

Tour、Learn、Docs 为什么不应该各维护一份术语表:v2 的统一 Glossary 设计

(78) Tour、Learn、Docs 为什么不应该各维护一份术语表:v2 的统一 Glossary 设计

v2 术语表变更后的页面影响范围判断流程:区分 Compatible 与 Affected,只处理真正受影响的页面。

(79) 术语表改了,为什么不应该让所有页面重新翻译?v2 的影响范围判断

CLI 性能优化示意图:通过 Prepare Once、Reuse Many Times,将执行时间从 6m54.554s 降至 10.335s,约提升 40.1 倍。

(80) 从 6 分 54 秒到 10.3 秒:Go 多语言项目一次 CLI 性能优化实战

历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

(81) 历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

在 Go Learning & Documentation v2 的开发过程中,“历史”后来变成了一个非常重要的话题。

但如果回到最开始,我保留历史的目的其实很简单。

不是为了建立一套越来越复杂的审计系统。

也不是为了让每一个状态都能够无限向前追溯。

最初真正想解决的问题只有一个:

已经翻译和审核好的内容,为什么还要重新做一遍?

A Tour of Go 已经积累了大量正式翻译成果。

其中很多内容已经经历过:

Plaintext
Generation
↓
Machine validation
↓
Independent QC
↓
必要时 revision
↓
re-QC
↓
最终通过

如果进入 v2 以后,只因为项目版本变了、工作流增加了新的能力,就把这些结果全部作废,再重新翻译、重新审核一次,我觉得这不仅浪费时间,甚至可能降低最终结果的稳定性。

所以历史最初真正的价值,其实就是:

让已经高质量完成的工作继续发挥作用。


v2 不应该意味着“从零开始”

软件开发中,一个大版本升级经常会给人一种直觉:

v1 结束了,现在开始 v2。

如果把这种版本概念直接带到翻译系统里,很容易形成这样的做法:

Plaintext
v1 Translation
↓
Archive

v2 Translation
↓
重新生成全部内容

从工程实现来看,这非常干净。

新版本只处理自己的数据。

旧版本全部留在历史目录。

新旧之间没有复杂关系。

但对于翻译来说,这种“干净”未必合理。

假设某个英文 Page:

  • source 没有变化;
  • 正式术语规则没有影响它;
  • candidate 没有问题;
  • 已经通过 Independent QC;
  • 新的 parser 仍然能够验证它;
  • 当前内容和用户最终看到的内容都没有发生语义变化。

那么仅仅因为:

现在进入 v2 了

就要求重新翻译一次,没有什么实际价值。

版本号是工程 milestone。

它不应该自动成为语言成果失效的理由。


翻译成果和普通缓存并不完全一样

表面来看,这件事情很像缓存复用。

旧结果仍然有效,就直接继续使用。

但我觉得正式翻译成果其实比普通 cache 更值得谨慎保护。

普通缓存通常可以删除以后重新计算。

例如:

Plaintext
source
↓
deterministic function
↓
cache

cache 丢了,再运行一次,理论上应该得到完全一样的结果。

AI 翻译不是这样。

同一篇英文 source,再次交给模型生成,可能出现:

  • 不同的句式;
  • 不同的词汇选择;
  • 不同的段落衔接;
  • 不同的语序;
  • 一些新的细微语言变化。

很多变化并不代表质量提高。

它们只是:

另一种同样可能成立的表达。

因此一份已经经过独立审核的 TranslationUnit,并不能简单理解成:

“反正重新生成一次就好了。”

它已经是一份经过验证的语言成果。

如果没有真实原因,重新生成反而会制造新的变量。


重复翻译还会带来重复审核

重新 Generation 的成本也不只是模型调用本身。

只要 candidate 发生变化,就意味着后面的可信链条也需要重新建立。

例如:

Plaintext
new Generation
↓
Machine validation
↓
Candidate Snapshot
↓
Independent QC

如果 Reviewer 发现新问题:

Plaintext
B / C / D
↓
exact revision
↓
re-QC

于是一个原本已经完成的 Page,因为没有必要的重新生成,再次消耗:

  • Generation 时间;
  • Reviewer 时间;
  • validation;
  • revision;
  • evidence;
  • workflow coordination。

更重要的是,这些成本并没有带来新的用户价值。

因为那个 Page 一开始可能就已经是正确的。

所以避免重复翻译,本质上也在避免:

为了验证没有必要发生的变化,再进行一整轮质量流程。


历史首先应该回答:“这个成果还能不能继续用?”

因此我后来越来越倾向于把历史的第一个职责定义得非常简单:

帮助系统判断已经存在的成果能不能继续复用。

这里真正需要关注的是当前事实。

例如:

Plaintext
Source changed?
Glossary affected?
Representation still valid?
Candidate still current?
Previous QC still trustworthy?

如果这些条件仍然成立,那么历史给出的最好答案应该是:

继续使用。

而不是:

“因为工作流升级了,所以重新跑一遍更安心。”

这也是整个 v2 中逐渐形成的一个核心方向:

只处理真正发生变化的部分。


Source 没变,是最基础的一层

最直接的历史复用依据当然是 source。

如果英文 source 已经变化,那么旧译文是否仍然有效就必须重新判断。

但如果 source 完全没有变化,就至少说明:

翻译对象本身没有改变。

当然,这还不能直接证明旧 candidate 一定可以继续使用。

因为其他依赖也可能变化。

例如 glossary。

前面的文章已经写过:

glossary 文件发生变化,并不等于所有 TranslationUnit 自动失效。

需要进一步判断 semantic delta 是否真正影响这个 Page。

因此 source identity 和 glossary compatibility 可以组合起来:

Plaintext
Source unchanged
+
Glossary compatible
↓
旧译文可能继续有效

这里的“可能”很重要。

因为还需要考虑 parser、representation 或其他相关规则。

但至少已经没有理由直接从 Generation 重新开始。


Parser 升级,也不应该自动让语言成果归零

上一篇刚刚写过 Learn / Docs 的 parser。

Parser 会继续演进。

今天可能增加对某一种 teaching comment 的识别。

明天可能修复某种 link binding。

以后还可能完善新的 Markdown representation。

如果每次 parser 实现发生变化,就把历史 TranslationUnit 全部重新生成,那么 parser 的每一次工程改进都会产生巨大的语言工作量。

但真正应该问的是:

旧 candidate 在新的 parser 和 validator 下还能不能成立?

如果答案是:

Plaintext
Parse = PASS
Reconstruction = PASS
Validation = PASS

并且没有发现这个 Page 实际受到 parser change 影响,那么旧译文本身没有理由失效。

这也是“复用历史成果”非常重要的一层含义:

基础设施升级,不应该自动推翻语言成果。


已经通过 QC 的结果尤其值得保护

历史中还有一种特别有价值的信息:

Independent QC。

Generation 自己生成了一份 candidate,只能证明:

有了一份候选翻译。

Machine validation PASS,只能证明:

机器结构没有发现问题。

真正完成 Independent QC 以后,才多了一层:

有独立 Reviewer 对这个 TranslationUnit 做过语言和技术质量判断。

如果最终得到 A,那么这份结果已经积累了相当有价值的质量证据。

所以当未来工作流发生变化时,应该尽量保护这样的成果。

当然,这并不意味着:

“以前是 A,所以永远都是 A。”

如果 source 改了。

Glossary 真正影响了它。

Parser 发现过去漏掉了结构问题。

或者其他 authority 变化使旧结论不再成立。

那当然应该重新进入流程。

但如果这些事情都没有发生,仅仅因为:

Plaintext
milestone changed
workflow gained new features

就把 A 全部重置,我觉得是非常浪费的。


历史复用还有一个容易忽略的价值:减少语言漂移

成本以外,还有一个我后来越来越重视的问题:

语言稳定性。

一个长期运行的文档站点,如果没有必要就不断重新生成翻译,会产生一种很奇怪的现象。

Source 明明没有变化。

用户今天读到:

“运行该命令即可……”

过一段时间重新生成以后,可能变成:

“可以通过执行该命令……”

再下一次又变成:

“执行此命令后……”

三句话都可能没有错。

但对于一个技术文档站点来说,这种变化其实没有意义。

它只是在制造:

translation churn。

更糟糕的是,每次这样的语言变化都可能触发:

  • diff;
  • QC;
  • revision;
  • Surface change;
  • 其他下游判断。

所以可信历史的复用,还能帮助保持:

已经稳定下来的语言尽量稳定。

这对于术语一致性、文体一致性以及长期维护都很有价值。


新内容应该新增,而不是把旧内容一起卷回来

v2 的一个重要变化,是项目从 Tour 扩展到:

  • Site shell;
  • Learn;
  • Docs;
  • future content packages。

如果采用“新 milestone 全量重做”的方式,那么每新增一种内容,都很可能把以前的成果重新卷入。

例如:

Plaintext
加入 Learn
↓
重新处理 Tour + Learn

加入 Docs
↓
重新处理 Tour + Learn + Docs

未来加入 package X
↓
全部重新处理

这种扩展方式很快就会失控。

更合理的模式应该是:

Plaintext
已有稳定内容
→ carry

新增内容
→ Generation / QC

真正受影响的旧内容
→ exact revision / re-QC

也就是说:

新工作量应该尽量接近“新增和真实变化”,而不是接近“整个历史 corpus”。

这对长期扩展非常重要。


Milestone 不应该成为新的治理 namespace

因此 v2 以后,我也越来越明确另外一个设计原则:

v1、v2、v3 是 milestone,不应该自动变成新的语言治理 namespace。

如果每个 milestone 都建立:

Plaintext
v1 glossary
v1 translation history
v1 QC

v2 glossary
v2 translation history
v2 QC

v3 ...

那么同一个 locale 的语言历史就会被人为切成很多段。

之后再想复用时,又需要不断解决:

v1 的 A 能不能迁移到 v2?

v2 glossary 和 v3 glossary 怎么对应?

这个 candidate 到底属于哪一代?

但从语言本身来看:

简体中文仍然是同一个简体中文 locale。

项目升级了。

Parser 进化了。

Content package 增加了。

但已经经过验证的语言成果,并不会因为工程 milestone 改名而天然过期。

所以更合理的方向是:

同一个 locale 延续自己的 glossary、Generation / Reviewer provenance 和可信语言历史。

真正发生变化时再处理变化。


Carry-forward 不是“复制旧文件”

不过,“复用历史”也很容易被理解成另一种危险的做法:

旧文件存在,那就直接拷贝过来。

这并不是我所说的可信复用。

文件存在,只能证明:

磁盘上还有东西。

它不能证明:

这份东西仍然符合当前 authority。

真正的 carry 至少应该建立在明确条件上。

例如:

Plaintext
source unchanged
glossary compatible
representation valid
candidate unchanged
previous QC trustworthy

然后系统才能得出:

Plaintext
trusted unchanged carry

也就是说:

复用不是绕过验证,而是证明“不需要重新做语言工作”。

这两者差别非常大。


Reuse 和 Revalidate 也不是同一个概念

这里还有一个很有用的区分。

一份历史 candidate 可以:

不重新 Generation

但仍然:

经过新的 deterministic machine validation。

例如 parser 升级以后,可以把旧 candidate 放到新 validator 中重新检查。

如果仍然 PASS,那么我们得到了一条新的机器事实。

但没有制造新的语言文本。

这往往比:

Plaintext
parser changed
↓
regenerate translation

合理得多。

因此历史复用并不意味着:

“以前通过过,以后什么都不看。”

而更接近:

能确定性重新验证的东西重新验证;没有必要重新生成的语言不要重新生成。

这也是我觉得机器工作和语言工作的一个重要分界。


真正需要重新处理的,应该是异常集合

长期运行以后,一个比较健康的系统不应该每次面对:

Plaintext
all units

而应该越来越接近:

Plaintext
missing
restore_failed
validation_failed
stale
affected

也就是说,正常情况是:

已经稳定的内容继续保持稳定。

系统主要处理的是异常和变化。

这和很多长期运行的软件系统非常相似。

如果每一次部署都需要重建全部历史状态,规模一大就会变得越来越难维护。

翻译系统也一样。

随着 locale 越来越多、Page 越来越多、content package 越来越多:

全量重新处理应该越来越少,而不是越来越多。


历史的价值,本质上是减少重复劳动

做到这里以后,我觉得可以把这篇文章的核心压缩成一句很简单的话:

历史的价值,不是证明过去发生过多少事情,而是避免把已经做对的事情再做一遍。

它应该帮助系统复用:

  • 已经翻译好的 candidate;
  • 已经通过的 QC;
  • 已经确定的 glossary decision;
  • 已经验证的稳定内容。

然后把有限的时间和模型资源用在:

真正新增、真正改变、真正出现问题的地方。

这才是历史最初加入这个项目时真正想解决的问题。


但后来,历史开始变得越来越重

不过,这次 v2 也让我意识到另外一面。

当一个系统越来越重视 history、identity、predecessor、Snapshot、promotion 和各种 evidence 以后,很容易慢慢发生一个变化:

最开始:

保存历史,是为了更快向前。

后来却可能变成:

为了向前,必须先把越来越多的历史重新还原出来。

想恢复一个 current state,需要找到 predecessor。

找到 predecessor以后,又需要恢复更早的 Snapshot。

为了证明那份 Snapshot,又需要继续追溯更早的 evidence。

最后工程团队开始花大量时间:

不是在翻译新内容,而是在考古。

这就说明历史的角色已经开始偏离最初的目标。

而这次 v2 后期,一个非常重要的架构调整就是:

历史继续保留,但未来工作不再要求无限向前追溯和重建所有过去状态。

这也是下一篇准备整理的主题。

因为如果说这一篇是在回答:

为什么历史值得保留?

那么下一篇要回答的就是另外一个同样重要的问题:

什么时候应该停止还原历史?

而这个问题,恰恰也是这次 v2 实际开发时间远超最初预期的重要原因之一。

从 6 分 54 秒到 10.3 秒:Go 多语言项目一次 CLI 性能优化实战

Go 学习与文档多语言本地化项目

本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。

项目源码:
✅ GitHub:shuijingwan/go-tour-i18n

语言版本:

当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。

英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。

  1. 阿姆哈拉语
  2. 阿拉伯语
  3. 孟加拉语
  4. 葡萄牙语(巴西)
  5. 保加利亚语
  6. 加泰罗尼亚语
  7. 克罗地亚语
  8. 捷克语
  9. 丹麦语
  10. 荷兰语
  11. 英语(美国)(Go 官方英文站点)
  12. 英语(澳大利亚)
  13. 英语(加拿大)
  14. 英语(印度)
  15. 英语(新加坡)
  16. 英语(南非)
  17. 英语(英国)
  18. 爱沙尼亚语
  19. 菲律宾语
  20. 芬兰语
  21. 法语(法国)
  22. 法语(加拿大)
  23. 德语(德国)
  24. 德语(奥地利)
  25. 德语(瑞士)
  26. 希腊语
  27. 古吉拉特语
  28. 希伯来语
  29. 印地语
  30. 匈牙利语
  31. 印度尼西亚语
  32. 意大利语
  33. 日语
  34. 卡纳达语
  35. 哈萨克语
  36. 韩语
  37. 西班牙语(拉丁美洲)
  38. 拉脱维亚语
  39. 立陶宛语
  40. 马来语
  41. 马拉雅拉姆语
  42. 马拉地语
  43. 书面挪威语(Bokmål)
  44. 波斯语
  45. 波兰语
  46. 葡萄牙语(葡萄牙)
  47. 旁遮普语(果鲁穆奇文,印度)
  48. 罗马尼亚语
  49. 俄语
  50. 塞尔维亚语(西里尔文)
  51. 简体中文(中国大陆)
  52. 简体中文(新加坡)
  53. 斯洛伐克语
  54. 斯洛文尼亚语
  55. 西班牙语(西班牙)
  56. 斯瓦希里语(坦桑尼亚)
  57. 瑞典语
  58. 泰米尔语
  59. 泰卢固语
  60. 泰语
  61. 繁体中文(台湾)
  62. 繁体中文(香港)
  63. 土耳其语
  64. 乌克兰语
  65. 乌尔都语
  66. 越南语

项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。

本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。