用手机使用电脑中的 DeepSeek Harness

DSH Mobile

在手机上安全、实时地使用电脑中的 DeepSeek Harness。

npm 版本 CI Android 10+ Apache-2.0

快速开始 · App 与浏览器 · 自定义 · English

Alpha 版本，当前原生 App 仅支持 Android；iOS 客户端仍为未发布的本地开发实验，不进入构建与 Release。本项目为 DeepSeek Harness 社区插件。

下载 Android App

DSH Mobile 是一个 DeepSeek Harness 插件，让手机浏览器或 Android App 在受保护的局域网内连接电脑，继续使用同一份会话、工作区、消息和工具。它只作为移动入口接入，不修改 DeepSeek Harness 源码。

能做什么

  • 在手机上继续电脑端的 DSH 工作：会话、工具、设置和运行状态实时同步。
  • 在 DSH 对话中直接修改手机端布局、交互和功能，打开的手机页面约一秒内刷新——用对话定制自己的移动端。
  • 专属移动布局：会话抽屉、工具详情、设置和输入栏都按触屏重新组织。
  • 自动发现局域网内的 DSH；切换 Wi-Fi、热点或 IP 后通常自动恢复，无需重新配对。
  • 扫码、配对链接或密钥均可配对。

快速开始

已经安装 dsh 命令：

dsh plugin --profile web add dsh-mobile@alpha
dsh plugin --profile web exec dsh-mobile setup
dsh --profile web

直接使用 DeepSeek Harness 源码：

corepack enable; pnpm install
pnpm dsh plugin --profile web add dsh-mobile@alpha
pnpm dsh plugin --profile web exec dsh-mobile setup
pnpm dsh --profile web

setup 会自动选择并记住当前局域网。切换 Wi-Fi、热点或 IP 后通常会自动恢复；仅在自动选择失败时使用 --address 192.168.x.x。

启动后，在 DeepSeek Harness 左下角打开“移动访问”并确认已开启，然后：

  1. 点击“生成并复制密钥”或“复制配对链接”，面板会显示配对二维码。
  2. Android App 点击“扫码配对”，把手机对准电脑屏幕上的二维码即可完成配对；也可以点击“扫描”选择电脑后粘贴密钥或配对链接。
  3. 配对完成后会建立持久设备信任，以后打开 App 无需重复输入。

配对设备被视为完全信任，可以操作电脑上的 DSH；建议只在可信的家庭、办公局域网或可信 VPN 中使用。

插件不会修改 DeepSeek Harness 源码。设置、证书、设备和自定义文件保存在 $DSH_HOME/mobile-access/。

App 与手机浏览器

方式 适合场景 说明
Android App 日常使用 自动发现；App 内保存私有证书信任，无需在浏览器手动信任证书
手机浏览器 临时或跨平台访问 打开“移动访问”卡片显示的 HTTPS 地址；首次连接需在浏览器手动信任该证书

Android 使用 mDNS/NSD、UDP 公告与主动查询、HTTPS 探测等方式发现 DeepSeek Harness。发现广播设备名、地址、端口、协议版本和稳定 instanceId，不会广播密钥或令牌。IP 变化后不需要重新配对。

手机浏览器首次连接：在电脑端开启配对后，点击“复制配对链接”并把链接发到手机浏览器打开，配对码会自动填入；也可以打开 HTTPS 地址中的 /mobile-access/pair，手动输入密钥最后一段的 43 位配对码。配对完成后，浏览器会保存可撤销的设备凭据。

移动端界面

手机端使用独立的移动布局外壳，不再依赖桌面三栏 DOM；原生的对话、工具、设置等组件保留触屏适配：

  • 左上角打开工作区与会话抽屉。
  • 对话、轨迹、工具详情和 Session log 保持原有能力。
  • 设置页使用顶部分类和单列内容。
  • 输入栏保留命令、权限、模型、上下文、图片和发送控件。
  • “添加工作区”在手机上展示电脑目录，不会在电脑上弹系统选择器。

Android App 只是 Kotlin WebView 薄壳，不内置另一份网页；手机浏览器访问的也是同一页面。需要排查兼容性时，可在浏览器地址后追加 ?frontend=stock，临时回到旧的桌面页面适配模式。

在 DSH 对话中自定义

默认文件：

$DSH_HOME/mobile-access/mobile.css
$DSH_HOME/mobile-access/mobile.js

直接在 DeepSeek Harness 对话中提出修改即可，例如：

请编辑 $DSH_HOME/mobile-access/mobile.css 和 mobile.js，
把移动端改成适合单手操作的开发控制台：增加底部快捷指令、
会话状态面板和长按语音入口。只影响窄屏，不修改 DSH 源码。

保存后，已打开的 App 和浏览器通常会在约一秒内应用变化。自定义不限于配色：mobile.js 可以添加导航、快捷操作、状态面板、相机、语音、扫码，以及调用同源 DSH API 的完整交互。

工作原理

flowchart LR
  Phone["Android App / 手机浏览器"] -->|"HTTPS + 设备会话"| Gateway["DSH Mobile 网关"]
  Gateway -->|"回环代理"| DSH["原生 DSH Web 与 Host"]
  DSH -->|"同一工作区、会话和事件流"| Phone

插件包含两部分：Host face 提供发现、配对、HTTPS 和回环代理；Client face 替换移动端的布局入口，并复用原生功能插件。DeepSeek Harness 的源码和 3080 桌面页面都不会被修改，安装和卸载完全通过插件机制完成。

安全

  • 仅在可信家庭、办公局域网或可信 VPN 中使用，不要转发到公网。
  • 配对设备拥有控制电脑端 DeepSeek Harness 的能力，应视为完全可信设备；丢失手机后应在电脑端撤销设备。
  • 移动网关开启时才监听局域网；关闭后 DeepSeek Harness 仍正常在电脑本机运行。

完整说明见 SECURITY.md。

兼容性

DSH Mobile 已验证的 DeepSeek Harness
0.1.0-alpha.29 0.1.0-rc.5、0.1.0-rc.6、0.1.0-rc.7

插件会在启动时检查 DSH Host 版本和移动布局所需的前端依赖；遇到未经验证的版本会直接给出错误，不会带着不兼容页面继续启动。CI 也会持续检查 DSH 主分支的布局插槽和移动端语义标记。升级 DSH 后如遇兼容提示，请先升级 DSH Mobile。

卸载

保留设备和自定义数据：

dsh plugin --profile web remove dsh-mobile

同时清除插件数据：

dsh plugin --profile web exec dsh-mobile purge --yes
dsh plugin --profile web remove dsh-mobile

源码模式把上述 dsh 换成 pnpm dsh。

开发

npm ci
npm run verify

Android 构建见 App 文档。

Apache-2.0，详见 LICENSE。