前言¶
DeepSeek Harness (DSH) 是智能体开发与运行平台。在管理多台机器时，常见的痛点是难以高效地控制远程设备。传统的做法往往依赖截图或模拟键盘输入，效率低且不稳定。
dsh-peer-mcp 插件解决了这个问题。它允许 DSH 机器之间直接通信，让 A 机的智能体像调用本地工具一样调用 B 机的环境，执行任务并传输文件。最重要的是，所有文件始终保留在原机，不发生数据搬运。
插件简介¶
| 项目 | 内容 |
|---|---|
| 名称 | dsh-peer-mcp |
| 仓库 | MyPanda-Hash/CHENGXIAO |
| 许可证 | MIT |
| 简介 | 让两台电脑上的 DSH 互相干活、互相传文件 —— 而各自的文件始终留在本机。 |
安装¶
使用以下命令安装插件。安装过程会将插件放入 profile 的 node_modules 并自动注册到 dsh.profile.bundles。
dsh plugin --profile <你的 profile> add github:MyPanda-Hash/CHENGXIAO
安装后，插件默认处于未暴露状态，需要手动开启监听。
核心功能¶
- 远程控制与协作：远程控制两台 DSH 机器，运行任务和传输文件。
- 配对机制：采用一次性配对码机制，安全便捷。
- 网络支持：支持局域网直连或跨网络中继（官方默认提供中继服务）。
- 安全与隐私：端到端加密，中继仅转发加密信封，不持有密钥或文件明文；默认不对外暴露。
- 独立 Worker 模式：支持无需 DSH Desktop 运行的独立 Worker 进程。
- 文件传输：支持分片文件传输，避免大文件传输失败；文件始终停留在本机。
- 异步任务：支持异步任务流，任务状态保存在执行任务的设备上。
配置与使用¶
基础配置¶
插件默认共享工作区为 %USERPROFILE%\DSH Workspace。
要启用对端连接，必须在 profile 的覆盖层配置中开启 listen。开启监听时，必须配置 allowedDirs 以指定允许对端访问的绝对目录。
在 ~/.dsh/profiles/<你的 profile>/cordis.patch.yml 中添加：
- id: dsh-peer-mcp
config:
listen: true # 开启监听，允许对端配对
host: 0.0.0.0
port: 7331
allowedDirs: # 必须至少配置一个绝对目录
- 'C:\Users\你的用户名\DSH Workspace'
交互工具¶
配对成功后，可使用以下命令行工具进行交互：
peer status # 查看对端状态
peer ls # 列出对端目录
peer ask "重启 nginx 并报告状态" # 在对端执行任务
peer read D:\logs\app.log # 读取对端文件
peer pull D:\logs\big.zip C:\local\ # 拉取大文件
peer push C:\local\report.pdf # 推送文件到对端
Agent 层面支持的工具包括：
peer_status, peer_ticket, peer_pair, peer_revoke, ask, submit_task, task_status, task_events, task_result, cancel_task, fetch_file, send_file, open_read, read_chunk, close_read, send_begin, send_chunk, send_finish, send_cancel。
中继模式¶
默认情况下，插件使用官方提供的公共中继服务，无需配置防火墙或端口映射，两台机器可在任何网络环境下互通。中继仅转发端到端加密的信封，不保存明文。
独立 Worker 模式¶
配合插件 CLI，被驱动的一端也可以不运行 DSH Desktop。仓库根目录下的 worker.mjs 是一个纯 Node.js 的独立 Worker，与 DSH 共享信任库。
启动独立 Worker：
node worker.mjs --port 7331 --dirs "D:\repos" # 监听模式
node worker.mjs --relay # 中继模式
结语¶
dsh-peer-mcp 为 DSH 提供了安全、高效的远程协作能力。通过端到端加密和一次性配对码机制，它在不牺牲安全性的前提下，实现了跨机器的文件共享和任务调度。开发者可以根据需求选择局域网直连或官方中继模式。
