[Bug] DeepSeek 模型（thinking mode）因未保存/回传 reasoning_content 字段导致 API 请求失败（400）

[Hola-Gracias]

What happened / 发生了什么

在使用支持“思考模式”（thinking mode）的 DeepSeek 模型（如 deepseek-v4-flash）时，AstrBot 发送多轮对话请求会收到 API 返回的 400 Bad Request 错误，错误信息为：
The 'reasoning_content' in the thinking mode must be passed back to the API.

经分析，原因是 DeepSeek 要求助手消息中若包含 reasoning_content 字段（模型输出的一部分），后续请求构建消息历史时必须原样回传该字段，而 AstrBot 未保存和回传该字段，导致 API 校验失败。

Reproduce / 如何复现？

1. 在 AstrBot 中配置 DeepSeek 模型，且模型启用思考模式。

2. 与机器人进行多轮对话，至少一轮后助手返回了包含 reasoning_content 的响应。

3. 继续进行下一轮对话，AstrBot 将之前的助手消息（仅包含 content 和可能的 tool_calls）发送给 DeepSeek API。

4. 收到 HTTP 400 错误，错误信息指明缺少 reasoning_content 的回传。

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

AstrBot 版本：v4.23.5

部署方式：源码运行

Python 版本：3.12

模型提供商：DeepSeek

模型名称：deepseek-v4-flash

消息平台适配器：Telegram

OS

Linux

Logs / 报错日志

