工具调用导致的会话污染问题

[lcxie9710-lang]

一、我们遇到的问题

现象

1. 会话中触发工具调用时，回合崩溃：

   Cannot read properties of undefined (reading 'prepare')
   

2. 崩溃后会话日志留下孤儿 tool call（tool/call 已写、tool/result 未写回）；
3. 此后该会话所有新 turn 全部失败：

   An assistant message with 'tool_calls' must be followed by tool messages responding to each 'tool_call_id'
   (insufficient tool messages following tool_calls message)
   

4. 会话被毒化，只能换新会话或手动修复日志。

我们已核验的归因

• 违反官方 adding-a-package.md 约定——核心运行时包必须走 peerDependencies
• 该错误声明 + nodeLinker: hoisted 导致 profile 里出现第二份 dsh-tools；
• 两份模块 → TOOL_RUNTIME_SCHEDULER（Symbol() 单例）不相等 → agent-loop 跨副本取调度器得 undefined → .prepare() 崩溃；
• 崩溃发生在 tool/call 落盘之后、tool/result 写回之前 → 孤儿调用 → 会话污染。

二、官方 Discussions 区的相关讨论

#1697 ：dsh plugin add 任何依赖 @deepseek-ai/dsh-tools 的第三方插件（如 @anweat/dsh-browser、@linxin666/dsh-ssh），就破坏所有工具调用；

• 报错：Cannot read properties of undefined (reading 'prepare')，回合在第一个 tool/call 后立即结束（turn/end reason: error）；

#3234 — 流式 tool-call 参数被截断 JSON 持久化，导致后续 turn 全失败
turn 标记失败；因为日志 append-only 且坏记录从不修复，同一会话每个后续 turn 都失败，无限期；只有开新会话（新日志、

都是"一条坏日志记录 → 会话后续全挂"。这里不是 Symbol 崩溃，而是流式参数截断 + 原样持久化；但同样卡在"append-only 日志从不修复坏记录"这个点。

三、工具调用全挂 → 会话彻底污染，是多种机制下的常见问题

可以看到一个清晰的模式：

1. 工具调用执行路径上任何一环出错（调度崩溃、参数截断、执行器异常）都可能让"调用已记录但结果未写回"或"坏参数被持久化"；
2. append-only 日志从不修复坏记录 → 一旦坏记录进去，会话从污染点起永久不可用；
3. 用户侧无法从对话层面恢复，只能：换新会话 / 手动修日志 / 等官方修复。

仍不确定的地方 ：

• 具体哪些机制会导致"调用已落盘但 result 未写回"或"坏参数持久化"，目前没有完整清单。已知的至少有：① Symbol 双实例调度崩溃（我们 + Bug: installing any plugin that depends on @deepseek-ai/dsh-tools breaks every tool call (Cannot read properties of undefined (reading 'prepare')) #1697）；② 流式参数截断（[Bug Report] Streamed tool-call arguments with truncated JSON are persisted, then every subsequent turn fails with `400 INVALID_REQUEST: Unterminated string ...` in the same session forever #3234）；可能还有 ③ 执行器抛错时 result 写回路径被吞、④ 取消/超时边界等——未逐一验证；
• 触发概率不可知：双实例只在 hoisted + 插件声明错误时出现；流式截断依赖网络/流时序——两者都是"偶发但后果严重"。

四、修复思路：污染会话的自愈

针对"会话已被污染"的现状，我自己制作了简单的本地工具，其思路如下，我相信任何AI都可以很容易的复刻类似的脚本：

• 解压每个会话的 JSONL → 展开打包行 → 逐 turn 配对 tool/call ↔ tool/result → 分类 CLEAN / POLLUTED-FIXABLE（含精确截断行）/ POLLUTED-UNCLEAN / OPEN / CORRUPT；
• 破坏性修复：对 POLLUTED-FIXABLE 截断到最后一个干净 turn（丢弃污染 turn 及其后全部内容）；对 POLLUTED-UNCLEAN 整会话删除；
  不管污染来自 Symbol 崩溃（我们/Bug: installing any plugin that depends on @deepseek-ai/dsh-tools breaks every tool call (Cannot read properties of undefined (reading 'prepare')) #1697）还是参数截断（[Bug Report] Streamed tool-call arguments with truncated JSON are persisted, then every subsequent turn fails with `400 INVALID_REQUEST: Unterminated string ...` in the same session forever #3234），只要日志里出现"turn 内 call 无 result"或"结构异常"，repair_sessions_apply 都能截断到最后一个干净 turn 恢复会话。修复的是后果，不依赖具体触发机制。

五、对官方的建议

1. 坏记录持久化问题（对应 #3234）

• 建议：流式 tool-call 参数在落盘前做 JSON 完整性校验——截断/非法参数不应原样写入 append-only 日志；
• 若已写入，serializeAssistant 重发前应检测并降级（而不是原样重发导致 400）。

3. 会话污染的自愈能力

• 建议 deriveMessages() 容错：日志中无配对 result 的调用、或参数非法的调用，重建历史时合成占位 result / 跳过，让单个坏 turn 降级而非让整个会话永久不可用；
• 建议官方提供受支持的会话维护入口：如 dsh session repair，或 SessionPersistence 语义级截断 API（带备份/验证/拒绝活动会话护栏）