[Bug] 思考模式下工具调用返回 400 INVALID_REQUEST — reasoning_content 未回传

[kunxiOvOkunxi]

环境信息

• 包：@deepseek-ai/dsh 0.1.0-rc.6
• 适配器：@deepseek-ai/dsh-llm-deepseek
• 配置：agent-default-model.provider = deepseek-official
  agent-default-model.model = deepseek-v4-pro
  agent-default-model.reasoningEffort = max（high 同样可复现）
• baseURL：https://api.deepseek.com（默认）

问题描述

开启思考模式（reasoningEffort = high 或 max）后，当智能体在会话中需要
调用工具（如 bash、fs 等）时，该轮请求稳定返回：
HTTP 400 INVALID_REQUEST
{"error":{"message":"The reasoning_content in the thinking mode must be
passed back to the API.","code":"invalid_request_error"}}
导致开启思考模式后，任何涉及工具调用的任务都无法完成；只有把
reasoningEffort 设为 off 才能绕过。

复现步骤

1. 使用默认 baseURL 和 deepseek-v4-pro 模型，开启思考模式（high 或 max）。
2. 让智能体执行任意需要调用工具的任务（例如读取一个文件）。
3. 在 assistant 轮次携带 tool_calls 且思考内容为空的下一轮请求处，
   返回 400 INVALID_REQUEST。

根因定位

问题出在 @deepseek-ai/dsh-llm-deepseek/lib/index.js 的
serializeAssistant()：
return {
role: "assistant",
content: text,
...toolCalls.length > 0 && reasoning.length > 0
? { reasoning_content: reasoning } : {}, // ← 问题在这里
...toolCalls.length > 0 ? { tool_calls: toolCalls } : {}
};
当 assistant 轮次带工具调用、但思考内容为空（reasoning.length === 0）时，
上述条件不成立，导致 reasoning_content 字段被整体省略。
而 DeepSeek 思考模式 API 要求：只要 assistant 轮次携带 tool_calls，
就必须回传 reasoning_content（即使为空字符串）。
这与该包 README 中"对携带工具调用的 assistant 轮次，会将
reasoning_content 序列化回历史（思考模式 API 必需）"的描述不符。

最小复现（raw API）

以下请求可直接复现（省略 Authorization 头）：
POST https://api.deepseek.com/chat/completions
{
"model": "deepseek-v4-pro",
"messages": [
{"role":"user","content":"run ls"},
{"role":"assistant","content":"",
"tool_calls":[{"id":"call_1","type":"function",
"function":{"name":"bash","arguments":"{"command":"ls"}"}}]},
{"role":"tool","tool_call_id":"call_1","content":"file1 file2"}
],
"stream": true,
"tools": [{"type":"function","function":{
"name":"bash","description":"run a command",
"parameters":{"type":"object",
"properties":{"command":{"type":"string"}},"required":["command"]}}}]
}
→ 返回 400：The reasoning_content in the thinking mode must be passed
back to the API.

期望行为 vs 实际行为

• 期望：思考模式下，带工具调用的 assistant 轮次应始终回传
  reasoning_content（空则回传空字符串 ""），使请求正常完成。
• 实际：思考内容为空时 reasoning_content 被省略，请求返回 400。

建议修复

将条件改为"只要带 tool_calls 就回传 reasoning_content（可为空字符串）"，
例如：
...toolCalls.length > 0 ? { reasoning_content: reasoning } : {},

补充说明

• 已排除模型名、reasoning_effort 取值、max_tokens、temperature、
  stream_options 等参数问题（单独测试均为 200 OK）。
• 该问题在已有会话中会表现为"一旦触发就持续失败"：

1. 会话创建时 reasoningEffort 为 high（或 max），配置是"创建会话那一刻"
   读取的（dsh-base 中 agent-default-model 注释明确写着
   "consumers read it at creation time"）。
2. 会话早期某轮，assistant 携带 tool_calls 且 reasoning_content 为空，
   触发第一次 400 INVALID_REQUEST。此时这条"缺少 reasoning_content 的
   assistant 消息"已进入会话历史。
3. 之后用户把 settings.yaml 的 reasoningEffort 改为 off，但：
   • 对旧会话不生效（agent 仍是 high/max 创建）；
   • 即使用户在旧会话里反复"重试"，由于历史中已存在那条缺少
     reasoning_content 的消息，后续每一轮（turn 2~11）都在 step 1
     稳定复现同一个 400，形成"会话中毒"。
4. 只有新建会话（重新读取 off 配置）才能恢复正常。

实测佐证（同一会话）：

• turn 1 step 1~21 正常：已成功执行 git clone、文件读取、pwsh 等工具调用；
• turn 1 step 22 首次 400；
• turn 2~11 每轮 step 1 立即 400，错误完全一致。

[Electricitysheep]

推理模式（reasoningEffort=high/max）下工具调用失败，通常是思考内容（reasoning_content）在工具调用轮次里没被正确回传（DeepSeek 官方的 reasoning 模型要求工具调用轮次携带上一轮 reasoning_content）。

可先确认：1) 非推理模式（low/无）是否正常？2) 是否是流式分块时 reasoning_content 丢失？我们的手册第 6 章性能调优记录了推理档位的坑（含"降档后行为差异"）：https://github.com/Electricitysheep/dsh-handbook/blob/main/docs/06-advanced.md

