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

103/103 与 7/7 Exact Match:A Tour of Go ChatGPT 新译文的最终线上验收

图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。

作者:

A Tour of Go 多语言翻译项目

图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。

(1) 103/103 与 7/7 Exact Match:A Tour of Go ChatGPT 新译文的最终线上验收

图 1:103 个正式课程页面完成最终语义质量审核,结果为 A=103、B/C/D=0,同时不存在缺失、重复或额外页面。A/B/C/D 是本轮项目内部语义质量分级,并不是自动结构 validator 的结果。

(2) 103 页翻完还不能发布:A Tour of Go ChatGPT 译文的语义审核与 Canonical Promotion

图 2:GitHub 中的 chatgpt-zh-CN-008 重译批次。一个 Batch 同时保存 inputs、raw-responses、candidates、validation 和 retry 记录,GitHub 成为 ChatGPT 与本地翻译流水线之间的数据交接层。

(3) 没有 OpenAI API,我如何用 ChatGPT + GitHub 完成 A Tour of Go 103 页全量重译

图3:访问过去的 Go Tour 简体中文站 tour.go-zh.org 时,当前已经无法正常建立连接。

(4) 从「A Tour of Go 中文版」这个搜索词开始:我决定做一个持续维护的 Go Tour 中文版

本地运行的 A Tour of Go「Methods continued」课程页面,左侧为课程说明,右侧为 Go 代码编辑器及运行结果。

(5) A Tour of Go 中文版项目设计冻结:从 101 页到 103 页,从 Gin 转向 Cobra CLI

A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

(6) A Tour of Go 中文版开发实战:英文基线、在线运行与 101 页上游同步体系

go-tour-i18n 项目完成首个简体中文课程页面 welcome/1 的整页翻译、结构校验和本地预览。

(7) A Tour of Go 多语言翻译项目实录:完成首个 zh-CN 页面翻译闭环

图 1:DeepSeek 官方更新日志显示,本次只更新 DeepSeek-V4-Flash,DeepSeek-V4-Pro API 与 APP、Web 模型均未更新

(8) A Tour of Go 中文翻译项目进展:完成前 8 页、修复 present 语法,并暂缓 DeepSeek 对比

图 1:generics/1 简体中文页面本地预览

(9) 一个页面重试五次:使用 GLM-5.2 翻译 A Tour of Go 时遇到的 Token 与 Present 结构问题

图 1:methods/16 简体中文页面浏览器预览

(10) A Tour of Go 中文翻译实录:如何只翻译教学代码注释,而不破坏 Go 代码

图 2:A Tour of Go methods/20「练习:错误」中文候选页面最终渲染效果

(11) A Tour of Go 多语言翻译:当正确的中文语序被受保护标记顺序校验误判

图 3:methods/24 中文页面,静态代码、Bounds 行内代码和链接内的 image.Rectangle 均正确渲染

(12) A Tour of Go 中文翻译完成 7 个代表页校准:最后 3 页又发现了哪些真实问题

图 2:首批 10 个普通页面经过试跑与流程校准后全部进入 ready

(13) A Tour of Go 多语言翻译项目:首批 10 个普通页面试跑,从 2 个 blocked 到全部 ready

图 2:flowcontrol/6 最终中文页面,return 与 v 为适应自然中文语序发生整体换位

(14) A Tour of Go 中文翻译第二批实跑:从 Inline Code 顺序误判到历史响应重新验证

图 1:flowcontrol/6 首次原始输入实验直接通过统一自动校验

(15) A Tour of Go 多语言翻译项目:从 swap 问题重新审视 Token 保护,原始输入与最小保护的一次真实实验

图 7:moretypes/1 最终中文页面预览。左侧课程正文、静态代码块、行内代码和教学注释均正常渲染,右侧官方 Go 示例继续保持原样。

(16) A Tour of Go 多语言翻译实战:第三批 10 页全部 Ready,继续校准 Protected Token 的结构角色

图 4:上游源码确认共有 103 个课程页面,zh-CN 最终达到 ready=103、pending=0、blocked=0

