《micro-one-api 拆解》第 28 篇 代码核对:
develop/4c64b766(2026-10-21) 主要变更:v0.35.0–v0.35.2 的原生证据、有限契约与受控修复;文末补充 v0.36.1 的 WebSocket 边界修正。
0. HTTP 200 为什么不能替一个适配器签字
补上游契约测试时,我留了一条看起来很不起眼的负例:上游返回 HTTP 200,JSON 也合法,就是没有 usage。
如果只测“请求发出去没有、响应能不能解析”,它已经通过了。再往前走一步,把这次结果当成新适配器的验证证明,网关就会批准一个连用量都讲不清楚的版本。
我现在的回归测试明确检查两件事:这次探测不能生成发布证明;失败的是候选版本时,正在使用的旧版本继续保持原状态。候选探测结果只影响它所验证的版本;当前版本自身的受控探测失败,或者被动回报触发原生用量完整性红线,才进入相应隔离处理。
这条负例让我回头看第 5 篇写过的适配器。那时我关心的是:哪些 provider 可以共享 OpenAI 兼容实现,哪些必须单独转换请求和响应。第 7 篇又划了透传边界,避免把每个接口都翻译一遍。
这两层解决了“今天怎么接”。后来补的这一轮,处理的是时间往前走以后怎么办:模型目录新增了名字、参数改了约束、原生 usage 多了一个计量字段,甚至旧协议仍返回成功,但含义已经变化。
我最初很容易把这些都叫成“自动适配”。真正写到执行链路时,这个词太宽了。改字段名、删除工具参数、换一个上游地址、猜一套新用量算法,都能被包装成自动适配,后果却差得很远。
于是我把这套契约解释器能在线执行的操作压成三种:rename、default、reject。已有协议和 parser 能表达的配置变化可以走验证与发布;需要新增协议语义或解析逻辑的变化,仍然回到代码审查、测试与新构建。围绕这三种小操作,我再补证据、版本、受控探测和发布门槛。
项目仍按个人工程验证的口径写。下面提到的失败场景来自仓库回归与受控验收;我不会把测试里的假上游写成真实用户事故,也不会把发布门槛写成已经完成的业务观察。
1. 我先拆开了“支持这个模型”里面藏着的几件事
“支持某个模型”看起来是模型表上的一个勾,落到网关里至少有三层含义。
模型目录知道它存在;适配器能构造它接受的请求;特定入口经过协议转换以后,客户端要求的语义仍然成立。目录里出现一个名字,只证明第一层。HTTP 200 也未必证明后两层。
Responses 是我最容易把这几层混在一起的地方。同样是 /v1/responses,一次无状态文本生成可以转换成 Chat Completions;previous_response_id 却引用上游保存的历史,background 和 store 还涉及服务端生命周期。把这些字段扔掉,再回一份长得像 Responses 的 JSON,不能算实现了原请求。
所以 internal/adaptor/responses_capability.go 在跨协议转换前,专门检查这类能力:
switch {
case request.PreviousResponseID != "":
feature = "previous_response_id"
case len(request.Conversation) != 0 &&
!bytes.Equal(bytes.TrimSpace(request.Conversation), []byte("null")):
feature = "conversation"
case request.Background:
feature = "background"
case request.Store:
feature = "store"
}
命中后返回 CapabilityError,告诉调用者需要原生 Responses 上游。走原生 Responses 的请求保留自己的原生能力,不经过这道转换限制。
端点也有自己的限制。provider.ValidateEndpoint 允许部分 provider 转换 Responses 创建请求,但 Responses 存储资源相关操作仍要求原生支持。创建一个响应和读回一个已存响应,虽然共用 /responses 前缀,不能共用一条“我能转 Chat”的证明。
每份契约还用 inbound_protocols 限定经过验证的入站协议。Chat、Responses、Messages 即使转向同一种上游协议,也要各自核对。我最后保留的是几道互相补充的检查:端点能力、转换能力、入站矩阵,以及原生响应证据。当前代码没有一个能覆盖所有 provider 特性的通用能力推断器;新的规则仍要有明确依据。我宁可多写一条拒绝,也不愿把没有保存历史、没有执行工具的响应包装成兼容成功。
这也解释了后面的一个决定:契约可以声明“不接受 tools”,却不能默默把 tools 从请求里删掉。拒绝让调用者知道能力缺失;删除会改变它原本要求的工作。
2. 我把契约做成了一个很小的解释器
有限契约放在 domain/upstream/contract。它首先回答的不是“怎么改”,而是“这份结论只对谁成立”。
type Scope struct {
Kind string `json:"source_kind"`
ID int64 `json:"source_id"`
Model string `json:"upstream_model_id"`
Protocol string `json:"protocol"`
}
channel:1 和 subscription:1 是两种来源。模型名保留精确原值,vendor/Exact 与 vendor/exact 生成不同的 scope key。当前 Validate 拒绝模型名里的 *、?,第一版没有通配符匹配。
文档还固定适配器构建、parser revision、usage revision、依据版本和独立 fixture 的引用。Document.Revision() 对文档的 JSON 计算 SHA-256,内容变了就是另一个版本。Compile 只接受当前代码安装的构建与 parser 标识;配置里写一个未来版本,不会让进程凭空获得新解析器。
规则分 provider、source、model 三层,从宽到窄合并。同一字段被更具体规则覆盖时,必须用 replaces 指出被替代的 rule ID。同层重复写一个路径直接拒绝,不能靠数组顺序偷偷决定赢家。
三种操作各自的边界很窄:
| 操作 | 当前执行含义 | 我保留的限制 |
|---|---|---|
rename |
把已证明等价的字段搬到新名字 | 新旧同时出现且值冲突就拒绝;不接受重命名链、环和重叠目标 |
default |
字段缺失时补一个固定 JSON 值 | 已出现的 null、0 都算已有值;不覆盖客户端显式输入 |
reject |
禁止字段,或者核对类型和数值范围 | 越界直接拒绝,不自动截断成另一个值 |
仓库的独立 fixture 使用 old_option → new_option,这是用于验证语义的假字段,不是某家供应商已经发生的参数变更。它有一条输入:
{"old_option":null,"unknown":true}
预期输出是:
{"new_option":null,"unknown":true}
这个例子小,但我关心的三个细节都在:null 被保留,未知普通字段被保留,只有命中的字段名发生变化。这里保留的是 JSON 字段和值;执行规则会重新序列化,不能把它写成字节级透传。
另一条 fixture 同时传 old_option: 1 和 new_option: 2,结果必须报冲突。网关没有足够证据替客户端选一个值。
我还给这个小解释器留了不少故意不聪明的限制:最多 64 条规则,字段路径最多 8 层,处理的请求体最多 4 MiB,不支持任意脚本,也不支持按通配路径批量改对象。重复 JSON key 会先被拒绝,避免两个解析器分别选中不同的值。
model、stream、messages、input、tools、thinking、cache_control 和输出预算这些根路径受到保护。rename/default 不能碰它们,reject 可以用来验证或拒绝。例如 max_tokens 超范围可以报错,不能把 17 自动改成 16;也不能借重命名规则把它搬到另一个预算字段。
这些限制使它不太像一个漂亮的通用规则引擎。但它越像通用编程语言,发布一份配置就越接近发布一段新程序,我反而更难说清它能改到哪里。
3. 规则放到发送前,才知道它到底约束了什么
光把契约存进数据库没有用。网关已经拿到缓存路由,或者 WebSocket 已经固定了来源,后台再修改契约,旧投影不能继续拥有“我刚才选中过,所以现在还能发”的权力。
我把执行前的确认留给 channel owner:ClaimUpstreamExecution。请求带上精确来源、配置 revision、模型,以及本地安装的 runtime build;owner 返回本次允许使用的固定快照、被隔离的协议和执行 revision。relay 把它们复制到这次准入结果里。
链路大致是这样:
选到来源(可能来自缓存)
→ ClaimUpstreamExecution 核对当前 owner 状态
→ 固定本次 contract snapshots / blocked protocols
→ 适配器构造真实上游请求
→ 发送前完成契约校验/有限改写与持久准入检查
→ 上游 I/O
→ 原生响应证据带回契约身份
HTTP 的公共出口在 domain/upstream/evidence/http.go。Do 先调用 contract.PrepareHTTP,失败包装成发送前拒绝;之后才检查持久准入并进入真实 client call。这样契约不只是管理页上的说明,它确实挡在上游调用前面。
PrepareHTTP 对适配器已经构造好的请求操作,这个位置也限制了它的权限。文档里的 endpoint 和 api_version 用来核对实际请求,不能据此把目标地址改到别处。URL、凭据和鉴权仍由原本的 provider/adaptor 构造路径负责。
Gemini 的一次修正能说明为什么这个位置有价值。
最初版本校验能从 Anthropic header 或 Azure query 读到 API 版本,Gemini 却把版本放在路径里:/v1beta/models/...。如果配置了反向代理前缀,真实路径还可能是 /google/v1beta/models/...。
我后来让契约和证据共用 GeminiAPIVersion,在最后一个 /models/ 之前取版本段:
func GeminiAPIVersion(path string) string {
index := strings.LastIndex(path, "/models/")
if index < 0 {
return ""
}
prefix := path[:index]
return prefix[strings.LastIndex(prefix, "/")+1:]
}
回归把空前缀、/google,以及本身含有 /models/ 的代理前缀都放进去。正确的 v1beta 放行,实际发成 v1 就拒绝。
已存在生效契约的来源还有一道兼容限制:旧 relay 没有安装对应 runtime,或者相关 gate 被关闭,不能沿着旧路径绕开已有绑定。没有生效绑定的来源继续保留原来的行为。升级因此需要先让消费者认识新证据,再放开生产者,不能只更新一个管理页面。
4. 发现模型和验证模型,我不再让它们共用一个“健康”结果
第一个容易获取的供应商证据是模型列表。它便宜,也适合做周期检查,但证明范围很有限:这个来源在这次查询里返回了这些精确 ID。
所以我把库存和推理探测分开了。
库存路径由 RecordUpstreamInventory 保存精确模型列表与 Added/Missing 差异。新发现模型可以进入已有目录,但初始是 testing/private;新增来源映射保持 disabled。库存回执和候选写入在同一个事务里,既有目录决策、价格和手工映射状态不被更新。
真正验证请求、协议、输出终态和原生用量,要走 canary。调度在 monitor,实际推理由 relay 执行,预算和单次许可持久保存。ProbeTarget 是 operator 配置,公网请求不能传一个目标给内部探测器,让它任意挑凭据或地址调用。
我给这条路定了很小的执行面:固定来源与模型、固定协议、文本或 tools 两类能力、可选流式;固定输入是 Reply OK.。tools 探测使用固定的 p1_probe,不执行外部工具。输出上限由配置校验限制在 1–16 token。
同一个 source 的多个任务必须使用一致的日预算,避免把同一组凭据拆成十个任务就获得十份额度。除了调用数和输入、输出 token 预算,还要配置可信成本上界,或者显式给出未知成本调用额度。成本未知时,记录的是受限暴露,不能把一个猜测价格写成硬金额保障。
调度默认周期是五分钟,可配置范围是一分钟到二十四小时;最多 64 个目标顺序执行,每次 RPC 给 35 秒窗口。失败会退避,最多到 16 个周期;预算或租约拒绝也会留下覆盖状态和下一次时间。因此“五分钟周期”不等于每个目标永远五分钟准时完成,排队、失败和预算耗尽都要在覆盖里如实出现。
验证某份新契约时,目标额外固定 contract_revision。channel 发给它一次性 probe lease,relay 再核对读到的 source revision 与租约一致,并确认转换后的实际上游协议没有越出 scope。凭据在这期间换过,旧证明就不能继续使用。
探测本身也先落独立 execution intent,再进入供应商调用;它的目的标成 canary 或 health probe,不混进用户消费。原生证据的持久交付在第 27 篇里展开,这里我只借用它提供的一个保证:修复判断看的是一次被明确识别、受预算约束的执行,不能靠重复推理把证据“补”出来。
5. 我想留下的证据,是“这个版本做了这件事”
协议转换有一个天然盲区:越是转换成功,越容易看不到原始响应长什么样。
上游 Messages 经过桥接变成 Chat,或 Responses 被整理成统一 usage envelope 以后,原生字段的位置和包含关系可能已经消失。要判断上游有没有变化,我不能再从自己改写后的结果倒推供应商原文。
所以原生观测放在 provider/adaptor 投影之前。HTTP 的 evidence.Do 包装原始 body;SSE 按原生帧和终结跟踪;WebSocket 在原生事件层留证。同一份响应供业务转换和观测使用,影子 parser 不额外打一次供应商。
Observation 固定 parser revision、usage contract revision、字段是否出现、结构指纹、usage digest 与解析状态。原文只保留受限 usage 子树,字符串经过脱敏,不把 prompt、响应正文和供应商错误长文本纳入修复上下文。
我也没有在整个响应里递归搜索名叫 usage 的对象。模型输出的正文完全可能包含一段示例账单;只有原生协议规定的位置,才有资格成为计量证据。Responses 从 response,Messages 从 message 等既定位置取,Gemini 认 usageMetadata。
参数契约的 trace 则保存另一组身份:scope、内容 revision、runtime build、binding revision、incident revision,以及命中的规则 ID 和改变的路径。它不保存参数值。
两组版本分开很重要。给请求加一个已验证的默认参数,不等于批准了新用量算法;原生 parser 认识字段,也不等于批准了用户价格或供应商成本。第 27 篇讲的收费政策冻结,不能因为这一边通过了一条参数规则就一起变化。
还有两个容易被我一开始看作“状态细节”的区别。
一个是合法零值与缺失。prompt_tokens: 0 可以是一个完整的已知数字;没有 prompt_tokens 则是信息缺口。另一个是 usage 可解析与流真正结束。最后一帧里有数字,但连接在终结标记前断了,不能算完成样本。Chat SSE 的 [DONE]、Responses 的终态都要经过各自的原生判断。
状态也因此保留 verified、missing、invalid、unsupported 等差别。新出现一个 parser 不认识的计量维度时,我需要看见它。把未知维度忽略后继续标 verified,会让适配器的“稳定”建立在漏掉信息上。
结果回报再多走一步:channel owner 对声称 verified 的原生 usage 重新解析,核对得到的 buckets 是否相等。relay 发来一句“我验证过了”不够,owner 至少要独立执行当前安装的解析规则。
同一份回报还带内容 digest。相同身份的同内容重放保持幂等,换内容则冲突;旧 binding/incident 的迟到结果不更新当前状态。这样我才能从一条完成证据回到当时实际使用的契约,而不是读到现在的配置后,误以为那也是过去请求的配置。
6. 灰度靠完整样本推进,隔离不会等 TTL 自动消失
契约内容不可变,当前谁在生效则由 binding 保存。它有自己的 revision、current、previous、灰度比例和事故 revision。管理动作提交 expected_revision,owner 在事务里做比较后再更新,旧页面不能覆盖新决定。
这道 CAS 解决的是并发覆盖,证明门槛解决的是“这次变更凭什么通过”。当前规则比我最初想过的“错误率别涨太多”更严格:
| 动作 | 当前实现核对的关键条件 |
|---|---|
| 发布候选 | 当前来源与当前 binding/incident 下,五分钟内的独立通过证明;灰度比例 1–5% |
| 晋级 active | 至少三十分钟、至少 100 个完整通过的执行、零失败,再核对 fresh proof |
| 隔离 | 持久更新状态与事故版本,后续普通请求在发送前被拒绝 |
| 恢复 | 对当前事故和精确版本重新获得有效证明,保留此前批准的灰度或 active 范围 |
| 回滚 | 只能回到记录的 previous,目标版本仍须有当前有效证明,且受切换次数限制 |
我不把“三十分钟到了”当完成。低样本下等足时间没有增加多少信息;反过来,一分钟跑完 100 个 fixture,也没有覆盖观察窗口。代码要求两项一起成立,晋级时还需要 fresh proof。
样本计数来自原生结果回报。执行成功、完整终结、能力检查和 verified usage 都满足才增加完整计数;HTTP 接受 2xx,无 HTTP 状态的原生执行则单独判定。回报失败或漏报不会替它补一个成功数,所以控制链故障的自然结果是晋级停住。
事故状态也不能靠时钟自己好。普通 transport 健康、短期容量退避和协议语义隔离分别保存。429 可以说明容量不足,不能据此判断 parser 坏了;反过来,HTTP 200 里的 usage 不可解释,也不能因为网络健康就继续当作语义安全。
契约隔离进入持久 binding,短冷却到期只允许受控探测,不直接重新开放用户请求。否则进程重启或 TTL 到期会让同一个坏协议不断复活,探测尚未运行,普通请求先替它承担验证成本。
复审里我特别保留了“失败候选不能带坏旧版本”的断言。候选 B 的 canary 返回 200/missing,不代表当前 A 已经失效;它只证明 B 还不能发布。针对 A 的有效探测失败,才可能隔离 A。把结果和版本绑定以后,这两种情况终于不会挤进同一个“渠道测试失败”。
回滚也不是换回一个旧字符串。供应商如果已经移除旧协议,previous 在数据库里存在并不能证明它还可用。TestRollbackRequiresFreshProofAndRemovedOldProtocolStaysQuarantined 就是在守这条边界:没有新证明,保持隔离。
恢复和回滚到灰度版本时,观察窗口与计数重新开始。先前的零散成功不能拼到新窗口里,让一个刚恢复的候选立刻晋级。自动恢复只限已批准的同一 revision、有效授权期限与切换预算,不能顺手生成新规则。
这里还有一笔明确欠账:transport 健康与执行控制仍含 channel owner 的进程内状态,源码写着单实例边界。契约、事故和预算有持久存储,不代表整个 channel-service 已具备任意加副本的能力。
7. 我让修复生成器产候选,把批准留在它够不到的地方
前面这些条件成立以后,才轮到“能不能让模型帮我修”。
我给它的第一份工作很小:针对已经分类为 protocol_drift、且受控契约探测失败的事故,生成一个有限候选。上游 400 的错误文本本身不是启动修复的授权;401、429 或一次普通客户端错误,也不能被自动翻译成“请改适配器”。
生成器看到的是固定事故模板、钉住摘要的 schema、受限代码片段与脱敏 usage。它没有生产凭据、reviewer 私钥或发布客户端;上下文也不包含文件系统或任意工具授权。
更关键的是独立输入。repair.Prepare(proposal, fixtures) 把候选和 fixture set 分开接收。候选生成器不能同时编一份预期答案,再用那份答案宣布自己通过。
回放要求有正例、负例和真实流终结覆盖。请求转换要与独立的 expected_request 相等;响应要核对状态、终态、完整性与 buckets。Chat 流的 fixture 会经过实际 SSE framing seam,[DONE] 的缺失不能被一串“看起来结束了”的 JSON 帧掩盖。
通过回放仍停在 review_required。随后由独立 reviewer 用 Ed25519 对准确文档签名,签名绑定 proposal、replay、CI 证据、基础版本、binding/incident/source revision 和到期时间。发布时 owner 再核对这些事实。审查后改一条规则,签名就不能继续用。
如果模型提出的是 Go patch,当前流程把它保留为 requires_code_review_and_ci_build。即使路径、文件数和 patch 大小都通过检查,也不会在线执行那段 diff。新代码必须重新走审查、CI 和构建,安装成新 runtime 后再谈发布。
有限候选进入灰度后,自动协调器也只是根据 owner 返回的状态提出下一步动作。三十分钟加 100 个完整样本满足时建议 promote,有失败或授权过期时建议 quarantine;真正 CAS 和证明核对仍在 owner。
修复授权最长受二十四小时边界约束,灰度到期检查写在持久 owner 路径里。协调进程不在线,候选也不能因此无限运行。候选失败后,旧探测成功不能续一张已经撤销的灰度许可。
到这里,“自动修复”在我这里的实际含义才比较准确:自动准备和回放有限候选,在明确批准的版本、时间和范围里推进,越界就停。新模型公开、价格、计费算法和收费白名单依然有各自的决定。
8. 我最后补的是三种传输共用的事实,以及还没通过的门
HTTP 路径接上了契约,不能据此推断 WebSocket 也接好了。前者是一请求一响应,后者一条连接上可以有很多 response.create 回合,每个回合都有自己的准入、发送、终态与结算。
所以 TestUpstreamContractEvidenceAcrossTransports 把同一份 Responses 契约放到三种传输里:HTTP JSON、SSE、WebSocket;每种分别跑 verified、missing usage、truncated、quarantined,合计十二项。
这组测试检查的事实很具体:缺失的 temperature 补成 0,原来的 unknown: null 还在;证据携带同一契约 revision、binding/incident revision 和 parser revision;截断不能标 complete;隔离时上游一个字节都不能收到。
这十二项是三种传输的矩阵,不能据此写成四种传输都做了同等验收。gRPC 有自己的执行与观测路径,不能顺便替它签字。
WebSocket 的发送前流程则按每个 response.create 应用当前回合的固定 selection。故障转移重放首帧时,计时使用 SendFirst 复用待完成回合;当前尝试的取消信号仍须约束 I/O,不能因观测上下文跨尝试保留,就让已取消的发送继续运行。
最近 v0.36.1 又补了一个与此直接相关的边界。
它区分“装了证据回调”和“已经准入持久交付”。普通连接也会安装回调来报告契约,旧判断却因此把普通连接套进持久模式的 32 回合历史限制。修复后,这道限制读取 ExecutionDeliveryVersion,只在真正准入对应能力时启用。记录证据的能力增加,不应凭空缩短普通会话寿命。
协议 fallback 也有类似约束。普通 Responses 兼容路径只把 404、405、501 视为端点不支持的候选信号;鉴权、限流和普通参数错误不能触发换协议重试。进入持久 execution intent 的执行还有一次实际发送的限制,redirect 或同 intent 的协议 fallback 不能绕过这道准入。一次转换已经失败以后,不能靠外层 permissive retry policy 再把同一组调用重放一轮。
截至这次按 2026-10-21 HEAD 核对,有限规则、owner binding、预算探测、签名候选、管理页面和传输回归已经有实现。本文复核时运行的 contract、evidence、repair 三个领域包测试通过。更完整的三库与传输验收可查 10 月 16 日工程记录,我不把既有归档写成本次重新运行的结果。
启用边界也要一起留下:三种 Compose 的 UPSTREAM_CONTRACTS_V1_ENABLED 默认关闭,探测与可选 operator profiles 各有自己的 gate。源码默认值不代表某个实例此刻的环境;历史部署记录也不替代重新检查。收费放行与契约发布继续分开,空的 RELAY_NATIVE_USAGE_V2_ALLOWLIST 不放行新的 native-v2 收费。
三十分钟和 100 个完整目标样本是灰度晋级门槛,五分钟实例收敛和真实 reviewer/IAM 是独立验收事项。截至仓库 10 月 18 日最新计划,executor 观察仍是 INSUFFICIENT:新旧 Responses SSE 都已有样本,但分属不同时段,没有同窗口可比增量,正式七天尚未开始。有工程测试、有手工供应商核验,都不能拼成一个尚未建立的观察窗口。
回到第 5 篇留下的那套适配器,我这次没有让它多一个“供应商万能分支”。我补的是变化以后能解释的路径:发现归发现,验证归验证,正在执行的请求带着自己的版本,修复只能在已经安装且被批准的范围里发生。
剩下让我愿意继续花时间的,还是独立证据和长期窗口。参数兼容测通很快,要证明一个来源在持续变化后仍讲得清请求和用量,慢得多。我现在接受这个慢,也把没有通过的门保留在页面和记录里。
代码与阅读入口
| 想核对的内容 | 仓库入口 |
|---|---|
| 精确范围、有限规则、保护字段、HTTP 发送前校验 | domain/upstream/contract/contract.go、contract_test.go |
| Responses 端点与跨协议状态能力限制 | domain/upstream/provider/capability.go、internal/adaptor/responses_capability.go |
| 缓存来源的执行前确认与快照绑定 | internal/biz/upstream_execution.go、app/channel/internal/biz/upstream_execution.go |
| 原生采集、静态 parser、流终结 | domain/upstream/evidence/http.go、native.go、stream.go |
| 库存候选与默认禁用的来源映射 | app/channel/internal/biz/upstream_inventory.go、app/channel/internal/data/upstream_inventory.go |
| 预算探测、固定目标与单次许可 | domain/execution/probe.go、app/monitor/internal/biz/upstream_probes.go、internal/data/upstream_probe.go |
| CAS、fresh proof、灰度和持久事故 | app/channel/internal/data/upstream_contract.go、upstream_contract_test.go、upstream_repair_test.go |
| 独立 fixture、受限生成、签名 reviewer | domain/upstream/repair/candidate.go、agent.go、rollout.go、domain/upstream/contract/repair_review.go |
| 十二项传输矩阵、fallback 与不可重放边界 | internal/server/upstream_contract_matrix_test.go、reliability_contract_test.go |
| WS 回合契约和近期时序修正 | internal/server/openai_ws_relay.go、openai_ws_forwarder.go、request_timing_test.go、request_timing_ws_e2e_test.go |
| 已交付工程与尚待现场门槛 | docs/runbooks/billing-upstream-p2-completion-2026-10-14.md、billing-upstream-p3-2026-10-14.md、plan-execution-2026-10-16.md |
| 后续观察窗口状态 | docs/design/next-stage-plan-2026-10-18.md、docs/design/v0.23-executor-observation.md |
与本篇相接的是第 27 篇:原生计费证据与结算;已有适配器结构与透传边界分别见第 5 篇、第 7 篇。