<!-- banner --> <div align="center">

dsh-coding-remote-kit

v0.4.1 · DeepSeek Harness 0.1.0-rc.6 · GitHub dsh-coding-remote-kit

面向 DeepSeek Harness 的远程手机访问插件。 把手机配对到已经在跑 dsh web 的桌面，观察会话并做一组窄写操作——不必把完整 Web API 暴露出去。

  

English · 中文版 · 日本語 · 한국어 · Português (BR) · Español · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md)

</div>

---

> 升级： 按 [INSTALL.md](INSTALL.md) 的版本化步骤操作。0.4.1 修复 0.4.0 在严格 Cordis 注入检查下的启动失败；保留 profile、存储与配对文件，所有选定插件更新后再重启一次现有 DSH Web 进程。dsh-coding-oauth-core@0.1.0 仍是 Hub/Subscription 的共享 npm 依赖，不是需要单独安装的 DSH 插件。

---

社区插件。与 DeepSeek 无隶属关系，也不暗示官方背书。 产品意图更接近 Orca Mobile Companion，而不是第二份桌面 IDE。

改这个仓库之前先读 [AGENTS.md](AGENTS.md)：禁止自行重启生产 DSH Web 进程或其本机服务包装。 只准备 tarball，由操作者通过测试机自己的进程管理器重启。

名称

最初 GitHub 仓库名是 dsh-mobile-remote。npm 上的 dsh-mobile-remote 是另一个项目（微信遥控插件）。本插件发布名为 dsh-coding-remote-kit。

不要执行 dsh plugin add dsh-mobile-remote——那会装到别人的微信插件。

状态

特性

• 双语界面 — 桌面设置页与手机端支持中文 / English（?lang= 或应用内切换；默认跟随 navigator.language）。
• 一次配对 — 桌面展示二维码或 8 位 PIN；手机钉死桌面 X25519 公钥并持有 deviceToken（服务端只存 SHA-256）。
• 双平面 — 管理面留在回环 dsh web；移动数据面是独立端口（默认 6879）上的 RPC 白名单。
• 握手后 E2EE — /m/ws 走 tweetnacl secretbox；未认证连接看不到会话内容。
• 窄写操作 — 观察会话、应答审批/提问、短回复；重编辑仍回桌面。
• 私网优先 — 推荐 LAN / Tailscale。可选 Cloudflare Quick Tunnel 只暴露数据面，永不暴露 3080。可选自建会合中继：桌面与手机都出站，业务帧仍 E2EE。
• 标准插件形态 — 一个 Cordis 服务端插件 + classic-script 设置页。用 file tarball 做 dsh plugin --profile web add，不要 link: 工作树。

截图

<p align="center"> <img src="docs/assets/zh-CN/settings-pairing.png" alt="桌面设置 — 配对二维码与 PIN" width="48%" /> &nbsp; <img src="docs/assets/zh-CN/settings-overview.png" alt="桌面设置 — 通道状态与已配对设备" width="48%" /> </p> <p align="center"><em>桌面 设置 → 移动远程：生成配对 offer（左）· 通道状态与设备（右）</em></p>

<p align="center"> <img src="docs/assets/zh-CN/mobile-pair.png" alt="手机配对页" width="28%" /> &nbsp;&nbsp; <img src="docs/assets/zh-CN/mobile-sessions.png" alt="手机会话列表" width="28%" /> </p> <p align="center"><em>手机端：输入 PIN / 扫码（左）· 配对后的会话列表（右）</em></p>

本插件解决的问题

快速开始

dsh plugin --profile web add dsh-coding-remote-kit@0.4.1

然后由操作者在自己的时间窗重启现有 DSH Web 进程。打开 设置 → 移动远程，生成配对 offer，手机扫码（或手输 PIN）。

源码 checkout（开发）：

pnpm test:sandbox
pnpm pack
mkdir -p "$HOME/.dsh/packages"
cp dsh-coding-remote-kit-0.4.1.tgz "$HOME/.dsh/packages/"
dsh plugin --profile web add "$HOME/.dsh/packages/dsh-coding-remote-kit-0.4.1.tgz"

不要对本工作树执行 dsh plugin add ./。pnpm 11 会把某些 file: tarball 解析成 link: 源码树，入口 import 失败会拖死整个 GUI。

目录

• [名称](#名称)
• [状态](#状态)
• [特性](#特性)
• [截图](#截图)
• [本插件解决的问题](#本插件解决的问题)
• [快速开始](#快速开始)
• [安装](#安装)
• [工作原理](#工作原理)
• [设置页](#设置页)
• [手机 RPC](#手机-rpc)
• [公网隧道](#公网隧道)
• [安全](#安全)
• [架构](#架构)
• [文档](#文档)
• [相关项目](#相关项目)
• [贡献](#贡献)
• [许可证](#许可证)

安装

需要 DeepSeek Harness 0.1.0-rc.6（钉死）与 Node.js 22.19+。完整步骤、配对与隧道说明见 [INSTALL.md](INSTALL.md)。

开发：

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 手机页

工作原理

设置页（回环）                 手机浏览器
        │                            │
        │  二维码 / 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() 时自动跑）

手机 RPC

白名单方法（其余一律 forbidden）：

status.get · session.list · session.history · session.subscribe · session.unsubscribe · host.subscribe · session.prompt · session.cancel · session.create · respond

推送包括会话事件以及带 rpcId 的 approval.requested / question.requested（供 respond 回显）。线格式见 [docs/03-protocol.md](docs/03-protocol.md)。

公网隧道

默认关闭。在设置页启动时，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。

禁止事项：

• 不共享他人凭据。
• 不监测未授权账户。
• 不把数据面端口裸绑 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)。

文档

相关项目

• dsh-coding-subscription-oauth — 同作者的兄弟插件；本仓库文档布局参照它。
• GitHub：lninghaha/dsh-coding-remote-kit。
• 本插件独立于用量中心插件 dsh-hub-oauth-gateway。
• 不替代官方 @deepseek-ai/dsh。

贡献

欢迎 issue 与 PR。Docker 沙箱、提交约定与文档分层见 [CONTRIBUTING.md](CONTRIBUTING.md)。

许可证

[MIT](LICENSE)。