(17) A Tour of Go 多语言翻译项目:zh-CN 103 个课程页面全部 ready,课程正文翻译阶段完成

图 4:GitHub 与 ChatGPT 已成功连接

(18) ChatGPT 连接 GitHub 实测:让 AI 直接读取 go-tour-i18n 仓库参与译文审核

图 3:中文 Go 术语校准完成后,将确定的译法写入 zh-CN glossary

(19) 为什么 channel 最终选择“通道”:A Tour of Go 中文术语统一的一次实践

图 1:技术含义基本正确,但“返回一个返回……”已经明显影响阅读,因此仍被列入 C 类修订

(20) 103 页逐页审核后,只返修 16 页:A Tour of Go 中文正文发布前质量审计

图 2:中文课程页面以及已经完成本地化的编辑器控制区

(21) A Tour of Go 多语言翻译项目:公共 UI 本地化完成,从课程译文走向完整中文界面

图 2:完整 zh-CN 正式投影成功生成,103 个课程页面被重新组装为 7 个 .article

(22) 从 103/103 ready 到完整站点验收:A Tour of Go 中文版补齐正式投影与课程元数据本地化

图 3:从 production bundle 独立启动的 A Tour of Go 简体中文页面,课程正文、公共 UI 和官方 Go 示例均已进入最终发布形态。

(23) A Tour of Go 多语言翻译项目:103 页全部完成后,我终于生成了可独立部署的 zh-CN Production Bundle

图 1:A Tour of Go 简体中文版正式生产页面,远程运行已经成功输出“Hello, 世界”。

(24) A Tour of Go 多语言翻译项目:zh-CN 正式上线,从生产发布到 go.dev Playground 的完整部署记录

图 1:新生产域名 go-dev.shuijingwanwq.com 已正常访问,Go 示例远程运行成功

(25) A Tour of Go 多语言翻译项目:从 go-tour 到 go-dev,完成 EdgeOne、Nginx 与 HTTPS 生产域名迁移

图 1:A Tour of Go 多语言翻译项目正式生产首页

(26) A Tour of Go 多语言翻译项目正式上线:从项目首页、公共 Footer 到生产发布元数据的完整收尾

图 3:GA4 g/collect 请求返回 HTTP 204,并携带当前课程页面地址,确认 Google Analytics 已产生真实事件上报

(27) A Tour of Go 多语言翻译项目:接入 Google Analytics 与百度统计,从 systemd 注入到 EdgeOne 与真实上报验证

图 1:生产环境 robots.txt 与 sitemap.xml 已正确对外提供,Sitemap 共包含 104 个规范 URL。

(28) A Tour of Go 中文站上线后:补齐 robots.txt、Sitemap,并完成五大搜索引擎提交

图 4:发布生产并刷新 EdgeOne 缓存后,再次通过真实手机访问,顶栏项目名称已经完整保持在一行,最终移动端验收通过。

(29) A Tour of Go 多语言翻译项目:修复手机端首页顶栏标题换行,并完成真机验证

图 3:生产自动部署脚本第一次真实运行时,systemd 已经显示 active,但首次 localhost 探测仍然得到 HTTP 000;随后连续 3 次同时满足 active + HTTP 200 后,脚本才判定部署成功,并继续完成公网 HTTP 200 验收。这次真实运行验证了连续应用层健康检查的必要性。

(30) A Tour of Go 多语言翻译项目:从一次 203/EXEC 故障到生产自动部署脚本落地

图 1:阿里云生产环境访问 go.dev Playground 时出现 TLS 握手超时

(31) A Tour of Go 多语言翻译项目:为 Playground 搭建独立的 ZgoCloud 执行代理

图 3:清除 /tour/script.js 缓存后,Run 已直接请求 ZgoCloud /compile 并返回 HTTP 200

(32) A Tour of Go 多语言翻译项目:将生产 Run / Format 切换到 ZgoCloud 执行节点

