deepseekplugins

DeepSeek Harness 插件

dsh-cross-collaboration

DSH cross-device LAN agent collaboration plugin: UDP discovery, identity summaries, and msg.post messaging between workspace main agents.（英文原文）

自动化与任务
跳到安装方式

来源信息

GitHub 仓库
gameswu/dsh-cross-collaboration
最近更新
2026年8月17日
分类
自动化与任务
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/gameswu/dsh-cross-collaboration
插件名：dsh-cross-collaboration
作者：gameswu

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-cross-collaboration

让多台运行 DSH（DeepSeek Harness）的设备互相发现、互相发消息唤醒对方的主 Agent。

  • 发现：同一局域网零配置自动互发现；跨网段按 ip:port 手动添加（Minecraft 联机式）；添加的节点会通过组网自动同步给其他设备
  • 通信：唯一的跨设备操作就是发消息。粒度是会话——在 DSH 里一个会话就是一个主 Agent，不存在 workspace 级 Agent；消息可以精确投递给对端设备上的指定会话（不指定则投给其默认主 Agent），不存在任何远端执行
  • 版本兼容检查：设备间通过发现/握手交换插件版本与协议号，版本不兼容的对端会在节点列表与 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

把设备连起来

1. 两台设备都安装并重启 DSH。同一局域网会自动互发现 2. 跨网段（如 Tailscale）：打开 设置 →「LAN 协作」→「添加节点」，填入对方地址 ip:port（如 192.168.1.100:45232，省略端口用默认值） 3. 连接成功后节点信息自动同步——组网内其他设备会获知并自动连接新节点，全组收敛为全互联 4. 给设备起个名、选个工作区标签，方便对方识别

发消息

模型工具

工具说明
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（都有默认值，一般无需改动）：

字段默认说明
udpPort45231LAN 发现端口（UDP），通信走 udpPort + 1
deviceName随机展示给对端的设备名
beaconMs3000发现心跳间隔（毫秒）
relayUrl""中继地址（如 ws://host:8799），留空禁用中继

设备名、工作区标签、节点列表、配对关系都在设置页维护，热生效并持久化。

覆盖 relayUrl 示例（profile 的 cordis.patch.yml）：

- id: dsh-cross-collaboration
  config:
    relayUrl: "ws://relay.example.com:8799"

安全

  • 只通信，不操作：对端唯一能做的事是把消息投进本机主 Agent 的收件箱，因此不需要授权/白名单体系
  • 端到端加密：中继传输只接受已配对设备的 AES-256-GCM 信封，中继服务器只能看到密文
  • 同源栅栏：客户端 API（/dshcc/api/*）只接受本机或可信来源请求

开发

要求 Node ≥ 22（中继传输）、pnpm。

pnpm install && pnpm run build     # 编译 src/*.ts → dist/*.js
pnpm run typecheck                 # 仅类型检查
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）。

路线图

  • [x] 离线消息队列（对端离线时暂存、上线后补投）
  • [ ] MQTT 传输适配器
返回搜索打开 GitHub 仓库

更多相关插件

查看分类