前言¶
DeepSeek Harness(DSH) 的开发工作多在本地 Web 面板里完成。离开工位后,若要用手机或外网浏览器继续对话、改文件,常见做法是自建 VPN、配置路由器端口映射,或把面板暴露到公网——步骤多、安全边界也不清晰。
DshRemote(仓库名 dsh-remote-plugin)是面向 DSH 的持久化插件包(host + client):在 DSH 侧边栏一键开启远程访问,通过 FRP 隧道与本地闸机把本机面板安全穿透出去;官方托管模式下无需自己维护 frps。下文介绍它是什么、能做什么,以及如何从仓库安装并启用。
这是什么¶
- 名称:DSH 远程助手(DshRemote),npm 包名
dsh-plugin-browserctl,当前版本 1.0.55(见仓库package.json)。 - 维护者:Memorial-coder。
- 分类:社区目录归类为「联网工具」;GitHub 约 10 stars(以目录页/仓库页为准)。
- 许可:MIT License · 2026 DshRemote Project。
- 定位:DSH Web 面板配套工具——扫码配对、设备管理与 2FA 集中在侧边栏「远程助手」,AI 对话与文件处理仍在本机 DSH 中执行。
在线体验入口(README 给出的官方地址):https://remote.ymzcc.com/dsh-remote/。社区插件目录:https://www.skillhub.cn/plugins/Memorial-coder/dsh-remote-plugin;源码:https://github.com/Memorial-coder/dsh-remote-plugin。
核心功能¶
以下能力均来自仓库 README 功能表与说明,安装后可在侧边栏面板中操作。
| 能力 | 说明 |
|---|---|
| 扫码即连 | 手机扫二维码,约 30 秒内完成配对,无需路由器端口映射 |
| 一次性 / 长期配对 | 临时会话用一次性码;常用设备用长期配对码并自动保存 |
| 场景配对 | 支持 iOS / 无 App 设备经 Safari 验证,30 天免登录 |
| 两步验证 2FA | TOTP(RFC 6238)+ 30 天 Cookie 设备信任 |
| 设备管理 | 在线设备列表、详情、一键踢下线 |
| IP 黑名单 | 暴力破解自动封禁,可自定义规则 |
| 消息推送 | Windows 原生 Toast,安全事件提醒 |
| 操作日志 | 配对、踢人、验证等关键操作记录 |
| PWA | 可添加到手机主屏幕全屏使用,无需单独 App |
| 自建 / 托管 | 默认官方服务器即开即用;也支持自建 frps |
| 多用户隔离 | 官方托管下每位用户专属入口,设备互不干扰 |
| 引导链接 | 一次性引导链接,可分享给他人免注册访问 |
数据与传输(README「安全性」):对话与文件处理在本机 DSH 运行;手机经 TLS 到官方 frps/Nginx,再经隧道路到本机 browserctl.py 闸机,README 声明数据不经第三方明文。
架构概要:
手机/外网浏览器
→ https://remote.ymzcc.com/dsh-remote/p/<uid>/ (官方托管:每用户专属 HTTPS 入口)
→ OpenResty/Nginx(Lua Cookie 签名门禁)
→ frps(KCP/UDP)
→ frpc 隧道
→ 本机 browserctl.py(2FA + 会话 + 看门狗)
→ DSH Web 面板
官方托管模式下,用户登录后拥有稳定路径 /dsh-remote/p/<uid>/(uid 不变,换端口不断连)。
安装与启用¶
环境要求¶
仓库 package.json 声明:
node:^22.19.0 || >=24.0.0dsh:>=0.2.1-rc.3
README 说明:一般不需要单独安装 Python 或 Node;插件会按序探测 BROWSERCTL_PYTHON、包内 python/、DSH 自带运行时、PATH;browserctl.py 仅使用 Python 标准库。lib/ 为预构建产物,运行时零 npm 依赖。
装之前确认两件事¶
- 官方托管需先在 https://remote.ymzcc.com 注册(README 写明免费),登录后服务器才分配专属端口。
- Windows 上
frpc.exe可能被报PUA:Win32/FRProxy;解压后先运行包内fix-antivirus.bat(或fix-antivirus.ps1),否则隧道可能无法启动,手机端出现 502。
从 GitHub 安装(推荐命令,README 原文)¶
开发或尝鲜可直接用 DSH CLI 从仓库根安装(仓库根 package.json 的 dsh.bundle 指向子包,根目录即为合法插件包,lib/ 已入库,无需 npm install):
dsh plugin add github:Memorial-coder/dsh-remote-plugin
也可在 DSH「设置 → 插件 → 添加插件 → 选择本地目录」中选中插件包根目录(含 package.json、cordis.patch.yml、lib/、browserctl.py 等)。发版 zip/tgz 目录结构与此一致。
官方托管快速步骤(README)¶
1. 解压插件包(Windows 先跑一次 fix-antivirus.bat)
2. DSH →「设置」→ 插件页 →「添加插件」→「选择本地目录」→ 选中插件包根目录 → 重启 DSH
3. 侧边栏「远程助手」→ 登录官方账号 → 点「开始控制」→ 手机扫二维码远程访问
更细步骤见仓库内 INSTALL.md。交流群:QQ 1134820071(README 给出)。
自建服务器:可自行配置 frps;README 写明密钥仅保存在本机,不会被提交或上传。
典型用法¶
经上述步骤启用后,日常流程与 README「手机 App:三步连接」一致:
- 电脑端在插件面板一键生成配对码(含二维码)。
- 手机扫描二维码,约 30 秒内完成验证。
- 验证成功后 30 天内免登录(场景配对 / Cookie 信任策略以面板为准),可随时从手机浏览器或 PWA 进入,操作与本地 DSH Web 面板一致(写代码、处理文件等)。
面板侧还集成设备管理、2FA 设置、黑名单、日志查看与 Windows 推送开关;需要临时让同事访问时,可使用「引导链接」生成一次性链接(README 功能表)。
适用场景与注意¶
适合谁
- 已在 PC 上跑 DSH,希望出门时用手机或外网继续同一工作区、同一助手会话的开发者。
- 不想自己维护公网入口与 frps,可先走官方托管;对合规或内网有要求的团队,可走自建 frps 路径。
使用注意
- 插件与 DSH 同进程权限运行:远程连上后,能力边界等于本机 DSH 与闸机配置所允许的范围。安装前请阅读
browserctl.py、INSTALL.md与 MIT 许可证,确认符合你的安全策略。 - 联网与隧道组件(
frpc、官方入口)会建立外连;企业环境需评估防火墙与终端安全软件策略(尤其 Windows 对frpc.exe的拦截)。 - SkillHub 等为社区插件目录,与 DeepSeek / 幻方无官方从属关系;星标与版本以 GitHub /
package.json为准。
结尾¶
DshRemote 把「远程打开本机 DSH 面板」收口到侧边栏:配对、2FA、设备踢出与日志在一处完成,计算仍留在本机。若要试用界面,可先打开 https://remote.ymzcc.com/dsh-remote/;若要装进自己的 DSH,使用 dsh plugin add github:Memorial-coder/dsh-remote-plugin 或本地目录安装,再按 README 三步扫码连接。