nanami-0713/dsh-remote-public ↗★ 0
dsh-remote
DSH plugin that brings the dsh-remote bridge and QR device pairing into the DSH web UI. Scan a one-time QR code from the phone app, approve on the desktop, and control DSH with a per-device token.
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:nanami-0713/dsh-remote-public说明文档
阅读完整 README ↗DSH-Remote
手机远程控制本机 DeepSeek Harness (DSH) 的项目。
本项目基于 DeepSeek Harness 构建,是 DSH 专用远程控制客户端。
这是一个脱敏后的公开版本,不包含任何个人 Token、IP、设备信息或本地绝对路径。
项目简介
DSH 默认只监听 127.0.0.1:3080,并且官方禁止直接 --host 0.0.0.0。
本项目提供两层能力:
- dsh-remote 插件:一条命令装进 DSH,DSH 页面右下角出现「手机遥控」按钮,点开即生成配对二维码、桌面确认、设备列表和吊销管理。
- 带鉴权的 bridge:插件自动托管(或独立运行)的桥接服务,默认拒绝式 API 白名单 + 每台手机独立设备 token。
手机侧不用再手填地址和 Token:扫码 → 电脑点允许 → 完成。没装 App 也可以直接用系统相机扫二维码打开手机网页版。
架构
DSH Web 页面
└─ dsh-remote 插件「手机遥控」按钮(二维码 / 桌面确认 / 设备吊销)
↓ loopback
bridge (0.0.0.0:8787)
├─ 手机 Flutter App ── 设备专属 Token ──→ /api/*(默认拒绝 + 白名单)
├─ 手机浏览器(网页版) ← QR 链接 → /app/
└─ /pair/* 一次性配对码、设备 token 注册表
↓ 转发
DSH (127.0.0.1:3080,只监听 loopback,绝不外露)
手机扫码后:配对码 → 桌面确认 → 签发该设备专属 token → 自动连接。二维码只含 3 分钟有效的一次性配对码,永不含永久 token。
与 Agents Anywhere 的区别
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 桥接服务(可独立运行,也是插件的托管对象) |