dsh-cross-collaboration
DSH 跨设备局域网代理协作插件：通过 UDP 发现、身份摘要以及 msg.post 在工作区主代理之间进行消息传递。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gameswu/dsh-cross-collaboration#5607af6c41e5da7ff439787c58433620cf933ea5Cross Collaboration 以 dsh-cross-collaboration 发布，当前版本为 0.5.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
让多台运行 DSH（DeepSeek Harness）的设备互相发现、互相发消息唤醒对方的主 Agent。
兼容性：v0.5.0 起要求 DSH ≥ 0.1.5-rc.1。v0.4.0 已适配 0.1.2-alpha.5，v0.2.0 完成 0.1.2-alpha.2 服务契约迁移（
ctx.agents/ctx.settings/ctx.workspaceRegistry/ctx.tools新 API、新工具参数 DSL、subprocess 新 stdio 语义等）。0.1.5-rc.1 复核：ctx.agent移除、Agent.inbox接口化、SubprocessHandle.pid移除、Session v3 / persona 前缀后缀拆分均不影响本插件；Agent.followup(UserMessage)与ctx.agents.roots()仍然存在，已通过类型检查、契约夹具、测试与构建。
ip:port 手动添加（Minecraft 联机式）；添加的节点会通过组网自动同步给其他设备ctx.agents.roots() 只返回 root agent；Agent Teams 的 teammate 是子 agent，因此不会出现在 lan_peers/身份摘要中。若对端已知某个存活子会话的会话 ID，仍可通过 agents.get(sessionId) 直接投递（保持既有“按会话投递”行为）lan_peers 中以 ⚠ 标出典型用法：Windows 开发机给 Mac 验证机的某个会话发一句「请在 macOS 上验证构建」，该会话的 Agent 被唤醒后用本机工具完成验证，再回一条消息通报结果。
cd dsh-cross-collaboration
pnpm install
pnpm run build
dsh plugin --profile web add "file:$(pwd)" # 一步安装进 profile
dsh web # 重启生效
卸载：dsh plugin --profile web remove dsh-cross-collaboration
ip:port（如 192.168.1.100:45232，省略端口用默认值）模型工具
| 工具 | 说明 |
|---|---|
lan_peers | 查看组网内有哪些设备，以及每台设备当前有哪些会话（会话 ID + 标题，一个会话即一个主 Agent） |
lan_message(peer, content, session?) | 发消息；peer 支持设备名、设备 ID 或 ip:port；session 可选，填 lan_peers 里看到的会话 ID 即可精确投递给那个会话，省略则投给设备的默认主 Agent。对端离线时自动排队，上线后补投 |
消息进入目标 Agent 的收件箱并唤醒它开始新对话。空消息会被拒绝，超过 4000 字自动截断。对端离线时消息进入离线队列（最多 50 条，持久化保存），对端上线后自动按序补投；发给已关闭会话的排队消息会被丢弃。
界面：设置页「LAN 协作」的节点列表会显示每台设备的会话数，发消息卡可下拉选择目标会话，通信消息记录标注会话标题，另有「离线队列」卡片可查看/移除排队消息；装有 dsh-plugin-vscode-sidebar 时侧边栏有同名标签页；装有 dsh-notifacation-frame 时收到消息会推送通知。
| 场景 | 做法 |
|---|---|
| 同一局域网 | 无需配置，自动发现 |
| 跨网段 / Tailscale | 「添加节点」填对方的 ip:port（tailnet 地址 + 45232）；防火墙放行 UDP 45231 与 TCP 45232 |
| 跨网络 | 自建中继 node scripts/relay.cjs [port]（需 Node ≥ 22），配置 relayUrl，两端在「中继配对」填入相同口令（≥ 8 位）完成 E2E 配对 |
组合行 config（都有默认值，一般无需改动）：
| 字段 | 默认 | 说明 |
|---|---|---|
udpPort | 45231 | LAN 发现端口（UDP），通信走 udpPort + 1 |
deviceName | 随机 | 展示给对端的设备名 |
beaconMs | 3000 | 发现心跳间隔（毫秒） |
relayUrl | "" | 中继地址（如 ws://host:8799），留空禁用中继 |
设备名、工作区标签、节点列表、配对关系都在设置页维护，热生效并持久化。
覆盖 relayUrl 示例（profile 的 cordis.patch.yml）：
- id: dsh-cross-collaboration
config:
relayUrl: "ws://relay.example.com:8799"
/dshcc/api/*）只接受本机或可信来源请求要求 Node ≥ 22（中继传输）、pnpm。
pnpm install && pnpm run build # 编译 src/*.ts → dist/*.js
pnpm run typecheck # 普通类型检查（真实 0.1.5-rc.1 dev 类型）
pnpm run typecheck:contract # Context 增广/服务面契约夹具
pnpm test # pretest 自动 build：离线队列 + 主机卸载/重挂载测试
node scripts/gateway-smoke.cjs # LAN 冒烟：组网同步 + 消息往返
node scripts/relay-smoke.cjs # 中继冒烟：配对与 E2E 加密往返
结构：src/host.ts（DSH 集成与消息投递）、src/gateway.ts（网络子进程：UDP 发现 + TCP JSON-RPC + WebSocket 中继）、src/client.ts（设置页与侧边栏 UI）。