Bug：切到第三方模型后，多轮对话报 400：reasoning_text must be passed back

[freespace8]

切到第三方模型后，多轮对话报 400：reasoning_text must be passed back

遇到个报错想反馈一下。

我在 dsh Web 里自定义了一个第三方供应商（走 llm-pi-ai，openai-responses 协议，deepseek-v4 系列模型，开了思考模式）。在一个会话里，我把模型从官方 DeepSeek 切到了这个第三方供应商，继续往下跑，结果带工具调用的那一步直接 400 了：

OpenAI API error (400): The `reasoning_text` in the thinking mode must be passed back to the API

比较奇怪的是：

• 新开一个会话直接用这个第三方供应商，完全正常——思考、工具调用、多轮续跑都没问题；
• 官方 DeepSeek 也一直正常；
• 就是会话中途切换模型之后，下一个带工具调用的请求必挂。

我排查的经过

我把失败的请求从会话日志里还原出来，原样发给网关，能稳定复现这个 400。然后一个一个删消息试，最后定位到：只要请求里有一个「完整工具轮」（assistant 调了工具、工具返回了结果），而这一轮的思考内容没回传，就会 400；反过来，给每一轮都补上 {"type":"reasoning","content":[{"type":"reasoning_text","text":"..."}]} 再发，就通过了。

翻了翻代码，我的理解是：pi-ai 的 openai-responses 序列化只回传带它自己签名的 thinking 块（openai-responses-shared.ts），官方 deepseek-official 生成的轮次没有这个签名，就被悄悄丢掉了。所以切到第三方供应商后，历史里所有官方轮次的思考内容都没了，工具轮不满足网关"必须回传 reasoning_text"的校验。官方适配器 llm-deepseek 是正确回传的（serialize.ts 里只在工具轮带 reasoning_content），llm-pi-ai 这边没对齐。

修改方案（代码）

① llm-pi-ai：无签名的 reasoning 块也要回传（本贴核心，已实测通过）

packages/llm/llm-pi-ai/src/replay.ts 的 foreignAssistant——对带工具调用的轮次，给 reasoning 块合成一个 thinkingSignature（pi-ai 序列化时会把签名解析成 reasoning 条目原样回传）：

function foreignAssistant(message: Message): AssistantMessage {
  const source = message.source.kind === 'model' ? message.source : undefined
  const hasToolCall = message.content.some(block => block.type === 'tool-call')
  const content: AssistantMessage['content'] = []
  for (const block of message.content) {
    switch (block.type) {
      case 'text': content.push({ type: 'text', text: block.text }); break
      case 'reasoning': content.push({
        type: 'thinking',
        thinking: block.text,
        // 思考模式规范：带工具调用的轮次必须回传 reasoning_text；
        // 无 pi-ai 签名的轮次（跨供应商历史）也要合成签名，否则序列化时会被丢弃
        ...hasToolCall ? {
          thinkingSignature: JSON.stringify({
            type: 'reasoning',
            content: [{ type: 'reasoning_text', text: block.text }],
          }),
        } : {},
      }); break
      case 'tool-call': content.push({
        type: 'toolCall',
        id: block.id,
        name: block.name,
        arguments: parseArguments(block.arguments),
      }); break
      case 'image':
        throw new LlmError('pi-ai chat history cannot represent structured assistant image output', 'UNSUPPORTED_CONTENT')
      default: break
    }
  }
  // ...其余不变
}

replayedAssistant 里 reasoning 分支的 thinkingSignature 缺失时也做同样的兜底（有签名仍优先用原签名）。

② llm-deepseek：兼容 vLLM 的思考流字段（对应 #199）

packages/llm/llm-deepseek/src/translate.ts 一行：

const reasoning = delta?.reasoning_content ?? delta?.reasoning

③ #231 的持久化丢失：还没定位到具体模块，需要对比 Web UI 和 headless 两条会话路径，确保都写入 reasoning 块和 replayState.blocks[].thinkingSignature。

④ 建议加个发送前校验（防回归）：思考模式开启且请求含完整工具轮时，每个工具轮必须带 reasoning 条目，否则直接报错而不是静默丢。

和 #199、#231 的关系

搜了下发现 deepseek 思考模式文档 里写了：带 tools 的请求，后续必须完整回传 reasoning_content。而 #199（vLLM 把思考流成 delta.reasoning，llm-deepseek 读不到）和 #231（Web UI 会话不持久化 reasoning）报的是同一个 400，但我感觉不是同一个 bug：

• Bug: Web UI multi-turn sessions drop reasoning blocks — 400 "reasoning_text must be passed back" (openai-responses custom provider) #231 是持久化阶段丢的（他们日志里 reasoning 一条都没有）；我这个日志里思考内容是有的（replayState 签名都在），是序列化阶段丢的，跟 Bug: Web UI multi-turn sessions drop reasoning blocks — 400 "reasoning_text must be passed back" (openai-responses custom provider) #231 机制不一样；
• Bug: vLLM self-hosted deployments stream thinking as delta.reasoning — adapter drops it (fix available) #199 是流解析阶段丢的，跟切换模型没关系；
• 我这个的触发条件是会话里切换供应商，这个场景 Bug: vLLM self-hosted deployments stream thinking as delta.reasoning — adapter drops it (fix available) #199/Bug: Web UI multi-turn sessions drop reasoning blocks — 400 "reasoning_text must be passed back" (openai-responses custom provider) #231 都没涉及。

不过修法可以一起做，正好把整条链路补上：流解析（#199）→ 持久化（#231）→ 回传（本贴）各修一处，再加上面那个发送前校验兜底。