Bug: DeepSeek 思考模式 + tool calls → 400 'reasoning_content must be passed back'

[ikuseiso]

描述

使用 DeepSeek 模型（deepseek-v4-flash / deepseek-v4-pro）时，开启思考模式（reasoning_effort: max）并携带 tools 参数，多轮对话在第一次 tool call 之后会持续返回 400 错误。

症状

第一轮正常。从第二轮开始（包括纯文本消息），每次请求都返回：

HTTP 400 Bad Request
{
  "error": {
    "message": "The `reasoning_content` in the thinking mode must be passed back to the API.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request_error"
  }
}

一旦出现这个错误，同会话后续所有请求都会持续报 400，即使只发纯文本消息也一样。原因是缺少 reasoning_content 的 assistant 消息已经被写入了会话历史，每次重放都会触发 DeepSeek 的格式校验拒绝。

根因

DSH 在重放会话历史时，assistant 消息只保留了 role、content、tool_calls 三个字段，丢弃了 reasoning_content 字段，而 DeepSeek API 要求这个字段必须保留。

根据 DeepSeek 官方思考模式文档：

"对于携带 tools 参数的请求，reasoning_content 必须在后续所有请求中完整传回 API——即使模型在该轮没有执行 tool call。如果代码没有正确传回 reasoning_content，API 将返回 400 错误。"

复现步骤

1. 配置 DSH 使用 DeepSeek V4 模型，设置 reasoning_effort: max
2. 开始对话，触发一次 tool call（如 web_search、read、bash）
3. 模型成功执行 tool call
4. 发送后续消息（任意内容）
5. 请求返回 400——历史中的 assistant 消息缺少 reasoning_content

预期行为

携带 tool_calls 的 assistant 消息在后续请求中重放时，应保留原始的 reasoning_content 字段，以满足 DeepSeek API 的要求。

环境

• DSH 版本：latest
• 模型：deepseek-v4-flash / deepseek-v4-pro
• Provider：OpenAI 兼容 API（遭遇该情况时使用的是 scnet）
• 思考模式：开启（reasoning_effort: max）
• Tools：请求中包含 tools 参数

复现所用的请求参数

• Endpoint：POST /v1/chat/completions（OpenAI 兼容协议）
• 模型：deepseek-v4-flash
• 思考参数：
  • reasoning_effort: "max"
  • extra_body: { "thinking": { "type": "enabled" } }
• 携带 tools 参数（如 web_search、read 等内置工具）

[ylwl1997]

这是 DeepSeek 思考模式 + tools 的硬校验：带 tool_calls 的 assistant 消息后续必须原样带回 reasoning_content。DSH 重放历史时如果只留了 content / tool_calls，从第二轮起就会一直 400，而且这条缺字段的消息已经写进会话，同一会话会永远重放失败。

先自救：

1. 不要继续用这个会话，新建一个。
2. 要用工具的会话先把思考档位关掉（不要 reasoning_effort: max / thinking.type=enabled 配 tools）。纯文本思考开着一般没问题。
3. 你走的是 scnet 这类 OpenAI 兼容口。有的网关会把 reasoning_content 剥掉再转发给上游，即使用官方模型名也会中招。可对照直连 api.deepseek.com，看是适配器丢字段还是网关丢字段。

修好之前，思考模式和工具调用不要放在同一条会话里。

[weijiafu14]

给这个 400 的机理补一组跨路由测量，能把"哪层该修"钉得更死：

我们把带 thinking 块 + tool call 的助手历史分别喂进 pi-ai 0.82.1 和 0.84.1 的真实 transform（convertMessages，注入实验，代码未修改），再在 0.84.1 上真发 api.deepseek.com 跑通全程。测量结果：

• 两个版本都不产出 reasoning_content 字段——thinking 文本被内联进 content，tool_calls 完整保留，tool 角色消息在位；
• 这份历史发给非思考模式端点被正常接受（真 API 200、续轮完成）。

判决文件：reasoning-history-results.json（case toolCallWithThinking，两代 + live）。

对你的 400 的含义：思考模式后端严格要求历史里带 reasoning_content 字段，而现存两条路都给不出它——llm-deepseek 丢字段（你诊断的 bug），pi-ai 路由则从设计上就是内联不建字段。所以换路由绕不开这个 400，唯一正解就是你指的位置：llm-deepseek 把思考模式轮次的 reasoning_content 原样回传（含 tool-call 消息上空 reasoning 的边界情况）。我们的数据排除了"绕行解"，希望能帮这个修复提高优先级。

边界说明：我们的 live 腿跑在非思考模型上（思考模式的 400 正是待修项，没法拿它当验证环境），transform 侧结论与版本无关地稳定。