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

一次内容变化,到底应该让哪些状态失效?v2 的依赖与失效传播设计

v2 依赖与失效传播流程图:从内容变化开始,评估依赖关系和真实影响,将结果区分为“仍然有效”和“需要失效”,只让真正受影响的状态重新进入流程。

作者:

在

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 为什么最终需要一个“断点”

v2 依赖与失效传播流程图:从内容变化开始,评估依赖关系和真实影响,将结果区分为“仍然有效”和“需要失效”,只让真正受影响的状态重新进入流程。

(83) 一次内容变化,到底应该让哪些状态失效?v2 的依赖与失效传播设计

前面已经写过一篇:

术语表改了,为什么不应该让所有页面重新翻译?

那篇主要讨论的是一个比较具体的问题:

当统一术语表发生变化以后,怎样判断真正受到影响的页面,只重新处理确实需要修改的翻译单元,而不是让整个语言版本全部重新翻译和审核。

但随着 Go Learning & Documentation v2 越来越完整,我发现这个问题其实并不只存在于术语表。

整个工作流里,到处都有类似的问题:

一个上游状态发生变化以后,到底应该让哪些下游结果失效?

例如:

一个页面被修订了。

它之前的质量审核还算数吗?

内容包原来的封存结果还能继续使用吗?

整合站点审核是否需要重新做?

其他完全没有变化的页面,要不要一起重新审核?

如果只是一个输入文件发生变化,整个语言版本是否都应该重新走一次流程?

另一方面,如果失效判断过于宽松,又会出现更加危险的问题:

下游继续使用一份其实已经不再对应当前内容的旧结果。

所以 v2 后来需要解决的,已经不只是:

Plaintext
发生变化了吗?

而是:

Plaintext
到底发生了什么变化?
↓
哪些状态真正依赖这次变化?
↓
哪些已有结果仍然有效?
↓
哪些状态必须失效?

这篇就准备整理这个问题。


最简单的处理方式:上游一变,后面全部清空

如果只考虑安全性,最容易实现的规则其实非常直接。

假设整个流程大致是:

Plaintext
Source
↓
翻译单元
↓
质量审核
↓
内容包
↓
整合站点
↓
Production

那么只要 Source 发生变化,就可以:

Plaintext
Source 发生变化
↓
所有下游状态全部失效

所有翻译重新生成。

所有质量审核重新做。

内容包重新封存。

整合站点重新审核。

Production 再重新验证。

这种方案很好理解。

而且非常保守。

因为几乎不会留下过期的旧结果。

但问题也非常明显:

工作量会被极度放大。

一个只有几行发生变化的页面,可能让整个语言版本重新进入流程。

术语表中只调整一个、而且只影响两个页面的术语,也可能把上百个已经稳定的翻译结果一起清空。

从安全角度看很简单。

从长期维护角度看,却很难持续。


另一个极端也很危险:只要旧结果还在,就继续使用

既然全部失效的成本太高,另一个极端就是尽可能复用。

例如:

Plaintext
旧质量审核记录存在
→ 直接复用

旧整合站点 PASS 记录存在
→ 直接复用

旧内容包封存记录存在
→ 直接复用

这样当然很快。

但它忽略了一个最核心的问题:

这些旧结果审核的,到底是不是现在这份内容?

如果候选译文已经修改,旧质量审核仍然存在,并不意味着它还能证明新的译文是 A。

如果内容包已经变化,一份旧的整合站点 PASS 记录仍然存在,也不意味着它审核过现在这组页面。

所以:

“旧结果存在”与“旧结果仍然有效”是两回事。

这也是 v2 中需要大量身份标识、SHA、范围和当前性检查的原因。

真正困难的部分,就是在两个极端之间找到平衡:

既不能动不动全部清空,也不能因为旧证据还在就继续相信。


判断哪些状态应该失效,首先要理解依赖关系

做到后来以后,我觉得失效判断本质上是在维护一张依赖关系图。

实际系统当然比下面复杂得多,但可以先简单理解成:

