[bug]ds-bot 0.2.7 × 宿主 0.2.2-rc.1 会话崩溃根因

[id7869]

Title:
0.2.2-rc.1: turn preStep crash "(reading 'filter')" on sessions with developer/messages after provider rename+restart; developer-role messages leak to custom openai-completions routes (HTTP 400); turn/end errors lack stack

Summary

在 0.2.2-rc.1 桌面端（Windows）遇到两类相关故障，并附一个可观测性缺陷：

1. 回合预组装（preStep）确定性崩溃：Cannot read properties of undefined (reading 'filter')。会话历史中含 developer/message（工具注册表抖动产物）的 bot 会话，在「provider 改名 + 配置层重写 + 宿主重启 + 插件升级」后，每个回合在 turn/start 之后、step/start 之前约 170ms 内崩溃（无 step/start、无 request/header），连续 4/4 必现，该会话从此不可用。
2. developer 角色消息泄露给 openai-completions 自定义路由：工具注册表变更时写入会话历史的 role:"developer" 内部消息（agent-loop 的 tool-addition/tool-removal 通知）被投影进请求发给自定义 openai-completions 网关，后端拒绝该角色，报 400: {"message":"developer is not one of ['system', 'assistant', 'user', 'tool', 'function']","type":"invalid_request_error"}。
3. turn/end 错误事件不带堆栈：崩溃只记录 {"message":"Cannot read properties of undefined (reading 'filter')","code":"UNKNOWN"}，无法从日志归因到具体帧（本次是解包 asar 静态比对了 6 个核心包才定位到疑似帧）。

Reproduction

按实际发生条件的复现路径（非最小脚本，如实说明）：

1. 会话历史中存在 developer/message（由插件兼容门禁导致的工具注册表抖动产生：43 个工具先 tool-removal 再 tool-addition）。
2. 自定义 provider（api: openai-completions）在 patch 层改名，同时 patch 层被设置界面重写、其中 agent-preset-registry 配置项被一并丢弃；宿主重启。
3. 期间 bot 插件从 0.2.2 升级到 0.2.7。
4. 之后向该 bot 会话发任意消息 → 每回合必崩（见 Current behavior）。

重要对照：在同样的会话历史上（含正常的 developer 消息），provider 改名前曾有连续 20 个回合正常运行——所以崩溃触发点是重启后的状态组合（疑似插件对 system-prompt/assemble waterfall 的转换返回了缺 contexts 的 assembly，且预设配置被丢弃后 runtime context 被抑制），而非「历史里有 developer 消息」本身。

Current behavior

事件时间线（Asia/Shanghai，来自本机会话日志 session.v4.jsonl.zstd，多帧 zstd）：

11-05 16:11:19  seq 2033  developer/message：43× tool-removal，且无 headerSeq（异常形态）
11-05 16:12:45  seq 2046  developer/message：43× tool-addition，headerSeq=2045
11-05 21:02     turn 205  400 invalid_request_error（developer 角色被自定义网关拒绝）
11-05 21:03     换模型后 turn 207-230 正常（同一会话、同样含 developer 历史）
11-06 12:17     patch 层重写（provider 改名、agent-preset-registry 配置丢失）+ 宿主重启；
                投影缓存 modelSelection 折叠态残留 lastUsed=<已改名的旧 provider>，pending=<新名>
11-06 12:19-12:21  turn 231-234 全部崩溃：
  turn/start → (无 step/start、无 request/header) → turn/end
  {"reason":{"kind":"error","error":{"message":"Cannot read properties of undefined (reading 'filter')","code":"UNKNOWN"}}}

静态比对 asar 内 0.2.2-rc.1 核心包，疑似/相关缺陷帧（均在该崩溃路径上、对 undefined 无守卫）：

• @deepseek-ai/dsh-system-prompt/lib/index.js L411：contexts: runtimeContextSuppressed ? transformed.contexts.filter(...) : transformed.contexts —— L401 的 system-prompt/assemble waterfall 允许插件改写 assembly；插件返回缺 contexts 的对象且 runtimeContextSuppressed 为真时，正好 undefined.filter。与本机时序吻合（patch 层重写丢弃 agent-preset-registry 配置 + ds-bot 0.2.2→0.2.7 升级恰在崩溃起点前）。
• @deepseek-ai/dsh-llm/lib/index.js projectToolUpdates L803 history.tools.filter(...)、L811 message.content.filter(...)：developer 消息投影路径，接收端无判空。
• @deepseek-ai/dsh-agent-loop/lib/index.js L1048：tools.filter(...) 与同函数内 baseline.tools?.map(...)（L1046）守卫不对称。

400 问题的机制面：withoutDeveloperMessages 仅在路由未声明 toolUpdate 模式时剥离 developer 消息；自定义 openai-completions 路由被投影保留后原样发送，被网关拒绝。另外 seq 2033 那条 developer/message 没有 headerSeq，与 assertDeveloperHeader 期望的形态不符（折叠层用空 definitions 容忍了它）。

Expected behavior

1. 回合预组装对历史折叠/上下文 assembly 的字段缺失具备守卫，任何插件转换结果不得让回合管线崩溃；崩溃时错误可归因。
2. role:"developer" 的内部消息默认不发送给未声明接受该角色的路由（按 API 能力剥离或降级），避免 400。
3. turn/end 的 error reason 中至少在诊断日志层附带 stack。

Environment

• DeepSeek Harness 桌面版 0.2.2-rc.1（app.asar 2026-11-04），Windows 11 x64
• 会话格式 v4；插件：ds-bot 0.2.2→0.2.7、@dsh-external/workflow 0.2.3（要求 0.2.1-rc.5，被 0.2.2-rc.1 门禁拒装→工具抖动毒源）、自定义 provider（openai-completions 网关，已脱敏）
• 诊断提示：session.v4.jsonl.zstd 是多帧 zstd——用单帧 decompress() 只能读到重启前的第一帧，会漏掉重启后的全部事件（本次排查踩过），需流式解压读取

[id7869]

根治：向 DeepSeek Harness 上游报告 .filter 未判空缺陷 + developer 角色泄露到 openai-completions 路由 + turn/end 缺堆栈三个问题

[id7869]

完整报告
排查ds bot崩溃.md

[id7869]