README.md

September 2, 2026 · View on GitHub

DeepSeek Harness Mobile（DSH Mobile）

面向 iOS 和 Android 的开源 DeepSeek Harness 手机端。
扫码配对，无需账号。
在手机上查看任务、继续 Agent 对话。

基于 DeepSeek Harness 构建的社区扩展。中文 · English

DeepSeek Harness 手机端任务列表    DeepSeek Harness Mobile 对话界面

GitHub stars MIT License Supported platforms: iOS and Android PWA LAN pairing

DSH Mobile 把 DeepSeek Harness 的 Agent 能力带到手机浏览器：通过局域网二维码与桌面 Host 配对，在 PWA 中浏览任务列表、进入会话、查看工具进度与轨迹。Host 仍运行在电脑上；Mobile 负责配对、连接与移动壳 UI，并通过官方插件机制与 Harness 组合。

快速开始

手机与电脑需在同一局域网，或通过手机可访问的穿透地址访问 Mobile PWA（:8030）。无需注册账号。

端地址说明
桌面 Hosthttp://127.0.0.1:3080/?token=...见下方「开发启动」；须用终端打印的带 token 的 URL 首次打开；侧栏 手机连接 展示二维码
Mobile PWA（本机）http://127.0.0.1:8030见下方「开发启动」；仅适合在电脑浏览器预览
Mobile PWA（局域网）http://<电脑 IP>:8030手机请用此地址；/api 与 WebSocket 由 Vite 代理到 Host :3080
Mobile PWA（穿透）https://<你的隧道域名>只穿透 8030，不要穿透 Host :3080

本机访问 vs 局域网 / 穿透（易踩坑）

开发时有两条路径，用途不同：

场景打开哪个地址说明
电脑上调试 Mobile UIhttp://127.0.0.1:8030本机回环；配对、扫码链路仍依赖下方「手机可达」地址
手机配对 / 日常使用http://<电脑 IP>:8030 或穿透域名手机必须能打开这个地址；页面再通过同源 /api 代理到 Host

架构要点： 手机只跟 Mobile（:8030）说话；Mobile 开发服务器把 /api 与 WebSocket 代理到本机 Host（:3080）。二维码与配对页也应指向 Mobile，而不是 Host。

常见踩坑：

  1. 手机打开 127.0.0.1:8030：手机上的 127.0.0.1 是手机自己，连不到电脑，页面打不开或配对失败。请改用电脑局域网 IP，或穿透地址。
  2. 只穿透 / 只访问 Host :3080：配对页在 Mobile 上（/mobile/pair），且 /api 代理在 Vite 侧；手机直连 Host 会缺代理与配对路径。穿透时只暴露 :8030。
  3. 二维码里是电脑内网 IP，手机却不在同一局域网：扫码后无法打开配对页。同网用局域网 IP；异地用穿透，并确保二维码 / 短码对应的是穿透后的 Mobile 地址。
  4. 电脑上 127.0.0.1:8030 能开、手机用穿透却配对失败：确认隧道指向的是 Mobile（8030）而非 Host（3080）；本仓库 Vite 已对代理请求去掉 Origin/Referer，避免穿透来源被 Host 的 Origin 校验拦住。
  5. 直接打开 http://127.0.0.1:3080/ 出现 401：上游 dsh TAG5+ 引入浏览器认证。请用终端 1 里 dsh web: 打印的完整 URL（含 ?token=...）首次登录；Mobile 用 :8030。

更细的穿透与短码说明见 手机端开发文档。

配对步骤

  1. 电脑启动 Host，再启动 Mobile PWA（见下方「开发」）。
  2. 桌面 Web 侧栏点击 手机连接，或进入 设置 → DSH 移动端 配置连接密码（可选）。
  3. 手机用局域网 IP 或穿透地址打开 Mobile，扫描电脑二维码；或在配对页从相册选择二维码图片。不要用手机访问电脑的 127.0.0.1。
  4. 配对成功后进入 全部任务 列表，点选任务继续对话。

桌面侧栏手机连接二维码

手机扫码配对    未配对时的手机首页

短码配对、生产构建与代码地图见 手机端开发文档。

文档

目标入口
本地开发与配对细节手机端开发文档
iOS / Android 原生 App原生 App 打包
Host 配对 API 与配置packages/host/mobile-pairing/README.md
手机壳与桌面 QR 代码地图手机端开发文档 — 相关代码
Harness 架构与插件系统架构文档
参与上游贡献CONTRIBUTING.md

主要功能

扫码配对

桌面 Host 生成二维码与 6 位短码；手机扫码或输入短码即可配对。支持可选连接密码与桌面确认模式，无需第三方账号。