【图 1:微信中运行 Go 示例时出现 Error communicating with remote server.】

(33) A Tour of Go 中文版手机端运行与格式化偶发失败排查:从间歇性报错到补强 Nginx 可观测性

【图 4:向 golang-dev 公开邮件列表发送 Playground 使用告知邮件并投递成功】

(34) A Tour of Go 多语言项目:为 Playground 代理增加唯一 User-Agent,并主动告知 Go 官方

【图 3:百度剩余 9 个核心 URL 提交成功,remain 归零】

(35) A Tour of Go 搜索引擎收录实测:从 Google 自然索引到百度主动提交与 Bing IndexNow

【图 1:当前正式中文 methods/24 页面,右侧示例代码运行成功】

(36) A Tour of Go 中文翻译完成后,我为什么重新评估 minimal-protect 翻译模式

【图 3:5 个页面 Request SHA256 完全一致,但 Response SHA256 全部不同】

(37) A Tour of Go 翻译实验:更多原始上下文为什么没有更好?从 157 个保护标记到 30 次重复盲评

图 3:3 个代表页 × 4 个评审模型,共 12 次匿名评审的完整排名与第一名票数。

(38) A Tour of Go 翻译质量再评估:minimal-protect 未达预期后,我开始比较 ChatGPT、Codex 与 GLM-5.2

前两篇文章分别记录了这轮 A Tour of Go 简体中文重译的两个阶段。

第一阶段,是利用 ChatGPT + GitHub 完成全部 103 个正式课程页面的整页重译,并通过现有的 restore、validator 和 retry 流程,把 ChatGPT 译文纳入原有工程体系。

第二阶段,则继续完成全部 103 页的独立语义质量审核、revision 和 canonical promotion。最终结果为:

Plaintext
A = 103
B/C/D = 0

结合整轮审核,我对当前 zh-CN 的内部综合质量评价,也从原来的约 94 分提高到了约 98 分。

但到了这里,其实还有最后一个问题没有回答:

仓库中的 canonical 已经换成新的 ChatGPT 译文,是否就意味着用户打开生产网站时,看到的一定也是这套新译文?

并不能直接这样推断。

因为中间还有:

Plaintext
production release

生产部署

当前运行中的 release

origin

EdgeOne

公网响应

任何一层如果仍然使用旧内容,都可能出现:

仓库已经更新,但公网用户看到的还是旧版本。

所以这一篇不再继续讨论翻译模型,也不再重复之前已经写过的 production deployment script 设计过程。

只做最后一件事:

证明这一轮 ChatGPT 103 页新译文,真的已经完整进入生产环境,并且公网返回的就是这一次正式 release 的内容。

一、先确认生产环境到底运行的是哪个 Release

正式部署结束以后,第一步不是马上打开几个浏览器页面查看。

我先确认:

/data/go-tour/current 当前究竟指向哪个 release。

图 1:正式生产环境当前运行的 release。当前版本为 20260818-zh-CN-45f4cad,包含 103 个正式课程页面和 7 个 article;systemd service 为 active,origin 与公网入口均返回 HTTP 200。
图 1:正式生产环境当前运行的 release。当前版本为 20260818-zh-CN-45f4cad,包含 103 个正式课程页面和 7 个 article;systemd service 为 active,origin 与公网入口均返回 HTTP 200。

当前结果:

Plaintext
current release :
/data/go-tour/releases/20260818-zh-CN-45f4cad

对应 manifest:

Plaintext
locale       : zh-CN
published_at : 2026-08-18T13:22:48Z
pages        : 103
articles     : 7
transport    : http-playground-proxy
local socket : False

同时:

Plaintext
service     : active
origin HTTP : 200
public HTTP : 200

这一步首先证明:

当前运行中的生产版本确实已经切换到了本轮新生成的正式 release。

而不是:

Plaintext
代码提交成功
但 current 仍然指向旧 release

或者:

Plaintext
current 已切换
但 go-tour.service 没有正常运行

另外还能确认:

Plaintext
local socket : False

