DeepSeek Harness（DSH）采用插件化架构，dsh-remote/plugin 是其宿主插件。它解决的核心问题是：如何在不通过复杂网络配置的情况下，利用手机对本地运行的 DSH 进程进行远程指令下发、流式输出查看、审批工具调用以及直接回答问题。
本插件运行在 DSH 进程内部，负责与中继建立连接、管理会话与命令、转发审批请求，并在状态栏显示配对入口。
核心功能¶
插件主要提供以下能力：
1. 远程操作：在手机上远程操作 DeepSeek Harness。
2. 指令下发与交互：下发指令，查看流式输出，直接回答问题。
3. 审批转发：将宿主的工具调用审批请求转发至手机端。
4. 主机唤醒：在任务跑完前保持主机唤醒，防止休眠。
5. 安全通信：载荷级端到端加密，中继只传输加密数据；支持零知识中继。
安装与启用¶
插件通过 dsh plugin 命令安装到指定的 profile 中。安装后必须重启 Harness 才能生效，因为 HMR（热模块替换）仅更新配置文件，不会重新加载核心代码。
安装命令如下：
dsh plugin --profile web add @dsh-remote/plugin
桌面端用户需将 --profile web 替换为 --profile desktop。
安装完成后，必须重启 Harness 进程。
生态与使用流程¶
本插件是 DSH 远控生态的主推组件，需要配合其他组件使用：
* 中继：提供 WebSocket 通信通道。
* 官方小程序：微信小程序“黑鲸远控”，用于扫码配对、会话管理和交互。
配对流程：
1. 在主机 DSH 状态栏会出现一颗 pill（胶囊）图标。
2. 打开微信小程序“黑鲸远控”。
3. 扫描状态栏的二维码。
4. 配对二维码里的地址来自主机侧配置的 serverUrl，小程序无需手动填写地址。
配置与注意事项¶
安装方式¶
推荐从 npm 安装：
dsh plugin --profile web add @dsh-remote/plugin
开发者也可从源码构建安装：
pnpm install
pnpm build
node scripts/install-to-profile.mjs
注意：从源码安装会创建软链，此时使用 dsh plugin add 安装会报错，两种方式不要混用。
安全设计¶
插件遵循严格的安全设计：
* 零知识：插件配置中只包含 hostTokenEnv（环境变量名），不存储 token 明文。中继只传输加密载荷，密钥在配对阶段通过二维码传递。
* 权限控制：凭据落盘权限设置为 0600，确保只有宿主进程可读写。
* 审批流程：审批必须真的过 waterfall，仅参与宿主 approval/request 的请求才会到达手机；approval/asked|decided 仅作为审计事件。
结语¶
该插件通过零知识中继和端到端加密，在提供远程控制便利性的同时保证了安全性。对于需要在移动端管理或干预 DSH 任务的开发者，这是一个直接的解决方案。
源码与文档见：GitHub。
