前言¶
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 提供了安全、高效的遠程協作能力。通過端到端加密和一次性配對碼機制，它在不犧牲安全性的前提下，實現了跨機器的文件共享和任務調度。開發者可以根據需求選擇局域網直連或官方中繼模式。
