dsh-phone

它能做什么

• 双版本一键部署：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 附件提供。

装过 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 文本模型看不懂照片、听不了录音，拍照/录音是给用户查看或留给视觉模型使用。

更多文档

从源码构建

# 依赖：JDK 17、Android SDK（platform-34 + build-tools 34.0.0）、PowerShell、curl
powershell -File tools/fetch-assets.ps1          # 拉取 Termux/Shizuku 等第三方 APK（自动校验哈希）
powershell -File app/root/build-apk.ps1          # → app/root/out/dsh-phone-root.apk
powershell -File app/shizuku/build-apk.ps1       # → app/shizuku/out/dsh-phone-shizuku.apk

零 Gradle 手工构建链：javac → d8 → aapt2 → zipalign → apksigner。依赖位置通过环境变量 ANDROID_JDK / ANDROID_SDK_ROOT 或仓库旁的 jdk17/、android-sdk/ 指定。

⚠️ 签名使用仓库本地的 apk/debug.keystore（gitignored，务必备份；v0.1.0 就因签名库遗失导致 v0.2.0 无法覆盖安装）。

目录结构

app/          双版本 Android 应用（common 共享 UI/图标，root 与 shizuku 各自实现）
tools/        资源拉取、图标生成、资源编译、发行说明等构建工具
scripts/      Termux 侧脚本（安装/启动/自启/DNS 修复/兼容补丁）
plugin/       dsh-android-control 插件（28 个工具 + 移动端 CSS + su/Shizuku 桥双执行器）
docs/         安装手册 / 架构说明 / 排障手册
apk/          v0.1.0 历史纯壳工程（保留）

第三方组件与许可

本项目代码：MIT，见 LICENSE。感谢 DeepSeek 团队开源的 DSH。

致谢

• DeepSeek Harness — 让这一切成为可能的 agent 框架
• Termux / Shizuku 社区 — 安卓生态最可靠的基建