手机遥控台 rururunu/DSHC

DSHC

简体中文 · English

DSHC 是 DeepSeek Harness（dsh）的 Android 遥控台。Agent 仍在 PC 上跑。手机是控制台：走 dsh web 同一套 /api，默认局域网，可选公网。

两块：

| 插件 dsh-companion-gateway 0.1.5 | dsh web 里的 Cordis carrier | 绑 0.0.0.0:3081，Bearer，可选 cloudflared。不改 dsh 源码。 |
| DSHC ai.dsh.companion 0.1.3 | Android 8+ | HTTP RPC + 一条 remote.mux WebSocket（Typert Remote）。不调模型服务商。 |

flowchart LR
Phone[DSHC] -->|"Bearer HTTP + WS"| GW["插件 :3081"]
GW --> Proxy[dsh-host-apiproxy]
Proxy --> Agent[PC 上的 dsh]
Phone -.->|"同网优先"| LAN[局域网 IP] Phone -.->|"外出"| CF["https://host:443"]
CF --> Tunnel[cloudflared]
Tunnel --> GW

npm：dsh-companion-gateway。路由和故障表：server/README.md。模块：android/docs/ARCHITECTURE.md。协议：docs/dsh-wire-protocol.md。

1. 插件

必须挂在 web profile。装完 / 更新完都要重新跑一次 dsh web，新代码才进进程。token 在 ~/.dsh/profiles/web/companion-gateway.json，更新和卸载都不会清掉（再装会接着用）。

dsh plugin --profile web … 转发给该 profile 里的 pnpm，所以 add / update / remove 都能用。

安装

默认拉 npm 最新：

dsh plugin --profile web add dsh-companion-gateway
dsh web

需要钉死某一版时才加 @版本，例如 dsh-companion-gateway@0.1.5。

成功：日志出现 [companion-gateway] listening on http://0.0.0.0:3081 — bearer token required。

然后 dsh web →「手机网关」：

- 开关局域网。关掉只 unbind :3081，dsh web 继续跑。
- 首次 listen 把 Bearer token 写进 companion-gateway.json。不要写进 cordis.yml / 发布包。
- 手机扫二维码，或从局域网折叠项抄 host / port / token。

手机「添加 → 文件」需要插件 ≥ 0.1.2（GET /api/companion/workspace-files）。

能 ping 通 PC 但 :3081 超时 → 防火墙：

netsh advfirewall firewall add rule name="dsh-companion-gateway" dir=in action=allow protocol=TCP localport=3081 profile=private

本仓库开发（旁边要有 deepseek-harness）：

pnpm dsh plugin --profile web add file:C:/My/code/DshCompanion/DshCompanion/server
pnpm dsh web
或：cd server; .\setup.ps1

更新

拉 npm 上的最新版（--latest 不受 package.json 里 semver 范围限制）：

dsh plugin --profile web update dsh-companion-gateway --latest
停掉正在跑的 dsh web（Ctrl+C），再：
dsh web

本地 file: 安装：改完源码再 add file:… 一次，然后重启。

卸载

dsh plugin --profile web remove dsh-companion-gateway

只卸插件，不删 companion-gateway.json。局域网端口会在下次 dsh web 时不再监听 :3081。

2. 公网

默认走局域网。隧道可选，保存即生效，不用重启 dsh web。

「手机网关」→ 公网隧道：

| 模式 | 填什么 | cloudflared | 手机 |
| quick | 启用 + 二进制（默认 cloudflared） | tunnel --url http://127.0.0.1:3081 | .trycloudflare.com:443 / https。每次桌面重启域名会变，要重新扫码。 |
| named | 启用 + 公网 hostname + Cloudflare token | tunnel run --token … | hostname:443 / https。稳定。 |

Bearer 与局域网相同。没有 token 不会开隧道（先把局域网网关打开一次）。页上状态：启动中 / 已就绪+URL / 失败+原因。

PATH 里没有 cloudflared：winget install Cloudflare.cloudflared，或在表单里填绝对路径。

隧道就绪后刷新二维码。payload 走公网 host/port/scheme；仍带 lanHost，同 Wi-Fi 时手机优先局域网。

cordis.yml 的 public. 只是启动兜底。GUI 上次写进 companion-gateway.json 的为准。

谁知道 Quick Tunnel URL 谁就能打到网关，门只有 Bearer。空/弱 token 不要开公网。不要把 dsh web 本身 bind 到 0.0.0.0——GUI 路由能读出明文 token。

3. DSHC

构建（Android Studio JBR 在 PATH 里）：

