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

历史应该被保留,而不是被反复重建:v2 为什么最终需要一个“断点”

历史状态通过 Trusted Checkpoint 建立可信断点,旧记录继续保留用于审计和诊断,后续工作流从当前状态继续向前,不再要求无限重建过去。

作者:

在

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) 历史为什么值得保留:复用已经完成的翻译成果,而不是重新做一遍

历史状态通过 Trusted Checkpoint 建立可信断点,旧记录继续保留用于审计和诊断,后续工作流从当前状态继续向前,不再要求无限重建过去。

(82) 历史应该被保留,而不是被反复重建:v2 为什么最终需要一个“断点”

上一篇里,我写了为什么历史值得保留。

它最初的目的其实很实际:

复用已经高质量完成的翻译成果,避免重复 Generation、重复审核和无意义的语言漂移。

如果一个 TranslationUnit 的 source 没有变化,新的 glossary 也没有真正影响它,旧 candidate 仍然能够通过当前的机器校验,而且之前已经完成了 Independent QC,那么最合理的做法通常不是重新翻译一次。

而是继续使用已经做对的结果。

但在这次 Go Learning & Documentation v2 的开发过程中,我也遇到了历史的另外一面。

随着工作流越来越完整,Snapshot、predecessor、promotion、authorization、receipt、identity、provenance 等状态越来越多,历史开始承担一种它最初并没有打算承担的职责:

为了完成今天的工作,系统开始要求把越来越早的历史状态重新还原出来。

这也是这次 v2 实际开发时间明显超过最初预期的重要原因之一。

最后真正需要调整的,不是“要不要保留历史”。

而是另一个问题:

保留历史,是否意味着未来必须永远能够从历史深处一路重建到当前状态?

v2 后来的答案是:

没有必要。


一开始,历史还原看起来非常合理

假设当前有一个 TranslationUnit。

它不是凭空出现的。

它可能来自某一次 Generation。

之后建立 Candidate Snapshot。

Reviewer 完成 QC。

如果得到 B、C 或 D,又进入 revision。

接着 re-QC。

再经过 finalization、promotion,最终成为当前使用的结果。

如果希望系统能够证明:

“为什么现在是这个状态?”

一个很自然的设计就是把这些关系都保存下来。

例如:

Plaintext
Current state
    ↓
Promotion
    ↓
Finalized Snapshot
    ↓
Quality Check
    ↓
Candidate Snapshot
    ↓
Generation

每一步都有明确来源。

每一份结果都可以继续向前找到 predecessor。

从审计角度看,这种链条非常漂亮。

而且在系统规模还不大的时候,它确实带来了很强的确定性。

如果状态出现异常,就可以沿着历史关系向前检查。

所以最初不断增强历史追溯能力,本身并不是错误。

真正的问题,是后来它逐渐从:

“发生问题时可以追溯历史”

变成了:

“正常向前工作也必须先恢复完整历史”。

这两件事情差别很大。


为了恢复 A,又开始恢复 A 的前任

历史恢复最容易出现的一种情况是:

当前工作需要一份旧状态。

但是这份状态是由旧版本 workflow 产生的。

它缺少后来才加入的某个字段。

于是需要恢复。

恢复的时候又发现:

这份状态的 predecessor 也需要能够被当前程序识别。

于是继续向前。

然后 predecessor 又依赖另外一个 Snapshot。

那份 Snapshot 又可能缺少新的 identity 或 provenance。

继续恢复。

很快,一个原本只想解决当前问题的任务,会变成:

Plaintext
恢复当前需要的历史状态
        ↓
发现 predecessor 不完整
        ↓
恢复 predecessor
        ↓
发现更早 Snapshot 不满足当前 schema
        ↓
继续恢复
        ↓
发现旧 promotion 还需要补关系
        ↓
继续向前……

这就是我后来越来越明显的一种感受:

历史恢复很容易没有天然终点。

每次都觉得:

“再补这一层应该就可以继续了。”

但补完以后,下一层依赖又出现了。


这和普通的数据迁移不太一样

数据库升级时,也经常要做 migration。

旧 schema 转成新 schema。

完成以后,系统继续使用新数据。

但这次遇到的问题更复杂一些。

因为工作流历史不是单纯的一张表。