Plaintext
Source
  ↓
翻译单元
  ↓
候选译文
  ↓
质量审核
  ↓
A-only finalization
  ↓
内容包封存
  ↓
整合站点审核
  ↓
激活
  ↓
预览 / Production

与此同时,统一术语表也会影响翻译单元。

Parser 和内容表示方式的变化,也可能影响某些页面。

所以一个东西发生变化以后,真正的问题不是:

“它下面还有多少东西?”

而应该是:

“下面哪些结论真正依赖这次变化?”

这才是需要重新判断的范围。


身份发生变化,不等于语义一定失效

这一点和前面术语表那篇文章中的结论其实是一致的。

SHA 很适合证明:

两份输入是不是完全相同。

但它不能单独回答:

这次变化是否真的让已有结论失效。

例如术语表的 SHA 从 A 变成 B。

这次变化可能只影响两个页面。

也可能影响一百个页面。

甚至可能没有任何已有译文需要修改,因为它们本来就已经符合新的术语规则。

同样,Parser 的实现发生变化,也不代表所有 Markdown 页面都必须重新翻译。

所以 v2 中需要明确区分两层问题:

Plaintext
输入身份是否发生变化?

和:

Plaintext
原来的语言或工作流结论是否真的受到影响?

第一层适合机器精确判断。

第二层才决定哪些结果需要失效。


翻译单元是第一层正式语言边界

对于 Learn / Docs,前面已经写过:

一个实际存在的 Page,就是一个正式翻译单元(TranslationUnit)。

所以当页面内部某个位置出现问题时,机器可以分析到非常细的范围。

例如:

Plaintext
Page
├── 上下文 A → 仍然兼容
├── 上下文 B → 仍然兼容
├── 上下文 C → 受到影响
└── 上下文 D → 仍然兼容

最终正式状态仍然是:

Plaintext
整个 Page
→ 需要重新处理

但这并不意味着:

整个内容包都受到影响。

更不意味着:

整个语言版本都受到影响。

这就是范围分层的第一步。

机器内部可以把原因分析得很细。

正式工作流则把影响提升到正确的治理单位。


一个 Page 被修订,不应该让其他 A 一起失效

假设一个内容包有 49 个 Page。

其中 48 个已经通过独立质量审核,都是 A。

另一个 Page 得到 B。

后来针对审核发现的问题做了精确修订。

这时候最简单的方式,是重新建立整批候选状态,然后让 49 个 Page 全部重新审核。

但这样会浪费前面 48 个已经可信完成的结果。

更合理的方式是:

Plaintext
48 个没有发生变化的 A
→ 继续继承

1 个已经修订的 Page
→ 机器校验
→ 独立复审
→ A

最后再建立新的 A-only finalization。

这里实际上已经发生了一次精确失效:

只有真正发生修订的翻译单元,其旧语言判断需要失效。

其他没有变化的 A,应该继续成立。

这和前面写过的“历史成果复用”,其实是同一个原则的另一面。


继承旧审核结果的前提,不是“这个文件没人动过”

当然,也不能简单认为:

这 48 个文件我没有手动修改,所以继续用 A。

真正应该证明的是:

Plaintext
候选译文没有变化
+
相关输入没有变化,或者仍然兼容
+
之前的 A 仍然对应当前这份确切译文

只有这样,旧审核结果才可以继续继承。

所以“继续复用”和“判断失效”实际上是一对关系:

能证明仍然有效 → 继续继承
无法证明仍然有效 → 重新判断或视为失效

这也是为什么系统需要坚持:

无法确认时,按失败处理。

不能为了减少工作量而猜测旧结果仍然有效。


内容包封存是另一层依赖边界

当所有翻译单元都达到正式要求以后,会进入内容包封存。

假设一个内容包已经完成封存。

后来其中一个 Page 因为整合站点审核发现问题,被重新打开并修改。

那么:

原来的内容包封存还能代表现在这个内容包吗?

显然不能。

因为它封存的是修改之前的确切状态。

