多智能体协作区 shizhonggang/dsh-collab

dsh-collab

多 agent 协作共享协议，做成一个跨平台 DSH 插件 + 通用 CLI。

支持 DSH / Claude Code / Kimi Code / DevEco Code（以及任意自定义参与方）在同一工作区里通过 .shared/ 文件协议协作：outbox 发件箱、status 状态回执、tasks 任务看板、knowledge 共享知识、artifacts 长结论。

特性

- ✅ 纯 Node，跨平台（Windows / macOS / Linux / HarmonyOS）
- ✅ 不依赖 shell / 原生模块 / 硬编码绝对路径
- ✅ 插件与 CLI 双形态：DSH 模型直接调工具，其他 agent 用 collab 命令
- ✅ 强约束：只允许追加自己的 outbox，绝不写别人文件
- ✅ 幂等初始化：.shared/ 骨架可重复执行，不覆盖已有内容

安装

作为 DSH 插件

dsh plugin --profile web add dsh-collab

或从 git 安装：

dsh plugin --profile web add https://github.com/shizhonggang/dsh-collab.git

安装后在 DSH 会话里会注册这些工具：

| 工具 | 作用 |
| collab_init | 初始化 .shared/ 协作骨架 |
| collab_watch | 检查其他参与方 outbox 新消息 |
| collab_mark | 更新自己的 status 已读回执 |
| collab_append | 只向自己的 outbox 追加一条协议消息 |
| collab_status | 查看各方状态回执和未读汇总 |
| collab_sync | 开工前一条龙：watch + mark + 汇总 |

作为通用 CLI

npm link # 或 pnpm link --global
collab help

collab init --root /path/to/workspace --me dsh
collab watch --root /path/to/workspace --me dsh
collab mark --root /path/to/workspace --me dsh
collab append --root /path/to/workspace --me dsh \
--to all --type 广播 --topic protocol-v2 \
--body '大家好，我已接入协作协议。'
collab sync --root /path/to/workspace --me dsh

目录结构（初始化后）

workspace/
└── .shared/
├── PROTOCOL.md # 协议总纲 ├── README.md # 共享区说明 ├── outbox-dsh.md # 各方发件箱（append-only） ├── outbox-cc.md ├── outbox-kimi.md ├── outbox-deveco.md ├── status/ # 各方已读回执 ├── tasks/ # 各方任务看板 ├── tools/ # watch-outbox.mjs 等 ├── artifacts/ # 长结论 └── knowledge/ # 共享知识

消息格式

[msg-1] 2026-08-19T00:00:00+08:00 | from=dsh | to=all | type=广播 | topic=hello | ref=artifacts/xxx.md

这里是消息正文。

设计原则

- 单一 writer：每个人只写自己的 outbox-.md / status/.json / tasks/.md
- append-only：消息只追加，不 rewrite
- 原子写：临时文件 + rename()（兼容 HarmonyOS 禁硬链接）
- 无外部依赖：只需要 Node 18+
- 可扩展：新参与方按 PROTOCOL.md 接入清单操作即可

开发

node --check lib/index.js
node --check bin/collab.mjs
node bin/collab.mjs init --root /tmp/demo --me dsh

License

MIT