桌面 设置 → 移动远程：生成配对 offer（左）· 通道状态与设备（右）
手机端：输入 PIN / 扫码（左）· 配对后的会话列表（右）
## 本插件解决的问题 | 你搜到 / 看到的 | 实际坏在哪 | 本插件怎么处理 | |---|---|---| | 「DSH 有没有 Orca 那种手机 companion」 | 官方没有一等公民的配对手机 App | 语义 companion：配对 + E2EE + 白名单 RPC | | 手机上用 `dsh-pocket` / `dsh-web-remote` | 权限面 ≈ 完整 `dsh web` | 双平面；未知 RPC 一律 `forbidden` | | 手机在蜂窝网、桌面在局域网 | 裸 LAN HTTP 页面可被 MITM | 优先 Tailscale；可选 Quick Tunnel（边缘 TLS，回源本机） | | 插件 `import` 失败、3080 挂了 | DSH 会 fail-fast 整棵插件树 | 沙箱门禁 + tarball 拷到仓库外；禁止 `link:` | ## 快速开始 ```bash dsh plugin --profile web add dsh-coding-remote-kit@0.7.2 ``` 然后由**操作者**在自己的时间窗重启现有 DSH Web 进程。打开 **设置 → 移动远程**，生成配对 offer，手机扫码（或手输 PIN）。 源码 checkout（开发）： ```bash pnpm test:sandbox pnpm pack mkdir -p "$HOME/.dsh/packages" cp dsh-coding-remote-kit-0.7.1.tgz "$HOME/.dsh/packages/" dsh plugin --profile web add "$HOME/.dsh/packages/dsh-coding-remote-kit-0.7.1.tgz" ``` 不要对本工作树执行 `dsh plugin add ./`。pnpm 11 会把某些 `file:` tarball 解析成 `link:` 源码树，入口 import 失败会拖死整个 GUI。 ## 目录 - [名称](#名称) - [状态](#状态) - [特性](#特性) - [截图](#截图) - [本插件解决的问题](#本插件解决的问题) - [快速开始](#快速开始) - [安装](#安装) - [工作原理](#工作原理) - [设置页](#设置页) - [手机 RPC](#手机-rpc) - [公网隧道](#公网隧道) - [安全](#安全) - [架构](#架构) - [文档](#文档) - [相关项目](#相关项目) - [贡献](#贡献) - [许可证](#许可证) ## 安装 安装闸门：DeepSeek Harness `>=0.1.1-rc.2 <0.3.0`（`engines.dsh`）；verified 构建 BOM 仍为 `0.1.1-rc.2`。`0.1.5-rc.1`、`0.2.1-rc.2` 等未验证候选记在 BOM。需要 Node.js 22.19+。完整步骤见 [INSTALL.md](INSTALL.md)。 开发： ```bash pnpm install && pnpm build && pnpm test # 在 Docker 沙箱里跑，不要在活着的 GUI 宿主机上跑 pnpm test:sandbox # Dockerfile 的 check / isolated-install / verify ``` 构建产物： - `lib/server/index.js` — Cordis 入口（`name` / `inject` / `Config` / `apply`） - `lib/client.js` — 设置页 classic-script - `lib/mobile/` — 数据面 `/m` 手机页 ## 工作原理 ```text 设置页（回环） 手机浏览器 │ │ │ 二维码 / PIN ────────────┤ ▼ ▼ /api/mobile-remote/* GET /m + WS /m/ws (dsh web, :3080) （数据面, :6879, E2EE） ``` 管理面留在宿主 Web 的回环围栏内。数据面是独立的 `node:http` + `ws`。配对广告 LAN 候选时可能把数据面从 `127.0.0.1` 再绑定到 `0.0.0.0`；若 Quick Tunnel 已在跑，则广告其 HTTPS origin，不再 widen。 ## 设置页 打开 **设置 → 移动远程**： - 状态（bind、端口、是否在听、活跃设备、隧道、会合中继） - **局域网** / **Quick Tunnel** / **会合中继** - 生成 offer → 二维码 + 8 位 PIN - 设备列表与吊销 - 可选安装官方 `cloudflared`（禁止在插件 `apply()` 时自动跑） - 连接诊断（脱敏网络候选、cloudflared 钉死校验、免责版本） - Quick Tunnel 免责勾选（Start 前必选） ## 手机 RPC 白名单方法（其余一律 `forbidden`）： `status.get` · `session.list` · `session.history` · `session.subscribe` · `session.unsubscribe` · `host.subscribe` · `session.prompt` · `session.cancel` · `session.create` · `respond` · `device.name` 推送包括会话事件以及带 `rpcId` 的 `approval.requested` / `question.requested`（供 `respond` 回显）。线格式见 [docs/03-protocol.md](docs/03-protocol.md)。 ## 公网隧道 默认**关闭**。设置页须先勾选免责声明（请求体 `disclaimerAccepted: true`）再 Start。`cloudflared` Quick Tunnel **只**指向 `127.0.0.1:<数据面端口>`。`/m` 会在 `https://<随机>.trycloudflare.com` 上可达；配对仍需要 fragment 令牌（或 PIN）和 E2EE。插件 unload / 点「停止」时杀掉子进程。 禁止把 `3080` / `dsh web` 送进隧道。可选自建会合中继（桌面与手机都出站，业务仍 E2EE）：见 [docs/05-cloud-relay.md](docs/05-cloud-relay.md)。需要 Cloudflare Workers Paid，**不是**本项目运营的公共中继。 ## 安全 不变量（完整模型：[docs/04-threat-model.md](docs/04-threat-model.md)）： 1. 未认证连接只处理握手。 2. `deviceToken` 只存 SHA-256；密钥与注册表文件权限 0600。 3. RPC 白名单默认拒绝；写操作审计到 `deviceId`。 4. 管理面：回环 + Host + CSRF。 5. 不削弱 `dsh web` `/api`，不抢 `api-proxy` provider。 **v0 诚实边界：** 裸 LAN 上 `/m` 的首次 HTTP 下发可被 MITM。优先走 overlay VPN。`/m` 响应带 Content-Security-Policy（`script-src 'self'`、`frame-ancestors 'none'`），用来收窄页面加载后的注入面，并不能关闭首次下发被替换的缺口。 禁止事项： - 不共享他人凭据。 - 不监测未授权账户。 - 不把数据面端口裸绑 `0.0.0.0` 到公网（用户显式开启的 Quick Tunnel 除外）。 - 不暗示 DeepSeek 官方背书。 文档示例只用 `example.com`、`127.0.0.1`、`YOUR_TOKEN`。 ## 架构 双平面、模块、存储与握手：[docs/02-architecture.md](docs/02-architecture.md) · [中文](docs/02-architecture.zh-CN.md)。 MVP 决策（路线 B）：[docs/01-mvp-scope.md](docs/01-mvp-scope.md)。 ## 文档 | 文档 | 用途 | |---|---| | [INSTALL.md](INSTALL.md) | 安装、配对、隧道 | | [CHANGELOG.md](CHANGELOG.md) | 发布历史 | | [docs/00-project-rules.md](docs/00-project-rules.md) | 版本、公开 vs 本地、宿主 DSH 红线 | | [docs/01-mvp-scope.md](docs/01-mvp-scope.md) | ADR：MVP 范围 | | [docs/02-architecture.md](docs/02-architecture.md) | 内部架构 · [中文](docs/02-architecture.zh-CN.md) | | [docs/03-protocol.md](docs/03-protocol.md) | RPC 白名单与推送信封 | | [docs/04-threat-model.md](docs/04-threat-model.md) | 资产、攻击者、不变量 | | [docs/05-cloud-relay.md](docs/05-cloud-relay.md) | 自建会合中继（M5） | | [docs/06-dsh-alpha-smoke.md](docs/06-dsh-alpha-smoke.md) | 未验证 DSH 候选宿主的隔离冒烟（`0.1.2-alpha.*`、`0.1.5-rc.1`） | | [CONTRIBUTING.md](CONTRIBUTING.md) | 贡献指南 | | [AGENTS.md](AGENTS.md) | Agent/操作者规则（禁止自行重启生产） | ## 相关项目 - [dsh-coding-subscription-oauth](https://github.com/lninghaha/dsh-coding-subscription-oauth) — 同作者的兄弟插件；本仓库文档布局参照它。 - GitHub：[`lninghaha/dsh-coding-remote-kit`](https://github.com/lninghaha/dsh-coding-remote-kit)。 - 本插件独立于用量中心插件 `dsh-hub-oauth-gateway`。 - 不替代官方 `@deepseek-ai/dsh`。 ## 贡献 欢迎 issue 与 PR。Docker 沙箱、提交约定与文档分层见 [CONTRIBUTING.md](CONTRIBUTING.md)。 ## 许可证 [MIT](LICENSE)。