所以:

Plaintext
翻译单元发生变化
↓
旧内容包封存不再是当前有效状态

等修订完成、机器校验、独立复审和 A-only finalization 全部完成以后,再建立新的后继内容包封存。

这里还有一个重要区别:

旧封存记录并没有被删除。

它仍然是历史的一部分。

只是:

它不再代表当前内容包。

这和前面“历史应该被保留,但不能绑住当前工作流”的思路是完全一致的。


整合站点审核判断的是“组合以后”的结果

单个翻译单元全部得到 A,并不代表整个网站组合起来以后一定正确。

所以 v2 中还有整合站点审核(Surface Review)。

它关注的是更高一层的问题,例如:

  • 多个内容包组合以后是否一致;
  • 导航是否合理;
  • 本地内容覆盖是否正确;
  • 页面之间的链接是否正确;
  • Site shell 与正文是否协调;
  • 用户最终看到的完整站点是否成立。

因此,它依赖的是:

一组当前有效的内容包封存所形成的确切站点范围。

如果这个范围真正发生变化,旧的整合站点审核结论就可能不再成立。

但这里仍然不能简单地认为:

Plaintext
任何地方发生任何变化
↓
所有整合站点审核全部重做

真正需要判断的是:

这次变化是否属于那次审核所覆盖的范围。


整合站点发现语言问题,不能直接跳过翻译单元审核

这也是 v2 中后来非常明确的一条边界。

假设整合站点 Reviewer 发现:

某个 Page 的翻译本身存在问题。

这时候不能直接:

Plaintext
整合站点审核发现问题
↓
直接修改 Page
↓
整合站点 PASS

因为整合站点审核并不能替代翻译单元的独立质量审核。

真正应该回到对应的语言治理层:

Plaintext
整合站点发现语言问题
↓
重新打开受影响的翻译单元
↓
精确修订
↓
机器校验
↓
独立复审
↓
A-only finalization
↓
建立新的内容包封存
↓
重新进行后继整合站点审核

这样依赖关系才是完整的。

问题虽然是在整合站点阶段发现的。

但真正拥有语言判断权的,仍然是翻译单元这一层。

所以:

问题属于哪一层,就回到拥有正式权威的那一层修复。


这样可以避免“高层审核偷偷修改低层事实”

如果不这样分层,会出现一种很危险的情况。

整合站点 Reviewer 发现一个 Page 翻译有问题。

有人直接把 Page 改了。

然后整合站点审核 PASS。

这时候表面上看,页面已经修好。

但内部可能出现:

  • 翻译单元的正式质量审核仍然对应旧译文;
  • 内容包封存仍然对应旧状态;
  • 整合站点记录却已经针对新状态。

整个证据链开始分裂。

也就是说:

用户看到的是新文本,但语言质量记录证明的却还是旧文本。

这种问题非常难从表面发现。

所以失效传播并不只是:

“让哪些东西变成过期状态。”

它还负责保证:

内容发生修改以后,所有依赖旧状态的正式结论,都重新绑定到新的后继状态。


并不是所有整合站点失败都属于语言失败

另一方面,也不能把整合站点阶段的所有失败都理解成翻译质量失败。

例如:

压缩包传输错误。

输入文件不完整。

当前性检查失败。

Schema 不匹配。

这些问题本质上属于:

输入门禁失败。

Reviewer 根本还没有得到一份可以正式审核的当前站点。

那么这时就不应该记录成:

Plaintext
语言审核 FAILED

因为真正的语言判断根本还没有开始。

更合理的处理方式是:

Plaintext
输入门禁失败
↓
没有产生状态变更
↓
修复传输或输入
↓
使用新的 review-id
↓
重新进入审核

这里非常重要的一点是:

系统故障和语言质量失败必须分开。

否则历史里就会留下很多实际上并不存在的“语言审核失败”。


激活阶段也有自己的当前性要求

再往后进入激活阶段,依赖关系又发生变化。

激活并不是简单地:

整合站点 PASS 以后,把一个开关打开。

