前言¶
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