即正式 release 仍然采用 HTTP Playground proxy,不重新启用本地 /socket 代码执行路径。

二、首页能打开,还远远不够

如果只执行:

Plaintext
curl https://go-dev.shuijingwanwq.com/

得到:

Plaintext
HTTP 200

其实并不能证明 103 页课程都已经正常上线。

因此下一步直接扩大到完整公网路由验收。

图 2:最终公网路由验收。首页、课程入口、课程列表、robots、sitemap 和前端脚本全部返回 HTTP 200;103 个正式课程路由达到 103/103,失败数为 0。
图 2:最终公网路由验收。首页、课程入口、课程列表、robots、sitemap 和前端脚本全部返回 HTTP 200;103 个正式课程路由达到 103/103,失败数为 0。

核心入口:

Plaintext
/                    200
/tour/               200
/tour/list           200
/robots.txt          200
/sitemap.xml         200
/tour/script.js      200

正式课程路由:

Plaintext
Formal course routes : 103
HTTP 200             : 103
Failed               : 0

也就是:

Plaintext
103 / 103

全部通过。

这一层回答的是:

新版本部署以后,有没有页面直接出现 404、500 或其他 HTTP 异常?

最终答案是:

没有。

三、该保持关闭的路径,也必须继续关闭

验收并不仅仅检查:

Plaintext
应该成功的 URL 是否成功

还应该确认:

Plaintext
不应该公开的 URL 有没有因为这次 release 意外恢复

最终检查:

Plaintext
/socket          → 404
/socket/anything → 404
/_/share         → 404

这些结果和当前生产架构一致。

这点尤其重要,因为 A Tour of Go 上游原本存在浏览器与服务端代码执行相关能力,而我的生产环境已经改为独立 Playground 代理。

正常生产链路是:

Plaintext
浏览器

play.go-dev.shuijingwanwq.com

独立 Playground proxy

不是:

Plaintext
浏览器

主站 /socket

本地代码执行

所以:

Plaintext
/socket → 404

并不是功能异常。

恰恰相反,它是这次验收中的预期结果。

四、103/103 HTTP 200 仍然不能证明内容不是旧缓存

到这一步:

Plaintext
103/103 HTTP 200

其实仍然没有完全回答本文最重要的问题。

因为 CDN 可以出现这样的情况:

Plaintext
生产 origin 已经更新

EdgeOne 仍然保存旧缓存

用户访问仍然返回 200

但拿到的是上一版内容

所以单纯:

Plaintext
HTTP 200

并不能证明“新 ChatGPT 译文已经真正到达公网”。

需要进一步比较:

origin 和 public 返回的 article 内容是否完全一致。

五、7 个 Article Endpoint 做 Exact Match

A Tour of Go 当前共有 7 个 .article

Plaintext
welcome
basics
flowcontrol
moretypes
methods
generics
concurrency

这 7 个 article 最终组成全部 103 个正式课程页面。

因此我分别获取:

Plaintext
生产 origin
http://127.0.0.1:3999/tour/lesson/<article>

以及:

Plaintext
公网
https://go-dev.shuijingwanwq.com/tour/lesson/<article>

然后对响应内容计算并比较 SHA-256。

结果如下。

图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。
图 3:7 个 article endpoint 的 production origin 与 EdgeOne 公网响应全部 exact match,同时新的 ChatGPT 译文标记存在,旧版译文标记已经消失。

结果:

Plaintext
welcome      exact=True
basics       exact=True
flowcontrol  exact=True
moretypes    exact=True
methods      exact=True
generics     exact=True
concurrency  exact=True

最终:

Plaintext
Origin/Public exact match : 7/7

这一步比“访问正常”更重要。

它证明:

EdgeOne 公网返回的 7 个 article 与当前正在运行的新 production origin 完全一致。

因此不存在:

Plaintext
origin 已更新
但 CDN 仍然返回旧 article

这种情况。

六、再用一组新旧译文 Marker 做直观确认

Exact Match 已经是很强的字节级证据。

