BB-84C/deepseek-harness-mobile-solution

dsh Mobile

从任意远程设备控制你本地的 DeepSeek Harness

License: MIT
Node ≥22
dsh plugin

本项目新增了一个远程控制平面和两种传输方式：

- Tailscale —— 在你的 tailnet 内点对点直连。
- VPS 中继 —— 如果你恰好有自己的 VPS，可以用它作为中继。一个中继，多台机器，一个菜单。

两者提供的是同一件事：通过带认证的网关访问官方 dsh web UI。

安装

这是一个 dsh 插件 —— 使用官方插件管理器安装，通过单一入口点控制：

一条命令（推荐）
dsh --profile mobile install

或直接添加这两个插件
dsh plugin --profile mobile add @bb-84c/dsh-mobile-cli
dsh plugin --profile web    add @bb-84c/dsh-mobile-server

一切都位于 dsh --profile mobile 之下 —— service、tailscale、relay、device、config、status、doctor、logs、update、uninstall。

| 包 | Profile | 角色 |
| --- | --- | --- |
| @bb-84c/dsh-mobile-cli | mobile | 命令族 |
| @bb-84c/dsh-mobile-server | web | 网关 + 传输 + 会话水合 |

📖 docs/plugin-install.md

特性

- 单一入口点：dsh --profile mobile
- 官方 UI，原样不变 —— 官方更新会自动到达你的手机
- 设备认证：一次性配对码，仅存储令牌哈希，即时吊销
- 通过 SSE/WS 实时流式传输，端到端隧道化
- 在中继域名上提供实例菜单
- 强制单一常驻实例；pidfile 守护的停止/重启
- 三操作系统脚本，自动启动模板
- 144+ 离线测试

工作原理

phone / browser
│
├─ tailscale ──────────────────────────────┐
│                                          ▼
└─ https:///instance// ─▶ relay ─▶ tunnel ─▶ gateway (device auth, :3081) ─▶ dsh web (:3080)

- dsh web 按发布时的方式，仅监听回环地址。
- 网关插件运行在同一个 dsh 进程内，并代理官方 UI。
- 中继是一个独立的零依赖 Node 服务。它存储凭据哈希和机器目录 —— 从不存储会话数据。

模式

Tailscale

dsh --profile mobile tailscale connect
dsh --profile mobile tailscale start
dsh --profile mobile device pair --name iPhone
dsh --profile mobile url

📖 docs/deployment/tailscale.md

VPS 中继

dsh --profile mobile relay connect https://relay.example.com --token
dsh --profile mobile relay start
dsh --profile mobile device pair --name iPhone

打开 https://relay.example.com，选择一台机器，配对，完成。

📖 docs/deployment/relay.md

面向 dsh 代理

正在为用户进行设置？请按顺序阅读，然后执行：

1. docs/plugin-install.md — 安装插件。
2. docs/deployment/tailscale.md 或 docs/deployment/relay.md — 设置传输方式。中继模式还需要在 VPS 上部署中继（scripts/relay-deploy）。
3. docs/commands.md — 命令参考。
4. 配对：dsh --profile mobile device pair --name 。使用 docs/acceptance.md 进行验证。

规则：

- 切勿修改随附的 @deepseek-ai/* 包。
- 每个 $DSH_HOME 只能有一个常驻的 dsh web 实例。
- 只能通过 CLI 停止/重启。
- 不要让令牌出现在日志和聊天中。
- 在官方 dsh 升级后，运行 docs/research/upstream-touchpoints.md。

仓库

├── packages/
│   ├── dsh-mobile-cli/        # dsh 插件：命令族
│   ├── dsh-mobile-server/     # dsh 插件：网关 + 隧道 + 水合
│   ├── dsh-mobile-common/     # 共享库
│   └── dsh-relay/             # 独立中继服务
├── scripts/                   # 安装程序、部署、探测、修复、自启动
├── docs/                      # 指南、部署、研究、规范
└── assets/                    # 美术资源

安全

- Web 服务器仅限回环地址；网关是唯一的网络接口。
- Tailscale 模式基于 WireGuard；中继模式是位于 Caddy 之后的 HTTPS。
- 配对码为一次性使用，5 分钟过期。令牌以哈希形式存储，以恒定时间验证，可即时撤销。
- 中继仅存储凭据哈希和一个公共目录。

文档

| 文档 | 受众 |
| --- | --- |
| docs/plugin-install.md | 用户 |
| docs/commands.md | 用户 |
| docs/deployment/service.md | 用户 |
| docs/deployment/tailscale.md | 用户 |
| docs/deployment/relay.md | 用户 |
| docs/acceptance.md | 用户与代理 |
| docs/plan.md | 项目 |
| docs/research/ | 项目与代理 |
| docs/specs/ | 应用实现者 |

要求

- 一台运行 DeepSeek Harness 且保持在线的机器。
- Node.js ≥ 22。
- Tailscale 或一台小型 VPS。

许可证

MIT — 参见 LICENSE。