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

保护机制也会保护错东西:为什么一个 Documentation 能阻塞整页修订?

protected representation 修订能力示意图:左侧 http.Client 被正确保护为 token;中间普通自然语言 Documentation 被错误保护为 opaque token,导致合法 revision 被阻塞;右侧保留旧 representation,通过 representation successor 建立新的可编辑表示,再继续 Generation 和独立 re-QC。

作者:

在

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 性能优化实战

Markdown Page 经过 Parse / Protect、Generation 和 Reconstruct / Validate 的流程示意图,强调保护 inline code、链接、代码等机器语义,同时允许译文按照自然语言调整语序。

(81) Markdown 不是纯文本:Learn / Docs 为什么需要新的 parser 与结构保护

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

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

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

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

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

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

v2 本地内容覆盖判断流程图:官方英文页面先检查是否已有正式本地覆盖,有覆盖时使用本地 URL,没有覆盖时直接链接 go.dev,并保持本地路径真实 404。

(85) 有英文页面,不代表一定应该有本地页面:v2 如何处理本地内容覆盖、canonical 与真实 404

v2 代码注释完整性审计流程图:从源页面建立代码块清单,分类教学注释、机器语义和无法判断的内容,再与当前译文精确对应,确认 missing、extra 和 protected mutation 均为 0。

(86) 代码块里的注释为什么不能只靠肉眼检查?v2 如何统计并验证代码注释翻译完整性

结构化语义输入扩展示意图:同一份 books.yaml 原始文件保持不变,旧 parser 识别 10 个可本地化单元,当前 parser 识别 12 个,并新增 PDF 和 GitHub,确认旧单元无删除无修改后重新进入 Generation。

(87) 原始文件一个字没变,为什么还要重新翻译?从 books.yaml 10→12 看语义输入扩展

v2 Activation 流程图:Surface PASS 后先执行只读 activation-preflight 获取 prior_sha256,activation-apply 时通过 CAS 再次比较当前状态,只有 current 等于 prior 才提交 result_sha256,否则停止并重新 preflight。

(88) 审核都通过了,为什么上线前还要再检查一次?v2 的 Activation、prior SHA 与 CAS 设计

v2 分层验证流程图:TranslationUnit、Package Closure 和 Integrated Surface 均通过后进入 Activation,再由 Preview 检查 LoadContent、Compose、Resolver 和 Renderer 的真实运行链;如果实际使用错误 renderer,即使前置内容全部通过,Preview 仍然失败。

(89) Surface 已经 PASS,为什么 Preview 还是会失败?从一次 wrong renderer 看分层验证的价值

更快不一定更好:为什么我主动撤销了一次已经明显变快的性能优化

(90) 更快不一定更好:为什么我主动撤销了一次已经明显变快的性能优化

TranslationUnit 同类问题完整性示意图:左侧 Reviewer 只列出 3 个 examples,Generation 只修这 3 处后仍留下 5 个同类问题,re-QC 再次判 B;右侧 Reviewer 明确 defect category 和 bounded scope,Generation 执行 same-class complete sweep,最终同类残留为 0 并进入 re-QC A。

(91) 为什么修完 Reviewer 指出的所有例子,下一轮还是会失败?从 B→revision→B 看同类问题完整性

immutable source 与 replacement successor 示意图:左侧直接把旧 canonical source A 覆盖成 source B,会使旧 Generation、Review 和 Closure evidence 失去准确对应;右侧保留 source A 作为 immutable predecessor,为新正文建立 source B successor,并重新进入 corpus、glossary review、Generation、QC、closure、Surface 和 Activation 生命周期。

(92) 页面明明是我自己的,为什么不能直接重写?从 /translation/ 改版看 immutable source 与 replacement successor

protected representation 修订能力示意图:左侧 http.Client 被正确保护为 token;中间普通自然语言 Documentation 被错误保护为 opaque token,导致合法 revision 被阻塞;右侧保留旧 representation,通过 representation successor 建立新的可编辑表示,再继续 Generation 和独立 re-QC。

(93) 保护机制也会保护错东西:为什么一个 Documentation 能阻塞整页修订?

在 Go Learning & Documentation v2 的翻译流程里,我一直非常重视一件事:

模型不能随便修改代码、URL、identifier、链接绑定和其他机器语义内容。

所以正式 TranslationUnit 在交给 Generation 之前,并不是把原始 Markdown 或 HTML 直接交给模型。

中间还有一层:

protected representation。

它会把不应该被语言模型修改的内容替换成受保护 token,只留下真正允许翻译或修订的自然语言部分。

这套机制解决了一个非常重要的问题。

例如原文里存在:

Plaintext
http.Client

或者:

Plaintext
https://go.dev/doc/

又或者 Markdown link、HTML attribute、Go identifier。

模型不应该因为觉得中文读起来更自然,就把这些内容一起改掉。

因此最安全的做法就是:

根本不给模型编辑它们的能力。

但后来我遇到了一种刚好相反的问题。

有一次独立 Reviewer 已经明确指出某个 Page 存在需要修订的语言问题。

Generation Bundle 也正常建立。

可真正准备执行 exact revision 时,却发现:

要改的那段普通自然语言,被当前 representation 当成 opaque protected content 保护起来了。

其中一个很直观的例子,就是类似:

Plaintext
Documentation

这样的普通可见 label。

Reviewer 可以看见它。

人也很容易判断:

这是页面上的自然语言。

但 Generation 拿到的 protected baseline 里,它已经变成了不可编辑 token。

这时候问题就变得很有意思:

译文知道应该怎么改。

Reviewer 也已经正式授权修改。

但机器表示根本不允许 Generation 碰它。

最后甚至可能出现:

Plaintext
正式 revision batch
→ Generation 无法合法表达 finding
→ 0 output
→ FAILED

这不是模型不会翻译。

也不是 Reviewer finding 错了。

而是:

当前 representation contract 没有能力表达这次本来合法的语言修改。

这篇就专门整理这个问题。


为什么翻译流程里需要 protected representation

先从最基本的问题开始。

为什么不直接把整个 Page 原文交给模型?

因为一个文档页面通常不只有自然语言。

里面还可能包含:

  • Go identifier;
  • API 名;
  • URL;
  • Markdown link destination;
  • HTML tag;
  • attribute;
  • code block;
  • directive;
  • placeholder;
  • template syntax;
  • technical literal。

这些内容中,有些绝对不能翻译。

例如:

Plaintext
json.Marshal

不能被改成中文。

URL:

Plaintext
https://go.dev/doc/

也不能被模型随便重新拼写。

Markdown 链接:

Plaintext
[Documentation](/doc/)

通常需要区分:

Documentation 是可见语言。

而:

/doc/ 是机器绑定。

所以正式 protector 做的事情,本质上是:

把“语言”和“机器语义”拆开。


一个理想的 protected input 应该是什么样

例如原文:

Plaintext
Read the Documentation for more details.

其中如果 Documentation 只是普通可见文本,理想情况下 Generation 应该可以看到并修改它。

而如果页面里有:

Plaintext
http.Client

protector 可能将其变成类似:

Plaintext
Read the Documentation for more details about ⟦P17⟧.

模型可以编辑:

普通英文 prose。

但是不能编辑:

Plaintext
⟦P17⟧

restore 时:

Plaintext
⟦P17⟧

重新恢复成:

Plaintext
http.Client

这样既能允许自然语言翻译,又能保证技术 identity 不被破坏。


问题出现在“自然语言被错分成技术内容”

真正麻烦的情况是:

protector classification 错了。

例如页面某个 heading navigation label,本来是用户真实可见的普通文字。

但是 source tokenizer 在判断时,因为附近存在一个可能被识别成 symbol lead 的词,后续普通 label 被错误归入 opaque atom。

于是原本应该是:

Plaintext
可编辑自然语言:Documentation

最终却变成:

Plaintext
不可编辑 protected atom:⟦P42⟧

这时候 TranslationUnit 从机器角度看仍然完全合法。

token 也没有损坏。

restore 也可能完全成功。

但它隐藏了一个能力问题:

模型已经失去了修改这段自然语言的能力。


“保护得更多”并不一定更安全

最开始很容易产生一个直觉:

宁可多保护一点,也不要让模型误改技术内容。