它包含的是一系列互相关联的事实:

  • 哪一次 Generation 产生了这个 candidate;
  • Candidate 属于哪个 Snapshot;
  • Reviewer 审核的是哪一份 exact candidate;
  • revision 针对什么 finding;
  • re-QC 对应哪个 successor;
  • promotion 使用的是哪一份 finalized result;
  • 当前状态和历史状态之间是什么关系。

当新架构增加新的约束以后,如果要求旧历史也全部达到新的完整标准,那么实际上是在要求:

过去所有时期产生的状态,都重新满足今天才定义出来的规则。

这件事情理论上当然可以做。

问题只是:

工程成本可能非常高。


最危险的是“已经花了这么多时间,再多恢复一点吧”

这种问题还有一个很典型的陷阱。

当已经恢复了很多历史以后,很容易产生一种心理:

前面都恢复这么多了,只差最后一点,干脆彻底做完。

但所谓的“最后一点”,往往又会继续展开。

因为旧系统从来没有按照今天的 architecture 生成那些 evidence。

有些缺失不是 bug。

只是:

那个时代根本还没有这种概念。

如果继续要求把它们全部补齐,就开始出现一种奇怪的工程目标:

不是为了当前翻译或发布需要什么。

而是为了让过去看起来像:

当年就已经运行在今天的系统里。

这显然是不现实的。


我后来开始怀疑:为什么必须恢复这么远?

真正的转折,其实来自一个很简单的问题:

今天要继续翻译和发布,为什么一定要把几个月前的整个状态链重新变成当前 schema?

假设我们已经能够可靠确认几个事实:

Plaintext
当前 candidate 是可信的
当前 source identity 已知
当前 glossary relationship 已知
当前 machine validation PASS
当前 QC 结论能够成立

那么为了以后继续处理新的 TranslationUnit,真的还必须证明:

当前状态能够完全按照新系统的所有规则,一路重建到最早的历史起点吗?

慢慢地,我觉得答案是否定的。

历史需要保存。

但:

当前工作不应该永远依赖无限深的历史 reconstruction。

这两件事情应该分开。


历史保留和历史可执行,是两个概念

这是这次架构调整以后,我觉得特别重要的一个区分。

一份旧历史可以继续存在。

它可以用于:

  • 审计;
  • provenance;
  • failure diagnosis;
  • 理解过去发生了什么;
  • 必要时进行人工调查。

但这不等于:

它必须继续成为未来 workflow 的可执行 predecessor。

可以把过去的设计理解成:

Plaintext
History A
   ↓
History B
   ↓
History C
   ↓
Current
   ↓
Future

Future 想继续向前,就必须保证:

Plaintext
A → B → C → Current

整条链全部可以按照今天的规则重新解释。

而新的思路更接近:

Plaintext
Historical records
Historical records
Historical records
        ↓
────────────────
 Trusted checkpoint
────────────────
        ↓
 Current state
        ↓
 Future workflow

断点之前的历史仍然存在。

但未来 workflow 的正式执行起点,从这个可信 checkpoint 开始。


“断点”不是删除历史

这里很容易被误解。

建立断点并不是:

老历史太麻烦,所以全部删掉。

也不是:

以前发生过什么不重要了。

相反,旧 evidence、旧 Snapshot、旧 provenance 仍然应该尽量保留。

真正改变的是:

它们不再全部承担当前工作流的执行责任。

也就是说,断点之前的历史主要回答:

过去发生了什么?

断点之后的 current authority 回答:

从现在开始,系统按照什么状态继续向前?

这是两个不同的问题。


断点需要是可信的

当然,也不能随便找一个时间点说:

从这里开始,前面不管了。

那只是把问题隐藏起来。

一个真正可以承担新起点的 checkpoint,必须能够提供足够的 current facts。

例如至少能够确定:

  • 当前 source 是什么;
  • 当前 candidate 是什么;
  • 当前 glossary 是什么;
  • 当前机器验证结果是否成立;
  • 哪些 TranslationUnit 已经可信完成;
  • 哪些还处于 pending;
  • 当前 Generation / Reviewer provenance 是什么;
  • 后续 workflow 应该从什么状态继续。

换句话说:

断点不是放弃验证,而是把验证目标从“重建全部历史”改成“证明当前状态足够可信”。

这是我觉得最关键的区别。


Current truth 比完整 replay 更重要