它还需要绑定:

  • 当前内容包封存;
  • 当前整合站点结果;
  • 当前正式权威状态;
  • exact prior SHA。

激活预检的意义之一,就是重新确认:

现在准备激活的,仍然是不是刚才已经审核过的那组确切状态。

如果预检得到的 prior_sha256 后来已经不再匹配,说明这期间发生了新的状态变化。

这时正确做法不是:

“之前都通过了,那就继续执行吧。”

而应该:

Plaintext
prior SHA 不匹配
↓
STOP
↓
读取当前正式状态
↓
重新执行预检

因为旧的预检结论已经不再对应当前状态。

这同样属于一种失效判断。


CAS 保护的是“决定时看到的世界”没有偷偷变化

激活阶段使用的 prior SHA,本质上类似 compare-and-swap(CAS)。

可以把它理解成:

Plaintext
我做预检时看到的是状态 A

只有真正执行变更时
当前仍然还是 A

才允许继续把它变成 B

如果真正执行时已经变成:

Plaintext
A'

那么之前的变更授权就不能继续使用。

它解决的是一个很实际的问题:

我做决定时看到的状态,和真正执行变更时的状态,还是不是同一个?

如果已经不是,就应该重新判断。

而不是假设中间没有人或没有流程改变过它。


预览和 Production 证明的又是另外一种事实

激活成功以后,也不代表 Production 一定正确。

最终网站还涉及:

  • 页面渲染;
  • 导航;
  • URL;
  • canonical;
  • 本地内容覆盖;
  • 404;
  • sitemap;
  • 浏览器实际行为。

所以预览验证和 Production 仍然是独立阶段。

语言链条可能完全正确。

整合站点也可能已经 PASS。

但最终页面渲染仍然可能出错。

因此:

Plaintext
翻译单元审核 PASS
≠
整合站点审核 PASS

整合站点审核 PASS
≠
已经可以安全进入 Production

每一层证明的事情都不同。

所以每一层的失效条件也不能混在一起。


上游发生变化,不代表失效必须一直传播到底

这里最容易出现一个误解:

既然系统存在依赖关系,那么上游变化是不是必然让所有下游结果一路失效?

并不是。

依赖关系首先说明的是:

需要重新判断。

至于是否真的失效,还要看变化的实际影响。

例如术语表发生变化。

系统首先重新计算兼容性。

但某个 Page 可能发现:

Plaintext
仍然符合新的术语规则

那么它的候选译文和质量审核都不需要失效。

既然这个 Page 的正式结果没有变化,内容包的实际内容也可能没有变化。

如果内容包身份也没有变化,整合站点就没有理由仅仅因为术语表文件曾经改过,就重新审核一遍。

理想的传播方式应该是:

Plaintext
发生变化
↓
评估真实影响
↓
如果正式结论没有变化
↓
停止继续传播

而不是:

Plaintext
发生变化
↓
所有下游状态全部失效

这其实很像增量构建系统

做到后来以后,我觉得整个 v2 越来越像一个增量构建系统。

编译器通常不会因为仓库中任意一个文件变化,就重新编译所有内容。

成熟的构建系统会判断:

哪些目标真正依赖这个输入。

然后只重新构建受影响的部分。

翻译系统也很类似。

它同样存在:

Plaintext
Glossary
Source
Parser 规则
候选译文
质量审核
内容包
整合站点
激活

每一层都有自己的依赖关系。

每一层都有自己的身份。

每一层也都可能因为上游变化而失效。

区别只是:

自然语言比普通编译产物更难判断“结果是否仍然等价”。

所以系统需要更多证据,才能安全证明旧结果仍然可以继续使用。


目标不是“让失效越少越好”

这里也要防止走向另一个极端。

如果过度追求:

越少状态失效越好

就会开始想办法把所有旧结果都判定为“仍然有效”。

这是非常危险的。

真正的目标不是:

尽可能减少失效。

而是:

尽可能准确地判断失效。

确实受到影响,就应该失效。

