nanami-0713/dsh-remote-public

安装

手机扫码后：配对码 → 桌面确认 → 签发该设备专属 token → 自动连接。二维码只含 3 分钟有效的一次性配对码，永不含永久 token。

## 多设备支持

| 场景 | 支持情况 |
| --- | --- |
| 同一台手机控制多台电脑 | App 会保存所有配对过的电脑（每台电脑各自运行自己的 bridge）。扫新电脑二维码时自动追加，不会覆盖旧电脑；首页「电脑列表」可一键切换，并单独忘记某台电脑。 |
| 同一台电脑配多台手机 | bridge 本身就支持：`devices.json` 为每台手机签发独立设备 token，配对页可分别允许、查看最近活跃和吊销。 |

说明：每台被控电脑都要安装 dsh-remote 插件（或独立运行 bridge），因为它们各自代理自己的 `127.0.0.1:3080`，不会互相冲突。

## 平台支持

| 组件 | macOS | Windows | 说明 |
| --- | --- | --- | --- |
| dsh-remote 插件（index.js） | ✓ | ✓ | Node.js，平台无关 |
| bridge（bridge/server.js） | ✓ | ✓ | Node.js，平台无关 |
| Web 客户端（设置中的「手机遥控」页） | ✓ | ✓ | 浏览器平台无关 |
| Flutter App | ✓（构建 iOS/Android） | ✓（构建 Android） | 开发机均可 |
| 一键启动 | `start_dsh_remote.sh` | `start_dsh_remote.ps1` | 插件本身也会自动托管 bridge |

## 与 Agents Anywhere 的区别

[Agents Anywhere](https://github.com/anywhere-labs/Agents-Anywhere) 是一个多 Agent 远程控制平台，目标是统一控制 Codex、Claude Code 等编程 Agent，并提供文件浏览、远程终端、多设备配对等能力。

本项目定位不同：

| 维度 | DSH-Remote | Agents Anywhere |
|---|---|---|
| 控制对象 | 只控制 DeepSeek Harness (DSH) | Codex、Claude Code 等多个 Agent |
| 定位 | DSH 专用轻量手机遥控器 | 多 Agent、多设备通用控制平台 |
| 架构 | DSH 插件 + 本地 Node bridge + Flutter App | FastAPI 后端 + Connector + Web/Android |
| 文件/终端 | 暂不支持 | 支持远程文件、shell、终端 |
| 多设备 | 一手机可切换控制多台电脑；一电脑可配多台手机 | 支持多台设备接入 |
| 适合场景 | 个人远程控制自己的 DSH | 多 Agent、团队/自托管场景 |

简单说：**DSH-Remote 是为 DSH 量身定做的专用遥控器；Agents Anywhere 是面向多种 Agent 的通用平台。**

## 目录结构

| 路径 | 说明 |
|---|---|
| `bridge/` | Node.js 桥接服务（可独立运行，也是插件的托管对象） |
| `app/` | Flutter 手机 App（原生 + Web 双端） |
| `index.js` / `client.js` / `cordis.patch.yml` / `package.json` | dsh-remote 插件本体 |
| `docs/` | 公网访问方案 |
| `start_dsh_remote.sh` | 一键启动 DSH + bridge（独立运行模式） |

## 快速开始

### 方式 A：DSH 插件（推荐）

先发布/本地安装插件：

把 nanami-0713/dsh-remote-public 加入你的 DSH 配置（web profile）即可启用。