手机远程操控JochenYang/dsh-remote

dsh-remote — 手机上的 DeepSeek Harness

License: MIT
CI
TypeScript
Node
pnpm
Protocol
PRs Welcome

简体中文 | English

用手机浏览器完整操作 DeepSeek Harness 桌面端：
自托管中继 + 桌面插件的点对点隧道，不改 dsh 内核与前端，
并为手机自动注入移动适配层。

组成

| 目录 | 角色 | 文档 |
|---|---|---|
| relay-server/ | 自托管中继：配对认证、HTTP 反向代理、WS 帧桥接、管理台。部署在公网 VPS（TLS 之后）。 | 简体中文 · English |
| dsh-remote/ | 桌面 host 插件：注册到中继，把手机流量桥接到本地 dsh web server；内置移动适配层与设置页。 | 简体中文 · English |
| android-app/ | 原生 Android 客户端（开发中）：配对＋会话＋聊天骨架，直连 relay 代理面；设计方向见需求确认记录。 | — |
| docs/PROTOCOL.md | 两端共同遵守的隧道协议契约（v1）：帧格式、握手、安全边界。 | — |

架构

手机浏览器 ──HTTPS──> relay-server ──WS 帧──> dsh-remote 插件 ──HTTP/WS──> 本地 dsh web server
│                    │  └─────────── 下行事件流透传（/events/）────────────┘
│                                                               (127.0.0.1:)
├── 上行：/d// 全量反代，帧序即流序（SSE / blob 不受影响）
├── 配对：6 位配对码 + 一次性挑战-响应（HMAC-SHA256），HOST_TOKEN 为信任边界
└── 安全：落盘只存 sha256 摘要；日志永不打印令牌与配对码

快速开始

1. 部署中继（公网 VPS，Node ≥ 22 + caddy TLS）：
relay-server/ 内 pnpm build 后按其 README 的 systemd + caddy 步骤部署；
CentOS/Rocky/Alma 可用自带 deploy/install.sh  一键完成。
2. 安装插件（桌面 DSH，含 web profile）：
从 Releases 下载 dsh-remote-.tgz，
dsh plugin --profile web add ./dsh-remote-.tgz 并重启 DSH。
从源码构建：dsh-remote/ 内 pnpm install && pnpm build && pnpm build:client && pnpm pack。
3. 配对：桌面 设置 → 手机连接 填中继地址与 HOST_TOKEN，
手机扫二维码或在 /pair 输入 6 位配对码即可进入与桌面同源的操作界面。

移动适配（亮点）

dsh 自带 web 界面是纯桌面布局，本仓库在隧道内为手机补齐了完整移动体验：

- 聊天正文与输入卡片全宽（重定义布局 CSS 变量，非侵入）；
- 设置弹窗全屏化、导航横滑条；模型下拉视口钳制；
- 侧栏抽屉化（展开时悬浮，不再挤压聊天区）；
- 键盘不再遮挡输入框（interactive-widget=resizes-content）。

适配样式只注入隧道流量，桌面 / GUI 打开的界面零变化；锚点全部避开构建期
hash 类名，dsh 升级若结构变化则自动退回原生桌面布局，不会更糟。

安全模型
- HOST_TOKEN 是 relay 的唯一信任边界；配对走一次性挑战-响应，防重放。
- 中继落盘只存 sha256(code) / sha256(token)；日志脱敏。
- 手机经 HttpOnly 会话 cookie 认证；管理台独立口令与会话。
- 新版 dsh 的浏览器会话认证（client-connection）由主机插件在进程内桥接：
用 Connection 启动令牌换取绑定回环 authority 的 cookie 并附到隧道流量上，
令牌绝不下发手机；老版 dsh 无此服务时自动降级为透传。
- 部署必须置于 TLS 之后（README 提供 systemd + caddy 完整示例）。

完整威胁模型与帧格式见 docs/PROTOCOL.md。

开发

两个包均为独立 pnpm 项目：

cd relay-server && pnpm install && pnpm build && pnpm typecheck
cd dsh-remote  && pnpm install && pnpm build && pnpm typecheck

dsh-remote 的 tsconfig 类型映射指向本机的 deepseek-harness 检出
（../../deepseek-harness），CI 只做构建与 node --check。

License

MIT © 2026 JochenYang