DSH-Remote

手机远程控制本机 DeepSeek Harness (DSH) 的项目。
本项目基于 DeepSeek Harness 构建，是 DSH 专用远程控制客户端。

这是一个脱敏后的公开版本，不包含任何个人 Token、IP、设备信息或本地绝对路径。

项目简介

DSH 默认只监听 127.0.0.1:3080，并且官方禁止直接 --host 0.0.0.0。
本项目提供两层能力：

1. dsh-remote 插件：一条命令装进 DSH，DSH 左下角「设置」弹窗中新增「手机遥控」页，点开即生成配对二维码、桌面确认、设备列表和吊销管理。
2. 带鉴权的 bridge：插件自动托管（或独立运行）的桥接服务，默认拒绝式 API 白名单 + 每台手机独立设备 token。

手机侧不用再手填地址和 Token：扫码 → 电脑点允许 → 完成。默认二维码是 dshremote:// 链接，以 App 为第一入口；未装 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。

多设备支持

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

平台支持

与 Agents Anywhere 的区别

Agents Anywhere 是一个多 Agent 远程控制平台，目标是统一控制 Codex、Claude Code 等编程 Agent，并提供文件浏览、远程终端、多设备配对等能力。

本项目定位不同：

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

目录结构

快速开始

方式 A：DSH 插件（推荐）

先发布/本地安装插件：

# 发布到 npm 后：
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-remote

# 本地开发包：
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add /path/to/dsh-remote-public

重启 dsh web 并硬刷新，打开左下角「设置」即可看到「手机遥控」页。插件会自动托管 bridge（检测到已有健康 bridge 就复用）。

方式 A-2：Windows 一键启动（插件已装时可用）

在 PowerShell 中执行：

powershell -ExecutionPolicy Bypass -File .\start_dsh_remote.ps1

脚本会检查并启动 DSH 与 bridge、验证健康状态、显示 Tailscale / 局域网地址并打开配对页。首次启动时如 Windows 防火墙弹出授权，请允许专用网络访问。

方式 B：独立 bridge

cd bridge
npm install
cp config.example.json config.json
# 修改 config.json 里的 token，建议用：
# openssl rand -hex 32
npm start

手机扫码绑定

电脑端（插件面板或独立配对页 http://127.0.0.1:8787/pair/qr）生成二维码：

• 已装 App（推荐）：打开 DSH-Remote App 点「扫码绑定电脑」扫二维码 → 自动保存设备专属 token 并连接。二维码支持 dshremote:// 唤起，兼容的扫码场景可直接打开 App。
• 未装 App：配对页点「复制网页版链接」，在手机浏览器打开 http://<电脑IP>:8787/app/?code=... → 自动配对连接。

网页版需要先构建一次：

cd app
flutter build web --release --base-href /app/

扫码后在电脑端点「允许」，之后不需要手填任何地址或 Token。

运行 Flutter App

cd app
flutter pub get
flutter run

手机 App 功能

• 扫码绑定：自动获取设备专属 token（原生端存 Keychain/Keystore）
• 多电脑切换：保存所有配对过的电脑，扫新电脑自动追加；首页「电脑列表」切换，可单独忘记
• 自动连接：下次打开直接连回上次选中的电脑
• 查看 DSH 会话列表
• 新建会话：可选预设（agent preset）、模型供应商 / 模型 / 推理强度、工作文件夹（直接选择电脑端已登记的 workspace，也可手填路径）
• 发送指令，支持从相册选择图片一起发送
• 实时查看 DSH 执行过程 / 流式输出；步骤与工具调用明细默认折叠，点步骤卡片展开；历史里的海量 token 流自动合并成完整消息
• 手机上批准 DSH 审批请求、回答 DSH 提问
• 隐私保护：电脑 IP 地址、工作目录、会话 ID 默认打码，点眼睛图标后显示
• 手动配置（高级）：仍可手填桥接地址和 Token
• Web 版兜底：系统相机扫码直接打开并自动配对

打包 Android APK

需要 JDK 17 和 Android SDK。

cd app
export JAVA_HOME=/path/to/jdk-17
export ANDROID_HOME=/path/to/android-sdk
flutter build apk --release

APK 输出到：

build/app/outputs/flutter-apk/app-release.apk

Release 标签（v*）会通过 GitHub Actions 自动构建 APK 并附到 Release；npm 发布任务带私密路径守卫，只允许在脱敏仓库执行。

当前 release 包使用 debug 签名，方便安装测试；上架应用商店前需要换成正式签名。

验证

# bridge 健康检查
curl http://127.0.0.1:8787/health

# 配对全流程回归测试（自动起隔离实例）
cd bridge
bash test_pairing.sh

# Flutter 静态检查与测试
cd ../app
flutter analyze
flutter test

# 端到端联调（需要 DSH + bridge 已启动）
dart run tool/bridge_integration_test.dart

公网访问

详见 docs/public-access.md。

安全提醒

• DSH API 可以驱动 agent 执行 shell / 文件操作，风险极高。
• 不要把 DSH 的 3080 端口直接暴露到公网。
• 公网必须 HTTPS + Token。
• 二维码只携带一次性配对码（3 分钟有效、单次使用），永远不携带永久 token；默认需电脑端点「允许」。
• 每台手机签发独立设备 token，散列存储，可在配对页单独吊销。
• bridge 对 DSH 方法默认拒绝，只放行手机 App 需要的 session.list/create/models/selectModel/prompt/cancel/history、agentPreset.list、llm.models、workspace.list（只读）与 respond。
• 开启 bridge 的 IP 白名单和限流。
• bridge/config.json 和 bridge/devices.json 已加入 .gitignore，不要提交真实 Token 或设备表。