[Bug] 思考模式 max 下请求体静默从 Responses 回落为 Chat Completions 且回传空 reasoning_content，网关 400 reasoning_text（retryable=false，整轮失败）

[wezhouji1-art]

类型 / Type

Bug（偶发 / intermittent）。思考模式（thought level = max）下，会话中途请求体从 Responses 形态静默回落到 Chat Completions 形态，且历史助手消息携带空字符串 reasoning_content，被网关以 400 拒收，整轮失败且不可重试。

环境 / Environment

• 系统：Windows 10 x64 10.0.19045；ZCode 桌面端 v3.11.2（user-agent: ZCode/3.11.2，x-zcode-app-version: 3.11.2，x-title: Z Code@electron，production 通道）
• Provider：自定义 OpenAI 兼容（providerKind: openai），baseURL https://api.bankofai.io/v1（one-api / new-api 类中转网关），声明 apiFormat: openai-responses，paths.openai = /responses
• 模型：deepseek-v4.1-flash；思考档位 max（thinking: {type: enabled}、reasoningEffort: max）
• 会话形态：主链会话（x-zcode-session-type: main），querySource: main_turn，工具调用密集的长任务（该轮请求体 50 条消息 / 25 次 tool-call）

现象 / Symptom

界面弹出错误：「Turn execution failed / provider_code=invalid_request_error / model=deepseek-v4.1-flash / status=400 / retryable=false」，完整报文为：

The `reasoning_text` in the thinking mode must be passed back to the API.

• TraceID：00f83c03-746e-4528-94d0-ec966278e581
• 客户端 requestId：cccf80b9-ea16-47a7-bc5b-471bd81818ca
• 网关侧 request-id（响应头 x-oneapi-request-id）：20260916144416867069803c955d568e70zkCcj
• 日志定位：~/.zcode/cli/log/zcode-2026-09-16.jsonl 事件 model.request.failed / model.network.failed（reason: invalid_request, retryable: false, canRetry: false, statusCode: 400）→ turn.failed

关键证据：请求体形态在会话中途被切换 / Evidence

对比留存于 ~/.zcode/cli/rollout/model-io-*.jsonl 的请求记录（本地时间 2026-09-16 22:43–22:44，UTC 14:43–14:44）：

记录	时间 (UTC)	body 形态	结果
前一条	14:43:44	input（Responses）	200 成功
失败条	14:44:15	messages（Chat Completions）	400 失败
后一条	14:45:29	input（Responses）	200 成功

该会话全部请求记录中，唯一一次 Chat Completions 形态的请求就是失败这一条；同一时段另两个并行会话（共 90 条请求记录）全部为 Responses 形态、零失败。当天全部请求记录合计 139 条，Chat Completions 形态仅此 1 条。

失败请求体的关键特征（同时具备三处异常）：

1. 顶层字段从 Responses 的 input 变成 Chat Completions 的 messages；
2. 全部 18 条历史助手消息都被写入 providerOptions.openaiCompatible.reasoning_content = ""（空字符串，一条不落）；
3. 请求体附带 bodySource: "ai_sdk_options"、experimental_include: {requestBody: true, responseBody: true}、stream: true —— 正常请求都不带这些字段。

"messages": [
  ...,
  { "role": "assistant",
    "content": [ { "type": "text", "text": "..." },
                 { "type": "tool-call", "toolCallId": "call_00_...", "toolName": "Read", "input": {...} } ],
    "providerOptions": { "openaiCompatible": { "reasoning_content": "" } } }   <-- 空串，18 条全部如此
]

对比正常（Responses）请求体：顶层为 input 数组，助手消息以 function_call / function_call_output 条目承载，完全不出现 reasoning 类字段（既不回传、也不送空串）。

排除项 / What it is NOT

• 不是模型或账号问题：同一 provider、同一模型、同一档位的前后请求均 200 成功。
• 不是网关故障：同一网关在失败前 30 秒与失败后 70 秒均正常返回；网关这次是正确地拒绝了不合规请求体（思考模式下必须回传思考内容）。
• 不是请求体超限（区别于已知的 >1MB 400 案例）：本次请求体 50 条消息，远未触及上限。
• 不是 CASE-09 那类 SSE 瞬断：本次 reason 是 invalid_request、retryable: false，客户端没有自动重试（retryReason: network_error 但 canRetry: false），失败是确定性的，不是等自愈型。

期望行为 / Expected

1. 会话中途不应无提示地在 Responses 与 Chat Completions 两种报文形态之间切换；若确有回退逻辑，应有显性日志/告警，并保证切换后报文仍然合规。
2. 走 Chat Completions 形态且处于思考模式时，历史助手消息应真实回传其思考内容；若客户端拿不到思考内容，应整个省略 reasoning_content 字段，而不是送空字符串——空串在网关看来正是"该带的没带"，必然 400。
3. 若配置的 apiFormat（openai-responses）与实际发出的报文形态不一致，UI/日志应提示，而不是静默发出。

实际行为 / Actual

报文形态静默回退为 Chat Completions，历史助手消息的 reasoning_content 全为空串，网关 400 且标记不可重试 → 整个回合直接失败。用户只能看到一句报错，无从判断原因；重发一条消息（新回合）后即恢复正常（本机实测：14:45 续问，后续 20+ 次请求全部 200）。

重现步骤 / Repro（偶现，尽力描述）