对很多系统来说,这确实是一个合理的保守策略。

但正式翻译流程里还有另一面。

如果把普通自然语言错误保护起来,就会导致:

合法语言修订无法发生。

所以 protector 的正确目标不是:

尽可能多地保护内容。

而应该是:

精确保护真正不允许语言模型修改的内容。

少保护会有风险。

多保护同样会有风险。


Reviewer 为什么仍然能够发现问题

这里会出现一个有趣的分层差异。

Generation 接收到的是:

protected input。

而 Reviewer 审核的是:

restored candidate。

也就是最终读者实际会看到的完整目标语言内容。

所以 Reviewer 完全可能看到:

某个 label 翻译得不自然。

然后正常给出 B finding。

例如 Reviewer 的判断可能类似:

当前 visible navigation label 应采用更自然的中文表达。

这个 finding 本身没有任何问题。

因为从最终页面语义来看,它确实应该修。

真正的问题直到 revision export 或 Generation 阶段才暴露:

Reviewer 授权修改的那段文字,在 Generation representation 中根本不可编辑。


这不是普通的翻译 revision failure

如果只是 Generation 把一句话改错了,处理方式很简单:

Plaintext
Reviewer 判 B
→ exact revision
→ validation
→ successor re-QC

但 representation capability failure 不一样。

因为 Generation 就算完全理解 Reviewer 的意思,也没有办法合法输出正确结果。

假设 protected baseline 是:

Plaintext
更多信息请参阅 ⟦P42⟧。

而 ⟦P42⟧ 实际对应:

Plaintext
Documentation

如果 Reviewer 要求调整这个 label,Generation 有三个选择。

第一个选择:

修改 ⟦P42⟧ token。

不允许。

第二个选择:

删除 token,然后手写中文。

仍然不允许。

第三个选择:

保持 token 不动。

那么 Reviewer finding 无法关闭。

所以:

不存在一个合法 ordinary revision output。


这也是为什么“让模型直接改 token”绝对不是解决办法

最危险的修法可能是:

既然模型知道 ⟦P42⟧ 是 Documentation,那就允许它改吧。

这样等于彻底破坏 protected representation 的意义。

因为下一次同样的能力可能被用于修改:

  • Go identifier;
  • URL;
  • code literal;
  • link destination;
  • template syntax。

token 本来就是机器边界。

Generation 不应该拥有:

自行判断哪个 token 可以破解。

这种权力。

否则 protector 就从:

machine-enforced safety boundary

退化成:

模型最好自觉一点。

这显然不够可靠。


也不能直接把 candidate 重新 Protect 一遍

另一个看起来很方便的办法是:

既然旧 protected baseline 不好用,那拿 Reviewer 审核过的 candidate,再用今天的 protector 重新保护一次不就好了?

这个方法也有很大问题。

因为 candidate 是:

target language。

而正式 token mapping 应该由:

canonical source-owned representation

决定。

如果从译文反向 Protect,很可能需要机器猜:

target 里的某个词到底对应 source 哪一个 atom?

当一个 technical literal 在 target 中出现多次时,这种 ambiguity 会更加明显。

所以正式规则一直强调:

不能从 target 猜 token mapping。

representation mapping 必须由 source authority 和历史正式表示确定。


“今天的 protector 更正确”也不能改写昨天的历史

假设后来修好了 tokenizer。

现在它能够正确判断:

Plaintext
Documentation

属于:

普通可见自然语言。

新的 protected input 也变得合理了。

但这并不意味着可以回头修改旧 batch。

因为旧 batch 的:

  • manifest;
  • input SHA;
  • Unit ID;
  • raw response;
  • candidate;
  • validation;
  • QC evidence;

已经形成历史。

如果把旧 input 原地换成新 representation,就会出现:

同一个 batch identity 在不同时间对应不同正式输入。

这会直接破坏 provenance。

所以旧失败必须保持原样。


0 output failure 也应该成为历史,而不是被“修掉”

这一点我觉得特别重要。

当时存在过一种正式失败状态:

Plaintext
Generation batch 已建立
→ representation 无法表达 finding
→ 0 output
→ no import
→ no process

最容易产生的冲动是:

既然现在已经知道工程原因,那就重新导出这个 batch,把旧失败抹掉。

但这不应该做。

正确方式应该是:

Plaintext
旧失败 batch
→ immutable preserved

新的 representation authority
→ successor

新的 revision batch
→ 继续处理同一个 finding

因为旧失败本身也是有价值的 evidence。

它真实记录了:

当时的正式 representation 没有能力完成这个任务。


修复 protector 和修复 TranslationUnit 不是同一件事

这个案例还有一个很容易混淆的地方。

工程上修好 tokenizer,例如:

heading navigation label 不再被错误识别为 opaque atom。

只能证明:

今后的 current representation 可以正确生成。

但已经存在的 TranslationUnit identity 可能依赖旧 protected input。

如果新的 protector 输出发生变化,那么:

Plaintext
old protected input
≠
current protected input

Unit identity 也可能随之变化。

所以不能简单说:

parser 修了,现在重新跑就行。

还需要解决:

old Unit 与 current Unit 之间是什么关系?

这就是 representation successor authority 存在的原因。


physical source 没变,formal Unit 仍然可能变

这一点和 books.yaml 那篇其实又有一点呼应。

普通直觉会认为:

Page source 一个字都没改,所以还是同一个 TranslationUnit。

但正式 Unit identity 不一定只取决于:

physical source bytes。

它还可能取决于:

protected representation。

所以可能出现:

Plaintext
physical Page source:完全没变
current parser:修正了 classification
protected input:发生变化
formal Unit ID:发生变化

这不是 source content replacement。

而是:

representation replacement。


source replacement 和 representation replacement 必须分开

这两个词看起来很像,但问题完全不同。

Source replacement

canonical source 本身改变。

例如:

/translation/ 正文被重新组织。

这时候需要处理:

新 source authority。

Representation replacement

canonical source bytes 没有变化。

但 parser / protector 对同一 source 的正式表示发生变化。

例如:

原来把普通 visible label 当成 opaque atom,现在正确分类成自然语言。

这时候需要处理的是:

old representation → current representation。

不能把两种情况混成:

“文件变了”。

因为第一种真的改了 source。

第二种没有。


representation successor 的任务不是生成新译文

这一点同样非常关键。

建立 representation successor authority 的时候,系统做的不是:

帮 Generation 翻译。

而是证明:

旧 formal Unit 和当前 formal Unit 是同一个 physical Page 在两种正式 representation 下的合法 predecessor / successor。

它需要验证很多机器事实,例如:

  • 同一个 package;
  • 同一个 physical path;
  • 同一份 source bytes;
  • 同一个 route;
  • 同一个 registry index;
  • 同一 dependency identity;
  • old representation 真实存在;
  • current representation 可以由当前 parser 重建。

只有这些关系都成立,才能继续说:

这是 representation successor。


为什么不能只按 path 找“最新 candidate”

一个更危险的捷径是:

path 都是 /doc/,那就直接拿这个路径最新 candidate 用吧。

这会失去正式 lineage。

因为一个 physical path 可能经历:

  • old Unit ID;
  • representation successor;
  • source successor;
  • revision;
  • 多个 Snapshot。

“latest”只能说明:

时间上比较新。

不能证明:

它是当前 finding 合法 predecessor。

所以正式流程必须绑定:

old Unit → current Unit 的明确 replacement relation。

而不能:

path-based latest candidate。


successor baseline 也不能从目标译文猜出来

representation reconciliation 的另一个关键任务,是为 Generation 建立:

current protected baseline。

理想情况是:

Plaintext
old passed raw response
+
source-owned deterministic mapping
→
current protected baseline

然后这个新 baseline 必须 restore 为:

逐字节相同的 reviewed predecessor candidate。

如果 restore 后有任何差异,就说明:

bridge 不能证明自己是纯 representation transition。

这时候必须失败。

因为 successor 的目标是:

改变“怎么表示”。

不是:

偷偷改变“已经审核过的译文”。


为什么 baseline 必须恢复成完全相同的旧 candidate

假设旧 candidate 已经被 Reviewer 审过。

现在只是 representation 发生变化。

在 Generation 真正执行新的 revision 之前,新 baseline 应该仍然代表:

同一份旧译文。

所以必须满足:

Plaintext
restore(new protected baseline)
==
old reviewed candidate bytes

只有这样才能说明:

新 baseline 只是把同一个 target 换成了新的可编辑表示。

如果 bytes 不同,那已经引入语言变化。

这种变化不能由工程 bridge 自动产生。


representation successor 也不会继承旧 A 或 B 为新结论

即使 old candidate 在历史上是 A,也不能因为 bridge 成功就说:

current successor Unit 自动 A。

同样,如果当前处理的是旧 QC B finding,successor 也不能自动把 B 带过来作为新语言结论。

representation authority 只证明:

predecessor 和 successor 的机器 lineage。

它不做:

新语言质量判断。

因此新的 candidate 在完成 revision 后仍然需要:

Plaintext
validation
→ new Snapshot
→ independent re-QC

最终是否 A,仍然由独立 Reviewer 决定。


这次真正合法的链条是什么

对于这种“正式 B finding 存在,但旧 representation 无法表达 revision”的情况,正确链条更接近:

Plaintext
旧 QC B
→ ordinary revision capability failure
→ 保留旧失败 evidence
→ representation successor authority
→ current successor Unit
→ 使用同一个原 B finding 创建新的 exact revision
→ Generation
→ validation
→ successor Snapshot
→ independent re-QC
→ A-only finalization

这里有两个重点。

第一:

原 finding 没有被改写。

第二:

中间增加的是 representation bridge,不是新的语言判断。


为什么必须继续使用原来的 finding

假设 Reviewer 原来已经正式判定:

某个 visible label 翻译需要修改。

后来工程发现:

protector 把它错误保护了。

不能因此新造一个语言 finding:

“因为 protector 有 bug,所以请翻译 Documentation。”

因为 protector bug 是:

engineering necessity。

不是:

新的 Reviewer language judgment。

所以 representation successor 建立以后,新的 revision 仍然应该消费:

原来那一个 B finding。

这样因果链才能保持完整。


engineering proof 也不能冒充 Reviewer finding

反过来也一样。

工程可以证明:

protected-natural-language-unrepresentable。

意思是:

当前正式 representation 无法表达已经授权的自然语言修订。

这个 proof 能授权:

建立 representation successor。

但不能授权:

语言应该改成什么。

它更不能替 Reviewer决定:

这是 B、C 还是 D。

所以必须严格区分:

engineering proof

和:

language finding。

一个证明:

工具能力不够。

另一个证明:

语言质量存在问题。


为什么这里仍然坚持 fail-closed

其实也可以设计一个更“智能”的系统。

例如机器发现:

token 里其实只是 Documentation。

然后自动判断:

这看起来不像 code,临时开放一下编辑能力。

这样用户体验可能会顺畅很多。

但问题是:

机器凭什么确定它不是某个必须保持 exact 的 identity?

又凭什么确定:

当前这一处可以开放,而同类 token 不能?

只要这个判断没有正式 source-owned proof,最安全的结果仍然是:

停止。

也就是:

representation 无法合法表达 revision,就 fail closed。

这虽然会增加一次工程处理。

但至少不会为了完成翻译而破坏机器安全边界。


保护机制真正需要的是分类正确,而不是绝对保守

这个案例让我重新理解了 protector。

它不是一个:

越严格越好的过滤器。

而更像是一个:

语言权限分配器。

它决定了:

模型可以编辑哪些 bytes。

所以 classification 错误有两个方向。

第一种:

把技术内容误判成自然语言。

风险是:

模型修改机器 identity。

第二种:

把自然语言误判成技术内容。

风险是:

合法语言修订永远无法完成。

两种都是 correctness bug。


protected token 本质上是一种 capability

如果从 capability 的角度理解,整个问题会更清楚。

Generation 能看到普通 prose,意味着:

它拥有修改这些 prose 的 capability。

Generation 只能看到 token:

Plaintext
⟦P42⟧

意味着:

它没有修改 token 内部 bytes 的 capability。

所以当 Reviewer finding 指向 token 内部自然语言时,真正发生的是:

语言 authority 已经授权修改,但 transport capability 没有授权修改。

两层 authority 不一致。

