|
|
f7dad243b6
|
fix(deepseek): reasoning_content 三层贯通 + thinking 关闭层级修正
## 生产故障
all 2 providers failed, last error: api error 400:
"The reasoning_content in the thinking mode must be passed back to the API."
## 两个根因，第一个更根本
### ① thinking 关闭一直没生效（真正的触发器）
deepseek.lua 写的是 `req.extra_body.thinking = {type="disabled"}`。
但官方文档里那个 `extra_body={"thinking":...}` 是 **OpenAI SDK 层参数** ——
SDK 会把它摊平进 HTTP 请求体顶层。而适配器是**裸发** JSON 给 api.deepseek.com，
多包一层 `extra_body` 服务端根本不认，直接忽略。
⇒ 即使内核 thinking_enabled=false（发出 disable_thinking=true），
也从来没真正关掉过思考，每次都走 thinking 模式，每次都撞 reasoning_content 规则。
改为顶层 `req.thinking = {type="disabled"}`。
### ② reasoning 从未被保存和回传
DeepSeek 规则（官方 thinking_mode 指南）：请求**带 tools** 时，
所有历史轮的 reasoning_content 都必须传回；内核每轮都带工具定义。
而内核三层全丢：
L1 ContextEvent 没有该字段；renderL1Messages 渲染 assistant 时不带
L2 coldcontext 只切 Input/Response 两块，推理内容不进块
L3 蒸馏原文只读 Input/Response/工具输出
修法（按用户裁定：L1/L2/L3 都要包含 reasoning）：
L1 ContextEvent.ReasoningContent + renderL1Messages 回传
顺带：textForVector 纳入 reasoning —— 关键线索常只在思考里
（"用户要的是 A 不是 B，所以先查 C"），只看 Response 会误裁
L2 RoleReasoning 独立块（不并进 Response：回灌时要放回不同字段，
合并会让思维链被当成正式回复发给模型）
L3 coldcontextOriginalText 按**时序** input → reasoning → response
## 一个易错点：不能用 f.Resp.ReasoningContent
f.Resp 只在「本批有工具调用」时赋值（stepLLM 里 len(ToolCalls)==0 就 return）。
纯文本收尾轮拿到的是**上一次工具轮**的旧响应 —— 用它写进 L1 会把上一批的
思维链冒名顶替成本轮的（比缺失更坏）。所以单独一个 TurnReasoning，
由 stepLLM 在分支**之前**无条件写入。
## 适配器兜底（治存量）
内核修了，但**存量会话**的 context.json 是修复前写的，那些事件没这个字段。
不兜底就是死结：历史缺字段 ⇒ 400 ⇒ 会话永久不可用（重启也救不回，
缺的字段在磁盘上的旧记录里）。
transform_request 里：带 tools 时给每条 assistant 补 reasoning_content=""，
已存在则不覆盖（不抹掉真实思考内容）。
## 顺手修的既有缺陷
零时间戳时 docBlocksForEntry 用 time.Now() 算块 ID，而 ColdEvent.Timestamp
留零值 ⇒ 哈希永久失配 ⇒ 内容就在那里却一个字段都读不回，且不报错不记日志。
线上因为 L1 总带时间戳没暴露。docEventsFromEntries 里先归一化时间戳。
## 验证
生产实机（A2A 多轮工具调用，日志确认落到 deepseek 源直连）：
LLM fallback: trying provider "deepseek"
response (12186ms, tools=[cmd_run plugin_start cmd_run])
reasoning_content 400 = 0 次
单元判据 16 条，全部变异验证（改回错误形态即红）：
coldcontext/test/reasoning_contract_test.go 5 条（L2 往返/独立块/
无思考不造空块/特殊字符/InOut 兼容）
agent/api/test/reasoning_protocol_test.go 3 条（顶层字段/无思考不发/
带 tool_calls 仍发）
lua/test/deepseek_reasoning_test.go 8 条（补空串/不覆盖真实值/
无 tools 不补/补全部轮/不破其他字段/顶层 thinking/默认不加 thinking）
go build / vet / gofmt / go test -race 全绿
|
2026-11-11 21:38:54 +08:00 |
|