$env:JAVA_HOME='C:\Users\GuoLv\AppData\Local\Programs\Android Studio\jbr'
$env:GRADLE_USER_HOME='C:\Users\GuoLv\.gradle'
cd android
.\gradlew.bat --no-daemon assembleDebug

安装 android/app/build/outputs/apk/debug/app-debug.apk。minSdk 26。相机可选（仍可手动填）。Debug 包名 ai.dsh.companion.debug。

远程更新

支持。设置 → 关于 DSHC → 检测更新。有新版本会从 GitHub Releases 下 APK（先读 latest.json，没有则退到最新 Release 的 .apk），下完点安装。进前台也会后台检查，关于项会打红点。

需要系统允许「安装未知应用」。这条通道只覆盖 同一签名、同一包名 的正式包（ai.dsh.companion）。自己打的 debug（ai.dsh.companion.debug）装不上 GitHub 正式包，继续侧载 debug APK。

发版步骤：android/docs/release.md。

配对

1. 插件已在听（第 1 步）。同一 Wi-Fi，或公网隧道已就绪（第 2 步）。
2. 手机扫码，或连接页点「扫描二维码」。
3. 确认。DSHC 把主机写进名册（显示名、token、可选 lanHost）。

不扫码就手动填：

| | 局域网 | 公网 |
| 主机 | PC 局域网 IP（192.168.x.x） | 隧道域名 |
| 端口 | 3081 | 443 |
| 协议 | http | https |
| Token |「手机网关」局域网折叠项 / companion-gateway.json | 同一个 token |

Deep link：dshc://pair?v=1&host=&port=&scheme=&token=&code=（code TTL 10 分钟）。

connect() = ping /healthz + host.describe + 打开 /api/remote.mux WebSocket（Typert 流：$events / session/control / workspace/follow，每个打开的会话另有 session/follow）。mux 断开、空闲超时、心跳失败或默认网卡变了 → nudge() 全部逻辑流一起重建（每个流以 baseline/ready/snapshot 开头，自动补齐断线缺口）。每 20s 打 /healthz，避免 NAT / Cloudflare / 手机无线电把闲置对话掐掉。

DSHC 做什么

手机投影桌面状态，并发送把 PC 解冻的 RPC。Agent 一份，审批闸门一道，屏幕两块。

| 界面 | |
| 会话 | session/list / 改名。界面上的删除 = workspace/archiveSession（dsh 没有 session-delete）。 |
| 工作区 | workspace/。列表来自 workspace/follow 流 baseline；按 sessionIds 分组（session/list 没有 workspaceId），文件树退到会话 cwd。 |
| 聊天 | session/prompt + assistant/chunk。历史与直播都来自 session/follow 流（快照 + 事件）；顶栏：模型（session/modelCatalog / selectModel）和权限预设。 |
| 添加 | 输入框 + → 分页 消息（/compact /goal /plan）/ 文件（工作区树 → @路径）。附件：选择图片（内联上传，PNG/JPEG/WebP/GIF，HEIC/超大图自动转码）。文件附件需 dsh ≥ 0.1.3（/api/session/uploadFileBinary）；在 0.1.2-rc.1 上会返回明确错误。 |
| 提问 / 审批 | $events 流的 approval/request、user-questions/request waterfall → POST /api/$events/result。工具闸门只有 允许一次 / 拒绝。 |
| 回传文件 | 桌面 share_to_companion → 卡片 → Range GET /api/companion/files/（上限 500MB）。path 不出 PC。 |

dsh 没有、因此 DSHC 也没有：会话级工具授权、skills/MCP 目录、第二套 Agent。
DSHC 基于 Typert Remote 协议（dsh ≥ 0.1.2-rc.1）；文件附件需 dsh ≥ 0.1.3。历史消息里的图片缩略图与工具产图回显暂未实现。

布局

DshCompanion/
├── server/ dsh-companion-gateway（index apply + http / tunnel / pairing / gui / share） ├── android/ app + feature: + core:{model,domain,network,data,designsystem} └── docs/ dsh-wire-protocol.md, img/

改网关：server/src/{http,tunnel,pairing,gui}.ts。改连接/会话/审批/工作区：android/core/data/.../repository/。改气泡/输入框/面板：android/feature/chat/。

限制

- dsh 是 developer preview；DSHC 钉当前 checkout。
- Quick Tunnel 域名随桌面重启变——对该主机重新配对。
- 空 token：不 bind 非 loopback，不开隧道。

致谢

DSHC 是 DeepSeek Harness 的 Android 伴侣：Agent 仍在 PC 上跑，手机只是控制台。感谢 DeepSeek 开源 dsh 以及「Everything is a Plugin」这套机制。

协议

MIT