DSH Mobile Web Remote

扫码即用，无需安装手机 App，也无需自备服务器或公网 IP。

English · 安装指南 · DSHFind

DSH Mobile Web Remote 是面向 DeepSeek Harness（DSH）Web profile 的非侵入式远程访问插件。它在本机建立带鉴权的移动桥接服务，再通过 Cloudflare Quick Tunnel 提供临时 HTTPS 入口。无需准备 VPS、域名、公网 IP，也不用在路由器上配置端口映射。手机端无需安装 APK，扫描电脑端二维码即可继续使用 DSH 原生会话界面。

[!WARNING] 本项目属于实验性功能。Quick Tunnel 的流量由 Cloudflare 中转，临时域名也不具备长期稳定性。请勿处理密钥、客户数据等敏感任务；使用后应立即撤销链接。长期运行时，建议改用可审计的 Named Tunnel，并继续保留本插件的鉴权层。

设计边界

本插件不修改 DSH 源码、构建产物或原生工作区选择器。它只使用 DSH 的插件组合、webServer 路由与 tapIndex 扩展点：电脑端增加一个悬浮入口，远程端复用原生 Web 界面。卸载插件并重启 DSH 后，新增路由和界面元素随插件生命周期一并移除。

为何复用 DSH Web 界面

DSH 本身就在 Web 环境中运行，其官方界面已经定义了会话、消息流、工具状态、语言与主题等交互。手机远程访问因此没有另造一套客户端，而是将同一 Web 应用通过受保护桥接交付给手机浏览器。该结构既减少了界面分叉，也使移动端能够随 DSH 官方界面和功能更新一同演进；插件只负责配对、鉴权、转发与手机端必要的权限收敛。

仓库通过兼容性 CI 每周拉取最新 DSH main，真实安装插件并验证桌面入口、管理页、一次性配对、会话 Cookie 与远程限制注入。检查使用本地假隧道，不会在 CI 中创建公网入口。DSH 若调整插件清单、Web 扩展点或首页交付方式，CI 会尽早暴露需要更新的薄适配层。

flowchart LR
  P[手机浏览器] -->|HTTPS / WebSocket| C[Cloudflare Quick Tunnel]
  C --> B[本地移动桥接]
  B -->|一次性配对 + 会话 Cookie| D[DSH Web profile]

• 一次性配对令牌位于 URL Fragment，不随初次 HTTP 请求进入代理日志。
• 配对成功后签发 HttpOnly、SameSite=Strict 会话 Cookie。
• HTTP 与 WebSocket 共用同一鉴权边界，并校正转发时的 Host 与 Origin。
• DSH 退出或插件卸载时，桥接端口与 cloudflared 子进程会被回收。
• 电脑未安装 cloudflared 时，插件会下载与平台匹配的固定官方版本，核验 SHA-256 后缓存使用。
• 弹窗、悬浮入口与远程界面跟随 DSH 的中英文和深浅主题。
• 远程端保留“添加工作区”和“设置”的原生位置，但以灰色禁用态呈现；请先在电脑端完成宿主配置，再从手机进入现有会话。

界面

入口附着在原生 DSH 页面，不会打开额外标签页：

扫码后，手机浏览器直接呈现同一套 DSH 界面；“添加工作区”和设置齿轮保留原生位置，但以禁用态显示：

安装

前置条件

• 已能正常启动 DSH 的 Web profile。
• 已安装 Node.js 与 pnpm（从 DSH 源码运行时通常已经具备）。

无需手工安装 cloudflared。插件优先使用 PATH 中已有的版本；如果不存在，则自动下载并校验 Cloudflare 官方发布文件。首次运行需要访问 GitHub Releases，后续会使用本地缓存。

无需自备服务器、域名或公网 IP。插件启动时，Cloudflare Quick Tunnel 会分配一个临时 HTTPS 地址，二维码中包含该地址和一次性配对信息。

从 GitHub 安装

在 DSH 源码仓库中执行：

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

从本地目录安装

git clone https://github.com/SnowfallC/dsh-mobile-web-remote.git
cd deepseek-harness
pnpm dsh plugin --profile web add "C:/path/to/dsh-mobile-web-remote"
pnpm dsh web

使用

1. 在电脑端打开 DSH，点击右下角“手机远程 / Mobile remote”。
2. 等待 Quick Tunnel 建立并显示二维码。
3. 使用手机系统相机或浏览器扫码。配对链接默认在 15 分钟后失效，且只能成功配对一次。
4. 在手机上进入已有工作区与会话，继续发送消息或查看执行状态。
5. 结束后点击“撤销链接 / Revoke link”。如需重新配对，先撤销，再生成新的二维码。

管理页也可从本机访问：http://127.0.0.1:3080/__dsh_mobile。

配置

默认配置位于 cordis.patch.yml：

config:
  cloudflaredPath: auto
  pairingTtlMinutes: 15
  sessionTtlHours: 12
  bridgePort: 0

bridgePort: 0 表示由操作系统分配空闲本地端口。cloudflaredPath: auto 会先检查系统命令，再安装经过校验的固定版本。自动安装文件缓存在 $DSH_HOME/cache/dsh-mobile-web-remote/cloudflared；也可以通过 cloudflaredPath 或环境变量 DSH_CLOUDFLARED_PATH 指定现有可执行文件。

卸载

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

随后重启 DSH。插件不会在 DSH 内核仓库中留下补丁。

开发与验证

pnpm install
pnpm check
pnpm test

友情链接

• DSHFind — DSH 生态项目索引

安全问题请按 SECURITY.md 私下报告，不要在公开 Issue 中提交配对链接、Token 或工作区数据。

许可

代码采用 MIT License 发布。运行时下载的 cloudflared 由 Cloudflare 以 Apache-2.0 许可发布，不属于本仓库的 MIT 授权。仓库头图属于社区角色的 AI 衍生创作，同样不纳入 MIT；详见 ASSET_LICENSE.md。