但为了让结果更直观,我又挑了一句本轮发生变化的正式译文作为 marker。

新的 ChatGPT 版本中存在:

Plaintext
每个 Go 程序都是由包组成的。

而上一版使用的是:

Plaintext
每个 Go 程序都由包构成。

最终公网检查:

Plaintext
New ChatGPT marker : True
Old translation    : False

也就是说:

公网确实已经出现新的 ChatGPT 译文,而旧版对应句子已经不存在。

这一项和前面的:

Plaintext
7/7 exact match

结合以后,基本把“是不是还在看旧缓存”这个疑问排除了。

七、页面和译文正常,还要继续验证 Run

A Tour of Go 并不是纯静态教程。

用户在右侧可以直接运行示例代码。

所以如果只检查:

Plaintext
课程页面正常
译文正常

但:

Plaintext
Run 已经坏了

仍然不能算完整生产验收。

因此这一次继续向真实 Playground proxy 发起一次代码执行请求。

图 4:最终生产验收实际执行 Run 与 Format。两项均返回 HTTP 200,JSON 响应合法,Run 得到预期 ONLINE_RUN_OK,Format 也成功返回格式化后的代码。
图 4:最终生产验收实际执行 Run 与 Format。两项均返回 HTTP 200,JSON 响应合法,Run 得到预期 ONLINE_RUN_OK,Format 也成功返回格式化后的代码。

Run:

Plaintext
Run HTTP         : 200
Run JSON valid   : True
Run errors empty : True
ONLINE_RUN_OK    : True

这并不是只请求一个健康检查 URL。

而是真正提交:

Go
package main

func main() {
	println("ONLINE_RUN_OK")
}

并确认返回结果中实际包含:

Plaintext
ONLINE_RUN_OK

因此可以确认:

公网代码执行链路仍然正常。

八、Format 同样完成真实请求

随后继续测试 Format:

Plaintext
Format HTTP         : 200
Format JSON valid   : True
Format errors empty : True
ONLINE_FMT_OK       : True
Formatted func      : True

输入故意使用没有正常格式化的代码:

Go
package main;func main(){println("ONLINE_FMT_OK")}

最终响应中确认存在规范化后的:

Go
func main() {

说明 Format 不是“接口返回了 200 但没有真正工作”。

而是已经实际完成代码格式化。

到这里:

Plaintext
页面
译文
Run
Format

四个主要用户可见层面都已经通过真实公网验收。

九、这次为什么没有执行 EdgeOne 全站缓存刷新

这轮发布还有一个和以往稍微不同的地方。

部署完成以后,我并没有立即执行一次:

EdgeOne 全站缓存刷新。

以前遇到过 /tour/script.js 缓存旧版本的问题,所以最初我也有点担心:

新的 103 页译文会不会仍然被 EdgeOne 旧缓存挡住?

但这次最终验收已经直接证明:

Plaintext
Origin/Public exact match : 7/7

所以如果没有发现 stale content,再执行一次全站 purge,其实没有实际必要。

随后又查看了不同 URL 的缓存响应头。

图 5:EdgeOne 不同 URL 的缓存 Age 并不一致。首页和 tour/script.js 已经存在较长时间的 HIT,而本轮刚访问的课程 URL Age 只有几秒,说明不同 URL 独立形成缓存状态,公网验收本身也可能完成部分 URL 的重新取源与缓存 warming。
图 5:EdgeOne 不同 URL 的缓存 Age 并不一致。首页和 tour/script.js 已经存在较长时间的 HIT,而本轮刚访问的课程 URL Age 只有几秒,说明不同 URL 独立形成缓存状态,公网验收本身也可能完成部分 URL 的重新取源与缓存 warming。

例如首页:

Plaintext
age: 54712
eo-cache-status: HIT

tour/script.js

Plaintext
cache-control: max-age=604800
age: 54709
eo-cache-status: HIT

但刚刚参与验收的:

Plaintext
/tour/basics/1

只有:

Plaintext
age: 4
eo-cache-status: HIT

而:

Plaintext
/tour/lesson/basics

也只有:

Plaintext
age: 13
eo-cache-status: HIT

这个现象很有意思。

它说明:

EdgeOne 并不存在一个“整个站点要么全部旧、要么全部新”的统一缓存状态。

每个 URL 都可能拥有自己的缓存生命周期。

十、低流量站点下,验收本身可能就在完成缓存 Warming

A Tour of Go 当前访问量还很低。

这意味着某个 EdgeOne 节点在部署以前,很可能根本没有提前缓存全部 103 个课程 URL。

发布完成以后进行:

Plaintext
103/103 公网验收

本身就会访问全部课程 URL。

对于此前没有缓存的 URL,实际流程很可能变成:

Plaintext
第一次验收访问

EdgeOne MISS

回源新 production release

返回新内容

写入 EdgeOne cache

后续再次访问变成 HIT

所以在这种低流量阶段,公网验收本身可能同时承担了一部分:

cache warming。

这也能够解释为什么后来查看:

Plaintext
/tour/basics/1
/tour/lesson/basics

时,它们已经是:

Plaintext
HIT

但:

Plaintext
Age

只有几秒。

十一、以后不再把“全站 Purge”作为每次发布的默认动作

这次最终形成了一个更适合当前项目的发布习惯:

Plaintext
Deploy

Origin validation

Public validation

Exact-match / marker validation

如果发现 stale URL
    → targeted purge
否则
    → 不主动 purge

相比:

Plaintext
每次发布

无条件刷新全站缓存

这种方式更容易知道:

缓存到底有没有真的出问题。

如果不管实际情况,每次部署以后都先清缓存,那么其实很难观察 CDN 原本的行为。

而这一次恰好证明:

即使没有执行全站 purge,最终公网仍然已经完整返回新的 ChatGPT release。

所以后续我更倾向于:

先验收,发现明确 stale URL 后再做 targeted purge。

而不是把 CDN purge 当成 deployment 的固定组成部分。

十二、最终验收结果

到这里,这一次 ChatGPT zh-CN 重译的最后一层验收也完成了。

最终可以总结为:

Plaintext
正式 production release
20260818-zh-CN-45f4cad

service active
origin HTTP 200
public HTTP 200

核心入口全部 200

103/103 正式课程路由 HTTP 200

7/7 article
Origin/Public exact match

New ChatGPT marker = True
Old translation    = False

Run = 200 / ONLINE_RUN_OK
Format = 200 / ONLINE_FMT_OK

/socket = 404

无需 EdgeOne 全站 purge

这也意味着,从最开始重新评估翻译方案,到现在为止,整个链路终于真正闭合:

Plaintext
Translation Engine 实验

选择 ChatGPT

103 页全量重译

语义质量审核

A=103

Canonical Promotion

正式 Production Release

生产部署

103/103 公网验收

7/7 Exact Match

Run / Format 实际验证

前两篇解决的是:

新的译文够不够好,以及怎样安全进入正式仓库。

这一篇解决的是最后一个问题:

怎样证明用户此刻从公网访问到的,真的就是这一轮正式发布的 ChatGPT 新译文。

现在这个答案已经有了:

103/103 正常,7/7 exact match,新译文存在、旧译文消失,Run 与 Format 全部通过。

到这里,这一轮 A Tour of Go 简体中文 103 页 ChatGPT 全量重译,可以正式收尾了。

从「A Tour of Go 中文版」这个搜索词开始:我决定做一个持续维护的 Go Tour 中文版

A Tour of Go 多语言翻译项目

本系列完整记录 A Tour of Go 多语言翻译项目从架构设计、整页翻译、结构保护、自动校验,到生产发布与后续维护的实际开发过程。

项目入口:
✅ 在线学习:A Tour of Go 简体中文版
✅ 项目源码:GitHub:shuijingwan/go-tour-i18n

当前第一阶段已完成简体中文版本。项目属于非官方社区多语言翻译项目,与 Go 官方无隶属或授权关系。

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理