以前的架构容易隐含一种想法:

只要整条历史能够 replay,当前状态就一定可信。

这种想法有一定道理。

但长期系统运行以后,还存在另外一种可靠性来源:

直接验证 current truth。

例如:

如果当前 Page candidate 可以重新通过最新 parser。

如果 glossary compatibility 可以重新计算。

如果当前 source identity 可以确认。

如果 Reviewer 的正式结论已经存在,而且所针对的 candidate identity 仍然匹配。

那么这些 current facts 本身就有价值。

没有必要为了证明它们,再要求重新复现数十步之前的所有历史操作。

这就有点像长期运行的 event system。

可以保存所有事件。

但并不代表每次程序启动,都必须从第一条 event 开始 replay 到今天。

当历史越来越长以后,合理的 snapshot / checkpoint 本身就是系统设计的一部分。


历史最初是为了让未来更快,而不是更慢

这也是我后来重新审视整个 history architecture 时最在意的一点。

上一篇已经写过:

历史最初最大的价值,是避免重复翻译和重复审核。

也就是说,历史本来应该帮助我们:

Plaintext
更少 Generation
更少 QC
更少 revision
更快继续新增内容

但如果后来为了复用历史,需要先花大量时间恢复历史:

Plaintext
restore old Snapshot
restore predecessor
restore promotion
repair identity
repair authorization
repair receipt
...

那么历史已经开始产生相反的效果:

为了避免重复工作,又创造出了更多历史恢复工作。

这时真正应该检查的就不是:

“还能不能再把 restoration 自动化一点?”

而是:

是不是整个执行模型已经偏离最初目标了?


项目的根本目标不是建立完美的历史博物馆

做到这里以后,我觉得整个问题其实可以用一句有点直白的话概括:

这个项目不是为了建立一座完美的历史博物馆。

它真正的目标仍然是:

快速、高质量地完成 Go 学习与文档的多语言翻译。

历史对这个目标有帮助,所以保留。

Glossary 对这个目标有帮助,所以治理。

QC 对这个目标有帮助,所以建立 Independent Reviewer。

Parser 对这个目标有帮助,所以不断完善。

但这些都只是手段。

如果某一个手段开始吞噬大量工程时间,却没有相应提高:

  • 翻译质量;
  • 发布安全;
  • 复用效率;
  • 可恢复性;

那么就应该重新评估。

历史也是一样。


原本预计的开发时间,就是这样被拉长的

这次 v2 开始时,我对整体上线时间的预期并没有特别长。

原本预计大约 5 个工作日 可以完成这一轮。

真正开始以后,Learn / Docs 翻译本身当然需要时间。

Glossary、parser、Surface、Production 等也都需要继续完善。

但实际超出预期的一个重要原因,就是:

越来越多时间花在旧状态恢复上。

而且这部分工作非常容易被低估。

因为单看每一次 restoration,好像都只是:

补一个 predecessor。

修一个旧 Snapshot。

让一个历史 promotion 能够重新被识别。

每一件事情单独看都不是特别大。

但它们连续出现以后,就会形成很明显的累计成本。

最终开发时间已经远远超过最开始预计的 5 个工作日。

而这也迫使我真正面对一个问题:

到底要恢复到什么时候?

如果架构没有明确答案,历史恢复就可能继续下去。


新架构真正需要的是一个 Stop Point

后来我越来越喜欢用一个非常简单的词来描述这次调整:

Stop Point。

也就是:

历史追溯必须有停止点。

在 Stop Point 之前:

保留真实历史。

在 Stop Point:

建立足够可信的 current baseline。

在 Stop Point 之后:

使用当前正式架构继续向前。

可以简单理解成:

Plaintext
Past
│
│ preserved
│
▼
====================
    STOP POINT
====================
│
│ current authority
│
▼
Generation
Validation
QC
Revision
Surface
Production

未来如果某个真实 failure 需要调查旧历史,仍然可以向前看。

但这是:

diagnosis path

而不再是:

normal execution path

这个区别对长期维护非常重要。


Normal path 和 Recovery path 应该分开

过去还有一个容易混在一起的问题。

为了保证 recovery 能力,正常路径也承担了越来越多历史要求。

但其实:

“出问题时我们能不能恢复”

和:

“每一次正常操作是否必须执行完整恢复逻辑”

不是同一件事情。