DSH 移动端设置与二维码

任务列表

iOS 风格任务首页：浏览全部或运行中任务、搜索历史会话、查看连接状态，右下角一键新建任务。

手机任务列表

移动对话

在手机上发送消息、查看 Agent 回复、工具调用进度与轨迹；支持模型选择、Plan 模式与上下文统计。

手机对话与工具进度

PWA 安装

手机浏览器可添加到主屏幕，获得更接近原生 App 的全屏体验。开发模式下通过 Vite 代理访问 Host API。

手机对话完成态

插件化设计

DSH Mobile 没有单独 fork 一套 Agent 运行时。Host 配对（dsh-host-mobile-pairing）、桌面 QR UI（dsh-client-ui-mobile-pairing）与手机壳（dsh-client-mobile-shell）都是合法的 DSH 插件，通过 cordis.patch.yml 与官方 Web profile 组合。会话、模型、工具与插件能力仍来自桌面 Host；Mobile 负责配对传输层与移动 presentation。

项目结构

Mobile 相关代码嵌在 DeepSeek Harness monorepo 中，按 Host / Client / App 三层分工：

apps/mobile/                         # Mobile PWA 入口（Vite + PWA）
packages/
  host/mobile-pairing/               # Host：配对 API、二维码、短码、设备管理
  client/
    ui-mobile-pairing/               # 桌面：侧栏「手机连接」与「DSH 移动端」设置
    mobile-shell/                    # 手机：任务首页、扫码、对话、轨迹、连接管理
    connection/                      # Host↔Client 连接与会话传输
  bundle/web-app/                    # Web profile：把上述插件 patch 进官方运行时
docs/mobile/                         # 手机端开发说明
路径职责
apps/mobile/PWA 壳、manifest、Vite 开发服务器；:8030 把 /api 与 WebSocket 代理到 Host :3080
packages/host/mobile-pairing//api/mobile/* 路由：发码、配对、确认/拒绝、设备列表与吊销
packages/client/ui-mobile-pairing/桌面侧 QR Modal 与设置页（连接验证、设备管理）
packages/client/mobile-shell/手机 UI：配对页、任务列表、Chat / 轨迹、Composer
packages/client/connection/配对后的 Bearer / WebSocket 连接与会话 RPC
packages/bundle/web-app/将 Mobile 相关插件编入 dsh web profile

详细代码地图与穿透说明见 手机端开发文档。

与官方项目的关系

本项目在 deepseek-ai/deepseek-harness 之上扩展手机端能力。

官方项目提供 Agent 循环、插件系统、会话持久化与桌面 Web UI。本扩展主要负责：

  • 局域网 / 穿透环境下的手机配对与设备管理
  • Mobile PWA 壳：任务首页、对话、轨迹与连接管理
  • 桌面侧 手机连接 入口与 DSH 移动端 设置
  • 手机端 /api 代理与 PWA 打包（apps/mobile）

核心 Harness 开发与 CLI 使用请优先查看官方仓库。

特别感谢

感谢 DeepSeek Harness 与 DeepSeek AI 团队提供的 Agent 框架与 Web UI；感谢 Cordis 的插件化基础；也感谢 DSH Desktop 社区在桌面体验上的探索——Mobile 与 Desktop 互补，共同把 Harness 带到更多设备。

开发

安装依赖后，构建与启动各只需记一条命令：

pnpm install

# 构建（已含 build:lib，无需再单独执行）
pnpm build:mobile   # 仅 Mobile PWA 生产包
pnpm build:web      # 仅桌面 Web 前端
pnpm build          # Web + Mobile 全部构建

# 开发启动（两个终端，自行启动）

```powershell
# 终端 1 — Host（:3080）
pnpm dsh web --no-open

# 终端 2 — Mobile PWA（:8030）
pnpm run dev:mobile

Host 就绪后，用终端 1 里 dsh web: 打印的带 ?token=... 的 URL 打开桌面 GUI；Mobile 打开 http://127.0.0.1:8030/。不要直接访问裸 :3080。

生产构建输出：pnpm build:web → Web dist；pnpm build:mobile → apps/mobile/dist。包级测试与更多细节见 手机端开发文档 与各包 README。

友情链接

项目简介链接
DeepSeekDeepSeek 官方网站。deepseek.com
Linux.do 社区本项目获社区认可与支持。linux.do

License

本项目遵循 MIT License。

本项目是基于 DeepSeek Harness 构建的社区手机端扩展，并非 DeepSeek 官方独立产品。

DeepSeek 是 DeepSeek AI 的商标。DSH Mobile 是社区扩展，与 DeepSeek 官方没有隶属关系，也未获得其背书。

Star History

Star History Chart