多窗协作锁 YNM10086/DSH-Collaboration

DSH Collab — 多窗口同项目协作插件

让多个 DeepSeek Harness（DSH）窗口在同一个项目里并行编码、互相沟通、不互相肘击——对标 Claude Code 的多窗口并行协作体验。

窗口A: 🔒 认领 games/snake/game.js → 编译中... 窗口B: ✍️ 尝试写 game.js → ⛔ 已被窗口A认领（已排队第1位）窗口A: ✅ 释放 → 锁自动交接给窗口B → B 继续写

核心能力

- 共享任务板：.dsh/collab/board.md，实时显示各窗口持锁/排队/冲突状态（锁目录为唯一事实源，板子为派生视图，自愈式重建）
- 文件认领锁：开工前 collab_claim 认领文件，被占自动排队等待（任务不取消），释放后队首自动接管
- 写入拦截：写被其他窗口认领的文件会被 tools/pre-execute 直接拒绝（⛔ 提示 + 排队信息），防肘击
- 审计日志：activity.log 记录认领/拒绝/写入观察，冲突标红提醒
- 用户指定身份：对窗口说"你是X"，执行 collab_identity letter=X 立即绑定（fork 窗口共享 sessionId 也互不干扰）
- 双模式部署：bundle 常驻（宿主级，重启不丢）或按需动态挂载（"开启并行模式"口令）

快速开始

模式一：bundle 常驻（推荐）

1. 安装到你的 profile（把 D:/Constantly-evolving 换成你的仓库路径）
dsh plugin --profile web add "file:D:/Constantly-evolving/collab-bundle"

2. 重启 DSH —— 所有窗口自动获得 collab 工具

模式二：按需动态挂载（不装 bundle）

任何窗口说 "开启并行模式"，窗口读取 collab/plugin-host.js 执行 cordis_define + cordis_run 立即挂载（进程重启后需重新挂载）。

绑定身份

对窗口说：你的身份是 A 窗口执行：collab_identity letter=A （被占用可 force=true 接管）

工具一览

| 工具 | 用途 |
| collab_board --refresh | 查任务板（持锁/排队/冲突警告） |
| collab_claim <任务> <文件列表> | 认领文件；被占自动排队；cancel_wait=true 退队 |
| collab_done [文件列表] | 完成任务释放锁，交接给队首 |
| collab_status | 本窗口身份、持锁、排队 |
| collab_identity [letter=X] [force] | 查询/指定本窗口身份 |

适配到你的环境

1. 克隆：git clone git@github.com:YNM10086/DSH-Collaboration.git
2. 装 bundle：dsh plugin --profile <你的profile名> add "file:<仓库路径>/collab-bundle"
3. 重启 DSH，新会话直接可用
4. 改插件源码后（关键坑）：pnpm 的 file: 依赖是复制不是链接，必须同步副本再重启： powershell -File collab/sync-bundle.ps1 或手动：删 node_modules/dsh-collab-bundle 后在 profile 目录跑 pnpm install

5. 验证：任意窗口执行 collab_status，身份用 collab_identity letter=X 指定

需要 DSH 版本：基于 @deepseek-ai/dsh 的 profile（web/headless 均可）；bundle 模式依赖 dsh-base 类 profile 提供的 fs/agents/sessions/tools/sandboxPolicy/systemPrompt/timer 服务。

目录结构

├── collab/ # 动态插件版（v2.1，按需挂载） │ ├── plugin-host.js # code.host 函数体（cordis_define 直接使用） │ ├── README.md # 详细使用说明（双模式、坑） │ ├── sync-bundle.ps1 # bundle 副本同步脚本（改源码后必跑） │ └── unpack-session-log.mjs # DSH 会话日志（zstd）解码调试工具 ├── collab-bundle/ # bundle 版（v3.0.1，宿主组合插件） │ ├── lib/index.js # 宿主插件（per-agent 身份、pre-execute 拦截） │ └── cordis.patch.yml # bundle patch（dsh plugin add 自动应用） ├── games/snake/ # 演示项目：贪吃蛇（exe 版 + 网页版） │ └── Snake.exe # 编译产物（csc 编译，零依赖） └── docs/superpowers/specs/ # 设计文档

已验证（真实双窗口测试）

- ✅ 认领 → 写被锁文件被 ⛔ 拦截（文件未被修改）
- ✅ 被占 → 排队第 1 位（任务不取消）→ 释放 → 队首自动交接
- ✅ 身份用户指定，fork 窗口（共享 sessionId）互不覆盖
- ✅ bundle 宿主重启后自动恢复（无需手动挂载）
- ✅ 审计日志完整留痕（claim/denied/guard-check/observed）

完整测试记录见 collab/test-errors.md（含历次报错与根因）。

已知边界

- 拦截覆盖模型文件工具（write/edit）的执行路径；shell 直接写文件不受拦（靠审计兜底）
- 拦截依赖窗口内存镜像，新锁最多延迟到 collab_board --refresh 或心跳（60s）后生效
- 动态插件模式进程重启即失（bundle 模式无此问题）
- 身份注册表残留条目暂不自动过期（字母用尽时可手动 force 接管）

许可证

Apache-2.0。参考项目：dsh-background-agents（其 bundle 部署/Config/持久化模式为本项目 v3.0 提供设计参考）。