插件适配成本：0.1.6 → 0.1.7 之间的公开接口破坏点 / Plugin adaptation cost between 0.1.6 and 0.1.7

[bobcyw]

我们在本机维护一套 DSH 定制（相对上游改过约 159 个文件，含几个自研插件），跨 0.1.6-alpha.1 → 0.1.7-rc.1 → 0.1.7-rc.2 的升级过程中记录了下面这些破坏点。贴出来供团队排期时参考，附出处，不评价。

一、0.1.6 之后遇到的

1. DeepSeek 默认协议切换为 Messages（上游 b0641b83fc）：该协议对 user/tool-result 里的非 text/image 块抛 UNSUPPORTED_CONTENT。我们本机 84 个会话含有早期 subagent-settled 通知写入的 reasoning 块，升级后全部发不出请求。chat-completions 一直静默忽略 —— 这是一个"只有切换协议才暴露"的兼容缺口。

2. 会话日志容错：session-persistence-jsonl 的 listArtifacts 只对 generation-0 跳过残帧。一个被 SIGKILL 打断的日志会让 WorkspaceRegistry.listStoredHeaders() 在自己的 init 阶段抛错，导致整个插件树加载失败、服务起不来、会话列表只剩内存里的活跃会话。

3. 会话日志注入没有大小上限：session-log-deepseek 按"自上次已接受水位以来的全部事件"注入。水位为 -1 的会话（36653 个事件）一次性注入 152MB → 上游 EPIPE；失败的请求不推进水位 → 每次重试重发同一份 payload，该会话彻底不可用。

4. token-meter 对中文低估约 4 倍（packages/llm/token-meter/src/estimate.ts 的 CHARS_PER_TOKEN = 4）：中文约 1 字符 ≈ 1 token，导致 800K 的压缩阈值实际要等到约 2M tokens 才触发。

二、0.1.7 之后遇到的

1. 删除了共享的 kind: 'plugin'：session-peers / session-channels 两个包必须做 PluginMessageSource + MessageSourceMap module augmentation 才能继续工作。

2. SummarizationInput / SummaryResult 不再从 compaction-basic 根导出：compaction-curator 的导入路径直接断掉。

3. 类型系统变更：6 个定制包的 .spec.ts 出现大量不兼容，最后只能把测试文件移出工作区。

4. 依赖的服务未就绪：dsh-better-workspace 依赖的 settingsScope 在 0.1.7 中不可用，只能禁用该插件。

三、想请教两件事

1. 持久化格式的扩展位：我们四个包给"持久化的消息来源联合"各加了一个成员，持久化门禁因此判定"需要升到会话格式 v5"，但 v4 已经冻结。插件要扩展这个联合时，官方期望的做法是什么 —— 有预留扩展点，还是要走正式流程升格式？

2. 插件作者该盯哪个通道：0.1.6 只发布过 alpha.1 / alpha.2，没有 rc，随后直接进入 0.1.7-alpha.1。如果 rc 才是可依赖的锚点，插件作者在 alpha 期间应该按什么预期适配？

以上每一条在我们本机都可复现，需要哪条的复现步骤或日志，我可以补。