SnowfallC/dsh-mobile-web-remote

Install

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

## 界面

<p align="center"><img src="docs/assets/mobile-remote-modal.png" alt="DSH Mobile Web Remote 英文弹窗" width="760"></p>

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

<p align="center"><img src="docs/assets/dsh-floating-entry.png" alt="DSH 页面中的手机远程入口" width="760"></p>

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

<p align="center"><img src="docs/assets/mobile-dsh-interface.png" alt="手机浏览器中的 DSH 原生界面" width="390"></p>

## 安装

### 前置条件

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

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

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

### 从 GitHub 安装

在 DSH 源码仓库中执行：

Add SnowfallC/dsh-mobile-web-remote to your DSH config (web profile) to enable.