无法可靠证明没有受到影响,也应该按失败处理。

只有真正能够证明旧结果仍然成立时,才应该继续继承。

所以:

Plaintext
减少重复工作

永远排在:

Plaintext
保证正确性

之后。


“不知道有没有影响”本身也是一个需要停止的状态

这一点在工程上尤其重要。

有时候系统无法确认:

某次状态变更到底有没有真正发生。

或者:

某份证据是否仍然对应当前状态。

这时候最危险的做法就是猜:

Plaintext
大概没变

然后继续。

更安全的规则应该是:

Plaintext
状态无法确认
↓
STOP
↓
先进行诊断

特别是机器明确给出:

Plaintext
mutation=unknown

这种情况更不能盲目重新执行。

因为你甚至不知道上一轮是否已经产生了一部分状态变更。

再次执行,有可能制造第二次变化。

所以:

无法确认时停止,比猜测继续更加可靠。


判断旧结果是否失效,也是故障恢复能力的一部分

以前我更多把失效判断理解成:

防止系统使用旧结果。

后来越来越觉得,它其实也是故障恢复架构的一部分。

因为工作流中断以后,系统真正需要回答的是:

Plaintext
哪些结果已经可信完成?
哪些只是缺少后续记录?
哪些结果真的已经失效?
哪些内容真正受到这次变化影响?

如果无法准确回答这些问题,最简单的恢复方式就只剩下:

全部重做。

而失效与继承判断越准确,恢复过程就越可以做到:

Plaintext
保留已经可信完成的结果
↓
只继续处理缺失、失效和真正受影响的部分

所以精确失效和快速恢复其实是互相依赖的。


好的失效判断,会让整个系统越来越增量化

长期来看,我希望整个工作流越来越接近:

Plaintext
新增工作
+
真实变化
+
真实故障

而不是:

Plaintext
每次都重新处理全部历史工作

例如:

新增一个 content package:

主要处理新增内容。

Glossary 调整:

主要处理真正受到影响的 Page。

整合站点发现一个语言问题:

主要重新打开对应的翻译单元。

某个内容包封存发生变化:

重新判断依赖它的整合站点结果。

激活阶段检测到并发状态变化:

重新预检,而不是继续使用旧 prior SHA。

这就是我理解的增量工作流。


历史复用、精确失效和快速恢复其实是同一件事

前面几篇分别写过:

  • 为什么历史值得保留;
  • 为什么历史不能无限重建;
  • 为什么术语表变化不能全量重做。

做到这一篇以后,我觉得这些问题其实已经逐渐汇合成了同一个目标:

让系统知道什么已经完成、什么仍然有效、什么真的发生了变化。

如果能够可靠回答:

Plaintext
是否已经完成?
是否仍然有效?
是否真正受到影响?

那么:

历史可以复用。

故障可以增量恢复。

Revision 可以保持精确。

整合站点可以只审核真正当前有效的范围。

Production 也可以避免依赖已经失效的旧状态。

所以依赖与失效传播并不是一个孤立的小功能。

它实际上是整个长期工作流能够稳定扩展的基础之一。


最终形成的几条原则

现在回头看,v2 中关于依赖和失效传播的设计,可以浓缩成几条规则。

第一:

身份发生变化,不自动等于语义结论失效。

第二:

只让真正依赖这次变化的正式状态重新进入流程。

第三:

能够证明仍然有效的可信结果继续继承。

第四:

发生修改以后,原来依赖旧状态的正式结论,必须重新绑定新的后继状态。

第五:

哪一层出现问题,就回到拥有正式权威的那一层修复。

第六:

无法证明没有受到影响时,按失败处理,不猜。

第七:

故障恢复优先处理缺失、失效和真正受影响的部分,而不是默认全部重做。

最终目标不是:

让失效越少越好。

也不是:

让流程越复杂越安全。

而是:

让每一次变化,只产生它真正应该产生的工程成本。

历史应该被保留,而不是被反复重建: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 官方无隶属、授权或背书关系。