[2026-04-25 19:29:38.352] [Core] [WARN] [v4.23.5] [runners.tool_loop_agent_runner:555]: Chat Model deepseek/deepseek-v4-flash request error: Error code: 400 - {'error': {'message': 'The reasoning_content in the thinking mode must be passed back to the API.', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_request_error'}}
Traceback (most recent call last):
File "/home/hola/AstrBot/astrbot/core/agent/runners/tool_loop_agent_runner.py", line 510, in _iter_llm_responses_with_fallback
async for attempt in retrying:
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/tenacity/asyncio/init.py", line 170, in anext
do = await self.iter(retry_state=self._retry_state)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/tenacity/asyncio/init.py", line 157, in iter
result = await action(retry_state)
^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/tenacity/_utils.py", line 111, in inner
return call(*args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/tenacity/init.py", line 393, in
self._add_action_func(lambda rs: rs.outcome.result())
^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3.12/concurrent/futures/_base.py", line 449, in result
return self.__get_result()
^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3.12/concurrent/futures/_base.py", line 401, in __get_result
raise self._exception
File "/home/hola/AstrBot/astrbot/core/agent/runners/tool_loop_agent_runner.py", line 514, in _iter_llm_responses_with_fallback
async for resp in self._iter_llm_responses(
File "/home/hola/AstrBot/astrbot/core/agent/runners/tool_loop_agent_runner.py", line 477, in _iter_llm_responses
yield await self.provider.text_chat(**payload)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/astrbot/core/provider/sources/openai_source.py", line 1165, in text_chat
) = await self._handle_api_error(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/astrbot/core/provider/sources/openai_source.py", line 1111, in _handle_api_error
raise e
File "/home/hola/AstrBot/astrbot/core/provider/sources/openai_source.py", line 1153, in text_chat
llm_response = await self._query(payloads, func_tool)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/astrbot/core/provider/sources/openai_source.py", line 572, in _query
completion = await self.client.chat.completions.create(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/openai/resources/chat/completions/completions.py", line 2714, in create
return await self._post(
^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/openai/_base_client.py", line 1884, in post
return await self.request(cast_to, opts, stream=stream, stream_cls=stream_cls)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/hola/AstrBot/.venv/lib/python3.12/site-packages/openai/_base_client.py", line 1669, in request
raise self._make_status_error_from_response(err.response) from None
openai.BadRequestError: Error code: 400 - {'error': {'message': 'The reasoning_content in the thinking mode must be passed back to the API.', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_request_error'}}

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

这个问题已经有人在 #7782 中报告了，是同一个 bug。

根本原因：Message 类中没有 reasoning_content 字段 [1]，导致 DeepSeek 返回的推理内容虽然会被提取到 LLMResponse 中 [2]，但在构建后续请求的消息历史时会丢失，因为 model_dump() 序列化只保留已定义的字段。

修复进展：PR #7759 已经提交来修复此问题（保留 reasoning_content 到对话历史、流式响应累积推理内容等），但目前尚未合并 [3]。

另外你在 #7782 中提到怀疑 astrbot_plugin_livingmemory 的 fake_tool_call 模式也有相关问题——如果插件也在构造 assistant 消息时没有回传 reasoning_content，即使主体修复了也可能依然触发此错误。如果你提交 PR，建议也关注 Message 类是否需要新增 reasoning_content 字段来从根本上支持持久化。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[lq-259]

我把你的pr扔给ai自己修，ai修了之后的结果:
如果其他这轮对话fallback到其他模型调用tool后切换回deepseekv4还是会报这个问题，ai给的解释是其他模型的assistant和tool不兼容污染上下文依然会报错，ai给的方法是过滤掉其他模型莫兼容的assistant和tool

[Hola-Gracias]

我把你的pr扔给ai自己修，ai修了之后的结果: 如果其他这轮对话fallback到其他模型调用tool后切换回deepseekv4还是会报这个问题，ai给的解释是其他模型的assistant和tool不兼容污染上下文依然会报错，ai给的方法是过滤掉其他模型莫兼容的assistant和tool

我给给非 DeepSeek assistant 补一个空字段，避免 DeepSeek 在 thinking mode 下因为字段缺失直接 400。同时修改了一下过滤条件。

我问ai的更稳妥的方案是给 assistant message 增加内部来源标记，例如 _provider_id / _model / _reasoning_required，保存时记录但发送前移除。这样可以区分：

• DeepSeek 生成的 assistant：必须保留真实 reasoning_content
• 其他模型生成的 assistant：切回 DeepSeek 时补空 reasoning_content
• 不接受 reasoning 字段的 provider：发送前剥离

但这会牵涉历史 schema 和更多 provider sanitizer，不是最小修复。

[lq-259]

我把你的pr扔给ai自己修，ai修了之后的结果: 如果其他这轮对话fallback到其他模型调用tool后切换回deepseekv4还是会报这个问题，ai给的解释是其他模型的assistant和tool不兼容污染上下文依然会报错，ai给的方法是过滤掉其他模型莫兼容的assistant和tool

我给给非 DeepSeek assistant 补一个空字段，避免 DeepSeek 在 thinking mode 下因为字段缺失直接 400。同时修改了一下过滤条件。

我问ai的更稳妥的方案是给 assistant message 增加内部来源标记，例如 _provider_id / _model / _reasoning_required，保存时记录但发送前移除。这样可以区分：

• DeepSeek 生成的 assistant：必须保留真实 reasoning_content
• 其他模型生成的 assistant：切回 DeepSeek 时补空 reasoning_content
• 不接受 reasoning 字段的 provider：发送前剥离

但这会牵涉历史 schema 和更多 provider sanitizer，不是最小修复。

好像确实是，只是改好后ai给的总结
（心里默默回忆了一下凌晨的排障过程，改了挺多地方的，我按文件给你列清楚～）

————————

✏ 一、message.py — 数据模型层

路径：/root/.local/share/uv/tools/astrbot/lib/python3.12/site-packages/astrbot/core/provider/entities/message.py

1. 新增字段：Message 类里加了 reasoning_content: str | None = None
2. 放宽验证器：允许 role == "assistant" 且 reasoning_content is not None 时，content 可以为 None
   ————————

✏ 二、tool_loop_agent_runner.py — Agent 执行层

路径：astrbot/core/provider//tool_loop_agent_runner.py

3 处修改，都在写 assistant 历史消息时传 reasoning_content：

1. 第一轮 assistant 响应写入历史时
2. tool_calls 完成后的 assistant 总结响应写入历史时
3. 新一轮 LLM 响应写入历史时
   每处都写成 reasoning_content=llm_resp.reasoning_content，不再用 or None 的写法。

————————

✏ 三、openai_source.py — API 请求层（核心）

路径：/root/.local/share/uv/tools/astrbot/lib/python3.12/site-packages/astrbot/core/provider/sources/openai_source.py

📚 PR #7799 链路补丁部分
4. _finally_convert_payload()：从 think/tool_use 格式提取 reasoning_content 时，改成只有字段确实存在且不为 None 时才写入，不覆盖已有值
5. _query 中原有的消息过滤逻辑：保留，但前面接上了新的 sanitizer
📚 DeepSeek 专项 sanitizer（新加，这才是真正止血的部分）
6. 新增方法 _sanitize_messages_for_deepseek_thinking()
7. 在 _query（非流式）中接入：发请求前，如果模型是 deepseek，先调用 sanitizer
8. 在 _query_stream（流式）中接入：同样的逻辑，流式请求前也调用
sanitizer 的规则：
⦁ 所有 reasoning_content is None 的 assistant 消息 → 丢弃
⦁ 如果这条 assistant 带 tool_calls → 记录其 tool_call_id
⦁ 后续对应的 tool 消息 → 也丢弃
⦁ 这样就不会把 fallback 模型（gpt-5.4）产出的不兼容历史喂回 DeepSeek
————————

（整理完啦～核心一句话：PR #7799 补字段链路 + DeepSeekSanitizer 洗 fallback 脏历史，两个合在一起才真止住血。）