这就是 ordinary revision 无法继续的根本原因。


所以 Bundle 完整也不代表任务一定“可执行”

以前我更容易把 Generation Bundle 理解成:

只要 bundle current、identity 正确、所有文件齐全,模型就可以开始工作。

这个案例让我意识到还要多问一个问题:

Bundle representation 是否真的拥有关闭 finding 所需的编辑能力?

Bundle 可以:

  • SHA 正确;
  • inventory 正确;
  • current-check PASS;
  • predecessor 正确;
  • finding 正确;

但如果 required prose 被保护成 opaque token:

任务仍然无法执行。

这不是 Bundle transport corruption。

而是:

formal editing capability mismatch。


restricted transport 和 formal representation replacement 也不能混为一谈

项目里有些特殊修订会使用受限 transport。

例如:

只允许修改某些 teaching comment body。

这种 transport projection 可以暂时限制 Generation 的编辑区域。

但它只是:

internal revision transport。

它不一定等于:

formal Page representation。

所以不能因为某个 restricted decoder 曾经成功 restore candidate,就反过来声称:

它可以充当普通 QC revision 的正式 baseline。

如果 formal source/input/Unit identity 没有发生对应 replacement,就必须另行证明 transport bridge。

不能拼接几个 token,伪造一个新 representation。


same-unit bridge 解决的是另一类问题

还有一种情况是:

formal Unit ID 没变,source/input 也没变。

但是之前某个 restricted transport 产生的 raw response,普通 QC revision decoder 无法继续使用。

这种问题不是:

formal representation replacement。

因为 formal Unit 根本没有变化。

它更像:

同一个 Unit 内,不同 editing transport 之间的 capability bridge。

因此需要的是:

same-unit transport reconciliation。

而不是伪造:

old Unit → new Unit replacement。

这两个场景看起来都叫“旧 baseline 不能用”,但 authority 完全不同。


为什么要把这些 representation 问题分这么细

因为如果全部归为:

protector 有问题。

处理方式很容易变成:

Plaintext
修 protector
→ 重跑

但这里其实至少有三种不同情况。

第一种:

current parser classification 错误,并造成正式 Unit representation drift。

需要:

representation successor。

第二种:

formal Unit 不变,但旧 restricted transport 无法执行 ordinary QC revision。

需要:

same-unit bridge。

第三种:

historical target 中某些 protected literal 的 source/target binding 本身无法唯一证明。

可能需要:

machine authority 或独立 semantic reconciliation。

它们不能互相借 authority。


为什么 machine 不能靠 occurrence 顺序猜 mapping

还有一种很典型的 ambiguity。

假设 source 中某个 technical literal 出现一次。

旧 target 中却出现两次。

如果旧 representation 没有保存足够的 binding evidence,机器可能无法确定:

source 的这一处到底对应 target 中第一次还是第二次出现。

最简单的算法当然是:

选第一个。

或者:

选离上下文最近的那个。

但这些都是 heuristic。

正式 workflow 不能因为:

两种选择最终看起来都能 restore。

就假设 binding 等价。

因为不同 binding 可能影响:

后续允许编辑的位置。

所以无法唯一证明时:

unknown。

而不是:

猜一个。


representation bug 和语言 bug 应该分开修

这一点对于恢复成本特别重要。

如果 Reviewer 已经给 B,后来发现 protector classification 错了。

不能把整个事件简单描述成:

翻译失败。

更准确的拆分是:

Plaintext
语言层:
Reviewer finding 有效

工程层:
current representation 无法执行该 finding

所以先修:

representation capability。

然后继续消费:

原语言 finding。

这样不会重新要求 Reviewer:

再判一次同样的问题。

也不会要求 Generation:

在不合法的 baseline 上硬做。


这和上一篇 source replacement 又形成了一个很好的对照

上一篇 /translation/ 的情况是:

source 本身真的要变。

所以需要:

source replacement successor。

这一篇的情况则是:

source bytes 没有变。

变化的是:

我们今天如何正确识别和保护这份 source。

所以需要的是:

representation successor。

这两种 successor 都坚持同一个原则:

predecessor 保留。

但是保护的历史对象不同。

前者保护:

