分类： Go
-
在 Go Learning & Documentation v2 的翻译流程中，protected representation 用来防止 Generation 修改 Go identifier、URL、链接绑定和其他机器语义内容。但保护机制本身也可能出错：一次正式 QC 已经明确指出某个可见自然语言需要修订，可当前 protector 却把它错误分类成 opaque protected content，导致 Generation 即使完全理解 Reviewer finding，也没有合法方式修改它。本文介绍为什么“保护得更多”并不一定更安全，为什么不能让模型直接修改 protected token，也不能从目标译文重新 Protect 来猜 token mapping，以及为什么修正 parser 后仍不能改写旧 batch。文章进一步说明 representation successor 如何在保留历史 evidence 的同时，把同一个 physical Page 从旧 formal representation 安全衔接到新的可编辑表示。核心结论是：语言质量授权和编辑能力是两层不同的 authority；当 representation 无法表达一个合法修订时，应该修复表示能力，而不是放宽模型边界。
-
在 Go Learning & Documentation v2 的独立审核流程中，我遇到过一种反复出现的情况：Reviewer 首轮判定为 B，并列出了几个具体问题；Generation 按照这些 examples 完成修订，机器校验也通过，但 successor re-QC 仍然因为同一类别的残留再次判 B。问题并不一定是 Generation 没有修，而是工作流把“Reviewer 举出的例子”和“完整修订边界”混在了一起。本文介绍为什么 finding-anchored 不等于 example-anchored，以及 Reviewer 如何通过 defect category、exact predicate 和 bounded scope 做 same-class scan，Generation 又如何在不扩大修订范围、不进行无关润色的前提下完成 locally complete 的 same-class sweep。核心结论是：真正需要关闭的是审核发现的问题类别，而不是几个碰巧被列出来的实例。
-
在 Go Learning & Documentation v2 的性能优化过程中，我曾把一条只读规划路径从约 164.03s 优化到 125.65s，后来又通过更激进的方案一度压到约 35.93s。但最终，更快的方案并没有被保留，因为对应的 correctness、freshness、stale detection 和 targeted tests 无法完整证明继续成立。本文整理这次性能优化过程，讨论为什么性能任务不能只看 benchmark，为什么 invocation-local reuse 通常比复杂 persistent cache、LRU 和多级 memoization 更适合这类强调 currentness 的工作流，以及什么时候应该停止继续优化。核心结论是：性能优化的目标不是把执行时间压到最低，而是在正确性、复杂度、验证成本和实际收益之间找到合理边界。
-
Go Learning & Documentation v2 在 TranslationUnit、内容包封存和 Integrated Surface Review 全部通过以后，仍然需要执行独立的 Preview 验收。一次真实案例中，前面的语言内容和整合站点状态都已经通过，但 Preview 首页仍因 wrong renderer 直接失败。本文介绍 Surface 与 Preview 为什么不能互相替代，以及 Preview 如何验证从 activated authority 到 LoadContent、Compose、route resolver、renderer、HTTP、DOM 和浏览器行为的真实运行链。文章还讨论了为什么 HTTP 200 不能证明页面正确、runtime 工程错误为什么不应该重新打开可信翻译成果，以及修复后为什么必须重新启动 fresh Preview。核心结论是：内容正确，只能证明输入正确；Preview 还必须证明系统真正按照预期消费了这些输入。
-
Go Learning & Documentation v2 在内容生成、独立审核、内容包封存和整合站点审核全部通过以后，并不会直接修改当前激活状态。原因是从审核完成到真正写入之间，权威状态仍然可能被其他合法流程改变。本文介绍 v2 为什么将 Activation 拆成只读的 activation-preflight 和真正产生状态变更的 activation-apply，以及 prior_sha256、result_sha256 和 CAS 如何共同防止旧计划覆盖更新状态。文章还讨论了 prior mismatch、already_active=true、并发状态变化和 mutation=unknown 的处理原则。核心结论是：一次操作曾经合法，不代表它在真正提交时仍然安全。
-
Go Learning & Documentation v2 在处理结构化内容时发现，一个原始文件即使字节完全没有变化，也不代表旧翻译仍然完整有效。books.yaml 的实际案例中，旧 parser 只识别出 10 个可本地化语义单元，而当前 parser 识别出 12 个，并新增 PDF 和 GitHub。本文介绍 v2 如何区分 source 变化、普通 stale 和真正的 semantic input expansion，为什么旧 Generation 应保留为历史事实却不能继续冒充当前完整结果，以及为什么重新进入流程前必须证明旧单元全部精确保留、当前输入只是严格扩展。核心结论是：判断翻译能否复用，不能只比较源文件，还必须比较模型真正接收到的正式语义输入。
-
代码块中的注释并不都是不可翻译内容：教学性自然语言通常应该进入翻译，而机器指令、结构和技术语义必须保持不变。更难的问题是，怎样证明所有应该翻译的注释都已经被发现，而不是只检查已经进入流程的那一部分。本文介绍 Go Learning & Documentation v2 如何从规范源内容建立代码注释清单，区分教学注释、机器语义和不支持的未知内容，再与当前正式译文进行精确对应，检查 missing、extra、结构变化和受保护内容变化。核心目标是避免静默遗漏，让“翻译质量正确”和“翻译内容完整”同时成立。
-
Go Learning & Documentation v2 扩展到 Learn、Docs 和完整站点以后，一个新的问题变得越来越重要：官方英文页面存在，并不代表本地语言站点也应该自动存在对应页面。本文介绍 v2 如何以“正式本地内容覆盖”为判断依据，决定本地 URL、导航、canonical、sitemap 和 404 的行为：已经完成本地覆盖的页面才进入本地站点；尚未完成的内容继续直接链接 go.dev，并让不存在的本地路径保持真实 404。核心目标不是让站点“看起来完整”，而是让公开状态准确反映真实内容边界。
-
Go Learning & Documentation v2 中，一个上游内容发生变化后，并不意味着所有下游状态都应该一起失效。本文介绍 v2 如何通过依赖关系、当前身份和真实影响范围，判断哪些翻译单元、质量审核、内容包封存、整合站点结果和激活状态仍然有效，哪些必须重新进入流程。核心目标不是尽量减少失效，而是让失效传播足够准确，让每一次变化只产生它真正应该产生的工程成本。