Repository navigation
Description
Important
用户已接受的备选方案 · 提供 v2.20.0 兼容模式,取消新增的冻结完整性检查。
如果完整修复上述转换链的工作量较大,用户接受由管理员显式选择兼容模式,取消新增的 input/controls 冻结等值拦截,恢复 v2.20.0 原有转发和账号池行为。
此项为待实现、待验证的兼容建议。 具体开关范围、HTTP/WS/桥接/压缩覆盖和验收要求见下方 兼容方案详细要求。
提交前确认
- 已搜索现有 Issue,并说明相关记录与本次差异。
- 已检查正文及附件,移除凭据、私人请求体和业务敏感内容。
问题现象
官方 v2.22.0 在 owner-binding opt-out=true 时会冻结完整 input,后续兼容步骤继续修改其中的字段,最终返回本地 encrypted_agent_recovery_wire_changed 409。
最初已确认 WS 的 additional_tools.id UUID 去横线冲突,并完成同镜像 19 项对照。本次新增两份 HTTP 采集,共 10 次失败,并扩查冻结后的构造链。第一轮已动态确认 14 类处理点,覆盖 OAuth HTTP、API-key HTTP、WS ctx_pool、WS passthrough、Lite 和 HTTP 原生压缩。
原 WS 样本直接 HTTP 完成的结论仍成立。新 HTTP 样本另含内部消息元数据删除、Lite 搜索历史补声明、原生压缩使用旧摘要等触发条件,因此 HTTP 的适用范围需要按具体输入判断。后文保留原 WS 证据,并补充每一类的触发条件、成功对照和代码位置。
第二轮进一步确认 3 类处理点,累计 17 类。新增包括 API-key WS→HTTP 的 custom 历史转换、WS ctx_pool 后续轮主动删除 previous_response_id 后被连续性检查拒绝,以及 Spark 在 409 省略恢复后追加 instructions 导致 controls_integrity。对应证据为新增 118 个场景、176 个回合的同镜像隔离测试。
用户补充接受旧版兼容方案。如果严格投影的修复范围过大,可以通过管理员显式选择的兼容模式取消新增的 input/controls 冻结等值拦截,恢复 v2.20.0 的转发和普通账号池行为。此项为实现建议,尚待候选程序验收。
运行版本与构建来源
Sub2API版本:2.22.0,ranxi2001/sub2api官方Release容器镜像。
Release tag:v2.22.0
镜像:ghcr.io/ranxi2001/sub2api:2.22.0@sha256:7047a3f32b2c04f7efc68b0c1f4d98e69e227873db3c8a76f076719cc7f4fe23
运行二进制 --version 提交:4ba33f8713cbf6c6406e0f2639ffcc2ef1e31c87
未修改生产源码;隔离对照使用相同官方镜像,未重新编译近似候选。
最近正常版本:未做同条件旧版WS对照,未知;不能将v2.20.0视为等价基线,因为它不支持该opt-out参数。
部署、客户端与相关配置
部署:Docker Compose,Ubuntu 24.04 / amd64,PostgreSQL 18、Redis 8。
客户端:Codex,具体客户端版本未独立核验。
平台/账号:OpenAI OAuth;故障关联查询为WS ctx_pool、SSE acceleration=true。
入站端点:WS /v1/responses,response.create。
业务入站参数:model=gpt-6.1-sol,stream=true,store=false,reasoning.effort=max;不声称被拒绝请求在上游执行过该档位。
网络:客户端→既有HTTPS反代→Sub2API→原生供应商路径;诊断未增加正式采集代理。
相关配置:
GATEWAY_DISABLE_ENCRYPTED_AGENT_OWNER_BINDING=true
GATEWAY_OPENAI_WS_MODE_ROUTER_V2_ENABLED=true
GATEWAY_OPENAI_HTTP2_ENABLED=false
openai_409_omit_encrypted_history_enabled=false
openai_400_omit_encrypted_history_enabled=false
gateway.openai_ws.lossy_history_restart_enabled=false
手动请求时区enabled=true/auto=false,输入Asia/Singapore、账号目标America/Denver;隔离中关时区和对齐时区仍可复现本次WS409。
故障时间及关联核对均为2026-11-18、UTC+08。请求来自原生采集,账号/设置为故障后的只读回查,不冒充每次发送时的逐请求配置快照。
本次增补的两个入站均为 HTTP POST /v1/responses,stream=true、store=false、reasoning.effort=max,模型分别为 gpt-6-astra、gpt-6.1-sol。第一份所选 OAuth 账号回查时区为 America/Los_Angeles,第二份为 America/New_York。原 WS 的 Denver 账号与这两个账号分别核对。
隔离测试使用相同镜像及全新 schema460、Redis。所有上游均为内部 HTTP/TLS/WS mock,凭据为虚构值,回答固定为 FIXTURE_OK。新增 301 项中,57 项使用两份私有采集各一份代表的受控变体,244 项全部使用虚构输入。WS Lite 的正式补充对照在 payload.client_metadata 中明确设置 ws_request_header_x_openai_internal_codex_responses_lite=true。
复现情况
可以稳定复现
前置条件与最小复现步骤
原 WS 声明 ID 路径的已验证步骤如下。
已在同官方镜像、全新schema460 PostgreSQL/Redis、虚构OAuth凭据、内部HTTP/TLS/WS假上游中验证;无生产卷、无宿主端口,不执行真实模型或历史工具。
- 准备可准入的OAuth账号及用户/Key/分组,开启owner-binding opt-out,关闭400/409省略与有损重启。
- 向WS /v1/responses发送完整历史,保留含密文agent和additional_tools声明;声明ID使用at_前缀、带横线UUID的39字符形态。
- 观察WS错误帧409/wire_changed、日志input_integrity;假上游收到0条请求。
- 仅将该声明ID规范为at_加32位十六进制;若有指向该声明的item_reference,保持对应关系。其余历史不改,再发送:假上游收到1条请求并完整结束。
- 将同一原始历史改走直接HTTP(删除WS事件的顶层type),得到HTTP200及完整SSE终态。
完整代表输入约19.8MB;另删减成1条原工具声明+1条原密文agent+1条虚构user的89,644B样本仍复现,只规范1个ID后89,640B完成。
两轮共19项:10次预期本地拒绝、9次假上游完整结束;不是19次全失败,也不是全站错误率。
动态对照主要使用不带previous_response_id的新连接首帧;带原指针的真实第2轮未做同等隔离回放。
新增处理点可用后文的纯虚构基体分别触发。HTTP Lite 需带 X-OpenAI-Internal-Codex-Responses-Lite: true。WS 需使用 response.create,并在 client_metadata 中设置对应 Lite 标记。
内部元数据对照只增删 input 项的 internal_chat_message_metadata_passthrough。Lite 搜索历史对照保留 web_search_call,并提前在 input.additional_tools 中声明 web_search。原生压缩对照保留 compaction_trigger,分别比较 user 环境时区与账号时区相同/不同,及 reasoning 元数据已规范/待规范。其他变体见下方审查表。
脱敏最小样例(请求、配置或测试)
现已用纯虚构输入验证以下基体。前置条件为同版本隔离应用、虚构 OAuth 账号、非空用户/Key/分组与会话,以及 TLS 假上游。encrypted_content 是占位字符串,mock 只记录请求并返回固定终态。
{
"model": "gpt-6.1-sol",
"stream": true,
"store": false,
"reasoning": {
"effort": "high",
"context": "all"
},
"input": [
{
"type": "agent_message",
"id": "am_fixture_1",
"author": "fixture_agent",
"recipient": "all",
"content": [
{
"type": "input_text",
"text": "Synthetic fixture."
},
{
"type": "encrypted_content",
"encrypted_content": "fixture-opaque-not-real-ciphertext"
}
],
"internal_chat_message_metadata_passthrough": {
"turn_id": "11111111-2222-4333-8444-555555555555",
"create_time": 1800000000.125
}
},
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain this isolated fixture."
}
]
}
]
}该基体通过 HTTP 或两种 OAuth WS 模式发送时均得到本地 409。仅删除 internal_chat_message_metadata_passthrough 后完成,mock 收到 1 请求。其他变体从删除此字段后的基体构造。
- WS ID 变体在 input 前加入 additional_tools,其 id 为 at_11111111-2222-4333-8444-555555555555,tools 放入一个参数为 object 的普通 function 声明。仅提前去掉该 UUID 的四个横线后完成。
- 工具 schema 变体将同一 additional_tools.tools 中 function.parameters.type 从 object 改为 null,冻结后 schema 修补触发 409。恢复 object 后完成。
- Lite 迁移变体把 namespace 工具置于顶层 tools。HTTP Lite 和 WS ctx_pool Lite 冻结后将它搬入 input,触发 409。客户端事先放到 input.additional_tools 后完成。
- 原生压缩变体保留一个独立 user environment_context,将时区设为与账号不同,并在 input 末尾加 compaction_trigger。普通 HTTP 完成,同一历史带压缩触发项时 409。提前对齐时区后完成。
这些全虚构对照已在同官方镜像运行。原 89KB WS 删减体和两份业务采集仍按私有材料处理。
预期行为
管理员应能选择适合现有客户端的转发策略。
- 保留严格完整性机制时,兼容转换和冻结快照使用一致的受控投影,让合法转换后的完整历史能够发送。
- 如果难以可靠修复全部转换路径,用户接受提供旧版兼容模式,取消这套新增的 input/controls 冻结等值拦截,按 v2.20.0 原有转发和账号池规则处理。
两种策略都应维持普通鉴权、分组和模型准入、额度、计费及既有协议处理。兼容模式的具体行为需要与官方 v2.20.0 做对照。
实际行为
WS握手为HTTP101,随后返回业务错误帧:
type=error
status=409
error.code=encrypted_agent_recovery_wire_changed
error.type=invalid_request_error
关联日志:subreason=input_integrity,phase=before_upstream_write,request_written=false。
失败记录没有upstream_request/attempt;隔离假上游接收计数也为0。不能仅凭Ops的upstream_status_code=NULL断言未发送,本报告还有上述独立证据。
当前失败轮没有正常模型输出;这是发送前本地拒绝,不是上游HTTP409,也不是请求体超限413。
两份新增 HTTP 采集直接返回 HTTP409,code/type 与上文一致。逐请求 journal 关联结果分别为 input_integrity 与 unknown,phase=before_response、request_written=unknown。包内每条均只有 client_request/client_response,没有 upstream_request/attempt。HTTP handler 的这组字段自身不能证明是否写过上游,隔离中的相同输入另以 mock 请求数为 0 验证本地拒绝。
时间、关联记录与证据范围
真实失败窗口:2026-11-18 03:04:10.619–03:05:17.160,Asia/Singapore(UTC+08)。
采集共7条均为WS:R1是generate=false/input=[]预热,某次上游429后最终已交付response.completed;本报告的6次409为R2–R7。
六份input相同:471项,26个agent_message(13含密文),2个additional_tools。整个请求并非完全相同:R2是原连接第2轮且带previous_response_id,R3–R7为新连接第1轮且不带该指针,client_metadata也有差异。
已用采集request_id/client_request_id逐条关联Ops和journal;真实用户、Key、账号和request ID不公开,维护者不能直接凭这些别名检索线上日志。
03:06:18.816后台有同Key、同失败账号的HTTP流式用量(input542659/output333 tokens),支持用户所述HTTP后续能继续;缺少该成功请求正文及客户端日志,不能声称已证明同一原任务完全恢复。
原生采集包含错误/重试样本,不作为全站失败率分母。无私有原体公开。
新增 HTTP-A 包有 7 条失败,窗口为 2026-11-18 04:00:01.595–04:00:42.177 SGT。每份约 4.99MB、709 项 input、23 个 agent_message,其中 14 个含密文,16 个 web_search_call,1 个 additional_tools。707 项含内部消息元数据。A2–A7 解析后整个请求相同,A1 的尾部四项与 client_metadata 有变化。采集任务 partial=0、skipped=6。
新增 HTTP-B 包有 3 条失败,窗口为 04:06:18.021–04:06:28.160 SGT。每份约 4.20MB、403 项 input、8 个 agent_message,其中 5 个含密文,2 个 additional_tools,末项 compaction_trigger。400 项含内部消息元数据,三次解析后请求相同。采集任务 partial=0、skipped=1。
新增 10 次均按各自 request_id 关联 journal。按 request_id/client_request_id 查询 Ops 表未取到相应行,因此新增证据采用原生采集和 journal,不沿用原 WS 六条的 Ops 关联结论。别名 HTTP-A/HTTP-B 不包含真实身份或可直接检索的请求 ID。
脱敏日志与截图(可选)
固定字段摘要,非逐字原日志:
R2–R7:protocol=websocket,WS握手101,业务帧409
code=encrypted_agent_recovery_wire_changed
subreason=input_integrity
phase=before_upstream_write
request_written=false
upstream_request/attempt=无
同官方镜像的关键隔离对照:
约19.8MB原输入,WS → 409,mock_requests=0
约19.8MB,仅规范两个声明ID、减少8字节,WS → 完整终态,mock_requests=1
89,644B原ID → 409;89,640B仅规范一个ID → 原生WS完整终态
原完整输入直接HTTP → 200,mock_requests=1
关时区/对齐时区/关内部HTTP桥接/仅删namespace → 原ID仍409
以上完成均指假上游固定回答,不是实际供应商或原客户端任务验收。
新增固定字段摘要如下。
HTTP-A1..A7 HTTP409 input_integrity phase=before_response request_written=unknown
HTTP-B1..B3 HTTP409 unknown phase=before_response request_written=unknown
关键单变量对照均在同官方镜像及假上游中完成。
| 输入 | 结果 | mock 请求数 |
|---|---|---|
| HTTP-A 原体,普通 HTTP / Lite HTTP | 409 / 409 | 0 / 0 |
| A 只删内部元数据,普通 HTTP / Lite HTTP | 完成 / 409 | 1 / 0 |
| A 删内部元数据且预先补搜索声明,保留 709 项历史,Lite HTTP | 完成 | 1 |
| HTTP-B 原体,时区开 / 关 | 409 / 409 | 0 / 0 |
| B 只删内部元数据,时区关 | 完成 | 1 |
| B 只删内部元数据,时区开且环境与目标不一致 | 409 | 0 |
| B 再对齐环境时区,保留 403 项和压缩触发项 | 完成 | 1 |
| B 删内部元数据且移除压缩触发项,时区开 | 完成 | 1 |
频率与影响范围
原 WS 六次及新增 HTTP 十次均为采集到的失败提交,包含同一输入的重复请求。频率评估仅覆盖这些采集及隔离探针。
已验证的影响范围扩展到冻结后的多类兼容处理,具体协议见审查表。同一报错可以叠加多个触发条件,提前规范 additional_tools.id 只解决该 ID 路径。原 WS 样本的直接 HTTP 对照完成,新 HTTP 样本仍可在内部元数据、Lite 补声明或原生压缩分支触发 409。
低于 90KB 的原 ID 缩小体及数百字节的全虚构新样本均可复现。15MiB 桥接阈值没有构成本组错误的必要条件。
已做对照、待验证推测与关联 Issue(可选)
已验证与代码定位:
- 同官方镜像两轮19项:第一轮10项(6次WS409、4次HTTP完成),第二轮9项(4次WS409、5次完成)。所有409均mock0请求,所有完成均mock1请求;私有夹具已清理,生产配置未改。
- WS prepareReadable先冻结reasoning/时区有限投影;后续兼容构造仍调用normalizeCodexAdditionalToolsIDsBody,把at_带横线UUID声明ID压缩。最终input摘要与冻结期望不一致,触发input_integrity。
- 只规范ID可解除;只删namespace、关时区、对齐时区、关桥接均不能解除,已区分这些变量。
精确v2.22.0代码:
https://github.com/ranxi2001/sub2api/blob/v2.22.0/backend/internal/service/openai_ws_agent_recovery.go#L123-L170
https://github.com/ranxi2001/sub2api/blob/v2.22.0/backend/internal/service/openai_gateway_request_body.go#L1515-L1552
https://github.com/ranxi2001/sub2api/blob/v2.22.0/backend/internal/service/openai_codex_transform.go#L1625-L1695
https://github.com/ranxi2001/sub2api/blob/v2.22.0/backend/internal/service/openai_agent_message_recovery.go#L489-L515
修复建议及验收要求:
A. 对受保护完整历史,统一哪些字段必须原样传递、哪些允许有限规范化。声明/引用ID如必须转换,应从已验证原source推导一致映射并在冻结前纳入预期,不在最终发送点重置摘要或放宽校验。
B. 原来列为源码审查点的工具别名、Lite 声明迁移、input 内工具 schema 清理,已在本次增补中分别完成纯虚构动态对照。对应协议和输入条件见下表。
C. 增加HTTP JSON/SSE与WS ctx_pool/passthrough/http_bridge、首帧/后续帧、带/不带response指针、低于/高于桥接阈值、原ID/已规范ID/声明引用配对、账号重选和相关兼容开关的正负例。上述完整矩阵是建议新增的验收范围,不是本报告已全部执行的测试。
D. 正例应到达最终发送并交付正确终态,负例应拒绝真正的密文/工具结果/目录篡改和交付未知状态;核对工具副作用不被重放。不能以HTTP101或其他会话成功代替失败会话验收,也不要求永远没有409。
关联:
#892/#895:此前手动时区投影冲突;本次时区关闭仍复现,新增独立声明ID证据。
#905:API-key第三方上游WS第二轮read_upstream返回owner_unavailable;本次是OAuth发送前本地wire_changed,症状相近,尚不能认定同因。
#854/#842:完整历史恢复与兼容转换的相关背景。
原阶段待验证项已有推进,现已完成纯虚构请求、API-key HTTP/部分 WS、WS passthrough 的变体对照。带原指针失败轮的同等回放、真实供应商及原客户端任务恢复仍待验收。
新增冻结后改写审查
第一轮按处理步骤归纳为 14 类,第二轮追加第 15–17 类。第 1 类沿用原 WS ID 证据。每项至少有触发输入与对应成功对照。表中“完成”表示假上游固定终态已交付。
| 处理点 | 冻结后发生的变化 | 已复现的协议 / 条件 | 成功对照 |
|---|---|---|---|
| 1. 声明 ID | additional_tools.id 的 UUID 去横线 | OAuth WS ctx_pool、passthrough、原 WS→HTTP bridge | 提前规范声明及引用 ID |
| 2. 内部消息元数据 | 删除 input 项的 internal_chat_message_metadata_passthrough,密文 agent 外壳也随之变化 | OAuth HTTP、WS ctx_pool、WS passthrough,两个 HTTP 采集均含该字段 | 只提前删除该字段的最小虚构体完成 |
| 3. input 内工具 schema | 根 type=null→object、删除 required=null、给明确 object union 补 type、移除不兼容 pattern | OAuth HTTP、API-key HTTP、两种 OAuth WS,另有 API-key WS null-type 对照 | 提前使用 object、required=[]、显式 union 根 type 或受支持 pattern |
| 4. 保留工具名别名 | python→python__sub2api,源码同时处理声明和历史引用 | OAuth HTTP、两种 OAuth WS | 普通 lookup 声明完成,API-key 不应用此 OAuth 别名 |
| 5. Lite 工具迁移 | 顶层 namespace 工具搬入 input.additional_tools | HTTP Lite、明确 payload 标记的 WS ctx_pool Lite | 提前放入 input 声明完成,WS passthrough 在冻结前迁移,已测完成 |
| 6. 搜索历史补声明 | 为 web_search_call 补 web_search,Lite 在 input 声明内追加 | HTTP-A Lite、OAuth WS ctx_pool / passthrough Lite | A 保留搜索历史并提前补声明后完成,虚构 HTTP 与 WS passthrough 同类对照完成 |
| 7. system 消息提升 | 从 input 删除 system 文本,或将 role 改为 developer,并复制到 instructions | OAuth HTTP | developer 输入完成,相同 system 输入在已测原生 WS 完成 |
| 8. namespace 清理及摊平 | 删除 input[].namespace,账号开启 flatten 时改历史调用名/namespace | 普通消息 namespace 的 OAuth/API-key HTTP,缺声明的 API-key HTTP 调用项,启用 flatten 的 OAuth HTTP 历史调用 | 无残留字段、API-key 完整 namespace 声明、关闭 flatten 时相应调用完成 |
| 9. 孤立工具结果清理 | 从 input 删除孤立 custom_tool_call_output | OAuth HTTP、两种 OAuth WS | 成对 custom_tool_call + output 完成 |
| 10. 空图片清理 | 删除空 base64 input_image,可能连带删除空消息 | OAuth/API-key HTTP | 非空图片完成,已测原生 WS 对同一空图片输入未应用这一步 |
| 11. 压缩触发项排序 | 将 compaction_trigger 移到 input 末尾 | WS ctx_pool、passthrough、API-key WS | 事先置于末尾完成,HTTP handler 在冻结前处理同一排序,已测完成 |
| 12. 原生压缩旧摘要 | OAuth 账号投影改变时区、reasoning.id 或 summary,压缩检查却继续比较最初 inputDigest | HTTP 原生压缩;HTTP-B 及纯虚构体均复现 | 对齐时区、关闭时区或提前规范 reasoning 元数据后完成;普通 HTTP 使用 nativeInputDigest |
| 13. 生图声明过滤 | strip 策略或 Spark 兼容过滤删除 input.additional_tools 中生图工具,可能删除整个声明项 | OAuth HTTP、WS ctx_pool | allow 策略或无该声明的 Spark 输入完成 |
| 14. 整包数字重编码 | 旧生图参数触发 json.Unmarshal/json.Marshal,input 中 9007199254740993 经 float64 重编码改变 | OAuth WS ctx_pool、passthrough | 改用现代 output_format 参数、或同请求改较小整数后完成;普通 HTTP 同条件完成 |
| 15. API-key 桥接的客户端工具历史适配 | 已配对的 custom_tool_call/output 被改为 function_call/output,input 的类型与参数格式改变 | 含完整占位 agent 历史的 API-key WS→HTTP http_bridge | 同一 custom 历史走直接 HTTP、原生 ctx_pool/passthrough 完成,function pair 桥接及无 agent 的 custom pair 桥接也完成 |
| 16. WS 后续轮主动删 response 指针 | 改 instructions 的严格复用分支或改 window_id 的边界处理删除 previous_response_id,随后原始 source 与发送 payload 的指针比较报 ws_previous_removed | OAuth/API-key WS ctx_pool 第二轮,指针来自刚交付的首轮 | 同控制项两轮、客户端主动无指针完整历史、passthrough 和 API-key http_bridge 相同两轮对照完成 |
| 17. Spark 指令追加 | 409 省略恢复已冻结 instructions,普通 Codex transform 随后追加 Spark 生图限制说明,controls 摘要失配 | 开启 409 省略恢复的 OAuth HTTP,gpt-5.3-codex-spark,无需生图工具声明 | 提前带 Spark 说明标记、关闭省略恢复或使用普通模型基线后完成 |
第 3、9、10 类包含需要兼容处理或明确拒绝的异常输入。它们暴露的是“先修改,再报完整性冲突”的处理顺序,维护者可以选择提前验证并返回对应输入错误。当前这些探针的 409 均在 mock 收到请求之前发生。
精确代码位置
以下均对应 v2.22.0,链接后的行号也用于本地逐行核对。
- HTTP handler 在 899 行准备元数据,1013 行冻结恢复上下文。openai_gateway_handler.go:899
- WS 在兼容构造前冻结账号投影。openai_ws_agent_recovery.go:123
- OAuth 删除内部消息元数据的 map/raw 两个实现。openai_gateway_request_body.go:1313
- WS 规范声明 ID,以及其后的兼容处理总入口。openai_gateway_request_body.go:1531
- HTTP 工具 schema 清理和 Lite 迁移在账号投影之后执行。openai_gateway_forward.go:282
- 工具 schema 的 null、union 和 pattern 清理。openai_responses_tool_schema.go:42
- 工具别名、system 提升与搜索历史补声明。openai_codex_transform.go:274
- HTTP namespace 清理/摊平。openai_responses_namespace.go:173
- HTTP 空图片及孤立结果清理。openai_gateway_forward.go:910
- WS 兼容构造末尾排列 compaction_trigger。openai_gateway_request_body.go:1673
- 普通 HTTP 最终发送采用 nativeInputDigest。openai_agent_message_recovery.go:488
- 原生压缩检查直接使用最初 inputDigest。openai_agent_message_recovery.go:723
- input 内生图声明及整个声明项的删除。openai_codex_transform.go:818
- WS 生图旧参数处理使用 json.Unmarshal 与 json.Marshal。openai_gateway_request_body.go:1651
- WS passthrough 的 Lite 迁移位于 prepareReadable 之前。openai_ws_v2_passthrough_adapter.go:750
已检查的保护边界与剩余范围
PrepareOpenAIAgentReplayBody 对标准 item ID 和部分 reasoning 元数据的规范发生在冻结之前。普通 OAuth HTTP 的账号时区、reasoning.id 和 summary 投影通过 nativeInputDigest 比较。PreserveReadableReplay / PreserveInput 跳过普通 reasoning 内容过滤。对应普通 reasoning、legacy 顶层别名、顶层 metadata 及 effort 参数的对照均完成。
HTTP 的 invalid_encrypted_content 自动剥离、普通 rejected-field 重试及部分 compact fallback 在 preservesHistory 条件下提前返回。WS rejected-field 重试受 OpenAIWSAgentRecoveryCanRetry 控制。显式开启的 400/409 省略恢复另有原始 source 验证、受控投影和独立摘要,应保留这些边界。
WS context-window 边界变动只处理 previous_response_id,涉及指针和连续性检查。带原指针的后续轮、账号切换、并发交付和已知 owner 丢失的完整动态矩阵仍需验收。第二轮已针对其中的指针删除增加动态对照,见第16类,其余跨账号和并发范围仍待专门验收。
新增 301 项的计数为 188 次 mock 完成、94 次本地 409、2 次早期 HTTP400、8 次前置 HTTP503、8 次前置 WS1013、1 次 WS1008。所有本地 409 的 mock 请求数为 0,每次 mock 完成均恰好 1 个请求。原 WS 19 项独立保留,累计记录 320 项。
前置 503/1013 出现在首轮图片能力未配置的测试账号,补上 gpt-image-2 之后再跑 24 项,完成了第 14 类的正反对照。WS1008 探针独立保留。早期 call_namespace_undeclared 的构造器后缀判断误带声明,后续已纠正并验证。早期 WS 仅有握手 Lite header,后续 20 项明确增加 payload Lite 标记,表中 WS Lite 结论来自后者。原始结果保留这些测试差异。
第二轮新增的协议与控制字段证据
第二轮只使用虚构请求和内部假上游,继续运行相同 v2.22.0 官方镜像。三个结果分别涉及 input 摘要、response 连续性指针和 controls 摘要。
第 15 类使用完整配对的 custom 调用和结果。桥接成功的明文对照在假上游呈现 function_call/function_call_output,证实该适配实际改写历史。加上一条占位密文 agent 后,同一桥接变为本地 input_integrity 409。原生 API-key ctx_pool、passthrough 与直接 HTTP 的同一输入均完成。仅 custom 声明、没有历史调用的桥接也完成,因为其变更局限于顶层 tools。
openai_ws_http_bridge.go:523 调用 function 上游适配,responses_client_tools.go:219 修改 custom 历史项。
第 16 类在同一 socket 首轮完整交付后,用刚交付的 response ID 续接。第二轮改变 instructions 时,严格复用分支 会删除指针并重组历史。改变 window_id 时,窗口边界处理 也会删除指针。之后 begin 的检查 对比原始 source,报 ws_previous_removed。纯明文第二轮也复现。保持 window_id、只改其他 client_metadata 的对照完成。
该分支日志同时记录 source_previous_present=true、wire_previous_present=false、before_upstream_write、request_written=false。两轮失败场景的 mock 总数为 1,对应正常首轮,失败的第二轮没有写入 mock。同控制项的两轮总数为 2。
第 17 类在隔离 settings 显式开启 openai_409_omit_encrypted_history_enabled 后复现。可读恢复已将占位 agent 转成普通消息,OAuth 投影 冻结 input 和 controls。后续 Spark transform 调用 applyCodexSparkImageUnsupportedInstructions,追加 instructions,最后在 controls_integrity 检查 本地拒绝。输入不含生图声明,与第 13 类的声明过滤分别验证。
Spark 请求的成功对照只预先加入 <sub2api-codex-spark-image-unsupported> 标记,普通追加逻辑因已存在标记而保持幂等。省略恢复关闭时相同原请求也完成,普通模型的省略恢复基线完成。此次该开关仅在隔离实例切换。
另将原 第 6 类扩展到非 Lite 的普通 HTTP 可读恢复。该路径会补顶层 web_search 工具声明,input 不变而 controls 改变,触发 controls_integrity。预先声明 web_search 后完成。由于触发函数仍为搜索历史补声明,此处继续归第 6 类。
| 第二轮对照 | 结果 | mock 请求数 |
|---|---|---|
| API-key http_bridge,custom pair + 占位 agent | input_integrity 409 | 0 |
| 同一 custom pair + 占位 agent,直接 HTTP / 原生 ctx_pool / passthrough | 完成 | 各 1 |
| API-key http_bridge,同一 custom pair 仅无占位 agent | 完成,接收类型为 function pair | 1 |
| OAuth/API-key ctx_pool,首轮完成后第二轮改 instructions / window_id,带刚交付指针 | 第二轮 ws_previous_removed 409 | 每场景总计 1,仅首轮 |
| 相同两轮,控制项不变 | 两轮完成 | 2 |
| 第二轮由客户端直接提供无指针完整历史 | 两轮完成 | 2 |
| Spark HTTP,409 省略恢复开启,未预先带说明标记 | controls_integrity 409 | 0 |
| 同一 Spark 输入,提前带说明标记 | 完成 | 1 |
| 同一 Spark 原输入,409 省略恢复关闭 | 完成 | 1 |
| 非 Lite HTTP 的搜索历史,409 省略恢复开启,未预先补声明 | controls_integrity 409 | 0 |
| 相同搜索历史,预先补声明 | 完成 | 1 |
第二轮共 118 个场景,176 个客户端回合,147 个回合到达 mock 并完成,29 个回合本地 409。29 个拒绝回合包含已知处理点的再对照。场景中有连续两轮,计数口径按场景和回合分别给出。
测试封装的一次 bootstrap 定位错误发生在探针前,排除在计数外。最终32项的全部结果已保存后,封装重复停止隔离 app 导致日志读取报错,随后按完整 partial 文件核对32项并恢复报告、清理夹具。中间轮最初的 stdout/stderr 行数切分会混入旧场景日志,最终轮改用 Docker 时间戳边界,三个新增处理点均已重新关联诊断。前两轮结果只用于请求状态和 mock 计数。
如果选择继续保留严格模式,其修复范围需要覆盖客户端工具适配、后续轮指针处理与source检查的一致性,以及冻结后追加instructions的分支,并保留该模式的独立负例。此次可复制示例和完成结果均对应 mock,原客户端任务仍待真实供应商验收。
修复与回归要求
保留严格模式时,应为每种账号/传输从不可变原始 source 生成一份允许的兼容投影,将相关 input、密文 agent 外壳、声明/引用、工具证明和最终发送检查使用的规范保持一致。需要丢弃或改写含义不明的输入时,应在冻结前明确验证并报告对应错误。
保留严格模式时,原生压缩应核对已验证账号投影的摘要,并继续校验原始归属、完整密文项与交付记录。所有从源码发现的整包重建都应保留 JSON Number 表示,特别是此处旧生图参数的 json.Unmarshal 路径。严格模式的最终摘要应校验真实发送字节,期望值须独立于最终body推导。
回归需要包括上述每类的独立变量和叠加场景,确认正常转换完成后真正发出一次请求并交付终态。严格模式应继续覆盖其声明要保护的密文、工具结果、目录或引用的负例,以及owner/交付未知状态。兼容模式按其明确声明的旧版语义验收。私有业务采集的输出只用于结构对照,真实供应商和原客户端任务仍需后续验收。
用户已接受的备选方案 · v2.20.0 兼容模式
用户已经明确接受取消该完整性检查作为备选方案。维护者可以在严格投影难以修复时,为现有 owner-binding opt-out 或独立的管理员兼容选项提供 v2.20.0 式转发语义。
已对照官方 v2.20.0 源码。旧版没有 WithOpenAIAgentMessageRecovery、prepareOpenAIAgentRecoveryAttempt、openAIAgentRecoveryInputDigest 或 encrypted_agent_recovery_wire_changed 这条新增链路。v2.22.0 的 opt-out=true 仍因 preservesHistory() 进入整份 input 冻结,因而与旧版转发行为存在差异。
可评审的兼容目标如下。
- 管理员显式选择兼容模式时,取消新增的 inputDigest/nativeInputDigest 和 controlsDigest 冻结等值拒绝,以及为这套摘要检查建立的前后投影状态,允许原有兼容构造按旧版规则工作。
- 将 HTTP、WS ctx_pool/passthrough/http_bridge、原生压缩和后续轮统一纳入开关范围。逐点删除某个409返回后,仍需核对 preservesHistory、bound/no-replay 等附带判断是否继续改变普通转发与换号,具体恢复范围按v2.20.0对照决定。
- 普通鉴权、Key/分组/模型准入、额度、计费及旧版原有协议处理继续沿用。账号切换按旧版原有条件执行。
- 对完整历史,由正常账号池选择可用账号发送,并保留上游实际返回的结果或错误。previous_response_id 的续接处理按旧版对应路径验收,上游私有状态的可用性仍由实际协议决定。
- 显式开启的400/409省略功能应声明其与兼容模式的交互和优先级,并核对其独立controls摘要是否仍会造成同类本地拒绝。
兼容方案应以官方v2.20.0为行为基线。回归包含本报告17类触发输入、连续两轮、普通换号与正常计费,确认这些用例不再因已取消的新增等值检查而本地拒绝。这里提出的是候选实现方向,本报告现有测试只验证原版故障与成功对照,候选实现需要另行验证。
Agent 名称与参与范围
OpenAI Codex主Agent:真实采集结构与日志关联分析、同官方镜像19项内部假上游对照、代码核对和草稿撰写;未修改生产、未调用真实模型或执行历史工具。
子Agent ws_409_audit:只读核对其他WS输入转换风险。
子Agent recovery_409_inventory:只读核对正常409保护边界。
子Agent issue_draft_review:只读复核既有证据范围与隐私边界;最终草稿追加复核未完成。
三个子Agent未参与19项动态测试、未操作生产、未发布Issue。
本次 HTTP 采集及冻结后改写增补由同一 Codex 主会话执行,包括只读日志关联、同镜像 301 项隔离对照、源码检查和正文更新。本次增补没有新增子 Agent。
第二轮补充由同一 Codex 主会话执行,范围为桥接/后续轮/控制字段源码审查、118个场景的隔离对照和正文增补。
模型名称
主Agent:gpt-6.1-sol,用户已明确确认本次配置。
子Agent ws_409_audit、recovery_409_inventory、issue_draft_review:继承主会话配置,未另行读取各自运行时模型元数据。
业务请求中的gpt-6.1-sol为被诊断模型,以上辅助Agent披露来自用户确认,未从业务model字段推断。
本次后续运行上下文曾切换为 gpt-6.2-sol,之后回到 gpt-6.1-sol。此处按实际可见运行上下文披露,原 19 项及历史子 Agent 的信息保留上文当时核验范围。
第二轮可见运行上下文还出现 gpt-6.2-astra,后续回到 gpt-6.1-sol。各阶段按工具日志和可见上下文披露。
推理强度
主Agent:max,用户已明确确认本次配置。
上述三个子Agent继承主会话设置,未另行读取各自运行时推理配置。
本次增补阶段未独立读取运行时推理配置,填未知。上文 max 是原阶段的用户确认值。
Activity
[-][Bug] v2.22.0 WS 在冻结 input 后规范化 additional_tools.id,触发本地 wire_changed 409[/-][+][Bug] v2.22.0 冻结后兼容改写与完整性校验冲突,影响 HTTP、WS、Lite 和原生压缩[/+][-][Bug] v2.22.0 冻结后兼容改写与完整性校验冲突,影响 HTTP、WS、Lite 和原生压缩[/-][+][Bug] v2.22.0 冻结后兼容改写与完整性校验冲突,影响 HTTP、WS、Lite 和原生压缩(附旧版兼容方案)[/+]ranxi2001 commentedon Nov 18, 2026
维护只读对账:#934 已由其他负责人合并(270ae1710353371552dd9f11be0dc3374de4bc9d),本轮没有合并或部署。新增显式旧版兼容模式在固定production 45ebcb7 的独立静态审查为限域SOURCE CLEAR:HTTP、OAuth/API-key WS三模式及后续轮、Lite/原生压缩的新增冻结管理器均有实际入口控制,默认严格模式没有全面修复,整包大整数重编码是独立实修。
继续保留本Issue,不能把取消完整性门禁等同真实续接成功:当前复用mock基本固定返回completed,历史custom pair不等于新call→原客户端执行→结果提交→下一终态;现有换号测试只验证尝试A/B并预期最终失败,没有B成功续答。尚缺官方v2.20.0同输入运行对照、原17类若干子分支完整候选矩阵(非Lite搜索、namespace flatten/引用、reasoning压缩、一般strip/WS生图、大整数最终WS wire)及原客户端原会话工具循环证据。
兼容模式明确不提供新增owner/交付/no-replay保证;这是其明示取舍,不能继续宣称拥有严格模式去重保护。本轮仅源码审查,未运行本机动态/真实供应商或修改生产,不以作者自报CI替代本轮原始日志。Agent:Hermes独立子Agent gpt-6.1-sol/推理强度未知(只读审查);父级Hermes gpt-6.1-sol/强度未知(证据整理与GitHub回读)。