【Bug】qqbot 会话在 agent 空闲回收重建后间歇性丢失 bash 工具（UNKNOWN_TOOL，4 个复发簇证实）

[golfygao]

现象

QQ 渠道（deepseek-harness-qqbot）的会话偶尔在连续多个回合内所有 bash 调用报 ToolNotFoundError / UNKNOWN_TOOL（unknown tool "bash"），随后又自行恢复。

bash 是已注册工具（该会话历史累计成功调用 569+ 次），报错名称为完整、非空的 "bash"——与近期热议的"流式工具调用空 callId/name"家族（#3464、#4611 等）签名不同，不属同一根因。

证据：4 个独立复发簇（16 次失败，全部与 agent 重建严格相关）

时间	失败次数	前驱事件
08-21 14:23:09–21	5	session/end-seed @ 14:23:02
08-21 14:29:14–18	3	同一坏实例续（turn 12）
08-22 17:37:03–14	5	session/end-seed @ 17:36:55
08-28 20:44:04–07	3	重建后立即

观察到的行为模式

1. 失败的根因是"恢复中的 agent 作用域工具视图不完整"，不是工具没注册：dsh-tools 的工具可见性按作用域解析（resolveExecution(name, scope) → view(scope)，permission 链过滤），重建（resume）后的 agent 在其生命周期内缺失 bash
2. 坏实例不自愈：如 08-21 的 turn 11 + turn 12 连续 8 次全败，直到 14:31 再次重建（end-seed）才恢复；期间无任何其他事件能修复
3. 触发机制：qqbot 插件在消息队列清空后 dispose 全部 agent（Dispose every bridge-owned Agent after queued message work settles），下一条消息触发 resume（会话重播种 = session/end-seed）。每次"隔一段时间"复现，本质都是"闲置→回收→重建"的间歇性竞态
4. 缓解：重启 dsh-web 或等下一次自然重建即可恢复——进一步支持"重建时序竞态"而非永久损坏

建议排查方向（框架侧）

dsh-tools 的 view(scope) / modeFor(scope) 与工具/权限层链条在 agent 恢复重建时存在间歇性绑定不全；特别是工作区作用域工具（bash）在恢复路径上可能先被解析后补挂。建议在 resume 路径上验证：恢复完成的 agent 的 tool view 是否与新建 agent 一致（wireSchemas/resolveExecution 命中率对比）。

排查相关（已确认非同一问题）

• 执行任务中所有和 Powershell 相关的调用都会触发 unknown_tool 报错 #225（pwsh unknown_tool）：表现为某工具一致不可用，与我们的"间歇性、绑定重建"模式不符
• [Bug] All tool calls fail with UNKNOWN_TOOL (unknown tool "") when using Bailian (DashScope) deepseek-v4-flash as provider #3464 / An empty tool call (callId = "") makes an entire history session unreadable (SessionPersistenceCorruptionError) #4611 / dsh 工具调用落库时 name/callId 为空，导致 unknown tool 死循环 #4908 等：空 callId/name 流式工具调用家族——报错名称为空 ""，签名不同

（附：完整会话日志与时间线可提供，如需进一步取证回复我。）

[golfygao]

补充：本报告的完整版已迁至 qqbot 插件仓库的 issue（sliverp/DeepSeek-harness-qqbot#2）。

说明归属：

• 触发机制在插件层（QQ 会话特有的"队列清空即 dispose、下条消息 resume 重建"生命周期，间歇性撞上工具解析竞态）
• 可疑根因在核心层（dsh-tools 的 view(scope)/resolveExecution 对恢复代理作用域工具视图的绑定）

保留本讨论作为核心层索引，与插件 issue 互为交叉引用。