系列: A Tour of Go 多语言翻译项目
A Tour of Go 多语言翻译项目
本系列完整记录 A Tour of Go 多语言翻译项目从架构设计、整页翻译、结构保护、自动校验,到生产发布与后续维护的实际开发过程。
项目入口:
✅ 简体中文:A Tour of Go 简体中文版
✅ 日语:A Tour of Go 日语版
✅ 德语:A Tour of Go 德语版
✅ 法语:A Tour of Go 法语版
✅ 项目源码:GitHub:shuijingwan/go-tour-i18n
当前已上线简体中文、日语、德语和法语版本。项目属于非官方社区多语言翻译项目,与 Go 官方无隶属或授权关系。
-
继续推进 go-tour-i18n 项目的第二批 10 个普通页面翻译。flowcontrol/6 在连续 3 次翻译后因 inline code sentinel 5 opening marker missing 进入 blocked,排查后发现 GLM-5.2 并未丢失 Token,而是将英文中的 v → return 按自然中文语序调整为 return → v,暴露出 Restore 层错误要求不同 Inline Code Pair 保持源码顺序的问题。修复后允许完整 Pair 随自然语序整体换位,并新增 translate revalidate-response,可直接复用历史成功模型响应重新执行当前 Restore 与 Validator,无需再次调用 GLM。最终 flowcontrol/6 使用原 attempt-003 成功恢复为 ready,第二批 10 页实现 10/10 Ready;同时修正了已经过时的 TestCommittedStatus Ready 页面白名单测试。当前项目状态为 ready=35、pending=68、blocked=0。
-
在 A Tour of Go 多语言翻译项目中,随着 protected token 保护规则不断增加,我开始重新思考输入端是否有必要做如此多的结构处理。本文记录一次围绕 –raw-input、–minimal-protect 和 –dev-attempts 的真实架构实验:flowcontrol/6 证明原始输入能够直接通过统一校验,而结构更复杂的 methods/24 又暴露出 .play directive、链接标签行内代码以及 font span 等结构风险。最终没有贸然替换当前成熟方案,而是保存实验能力和真实审计,继续使用默认 protected-token 流程推进课程翻译,并将“原始页面优先、少量高风险机器结构保护、严格统一校验、针对性重试反馈”作为后续值得继续研究的简化方向。
-
A Tour of Go 多语言翻译项目继续推进第三批普通页面。本批最初 10 页中有 8 页直接进入 ready,flowcontrol/10 与 moretypes/1 因静态预格式化代码块、行内结构和教学注释 Go 标识符等问题进入 blocked。排查过程中进一步确认:Protected Token 不仅需要保护 payload,还需要向模型明确其结构角色;同时 static preformatted block 的 token 化还曾吞掉原有块级换行边界,导致模型输入本身误导结构判断。完成首次 Prompt、protected input 边界和教学注释标识符角色校准后,两页均在干净首次请求中通过全部自动校验;同时修复了 retry feedback 因 diagnostic suffix 中包含 directive 而导致的字符串误分类。第三批最终实现 10/10 ready,全局状态更新为 ready=45、pending=58、blocked=0。
-
A Tour of Go 多语言翻译项目完成简体中文课程正文的全量翻译:基于官方 upstream master@e11dacba76c5aae474746e9eedee19693f492803,重新确认 101 个普通顶层 Section 加 2 个 #appengine 条件顶层 Section,共计 103 个课程页面。批量翻译过程中进一步修复了行内代码完整结构换位导致的恢复边界问题,以及完整链接按中文自然语序换位导致的校验误判,并直接利用已有 GLM-5.2 历史响应重新校验恢复。最终状态达到 ready=103、pending=0、blocked=0,课程正文翻译阶段正式完成,下一步进入 zh-CN 发布前全局验收。
-
在推进 A Tour of Go 多语言翻译项目的发布前正文审核时,我尝试将 ChatGPT 直接连接 GitHub,让它能够读取 go-tour-i18n 仓库中的真实源码和译文。本文记录实际连接与授权过程,以及连接完成后 ChatGPT 与 Codex 在项目中的新分工:ChatGPT 负责直接读取仓库、分析和审核,Codex 继续负责仓库级修改、测试与提交,从而减少过去需要手工转发仓库内容的中间环节。
-
在 A Tour of Go 简体中文版本进入发布前质量审核后,我发现 channel 在中文 Go 资料中存在“通道”“信道”“管道”以及直接保留英文等多种用法。本文记录这次术语校准过程:不再依据项目内部出现次数判断译法,而是参考中文 Go 社区长期形成的实际习惯,并进一步统一 type inference、untyped constant、built-in 等核心术语。最终形成“社区强共识、项目约定、保留原生术语”三类处理原则,并将确定的译法写入 zh-CN glossary。
-
A Tour of Go 简体中文 103 个正式发布页面完成自动翻译和结构校验后,我又进行了一轮完整的发布前正文质量审计。最终 87 页无需修改,14 页列为 C 类建议修订,2 页列为 D 类必须修订,共返修 16 页。本文记录这次审核如何区分可读性问题与技术误译,以及人工修订仍然必须经过同一套 validator 校验的过程,包括 methods/19 因少保留一个行内代码结构而被自动拒绝的代表案例。
-
记录 A Tour of Go 多语言翻译项目在简体中文 103/103 页面全部 ready 后的完整发布前验收过程。项目首先补齐完整语言正式投影与本地预览能力,将 103 个 canonical candidate 重新组装为 7 个 .article,并完成 103/103 HTTP 页面级验收;随后又在准备博客截图时发现 present.Doc.Title 和 present.Doc.Subtitle 未进入原有翻译模型,最终新增独立的课程元数据本地化层,实现 7/7 标题与副标题完整中文化。至此,课程正文、课程元数据和公共 UI 三层 zh-CN 本地化全部闭合,下一阶段将进入 production publish。
-
A Tour of Go 多语言翻译项目的简体中文 zh-CN 已完成 103/103 个正式课程页面、7/7 个 article metadata 和公共 UI 本地化。在完成生产环境安全运行服务后,本阶段进一步实现了确定性的 production publish:可生成包含独立 Tour binary、完整 _content、release.json 和 SHA256SUMS 的生产发布包。最终本地人工验收确认 185 个文件完整性校验通过,103/103 页面及 7/7 lesson 正常,Run 与 Format 可通过远程 Go Playground 工作,同时生产环境 /socket 保持关闭。至此,项目已具备正式部署条件,下一阶段进入实际生产环境部署。
