前言¶
DeepSeek Harness（DSH）的智能體默認跑在你本機：文件、工具權限、審批都在桌面端完成。人離開電腦時，常見做法是 SSH、遠程桌面，或把會話遷到雲端——要麼綁在電腦前，要麼把執行環境搬出本機。
HarnessMate 走另一條路：智能體仍在本機 DSH 裏跑，通過插件連到可自託管的 HarnessMate 平臺，用手機 App 或瀏覽器發消息、傳文件、在手機上點批准或拒絕。下面介紹插件 harness-mate-dsh 的定位、能力與安裝方式。
這是什麼¶
harness-mate-dsh（npm 包名 harness-mate，當前版本 0.2.0）是 DeepSeek Harness 的 Cordis 插件，由維護者 liaosiliangCodeLife 發佈，MIT 許可證。它把本機 DSH 智能體經 WebSocket 接到 HarnessMate 平臺；平臺提供手機端與 Web 入口，本身不替你在遠端執行工具——工具仍在你的電腦上、按你的 DSH profile 權限運行。
SkillHub 目錄分類爲「客戶端」；倉庫 GitHub 星標爲 0（以目錄頁爲準）。
核心功能¶
以下能力均來自項目 README 說明：
- 隨處對話：在手機 App 或 Web UI 發消息，流式回覆帶輸入指示。
- 雙向文件：可從手機發給智能體；智能體也可把文件發回。
- 手機審批：智能體請求執行有風險工具時，推送至聊天；在手機上批准或拒絕，而不必守在電腦前。
- 本機爲主：HarnessMate 不自行執行任何工具；模型隨 DSH profile 配置，與具體模型廠商無關。
- 平臺支持：macOS、Windows（README 徽章標明）。
安裝與啓用¶
前置條件¶
- DeepSeek Harness 桌面端 v0.2.0-rc.2 或更新，且至少啓動過一次。
- HarnessMate 平臺上的智能體憑證：
bot_id與bot_key。默認平臺地址爲https://harness.alltman.com，登錄後進入 個人空間 → 創建智能體，複製兩項；密鑰只顯示一次。 - 插件依賴 Node >=22.19.0（見
package.json）。
方式 A：作爲 DSH 插件安裝（推薦）¶
在終端執行官方命令：
dsh plugin --profile web add github:liaosiliangCodeLife/harness-mate-dsh
包上架 npm 後，README 說明可簡化爲 dsh plugin --profile web add harness-mate。
在 profile 配置裏寫入憑證。macOS 路徑爲 ~/.dsh/profiles/desktop/cordis.patch.yml，Windows 爲 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml：
- insert:
- id: harness-mate
name: 'harness-mate'
config:
gatewayUrl: 'wss://ws-agent.alltman.com:1443/ws'
botId: 'YOUR_BOT_ID'
botKey: 'YOUR_BOT_KEY'
方式 B：運行安裝腳本¶
從 Release 下載 zip，解壓後在插件目錄運行安裝程序：會註冊插件、寫入 profile、備份舊配置。
macOS：
cd harness-mate
./install.sh # 或: ./install.sh <bot_id> <bot_key>
Windows：
powershell -ExecutionPolicy Bypass -File .\install.ps1
兩種方式共同的收尾¶
完全退出 DeepSeek Harness（菜單欄 / 托盤 → Quit，不要只關窗口），再重新啓動。用手機 App 或 Web UI 給智能體發一條消息；有回覆即表示連通。日誌路徑：~/.harness-mate-trace.log（Windows：%USERPROFILE%\.harness-mate-trace.log）。
更細的步驟、FAQ 與完整配置說明見倉庫 INSTALL.md。
配置項¶
字段寫在插件 cordis.patch.yml 的 config 下；修改後需重啓 DSH。
| 字段 | 默認值 | 含義 |
|---|---|---|
gatewayUrl |
HarnessMate 網關 | 插件連接的 WebSocket 網關 |
botId / botKey |
— | 平臺上該智能體身份（必填） |
workspace |
用戶主目錄 | 智能體可讀寫的根目錄 |
dmPolicy |
open |
open · allowlist（配合 allowFrom）· disabled |
approvalTimeoutMs |
300000 |
工具審批超時；超時視爲拒絕 |
maxReplyChars |
4000 |
單條回覆最大長度 |
forwardReasoning |
false |
是否把推理過程一併轉發到聊天 |
典型用法¶
安裝並重啓 DSH 後，日常用法即：在 HarnessMate 手機端或瀏覽器打開對應智能體，像在本機聊天一樣發指令；需要傳文件時從手機上傳；當智能體調用需審批的工具時，在聊天裏點批准或拒絕。平臺也可自託管，與插件配套的倉庫爲 harness-mate-plat（Vue 3 + Flask + Go WebSocket 網關 + Docker）。
適用場景與注意¶
適合誰：已在本地用 DSH 跑智能體，又希望外出時用同一套本機權限與文件做對話、傳文件、遠程點審批的開發者。
權限與安全：插件與當前 DSH 進程同權，工具在本機執行；安裝前建議閱讀源碼與 MIT 許可證，並妥善保管 botKey。社區插件目錄（如 SkillHub）獨立於 DeepSeek / 幻方，並非官方應用商店。
生態：DSH 側插件通過 cordis.patch.yml 注入；同平臺還有 Hermes 通道適配器，位於 harness-mate-plat 倉庫的 plugin/hermes/。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/liaosiliangCodeLife/harness-mate-dsh
- GitHub 倉庫：https://github.com/liaosiliangCodeLife/harness-mate-dsh
