对等协作桥 lgtuusb/dsh-peer

DSH Peer — 两个对等 AI 实例的协作工具包

让两个独立安装的 AI 编码助手互相认识、互相派活、互相复验，并且人类可以从一个窗口同时看到它们、跟它们说话。

它和别的多 agent 工具有什么不同

| | 常见的多 agent 方案 | 本项目 |
| 形态 | 一个主实例，内部开多个分身 | 两个对等的实例，各自独立 |
| 谁启动谁 | 主实例生出子实例 | 两个都是独立安装的，谁也不是谁生的 |
| 界面 | 子实例没有界面，后台跑 | 两个都有自己的完整界面 |
| 身份 | 子实例没有独立履历 | 各自独立的会话历史、设置、插件 |
| 隔离 | 共享配置 | 独立配置，甚至可以用不同的账号 / API key |
| 单点故障 | 主实例挂了全挂 | 一个挂了另一个照常跑 |
| 关系 | 主从 | 对等 —— 任何一方都能主动发起 |

核心差异：常见方案解决的是"一个大脑指挥多只手"；本项目解决的是"两个平等的个体怎么协作"。

后者更难，因为没有主从关系可以依赖 —— 所以这里有一整套"外交礼节"：

- 身份牌（新会话如何快速认出对方）
- 署名信封（[甲方→乙方] 意图:交付 | 编号:003）
- 文件归属表与认领制（避免互相踩文件）
- 实现者 / 复验者分离（不许自己顺手改对方的实现）

目录结构

peer-plugin/ 给对方实例装的插件：暴露一个本地 JSON-RPC 端点 peer/ 命令行客户端（状态 / 读时间线 / 发消息 / 等待） app/ 双栏对话程序（后端 + 前端 + 测试） desktop/ Electron 打包壳（把 app 做成独立 exe） IDENTITY.md 新会话开局读这一份就能接上协作 RULES.md 协作规矩看板 共享看板模板（文件归属 + 认领 + 变更记录） ROADMAP.md 路线

工作原理

实例 A（工作区 X） 实例 B（工作区 Y） DSH 进程 DSH 进程 └─ 桥插件 ←──── 本机回环 ────→ 桥插件 ↑ ↑ └──────── app / peer ──────────┘ （人类界面）

每个实例的插件会在自己的 DSH_HOME 下写一个端点文件：

<DSH_HOME>/agents-anywhere/bridge/endpoint.peer.json
{ "version":1, "host":"127.0.0.1", "port": <随机>, "token": <随机>, "pid": <进程号> }

端口与 token 每次重启都变，所以客户端永远从文件读，不要写死。

配置（重要）

本仓库已做隐私清理，源码里的个人路径被替换成占位符：

| 占位符 | 含义 | 你要改成 |
| %DSH_HOME% | 该实例的 DSH_HOME | 你的实际路径 |
| %REPO% | 本仓库所在目录 | 你的实际路径 |
| %WORKSPACE_A% / %WORKSPACE_B% | 两个实例的工作区 | 你的实际路径 |
| session-<id> | 会话 id | 运行时从接口取 |

推荐用环境变量而不是改源码：代码里优先读 DSH_HOME，其次才是默认值。

已知限制

- 延迟：一条消息要经过 HTTP → 后端 → 桥 → 注入目标会话 → 对方模型启动，比同进程内派活慢
- 受制于官方桥的能力：官方桥只提供"对已有会话发消息"和"中断"，不支持新建会话；本项目自带插件补齐了这块
- 两边都要装插件：只装一边则那一侧功能不完整
- 端点会变：重启后端口和 token 都换，必须重读端点文件

状态

早期版本，能跑通端到端，但不保证稳定。欢迎 issue / PR。

许可

待定（见仓库说明）

文件说明

| 文件 | 内容 |
| README.md | 本文件 —— 它和别的多 agent 方案有什么不同 |
| INSTALL.md | 怎么装：两个实例、装插件、跑通链路 |
| DEPLOYMENT.md | 一份实际跑通的配置样例 + 6 个实测坑 |
| IDENTITY.md | 身份牌 —— 新会话开局读这一份就能认出对方 |

| RULES.md | 协作规矩 |
| ROADMAP.md | 路线 |
| peer-plugin/ | 核心：给对方实例装的桥插件（本地 JSON-RPC 端点） |
| peer/ | 命令行客户端 + 协议规格 + 测试 |
| app/ | 双栏对话界面（后端 + 前端 + 测试） |
| desktop/ | Electron 打包壳（把 app 做成独立 exe） |