dsh-mobile-web-remote

Readme

<p align="center"><img src="docs/assets/deepseek-mascot-hero.png" alt="DSH Mobile Web Remote 头图" width="100%"></p>

# DSH Mobile Web Remote

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

[![Compatibility CI](https://github.com/SnowfallC/dsh-mobile-web-remote/actions/workflows/compatibility.yml/badge.svg)](https://github.com/SnowfallC/dsh-mobile-web-remote/actions/workflows/compatibility.yml)

[English](README.en.md) · [安装指南](#安装) · [DSHFind](https://dshfind.com/)

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 会尽早暴露需要更新的薄适配层。

```mermaid
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 的中英文和深浅主题。
- 远程端保留“添加工作区”和“设置”的原生位置，但以灰色禁用态呈现；请先在电脑端完成宿主配置，再从手机进入现有会话。

## 界面

<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 源码仓库中执行：

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

### 从本地目录安装

```powershell
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`：

```yaml
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` 指定现有可执行文件。

## 卸载

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

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

## 开发与验证

```powershell
pnpm install
pnpm check
pnpm test
```

## 友情链接

- [DSHFind — DSH 生态项目索引](https://dshfind.com/)

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

## 许可

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