1. 配置自定义 OpenAI 兼容 provider（baseURL 指向网关，模型为 deepseek 类），思考档位置 max；
2. 在一个工具调用密集的长会话中持续推进（本机触发时该回合已累计 25 次 tool-call、上下文 50 条消息）；
3. 观察 ~/.zcode/cli/rollout/model-io-*.jsonl：偶发某一次请求的 body 从 input 变为 messages，助手消息带 reasoning_content: ""；
4. 该请求必然被网关以 400 reasoning_text ... must be passed back 拒绝，回合失败。

影响 / Impact

单次发生即导致整轮对话作废（不可重试），长任务需手动重发；由于报文形态切换无任何用户可见线索，极易误判为网关/账号故障。期望至少做到"回退后仍合规"或"送空串改为省略字段"。

相关 / Related

• 与 [Bug] v3.12.1 custom openai-compatible provider (OpenCode Go): reasoning enabled builds Anthropic-format request with thinking field → 400 invalid_request #629（思考开启时把 openai-compatible provider 的请求错建成 Anthropic 形态 → 400）属同一族：思考模式 × 报文形态不匹配导致 400，但触发路径不同（[Bug] v3.12.1 custom openai-compatible provider (OpenCode Go): reasoning enabled builds Anthropic-format request with thinking field → 400 invalid_request #629 是错建成 Anthropic，本条是从 Responses 回落到 Chat Completions 并送空思考字段）。
• 与 [Bug] v3.8.1: Thought-level changes silently discarded after first selection (stale_runtime_refresh_ignored) + reasoning_effort never sent for custom OpenAI-compatible providers #339 / [Bug] 自定义 OpenAI-Compatible 模型的思考档位从不发送 reasoning_effort：档位→协议参数映射仅按模型家旭白名单合成，非白名单模型（grok/自建模型）被静默丢弃 #389 / [Bug] 思考档位对 grok 这类自定义模型是摆设，请求里根本没带 reasoning_effort #507 / [Bug] Reasoning effort never sent on the wire for custom OpenAI-compatible providers #594（自定义 provider 的思考档位参数处理问题）可能同源，供参考。

[github-actions]

👋 感谢你的反馈，我们已经收到。

• 维护者看到后会尽快回复你。
• 状态保持为 status: 待评估，你可以随时补充信息。
• 信息不全时我们会打上 needs: 更多信息 标签并 @ 你。

---

👋 Thanks — we've received your issue.

• A maintainer will get back to you as soon as we can.
• Status stays at status: 待评估 (Triage); feel free to add context.
• If we need more details, we'll add needs: 更多信息 and ping you.

[wezhouji1-art]

追加：同一机理在本机第二次复现（独立会话，2026-09-16）

首次报告后 约 33 分钟，在另一个独立会话中同样的问题再次出现，机理与首次完全一致，可作为复现证据补充。

第二次环境 / Second occurrence

• 会话：sess_7a16b335-a2d9-478b-a719-3b97480a896c（标题即 "ZCode reasoning_text API 报错 400"，工作区 C:\Users\wei\.zcode\workspace\default）
• 时间：请求发出 2026-09-16T15:16:59Z，失败于 15:17:03.897Z（UTC；北京时间 23:16–23:17）
• TraceID：d7ee127e-2f21-4c63-81b8-b09813bc4afb
• 请求 requestId：795b06f4-78ae-4641-b22a-344c1a58dc8c
• 报文：The \reasoning_text` in the thinking mode must be passed back to the API.（400，retryable: false，canRetry: false）→ turn.failed`

与首次相同的三处特征 / Identical signature

该会话留存 47 条请求记录，其中 唯一 一次 Chat Completions 形态的请求就是失败这一次：

记录	时间 (UTC)	body 形态	结果
前一条 (rec 44)	15:16:46	input（Responses）	200
失败条 (rec 45)	15:16:59	messages（Chat Completions）	400
后一条 (rec 46)	15:19:42	input（Responses）	200

失败请求体特征（相对正常请求的差异项，两次完全吻合）：

1. 顶层 input → messages；
2. bodySource: "ai_sdk_options"（正常请求此字段为 null）；
3. experimental_include: {requestBody: true, responseBody: true} + stream: true（正常请求均不带）；
4. 43 条历史助手消息中，42 条被写入 providerOptions.openaiCompatible.reasoning_content = ""（空字符串），1 条缺该字段；
5. 请求规模：119 条消息 / 64 次 tool-call（首次为 50 条 / 25 次）。

两次事件的共同点 / Common pattern

• 均为 主链会话（x-zcode-session-type: main，querySource: main_turn），处于工具调用密集的长回合中；
• 失败前的请求体规模分别达 50 条 与 119 条 消息；
• 失败请求前一条与后一条均为正常的 Responses 形态且成功；
• 失败后下一个回合即恢复（本机两次实测均如此）。

结论

两次独立复现指向同一客户端缺陷：思考模式（max）下，长会话某次请求体被静默切换为 Chat Completions 形态，且历史助手消息的思考内容以空字符串回传，被网关正确拒收（400、不可重试），整轮失败。建议优先核查：

1. 会话中途 Responses → Chat Completions 形态回退的触发条件（是否与上下文长度/消息数/某种重试路径相关）；
2. bodySource: "ai_sdk_options" 路径为何与主链请求形态不一致；
3. 思考模式下无法取得思考内容时，应 省略 reasoning_content 字段而非送空串。