CASE 02

Token Monitor D-006 — 全部 Review 通过后,系统仍然坏着

z.ai 5 小时窗口刚重置时,上游接口整体省略两个字段,实现误判为「接口结构错误」→ Provider 整体掉线。34 轮独立 Review + 5 轮自检全部漏判——靠与原始 API 数据交叉核对才暴露。

类别
验收制度起源案例
时间跨度
2026-09-11
技术栈
Token Monitor v0.1(Windows GUI)
状态
commit 02725b7 修复 · v0.1.0 冻结

缺陷是什么

z.ai 的配额是按 5 小时一个窗口滚动清零的。刚清零的那一刻,用量为 0,上游接口整体省略 percentage / nextResetTime 两个字段。原实现没把这当成合法状态,判成了 unexpected_shape——结果不是「显示错了」,而是整个 Provider 从监控里下线。

它只在边界时刻出现:一天 24 小时里可能只有几分钟窗口能命中。34 轮独立 Review、5 轮自动自检,测了这么多遍都没踩到这条路径。

EVIDENCE 01

两个字段在边界态的消失

上游字段正常态窗口刚重置(归零)原实现判定
percentage存在整体省略判为 unexpected_shape → 该 Provider 下线
nextResetTime存在整体省略同上,无降级路径
currentValue / usage存在存在(=0)未被用于兜底

修复(P5 / commit 02725b7):缺字段按「窗口已重置」处理,resets_at=None, unexpected_shape 收紧为真正的结构错误。修复后 5h 显示 0.0% / 100.0%,RESET 显示 —。

是什么把它暴露的

手工验收环节把四个 Provider 的接口数据与原始源逐字段交叉核对,才看到那两个字段整体消失。修复(commit 02725b7)后:缺字段按「窗口已重置」处理(resets_at=None),并收紧了 unexpected_shape 的判定。测试 341 passed,四家数据 4/4 MATCH,版本直接冻结 v0.1.0。

这为什么重要

如果工程成果停在这里,它会是一次好看的技术修复。真正可贵的是它直接催生了 D26 独立验收原则,并把 AGENT_PASS / STAGE_PASS / PROJECT_PASS 三个词变成系统级词表——制度的灵感来自一次失败。

← Aegis Watchdog — 可靠性工程Pi Bridge — 多 Agent 委派的协议工程 →