v0.4.6:DSH Session 事件接口兼容
v0.4.6 修复 DSH 0.1.2-alpha.4 新会话出现的 agent.session.events is not iterable 错误,同时覆盖最新 alpha.5 接口,并继续以 DSH 0.1.1-rc.2 作为稳定、推荐的基线。Issue #156、PR #159。
修复
- Session 事件读取现在检测能力而非版本字符串。稳定版 DSH 0.1.1-rc.2 继续使用
events[];DSH 0.1.2-alpha.4 与 alpha.5 使用snapshotEvents()和eventAt()。 - 生命周期回放、回合检测与子 Agent 诊断共用同一兼容层,使完整读取与索引读取在受支持版本上遵循同一份持久历史契约。
- 遇到未知的未来 Session 形态时会明确失败,不会静默地把持久历史当作空数据。
升级与兼容性
在所属 DSH profile 中安装 dsh-mnemon@0.4.6,然后重启。DSH 0.1.1-rc.2 仍是稳定的 registry 基线与推荐安装目标;DSH 0.1.2-alpha.4 和最新 alpha.5 是预览兼容目标。兼容路径依据 Session 实际提供的能力选择,不依赖预发布版本标签。
记忆数据、存储路径、Pack 格式、Provider 凭据、RPC 权限、设置、生产依赖和会话投影状态均不变,无需迁移或删除缓存。v0.4.4 的投影兼容性与 v0.4.5 的 Better Sidebar 集成保持不变;本补丁不包含无关的 v0.5 开发内容。
验证
实现与发布候选在 Node 24.18.0 与 pnpm 10.13.1 下通过完整 pnpm run verify:654 项测试通过,1 项 Windows 专用测试在 macOS 跳过。110 个构建文件的确定性检查、Headless 激活、10 个 Node 兼容公开入口、包内容检查、publint 和 attw 均通过。PR #159 的 Linux Node 22.19/24、Windows Node 24 与源码链接 DSH 0.1.2-alpha.5 CI 任务也全部通过。
隔离的真实 WebUI profile 先在 DSH alpha.4 与已发布 Mnemon 0.4.4 上复现错误,再使用本修复分别在 alpha.4、alpha.5 与稳定 rc.2 上完成合成会话。三个修复后场景的浏览器控制台均为 0 个 error、0 个 warning,Host 日志也没有 error、warn 或 not iterable 匹配。详见环境记录与截图。
回滚
在同一 profile 中重新安装 dsh-mnemon@0.4.5 并重启,无需转换数据。在 DSH 0.1.2-alpha.4 或 alpha.5 上回滚后,原 Session 接口错误可能再次出现;如需继续对话,应同时将 DSH 恢复为稳定的 0.1.1-rc.2。
上一版:v0.4.5。