更合理的设计应该是:

正常情况:

Plaintext
current trusted state
↓
continue forward

只有真正出现:

Plaintext
FAILED
unexpected state
mutation unknown

才进入:

Plaintext
historical diagnosis
↓
recovery

这样历史恢复能力仍然存在。

但不会让所有正常 workflow 都支付这笔成本。

这也是我觉得 v2 后期非常重要的一次思路转变。


“mutation unknown” 反而应该停下来

引入 Stop Point 并不意味着以后遇到问题就强行向前。

恰恰相反。

如果当前状态到底发生过什么无法确认,例如:

Plaintext
mutation = unknown

更合理的做法仍然应该是:

停止。

先诊断。

不要盲目 replay。

不要觉得:

“反正有历史,再重跑一下应该没问题。”

因为一旦无法确认某个操作是否已经产生 mutation,再次执行本身可能制造新的状态。

所以新架构并不是从“太严格”走向“随便继续”。

而是更加明确地区分:

哪些情况下可以安全向前。

哪些情况下确实需要回看历史。

哪些情况下必须停止等待诊断。


Recovery 应该处理异常,而不是成为日常工作

这和上一篇提到的另外一条原则也能够对应起来。

一个长期稳定的系统,正常应该主要处理:

Plaintext
new
changed
affected

异常情况下才处理:

Plaintext
missing
restore_failed
validation_failed
unexpected
mutation unknown

如果绝大多数正常工作都不断进入:

Plaintext
restore historical state

那说明 recovery 已经开始反客为主。

理想状态下:

Recovery 是安全网,不是主干道。

历史保存也是一样。

它应该让系统在必要时能够回头。

但正常情况下,方向应该始终是:

向前。


断点还可以降低未来架构演进的成本

这套设计还有一个长期价值。

如果今天的 workflow 未来继续升级,可能又会加入新的:

  • schema;
  • identity;
  • evidence;
  • validation;
  • package 类型。

如果每一次升级都要求:

所有历史记录全部补齐新字段。

那么系统越运行越久,migration 成本会越来越高。

但如果正式建立:

旧历史保持原样 + current checkpoint + 新规则从 checkpoint 向后生效

那么未来架构演进就会容易很多。

新的规则不必假装:

十个月前系统就已经知道今天的设计。

它只需要保证:

从新的正式起点开始,之后的状态全部符合新规则。

这更接近真实的软件演进方式。


不要让未来承担无限的过去成本

做到这里以后,我觉得这篇文章真正想表达的核心已经比较清楚了:

历史需要保存,但未来不应该无限承担还原过去的成本。

历史能够帮助我们:

  • 复用已经完成的翻译;
  • 调查真实 failure;
  • 保留 provenance;
  • 理解过去发生过什么。

但未来 workflow 不应该默认要求:

所有过去状态都必须先升级成当前 architecture,才能继续下一步。

到一定阶段,系统需要允许自己说:

这里以前发生的事情已经被保存。

这里是经过验证的 current baseline。

从这里开始继续向前。


这不是降低质量,而是在保护工程目标

最开始决定停止无限恢复历史时,确实很容易产生一种担心:

会不会变得不够严格?

但后来我觉得:

真正的严格不应该体现在:

系统可以还原多少年前的每一个内部状态。

而应该体现在:

当前发布的内容是否可靠。

如果 current candidate:

  • source 正确;
  • glossary 正确;
  • machine validation 正确;
  • QC 正确;
  • Surface 正确;
  • Production gates 正确;

那么用户真正关心的质量目标已经被满足。

把额外几天花在恢复一条已经不会再影响 current truth 的旧 predecessor,并不会让用户看到的中文因此更准确。

质量保障应该围绕真正的风险设计。

而不是围绕“历史一定要无限完整”设计。


两篇历史文章其实讲的是同一个目标

上一篇写:

历史为什么值得保留。

这一篇写:

为什么历史又不能无限重建。

看起来像是两个相反的方向。

但实际上,它们的根本目标完全一致:

快速、高质量地向前。

历史有助于避免重复工作,所以保留。

历史恢复开始阻塞新工作,所以建立断点。

换句话说:

历史是优化手段,不是治理目标。

我觉得这可能是这次 v2 在历史架构上最终最重要的一条经验。

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

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 官方无隶属、授权或背书关系。