old canonical source。

后者保护:

old formal representation。


为什么历史 representation 也值得保留

可能会有人觉得:

旧 protector 明明有 bug,为什么还要保留那个错误 representation?

因为它解释了:

当时的正式 artifacts 是怎么产生的。

如果旧 Generation、raw response、candidate、QC 都绑定旧 token mapping,那么删除旧 representation 后,将来就无法重建:

那份 candidate 当时为什么合法。

所以:

错误的工程判断可以被后继修正,但历史事实不能被抹掉。

这和旧 source immutable 是同一个思想。


新 representation 不应该要求旧历史重新通过今天的 protector

这也是很重要的一点。

如果当前 protector 已经修正,那么历史 representation 很可能:

按今天的规则已经不会再生成。

但不能因此说:

历史 artifact 无效。

历史验证应该问的是:

当时保存的 old representation 是否与当时的 raw/candidate/evidence 自洽?

当前验证则问:

今天 current source 应该生成什么 representation?

这两个问题必须分开。

否则每次 parser 演进,都可能导致:

所有历史 evidence 全部失效。

那就无法真正维护长期 provenance。


successor 的价值就在于连接这两个时代

representation successor 本质上是在说:

我知道历史 formal Unit 是什么。

我也知道 current formal Unit 是什么。

我能用确定性的 source-owned evidence 证明,它们对应同一个 physical Page 和同一份 canonical source。

因此:

Plaintext
historical representation
→ explicit reconciliation
→ current representation

而不是:

Plaintext
历史已经过时
→ 丢掉
→ 只认最新

这就是 successor lineage 的意义。


修正 classification 时,也不能顺便扩大可编辑范围

假设这次真正的问题只在:

heading navigation label Documentation 被错误保护。

修复 parser 时,应该尽量做到:

只把这一类真实可见自然语言重新分类为 editable prose。

不能顺便把:

  • URL;
  • tag;
  • href;
  • id;
  • code/API;
  • link binding;

全部开放给模型。

也就是说:

修复 under-classification 和 over-protection 时,都应该保持最小边界。


这类问题为什么很适合机器 proof,而不是人工拍脑袋

representation 是否发生变化,本质上有很多可以机械证明的事实。

例如:

  • source bytes 是否相同;
  • physical path 是否相同;
  • old/current input SHA 是否不同;
  • Unit ID 是否发生变化;
  • route 是否相同;
  • package 是否相同;
  • dependency identity 是否相同;
  • rebase 后是否恢复成同一 reviewed candidate。

这些都应该交给机器。

Reviewer 不应该被要求判断:

两个 Unit ID 是不是“差不多就是同一个页面”。

Reviewer 应该继续专注于:

语言质量。


Reviewer 也不应该负责修 representation

同样,Reviewer 发现:

Documentation 应该修。

就已经完成了语言职责。

不能要求 Reviewer:

顺便决定这个 token 应该怎么重新绑定。

那属于:

repository engineering / representation authority。

否则 Reviewer 会同时承担:

  • language judgment;
  • tokenizer semantics;
  • token mapping;
  • historical lineage。

角色会迅速失控。


Generation 更不应该自己创造 mapping

Generation 在这里的职责同样很简单。

如果 Bundle 给出的 baseline 合法可编辑:

按 finding 修改。

如果 required content 被保护、mapping 不可表达:

停止。

它不应该:

自己猜 ⟦P42⟧ 是什么,再构造一份新的 token mapping。

因为那会让 language model 反过来定义:

machine authority。

这是最应该避免的事情之一。


“0 output”有时候反而是最正确的结果

从生产效率看:

Plaintext
0 output

很让人挫败。

因为模型调用已经发生,却什么正式 candidate 都没得到。

但从 fail-closed 的角度,它可能反而说明:

safety boundary 正常工作了。

如果唯一能完成任务的方式是:

修改不允许修改的 protected token,

那么拒绝输出就是正确行为。

真正应该修的不是:

让模型更大胆一点。

而是:

修正正式 representation contract。


这类失败最大的价值是暴露“流程能力缺口”

普通语言 B 说明:

candidate 有质量问题。

representation capability failure 说明的是另一件事:

当前 workflow 没有能力执行已经合法授权的修订。

后者其实更接近:

infrastructure bug。

所以处理方式也应该完全不同。

不能通过:

多试几次 Generation。

来解决。

因为无论换多少次模型,只要 protected baseline 不变:

capability 仍然不存在。


重试不能解决 representation 不可表达

这也是 retry 和 revision 必须分开的原因。

如果失败是:

  • token 丢失;
  • restore malformed;
  • Generation 偶然输出格式不对;

可以考虑:

retry。

但如果失败原因是:

Reviewer 要改的自然语言根本处于 opaque protected token 内,

那么 retry 一百次结果也一样。

因为问题不是:

模型这次没做好。

而是:

任务在当前 representation 中没有合法解。


所以失败诊断一定要先确定“问题在哪一层”

遇到 revision failure 时,至少应该区分:

Generation 输出错误。

validator 规则错误。

representation capability 不足。

historical binding 无法证明。

transport bridge 不兼容。

如果全部统一处理成:

retry。

不仅浪费额度,还可能产生越来越多没有意义的失败 artifacts。


representation successor 最终仍然不是 PASS

即使工程已经建立:

old Unit → current Unit 的合法 successor。

也只能说明:

现在终于具备执行原 finding 的能力了。

下一步仍然是:

Plaintext
new revision Generation
→ restore
→ validation
→ Snapshot
→ independent re-QC

representation reconciliation 本身不产生:

A。

这一点和 source replacement authority 非常相似。

它解决的是:

输入和 lineage。

不是:

语言质量。


我现在更认可的一条分层原则

走到这里,我越来越觉得正式翻译流程里至少应该明确区分三件事。

第一件:

语言有没有问题?

由 Reviewer 判断。

第二件:

Generation 有没有被授权修改这个范围?

由 finding 和 revision scope 决定。

第三件:

当前 representation 有没有能力表达这次修改?

由 machine contract 决定。

只有三者同时成立:

Plaintext
存在合法 finding
+
存在合法 revision authorization
+
存在可执行 editing representation

Generation 才真正有可能完成任务。


这次最值得保留的几条原则

经过这类 representation failure,我觉得可以把规则浓缩成下面几条。

第一:

protected representation 的目标不是保护越多越好,而是准确区分可编辑自然语言和不可修改机器语义。

第二:

把技术内容误放给模型是 bug;把普通自然语言错误保护起来,同样是 bug。

第三:

Reviewer 可以合法发现一个 Generation 当前没有能力修改的问题。语言 judgment 与 editing capability 是两层不同 authority。

第四:

如果正式 finding 指向 opaque protected content,不能让 Generation 修改 token、删除 token或自行重建 token mapping。

第五:

不能从 restored target 重新 Protect 来猜 current formal mapping;representation 必须由 canonical source authority 决定。

第六:

修正 parser / protector 以后,如果 protected input 或 Unit identity 真实变化,就必须建立 explicit representation successor,而不是改写旧 batch。

第七:

旧 zero-output failure、raw、candidate、QC 和其他历史 evidence 都应保持 immutable;后继能力通过 successor lineage 前进。

第八:

representation successor 只证明 old/current formal Unit 的机器关系,不生成新译文,也不继承新的语言 A。

第九:

新的 revision 仍然消费原 Reviewer finding,然后经过 validation 和 independent re-QC。

第十:

同一个 physical source 不代表永远是同一个 formal TranslationUnit;representation contract 的真实变化同样可能产生新的 Unit identity。

最终我觉得这次最值得记住的一句话是:

保护机制的价值,不在于让模型“什么都不能碰”,而在于让模型只碰它真正应该碰的东西。

保护不足,会让模型破坏机器语义。

保护过度,又会让合法语言修订无法发生。

而当这种边界真的发生变化时,正确处理方式也不是偷偷修历史。

而是明确承认:

旧 representation 曾经存在。

它今天已经不足以表达新的合法任务。

然后通过一个正式 successor,把工作流安全地带到新的表示上。

这才是真正能够长期演进的 protected translation workflow。

为什么修完 Reviewer 指出的所有例子,下一轮还是会失败?从 B→revision→B 看同类问题完整性

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