手机远程控制端 sorsama/deepseek-harness-mobile

DSH Mobile

一款 Android 应用，让你在手机上操控 DeepSeek Harness。

English ·中文 · हिन्दी · Español · Français · ไทย

DeepSeek Harness 是一个运行在你电脑上的 AI 编程代理，自带网页界面。DSH Mobile 连接到这个 harness，把同样的操作搬进原生 Android 应用。你可以在电脑前开始一个任务，然后在手机上跟进进度、回答它的提问、批准它要执行的命令。

这是一个非官方的社区应用。它需要连上一个正在运行的 harness：可以在你的电脑上，也可以通过 Termux 跑在手机本身。

项目主页用一页做了概览，完整的用户指南在 wiki。

截图

| 连接 | 对话 | 轨迹 | 详情 |
| 粘贴 harness 打印出的链接，就能连接并登录。 | 回复实时流式显示。工具调用折叠成一行，点开即可查看。 | 每一次工具调用，按回合排列。 | 会话的模型、上下文、目标、计划模式和后台任务。 |

| 子代理 | 终端 | 深色主题 |
| 查看子代理做了什么，并给它发一条追问。 | harness 电脑上一个真正的 shell。 | 浅色、深色或跟随系统。 |

能做什么

- 和代理对话。回复会连同推理过程、代码块和工具调用一起流式显示。你可以附加照片和文件，用 @ 引用文件，用 / 运行命令和技能。
- 长按消息、工具调用或文件，看看还能做什么：复制内容，把发错的消息改好再发，或在下一条消息里引用某个文件。
- 处理代理需要你做的事：批准或拒绝一条命令，回答它的提问，在计划开始执行前先审阅。
- 盯住耗时较长的工作。目标、待办列表、排队的消息、后台任务和子代理各有自己的视图，你可以暂停、引导或停止它们。
- 回合结束、目标完成或受阻、代理在等你回答时，都会收到通知。连接会在后台保持。
- 浏览和预览工作区里的文件，在 harness 电脑上打开终端。
- 管理 harness 本身：模型、代理预设、插件、定时任务和已归档的会话。
- 应用界面支持英语、中文、印地语、西班牙语、法语、阿拉伯语、孟加拉语、葡萄牙语、俄语、乌尔都语和泰语，也支持从右到左书写的语言。

更新日志列出了每个版本的改动。

快速开始

1. 安装应用

从最新版本下载 APK 并安装。需要 Android 8.0 或更高版本。

2. 让 harness 可以被访问

harness 默认只在它自己的电脑上监听。根据手机会在哪里使用，选择对应的方式。

和电脑连着同一个 Wi-Fi

让 harness 在电脑的局域网地址上启动。harness 0.2.1-alpha.2 及更新版本可以这样做：

dsh web --host 192.168.1.20

把 192.168.1.20 换成你电脑的实际地址。harness 会打印一行类似 dsh web: http://192.168.1.20:3080/?token=… 的内容。在应用里选择局域网，把这整条链接粘贴到地址栏（或点粘贴按钮），然后点连接。链接里的令牌会让手机完成登录，之后这个 harness 会出现在最近使用里，下次直接点就行。更早的 harness 版本不支持 --host，需要打一个小补丁，见 harness/README.md。

不在家时

安装 dsh-relay。这是一个 harness 插件，提供密码、加密和设备配对。然后在应用里选择中继，扫描配对二维码。wiki 上的 Relay 页面有完整的步骤。

USB 数据线或模拟器

在电脑上运行 dsh web 和 adb reverse tcp:3080 tcp:3080。在应用里选择本机，用 dsh web 打印出的链接登录。

在手机上运行

harness 可以在 Termux 里运行。选择本机，应用就能替你启动和停止 harness，并自动登录。在 Termux 里配置 Node 目前还不是每台设备都能成功，请先阅读 harness/TERMUX.md。

你自己的 HTTPS 反向代理

在局域网模式下粘贴它的 https:// 地址。代理会加密连接，但不会检查连过来的是谁。见 harness/README.md。

3. 开始工作

从列表里选一个会话（从屏幕左边缘向右滑），或者新建一个。连接失败时，应用会说明原因，wiki 的疑难解答页面就是按这些提示来组织的。

安全

通过网络连接之前，请先阅读 docs/SECURITY.md。已登录的手机能做代理能做的任何事，而代理会在你的电脑上执行命令。让手机登录这件事，要像交出 shell 权限一样慎重对待。

- 局域网模式会检查登录令牌，但不做任何加密。只在你信任的网络上使用。
- 中继模式加上了加密和固定证书，在你的网络之外也能用。
- 不要把 dsh web 链接给别人。拿到链接的人在 harness 重启之前都能登录。

兼容性

DSH Mobile 针对 DeepSeek Harness 0.2.1-rc.2 测试。最早到 0.1.6 的旧版 harness 大部分功能仍然可用，但较新的功能需要较新的 harness。兼容性表列出了每个应用版本对应的 harness 版本。

从源码构建

./gradlew :app:assembleDebug # debug APK
./gradlew :app:assembleRelease # release APK, signed when the keystore environment is set
./gradlew :core:test :app:testDebugUnitTest

要用真实的 harness 检验应用，先构建一份 harness 源码，再运行一致性测试套件：

DSH_HARNESS_SRC=/path/to/deepseek-harness ./gradlew :conformance:test

发布构建的版本号取自 git 标签。CONTRIBUTING.md 介绍了开发流程、模块划分和发布步骤。

| 路径 | 内容 |
| app/ | Android 应用：各个界面、连接、通知、翻译 |
| core/ | 纯 Kotlin 协议代码：线路类型、RPC 与流客户端、重连逻辑、会话事件折叠 |
| conformance/ | 启动真实 harness 并检查应用发出的每一个调用的测试 |
| mock-harness/ | 供测试使用的小型模拟 harness 服务端 |
| tools/capture/ | 把真实 harness 的流量录制成测试夹具 |
| harness/ | 局域网和 Termux 的设置指南 |
| docs/ | 架构、协议说明、兼容性、安全 |

中继插件在单独的仓库里： sorsama/deepseek-harness-relay。

许可证

MIT。随应用附带的第三方材料列在 THIRD_PARTY_NOTICES.md 中。DeepSeek Harness 及其品牌归其所有者所有，本项目与他们没有任何关联。