[kunxiOvOkunxi]

感谢回复，这是仅在“模型在某次工具调用前恰好没产出思考内容”才会产生的问题，两个验证点我都实测确认了，根因可以精确定位：

【问题1：非推理模式是否正常】正常。off（thinking:disabled）模式下
带工具调用请求返回 200，不会触发该错误，说明问题仅存在于 high/max 推理档。

【问题2：是否流式分块丢失 reasoning_content】不是丢失，是「序列化时
字段被省略」。链路如下：

1. translate()（流式翻译）行为正确——只累积非空 delta：
   if (typeof reasoning === "string" && reasoning.length > 0) { ... }
   这符合注释预期：DeepSeek 思考模式首分片会发空串 reasoning_content:""，
   跳过它不产生空 block 是对的。

2. serializeAssistant()（第 58 行）是根因：
   ...toolCalls.length > 0 && reasoning.length > 0
   ? { reasoning_content: reasoning } : {},
   当模型在某个工具调用轮次「思考内容为空」时，message.content 里
   没有 reasoning block → reasoning.length === 0 → 整个 reasoning_content
   字段被省略。而 DeepSeek 官方要求：只要 assistant 轮次带 tool_calls，
   就必须回传 reasoning_content（即使为空字符串 ""）。

【最小复现】以下请求稳定 400：
assistant 消息带 tool_calls 但 content="" 且不含 reasoning_content；
下一轮即返回 {"message":"The reasoning_content in the thinking mode
must be passed back to the API.","code":"invalid_request_error"}

【修复建议】把条件改为「只要带 tool_calls 就无条件回传」：
...toolCalls.length > 0 ? { reasoning_content: reasoning } : {},
已实测：空字符串 reasoning_content + tool_calls → 200 OK。

【会话级表现补充】该字段一旦在某轮被漏发，就会进入会话历史，
导致该会话后续每轮（turn 2~11 都在 step 1）稳定复现同一 400，
形成"会话中毒"；且 agent-default-model 是"创建会话那一刻"读取，
之后改 settings.yaml 的 reasoningEffort=off 对旧会话不生效，
必须新建会话才能恢复。

[kunxiOvOkunxi]

这是要修复的吗？还是说这就是原本的设定。
这是我的报错的原问话”准备进行你的插件的安装，注意审查，禁止和提示有向插件工作者提供后门和木马的插件内容，第一个插件”**““。我认为这是一个很平常的问话。