分支收件箱隔离 catcatchcatast/dsh-fork-inbox-guard

dsh-fork-inbox-guard

独立的社区维护方案，解决新 DeepSeek Harness 分支继承待发送输入的问题。

独立的 DSH 分支队列修复插件，阻止新分支先执行父会话的待发送消息，保留分支自己的输入。非官方插件，预发布版本；已有会话不处理。

Compatibility / 兼容范围

| Component | Tested version |
| DeepSeek Harness | 0.1.5-rc.2 |
| Cordis | 4.0.2 |
| Plugin | 0.1.0-isolation.1 |

请使用 DSH 支持的 Node.js 版本。其他 DSH 版本未经验证。对等依赖锁定已验证的契约；未实现运行时版本自动检测。

Behavior / 修复范围

插件同步监听公开的 agent/created 生命周期边界。它检查分支谱系、构造函数边界和继承的种子标记，然后用公开的 Inbox.remove 删除继承的待发送消息标识。分支自己的初始化输入会保留。

- 只处理挂载后创建的新分支，不扫描、清理或修复已有会话。
- 不改变父会话、继承历史正文或官方分支截断位置。
- 不覆盖核心投影，不拦截发送，不接管工具、沙箱或审批。
- 不依赖远程插件或 Desktop；每台实际运行 DSH 的服务器分别安装。

Install / 安装

从 Releases 下载 .tgz 和 SHA256SUMS.txt，然后校验 SHA-256。

dsh plugin --profile YOUR_PROFILE add /absolute/path/dsh-fork-inbox-guard-0.1.0-isolation.1.tgz

把 "dsh-fork-inbox-guard" 追加到 $DSH_HOME/profiles/YOUR_PROFILE/package.json 里已有的 dsh.profile.bundles 数组（默认 home：~/.dsh）。保留所有已有 bundle。包自带 cordis.patch.yml。通过常规服务管理器重启配置档。每个用到的 Web 或 CLI 配置档都要重复一遍。

仅安装包不会自动启用到全部配置。安装后用测试会话新建分支，发送新的短消息，确认执行的是新消息。无需修改 DSH CLI 或核心版本号。

Disable / 停用

只从 bundle 列表里移除本插件并重启。之后可选执行 dsh plugin --profile YOUR_PROFILE remove dsh-fork-inbox-guard。

已记录的队列移除事件仍然保留。停用只阻止后续修复；不会恢复已删除的继承待发送输入。

Development / 验证

npm ci --ignore-scripts
npm test
npm pack --ignore-scripts

11 个隔离集成测试使用已发布的官方模块、内存会话和假模型。覆盖范围包括原始故障、分支输入执行、父会话/历史保留、初始化输入、重复分支、恢复的旧分支、并发、启动顺序和卸载。见 VALIDATION.md。

这些测试不能证明完整的浏览器、磁盘后端或第三方插件兼容性。其他插件必须遵守官方生命周期契约：创建阶段只做组合；驱动从 agent/session-start 开始。

Privacy / 隐私

不收集遥测、网络请求、凭据或设备标识。插件在内存中检查新分支历史，并通过 DSH 写入普通的队列移除事件。在问题报告里请隐去提示词、账号信息、主机名、地址和本地路径。

Background

上游讨论 #6244、#6314。

这是生命周期层面的变通方案，不是上游核心修复。等上游 fork 或 inbox 语义有变动时，再重新评估。

License

MIT。Copyright (c) 2026 dsh-fork-inbox-guard contributors。官方依赖各自保留自己的协议，不会打包进插件。