插件写入自定义 session 事件类型会让会话永久无法恢复

[jiruidai]

我在开发第三方插件（https://github.com/jiruidai/dsh-meta-orchestrator）时碰到的问题，任何按文档写自定义事件的插件都会踩中。

现象

插件用 SessionEventMap 声明合并定义自己的事件类型，再用 Session.append 写入——运行时一切正常，但重启后这个会话就再也打不开了：

• 持久化读取端 assertEventsSupported（session-persistence/coordinator.ts）对白名单 KNOWN_SESSION_EVENT_TYPES 之外、且未标 ignorable 的事件直接抛 SessionFormatUnsupportedError，拒绝加载整个日志；
• 白名单只从仓库内的 SessionEventMap 成员生成，插件事件天然不在其中；
• 而 Session.append 没有任何途径给事件标 ignorable。

写入当下没有任何报错；等到重启后尝试恢复这个会话时，加载直接抛 SessionFormatUnsupportedError——整段对话历史无法再打开，也没有任何恢复手段。

能修复下吗？

比如给插件事件类型加一个注册面，或者让 append 支持 ignorable（known-event-types.ts 注释里也提到注册面 "deferred until such a consumer exists"）。

[LeoLin990405]

我不是维护者，但在当前 master（47f943859bef60e4160492346772ded9b24f765a）按源码复核了一遍：这个报告成立，而且正好命中了仓库已经记录的 v0 持久化边界。

• assertEventsSupported() 会拒绝未知且未带 ignorable: true 的事件；这是为了避免旧 reader 静默跳过一个会改变重放语义的必需事件，从而恢复出“看似成功、实际缺状态”的会话。
• SessionEvent 信封虽然定义了 ignorable?: true，但公开的 Session.append(type, data, ...surfaceOpts) 目前没有 writer 入口可以设置它。
• 仓库的 session log versioning Agent Note 也明确写了：out-of-repo plugin event 在第一方 reader 下会拒绝恢复，这是当前 pre-release 阶段接受的 fail-loud 限制；runtime 注册表被推迟，是因为“已知事件集合”若随 composition 改变，同一份日志会因启动的插件不同而得到不同结果。

因此不建议把检查直接删掉、把未知事件默认当作可忽略，或仅做 composition-local 注册。这三种快速修法都可能把可见的拒绝变成静默错误重放。

短期规避方式是：第三方插件不要把自有的必需状态写进第一方 Session log，先放到插件自有的持久化存储；当前 reader 拒绝时，支持定位的 backend 会在 SessionFormatUnsupportedError 中附 raw log 路径，原始数据并没有被删除，但当前 reader 无法安全重建它。

长期我认为这个案例很适合推动一个明确的扩展契约，至少要区分两类事件：

1. 纯信息、丢失不影响重建的 log-only event：给 append 一个受校验的 ignorable: true writer surface；
2. 参与插件状态重建的 required event：需要跨 composition 稳定的 namespace/schema 契约，而不是仅在本次运行注册类型。

对应回归测试也应覆盖完整的 append → flush → 进程重启 → cold load，而不只是内存中的 SessionEventMap declaration merge。这个问题的核心不是白名单少一项，而是当前类型扩展面与 durable writer 契约还没有闭合。

[www13975qq]

我也遇到了同类问题，非常希望官方增加插件事件类型注册接口的功能。