DSH Mobile Web Remote:扫码连接、无需手机 App 的 DSH 远程访问插件

前言

DSH 的日常使用往往从电脑端开始:启动 Web profile,创建会话,查看工具执行状态。若想在手机上继续同一个会话,通常会遇到几个额外问题:是否要安装一个手机 App,是否要准备服务器、域名或公网 IP,是否要在路由器上做端口映射。

DSH Mobile Web Remote 的目标是把这些问题收敛到一个插件里:在 DSH Web profile 中增加手机远程入口,通过 Cloudflare Quick Tunnel 提供临时 HTTPS 入口,让手机浏览器直接访问同一套 DSH 原生界面。

这是什么

DSH Mobile Web Remote 是 SnowfallC 发布的 DSH 插件,仓库名为 dsh-mobile-web-remote。它面向 DeepSeek Harness(DSH)Web profile,提供扫码连接、无需安装手机 App 的移动远程访问能力。

插件在本机建立带鉴权的移动桥接服务,复用 DSH 原生 Web 界面。它不修改 DSH 源码、构建产物或原生工作区选择器,也不需要用户自备服务器、域名或公网 IP。

核心功能

  • 扫码连接,无需安装手机 App。
  • 无需自备服务器、域名或公网 IP,通过 Cloudflare Quick Tunnel 提供临时 HTTPS 入口。
  • 在本机建立带鉴权的移动桥接服务,复用 DSH 原生 Web 界面。
  • 非侵入式,不修改 DSH 源码、构建产物或原生工作区选择器。
  • 一次性配对令牌位于 URL Fragment,并签发 HttpOnlySameSite=Strict 会话 Cookie。
  • HTTP 与 WebSocket 共用同一鉴权边界,并校正转发时的 Host 与 Origin。
  • 电脑端未安装 cloudflared 时,自动下载平台匹配的固定官方版本,核验 SHA-256 后缓存使用。
  • 跟随 DSH 的中英文和深浅主题。
  • 支持撤销链接并重新生成二维码。

安装与启用

前置条件

  • 已能正常启动 DSH 的 Web profile。
  • 已安装 Node.js 与 pnpm。
  • 首次运行需要访问 GitHub Releases。
  • 自动安装文件缓存在 $DSH_HOME/cache/dsh-mobile-web-remote/cloudflared

插件未在本机找到 cloudflared 时,会自动下载平台匹配的固定官方版本,并在核验 SHA-256 后缓存使用。

安装

在 DSH 源码仓库中执行:

pnpm dsh plugin --profile web add "github:SnowfallC/dsh-mobile-web-remote"
pnpm dsh web

第一条命令安装插件,第二条命令启动 DSH Web profile。

卸载

执行:

pnpm dsh plugin --profile web remove dsh-mobile-web-remote

随后重启 DSH。

典型用法

1、在电脑端打开 DSH,点击右下角“手机远程 / Mobile remote”。

2、等待 Quick Tunnel 建立并显示二维码。

3、使用手机系统相机或浏览器扫码。配对链接默认在 15 分钟后失效,且只能成功配对一次。

4、在手机上进入已有工作区与会话,继续发送消息或查看执行状态。

5、结束后点击“撤销链接 / Revoke link”。如需重新配对,先撤销,再生成新的二维码。

资料中列出的本机管理页地址为:

http://127.0.0.1:3080/__dsh_mobile

适用场景与注意

适合这类场景:需要在手机上查看已有 DSH 会话、继续发送消息或查看执行状态,但不希望额外安装手机 App,也不希望临时准备公网入口。

使用前需要注意:

  • 本项目属于实验性功能。
  • Quick Tunnel 的流量由 Cloudflare 中转,临时域名也不具备长期稳定性。
  • 请勿处理密钥、客户数据等敏感任务;使用后应立即撤销链接。
  • 长期运行时,建议改用可审计的 Named Tunnel,并继续保留本插件的鉴权层。
  • 远程端保留“添加工作区”和“设置”的原生位置,但以灰色禁用态呈现。
  • 建议先在电脑端完成宿主配置,再从手机进入现有会话。
  • 插件会随当前 DSH 进程运行,并可能在本机启动桥接服务、下载或缓存 cloudflared;安装前应检查源码、依赖和许可证。

许可证方面:代码采用 MIT License。运行时下载的 cloudflared 由 Cloudflare 以 Apache-2.0 许可发布,不属于本仓库的 MIT 授权。仓库头图属于社区角色的 AI 衍生创作,同样不纳入 MIT。

相关链接

  • GitHub 仓库:https://github.com/SnowfallC/dsh-mobile-web-remote
  • 目录页:https://www.skillhub.cn/plugins/SnowfallC/dsh-mobile-web-remote
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