dsh-phone

DSH Phone

把 DeepSeek Harness 装进安卓手机：AI 自己截图、点屏幕、滑页面、开应用、执行命令。

装一个 APK → 粘贴 API Key → 点一下，全自动部署。全程跑在手机本地，不依赖电脑常驻。

License · Latest Release · 安装手册 · 排障手册 · English

它能做什么 双版本一键部署：Root 版（已 root 手机）与 Shizuku 版（未 root 手机）都是「装 APK → 粘贴 Key → 点部署」，Termux、Node.js、DSH 和安卓控制插件全自动装好。 AI 原生操作安卓：agent 可以截图、点击、滑动、输入文字、按键、打开应用、读 UI 层级、安装 APK、执行 shell。 硬件感知与控制：查电量/亮度/音量/传感器，拍照、录音、朗读、播媒体、发通知、震动、定位，高危操作前可在手机弹窗人工确认。 全程本地运行：DSH 跑在手机里的 Termux + Node.js 上，界面是本机 3080 端口的 Web GUI（APK 内置 WebView 壳）。 API Key 只存本机：安装包不含任何 Key；你粘贴的 Key 只写入手机本机 ~/.dsh-api-key（chmod 600），不内置、不上传、不进仓库。 选版本 快速开始 下载：打开 Latest Release，按上面的版本选择下载 dsh-phone-root-*.apk 或 dsh-phone-shizuku-*.apk。校验和随 Release 附件提供。

Root 版（三步）

1. 安装 Root 版 APK（允许「未知来源」）。 2. 打开 App，粘贴 DeepSeek API Key（platform.deepseek.com 申请）。 3. 点 一键部署 → 允许超级用户授权 → 等待，完成后自动进入界面。

部署过程全自动：安装 Termux（bootstrap 内置）→ 配置镜像 → 安装 Node/DSH → 注入插件与 Key → 授予硬件权限 → 启动服务。

Shizuku 版（四步）

1. 安装 Shizuku 版 APK。 2. 打开 App → 点部署 → 按引导安装并激活 Shizuku（开发者选项 → 无线调试 → 配对码，仅此一次）。 3. 回到 App，粘贴 API Key。 4. 点 一键部署 → 等待，完成后自动进入界面。 重启手机后打开一次 Shizuku 确认自启；DSH 会由 Termux:Boot 自动拉起。 装过 v0.1.0 纯壳的：先卸载旧壳再装（v0.2.0 换用了新签名；Termux/DSH 环境不受影响，新 APK 会自动复用）。 怎么用

打开 App（或手机浏览器访问 http://127.0.0.1:3080）直接跟 agent 说话： 想用电脑操作：adb forward tcp:3081 tcp:3080，浏览器打开 http://127.0.0.1:3081。 工具速览 完整 28 个工具的参数与说明见 plugin/README.md。 安全与隐私 Root 版 agent 等于握着 root：请用备用机，勿登录支付、网银等敏感账号；Shizuku 版同样建议备用机。 部署时会自动给 Termux:API 授予相机、麦克风、定位等运行时权限并做电池豁免，授权结果逐项打印在部署日志里；系统隐私指示灯全程可见。 安装包与仓库不含任何 Key；Key 只写本机 ~/.dsh-api-key（chmod 600）。DeepSeek 文本模型看不懂照片、听不了录音，拍照/录音是给用户查看或留给视觉模型使用。 更多文档 从源码构建