前言¶
在多台机器之间跑 DeepSeek Harness 时,常见做法是远程桌面或单独做一套精简 Web 面板:界面和操作习惯变了,审批、下载等能力也要重新对接。若你希望「控制端看到的仍是同一套 DSH 原生界面和控件」,就需要把对端 Host 的流量接到当前窗口,而不是套一层通用远程桌面。
下面介绍社区插件 dsh-remote-control(维护者 stjq12):在当前 DSH 窗口里操作另一台电脑上的 DSH 实例,界面与功能保持完整。
这是什么¶
dsh-remote-control 是 DeepSeek Harness 插件,包名 @stjq12/dsh-remote-control,在 SkillHub 目录 归类为客户端类工具;源码与说明在 GitHub:stjq12/dsh-remote-control。
定位可以概括为:对端仍是同一套 DSH 界面与操作方式,本机通过 本机页 / 远程页 与带凭据的 /bridge 完成连接,而不是远程桌面,也不是简化面板。
DSH 生态奉行「一切皆插件」;SkillHub 等目录为社区站点,与 DeepSeek / 幻方无官方从属关系。插件以当前 DSH 进程权限运行,安装前请自行查阅源码与 MIT 许可证。
核心功能¶
依据仓库 README,已核实能力如下:
- 原生 DSH:控制端窗口内呈现的是对端同一套界面、控件与操作路径。
- 本机页 / 远程页:被控端在本机页选择 IP 与 1024 以上端口,开放带凭据的
/bridge;控制端在远程页填写对端地址与 token 后接入流量。 - 审批与下载:存在远程控制连接时,审批与 AI 提问由远程端侧处理;下载可限定到指定目录。
- 协议与体量限制:bridge 使用明文
ws://与 bearer token;不支持 WSS/TLS;不支持远程上传;字节 RPC 结果上限 64 MB,普通文件下载按 256 KB 分块流式传输。
实现思路与社区插件 dsh-plugin-mobile-gateway 类似:经认证的 WebSocket 暴露 Host,再在客户端侧做适配。
安装与启用¶
两台参与远程控制的电脑都需要安装同一插件。
在 DSH → 插件 → 添加插件 中输入 GitHub 源,或使用插件的本地绝对路径。官方 README 给出的地址为:
github:stjq12/dsh-remote-control
package.json 中声明的运行环境为:dsh 版本 >=0.2.1-rc.4 <0.3.0,node >=22。Host 侧逻辑仅在 DSH 启动时加载;更换或更新插件后需完全退出并重新启动 DSH。
典型用法¶
按 README「快速开始」,连接分三步:
- 被控制端(本机页):在本机已有 IP 与 1024 以上端口中选择一项,打开开关,复制 token。
- 控制端(远程页):填写对端显示的地址与 token,打开开关。
- 页面会刷新一次;关闭开关即可回到本机 Host。
表单上的 保存 只记录配置;开关 才使连接生效。选择预设只会填充表单,不会自动连接。
适用场景与安全注意¶
适合:需要在另一台机器上继续使用完整 DSH(含审批流、AI 提问、受控下载)的开发者;网络侧已具备加密隧道(如 Tailscale、SSH 端口转发、WireGuard),可承载明文 WebSocket。
务必注意(README 安全章节):
- 这是具备完整控制权限的远程控制,不是只读查看器。
ws://与 token 均应在加密隧道内使用;token 等价于被控端 Harness 的完整控制权,勿分享或截图,怀疑泄露应立刻轮换。- 优先使用 5 分钟到 24 小时的有限 token 时长,用完关闭开关;永久选项也会在 DSH 退出时结束。
- 下载目录权限只约束下载路径;预览仍可能通过 RPC 读取文件,应授权最窄目录。
- 不要把 token 交给不受信任的控制端;协议与威胁模型见仓库 TECHNICAL.md。
更详细的安装步骤见 INSTALL.md。
结尾¶
经过上面的步骤,你可以在单窗口内用原生 DSH 界面驱动远端实例,而无需另开远程桌面或二次封装 UI。查阅插件说明与版本信息可到目录页 skillhub.cn/plugins/stjq12/dsh-remote-control,源码与 issue 见 github.com/stjq12/dsh-remote-control。