面向 DeepSeek Harness 的 Relay Events

稳定版 0.2.4 已在官方 DSH 0.1.5-rc.2 和 0.1.6-alpha.1 上验证。 实现使用 alpha 版本要求的官方 Session 列表显式状态契约，同时保持 rc.2 兼容；peer 元数据已声明两个精确版本。从 npm 安装 · 兼容性证据。

发布通道： latest → 0.2.4；next → 0.2.4-rc.1。

npx @deepseek-ai/[email protected] plugin --profile web add relay-dsh-plugin-events@next
npx @deepseek-ai/[email protected] web

English | 中文

relay-dsh-plugin-events 是官方 DeepSeek Harness 的持久化、中立执行后端的 Wait/Event/Delivery 核心。它提供 Agent 工具、通用 JSON 事件入口、向原有归属 Session 投递、故障恢复以及 Waiting Events 设置界面，但不增加执行后端。

旧的 internal npm 通道继续用于集成测试，不包含此次兼容保证。请使用上方最新版 DSH 命令中精确的 0.2.3 版本，不要替换为 @internal。

dsh plugin --profile web add --save-exact relay-dsh-plugin-events@internal
dsh web

语义路由与 Monitor 执行由独立插件提供。未安装 Router 时，Events 使用精确事件类型 匹配；未安装 Monitors 时，Wait 注册与外部事件入口仍然可以完整使用。

数据库生命周期

Relay 数据库是持久化数据，卸载插件时不会被删除。启动时，插件会将不存在或空数据库 直接初始化为当前 schema。对于可识别的旧 schema，会先校验完整性，再备份到 <database>.backup-v<old>-to-v<current>.sqlite，然后在同一个事务内执行升级， 最后创建依赖新字段的索引。备份会被校验，重试时会复用。迁移失败会回滚所有 schema 修改， 并在错误中给出备份路径。未知的非空 schema、损坏的数据库、外键违规，或高于插件所支持版本的 schema 都会被拒绝，不会猜测结构或静默修改数据。

详见 SPEC.md 与投递场景。

将 DSH_ROOT 指向准备好的官方 DSH 只读检出，然后执行 npm ci --ignore-scripts && npm run verify && npm pack。npm 包和本地生成的 tarball 包含已构建的运行文件。原始 GitHub 检出不会跟踪 lib/，不要把 #main 当作已构建 版本安装。

已验证的官方 DSH：0.1.1-rc.2 / b150a551b8d465e31e418e1b2eaf5e79bbb7d28e 、0.1.2-alpha.2 / 0a53fb55bea101816fa226bb964ae2bed71c343b，以及 0.1.2-alpha.3 / dd6322d604e00eec1ba5e0c8541159906a21094a。