DeepSeek Harness (DSH) 的运行界面通常绑定在本地。要在移动端直接操作，现有方案要么依赖功能受限的 Companion 应用，要么需要配置 SSH 等复杂工具。omdsh-remctrl 插件提供了一条更直接的路径：在 DSH 的自有端口上建立一个“第二扇门”。它通过反向代理将 DSH 的完整界面暴露到公网，并前置了一个基于密码的认证层。手机通过这个入口，可以观看会话、批准工具请求并分派新工作。
插件定位¶
- 名称：
omdsh-remctrl - 所有者：
omdsh-plugins - 类别：
system - 一句话介绍：DeepSeek Harness 的远程控制：在自有端口上充当“第二扇门”，在设备配对和分层方法白名单之后，使得手机可以观看会话、批准请求并分派新工作。
核心功能¶
该插件通过一层反向代理实现远程访问，核心能力包括：
- 反向代理：提供 HTTP 和 WebSocket 反向代理，将流量转发到 Harness 的
webServer，复刻原生的完整界面。 - 密码鉴权：在代理层增加 passcode 认证门，未通过鉴权无法访问界面。
- 自动隧道：默认启动
cloudflared子进程，自动生成 HTTPS 公网地址。 - 插件中心集成：提供卡片集成，允许通过开关控制插件的启用与禁用。
- 移动端适配：针对移动端优化键盘弹起和侧边栏展开的逻辑。
- 会话管理：管理会话 Cookie，设置
HttpOnly和SameSite=Lax属性。
安装与启用¶
该插件默认未启用，安装后需手动激活。
- 通过插件中心或直接访问仓库安装插件。
- 在 DSH 界面中找到插件中心卡片，点击开关将其启用。
典型用法¶
配置的核心在于如何确定公网访问地址：
-
使用默认隧道：
留空publicHost配置项。插件会启动 cloudflared 快速隧道，并分配一个https://<uuid>.trycloudflare.com地址。这种方式无需配置域名或防火墙。 -
手机登录：
插件卡片会显示公网地址、预填了密码的登录链接以及密码本身。将链接发送到手机并点击，浏览器会自动携带密码完成登录并重定向，无需在地址栏手动输入密码。 -
使用自有域名：
如果机器已有公网地址（如harness.example.com），在配置中设置publicHost。由于此方式使用 HTTP，必须在代理层手动设置allowInsecure以允许连接。 -
控制开关：
通过插件中心卡片的开关，可以随时开启或关闭远程访问能力。
安全与配置¶
插件的配置项极少，安全性主要依赖 DSH 自身的机制：
- 转发限制：在未解析到有效会话 Cookie 之前，不转发任何请求。
- 速率限制：每个地址每分钟限制 6 次认证尝试。
- 传输加密：通过 cloudflared 隧道强制 HTTPS 传输。
- 无其他配置：插件未提供其他可配置项。
环境要求¶
插件依赖 Node.js 运行环境，要求版本满足以下条件之一：
- Node.js
^22.19.0 - Node.js
>=24.0.0
短结尾¶
omdsh-remctrl 为 DSH 提供了原生的远程控制能力。它不是功能子集的 Companion 应用，而是将 DSH 的完整界面通过反向代理和 Cloudflared 隧道复刻到公网。通过插件中心的开关和 passcode，你可以安全地在任何设备上管理 DeepSeek Harness 会话。
