Files
MailUI4Agents/deploy
JianFeeeee c6a497f4ed feat(deploy): 漂移检查补 ⑤b —— 比 vcs.revision,接住"二进制落后 HEAD"
## 缺口

`check-deploy-drift.mjs` 判据 ⑤ 只判**构建参数**(有没有带 `-trimpath`),
不判**这份二进制是哪次提交建的**。2026-09-25 实证:

    线上 /opt/agentmail/agentmail-gateway  vcs.revision=e8b260d(09-19 构建)
    仓库 HEAD 已有 6 天的新提交(含两条 relay 幂等键/回滚修复)
    ⑤ 当日报的是"63 处源码路径"(另一个毛病)⇒ **完全没指出它落后 6 天**

当时是靠人手动跑 `go version -m` 才发现的。而"部署脚本跑过了 ≠ 线上跑的是当前代码"
正是这个文件头自己列的第 2 类漂移 —— 判据却缺了它。

## 实现

Go 默认把 `vcs.revision=<sha>` 以**明文字节**编进二进制,所以直接按字节匹配读出,
不依赖 `go` 命令、不 spawn:与 ⑤ 读同一份 buffer。

⚠️ 三态而非两态:**拿不到 revision(`-buildvcs=false`/老构建/非 git 构建)⇒ 不判**。
写成红会让合法环境恒红,写成绿等于没判 —— 所以只接受"不判",且 note 必须说出来,
否则读者分不清"比过且相同"与"根本没比"。只比相等/不等,**不判谁新谁旧**
(判新旧要 git 图,而二进制里的 sha 未必在本地仓库里)。

## 判据自检

新增 3 条(不等→红 / 相等→绿 / 拿不到→不判且 note 说出来),自检 **58 → 61 项**,
`判据自检失败` 不出现。只钉"不等红"会放过"两侧都读不到时恒绿"的退化。

## 顺带修一处脆锚

原有自检用 `o.find(c => c.name.startsWith('已安装的网关二进制'))` 取 ⑤。我新增的
⑤b 名字以同一串开头 ⇒ `find` 会返回它,⑤ 的断言就可能测到 ⑤b。
已把选择器锚到**完整前缀** `'已安装的网关二进制不含源码路径'`,并把新判据命名为
`网关二进制构建版本…`。("按名字锚定"是对的,但**锚得太短就等于按位置**。)

HEAD 版与新版 `--self-check` 同为 rc=1(来自既有真实漂移:3 个宿主待重部署 +
判据 6),非本次引入。
2026-09-25 06:19:38 +08:00
..