DSH-Android README

项目的 README,来自 github.com/jackwener/DSH-Android。合并为一个 markdown 文件:README.md。

DSH-Android:让 DSH 替你用手机

不要 root,不用电脑,直接跑在你的安卓手机上。真正的手机 Agent,替你把手机上的事干完。

在安卓手机上运行 DeepSeek Harness(dsh):让它操作 App、整理文件、修改系统设置,或者自动执行任务。

Release Android ABI Engine Root License

下载 APK • 快速开始 • 架构 • 从源码构建


亮点

界面一览

界面一览:首页、操作手机、轨迹、随处唤起、手机权限、会话列表

快速开始

  1. 从 Releases 下载 APK 并安装(arm64,Android 10 及以上)。
  2. 登录 DeepSeek 账号,或者填入 API key;也可以在 设置 → 模型服务 里添加其他服务商。
  3. 直接说要做什么,比如“列出下载目录里最大的 5 个文件”。用到某项权限时,App 会再引导你开启。
  4. 可选:在 设置 → 手机权限 里一键安装 Shizuku,并在 Shizuku 里打开“开机启动(无线调试)”。

能做什么

架构

flowchart LR
  subgraph main[":main 进程(Kotlin · Compose)"]
    UI["对话 · 轨迹 · 审批<br/>唤起层 · 设置"]
    CAP["CapabilityHub<br/>设备工具"]
    TRG["TriggerHub<br/>自动化"]
    SVC["无障碍 · 通知监听<br/>系统助手 · 输入法"]
  end
  subgraph engine[":engine 进程(前台服务)"]
    NODE["libnode.so<br/>Node 24 · bionic"]
    DSH["dsh --profile android<br/>+ device / guard / account 插件"]
  end
  SHZ["Shizuku(可选)"]
  API["DeepSeek API"]

  UI <-- "dsh SDK JSON-RPC(stdio)" --> DSH
  DSH <-- "能力桥 JSON-RPC(socketpair)" --> CAP
  TRG --> DSH
  CAP --- SVC
  CAP -. shell 权限 .-> SHZ
  NODE --- DSH
  DSH -- HTTPS --> API

系统要求

Android 10 及以上,arm64-v8a;安装包约 110 MB,建议预留 500 MB 可用空间;需要能访问 DeepSeek API。

安装失败怎么办

安装时提示“已屏蔽有害应用”

DSH-Android 不在 Google Play 上分发,又用到了无障碍、通知读取、短信等能力,Google Play 保护机制可能把它误判为有害应用。核对过下载的 APK 和发布说明里的 SHA-256 一致后,可以这样安装:

当前限制

开发者

从源码构建

需要 JDK 21、Android SDK(compileSdk 37.2)、NDK r29。在 arm64 Linux 主机上构建时,需要额外传入 -Pandroid.aapt2FromMavenOverride=<arm64 版 aapt2 的路径>。

# 1. 原生库(libnode 等):下载预编译产物并校验哈希,不用自己编 Node
native/prebuilt.sh fetch            # → toolchains/out/jniLibs/arm64-v8a/

# 2. 引擎包:dsh + 插件 + 补丁 → engine.zip
OUT_DIR=<engineOut> js/build-engine.sh

# 3. APK
./gradlew :app:assembleDebug -Pdsh.engineOut=<engineOut>
  • 预编译产物的标签由 Node 版本加上全部原生补丁的哈希生成(比如 native-node24.22.1-caacecde44)。只有升级 Node 或改动原生补丁时才需要重编:先运行 native/build.sh,再用 native/prebuilt.sh publish 发布。
  • 主机端到端测试(真实调用 DeepSeek API):node js/test/host-e2e.mjs,API key 放在一个文件里,用环境变量 DSH_E2E_KEY_FILE 指定路径(默认是 ~/.config/dsh/deepseek_api_key)。
目录结构
app/        Android App(Kotlin · Compose · Hilt · Room)
  core/engine/       引擎进程、JNI 启动、崩溃恢复
  core/capability/   设备工具(文件、屏幕、系统、通知、媒体……)
  core/trigger/      自动化规则和事件源
  feature/           界面:对话、轨迹、快捷面板、自动化、设置、登录
js/         dsh 的 android profile、插件、补丁,build-engine.sh → engine.zip
native/     Node 24 安卓构建、JNI 包装、原生插件、预编译产物脚本
tools/      字符串、图标、README 首图(tools/ui/hero.py)、App 内更新清单(make-update-manifest.py)等生成脚本
update/     latest.json:App 内更新读取的最新版本清单(docs/RELEASE.md)
docs/       架构说明、引擎契约、设计 token、截图
翻译 / 添加界面语言

app/src/main/res/values/ 是中文(默认),values-en/ 是英文。添加一种语言只需两步:

  1. 新建 app/src/main/res/values-<语言代码>/,复制 values-en/ 下的全部 strings*.xml 并翻译(lint 的 MissingTranslation 会报漏翻的条目);
  2. 在 app/src/main/res/xml/locales_config.xml 里加一行 <locale android:name="<语言代码>" />。

设置 → 通用 → 语言 的选项和 Android 13+ 系统设置里的“应用语言”都读这份列表,不用改代码;单元测试 LocalesConfigTest 会检查两者一致。引擎拿到的语言(DSH_ANDROID_LOCALE)跟随 App 语言。

设计文档

致谢

声明

本项目是社区项目,与 DeepSeek 官方无关联,也未获其背书。“DeepSeek”及相关商标归其各自所有者所有。

许可证

Apache License 2.0。内置的第三方组件(Node.js、dsh、dsh-llm-service-lite、Shizuku、ripgrep 等)遵循各自的许可证。

DSH-Android (jackwener/DSH-Android)

正在搜索数据库…

这是什么?DSH-Android 让你把完整的 AI 智能体(DeepSeek Harness)以单个 APK 的形式直接运行在安卓手机上,无需 root,也不需要 Termux,因此它可以代你操作应用、管理文件、修改设置并自动执行任务。
它能在手机上完整运行智能体引擎吗,还是只能连接别处的引擎?它是一个独立的安卓应用,通过 JNI 把 dsh 引擎(编译为原生库的 Node.js)直接嵌入自身进程中,因此完整的 DeepSeek Harness 可以直接在手机上原生运行,而无需借助 Termux 或远程服务器。
我该怎么安装和开始使用?从 Releases 页面下载 APK(arm64,Android 10 及以上),使用 DeepSeek 账号登录或粘贴 API 密钥,然后直接告诉它要做什么;需要权限时,它会提示你授予。
我需要 root、Termux 或 DeepSeek API 密钥吗?无需 root 或 Termux,安装 APK 即可。你需要一个 DeepSeek 账号或 API 密钥,或者其他服务商(OpenAI、Claude、Gemini、Grok、OpenRouter、Kimi、GLM、Qwen 等)提供的兼容 OpenAI 接口的密钥。
有哪些限制我需要了解吗?在安全锁屏状态下,它无法操作其他应用(文件、设置等系统级任务仍可运行);重启后需要重新启用 Shizuku;部分国产定制系统需要手动授予后台弹窗权限;第三方模型仅支持通过 HTTPS 调用的兼容 OpenAI 格式的 Chat Completions 接口;冷启动大约需要 5 秒。
这个智能体在我的手机上到底能做什么?它可以发送微信消息并总结群聊,浏览小红书,在 BOSS直聘上投递求职申请,在淘宝下单,管理文件(查找、移动、重命名、压缩),通过无障碍服务读取屏幕并点击、输入文字,还能修改亮度、Wi-Fi、蓝牙、勿扰模式等系统设置。
这里的 Shizuku 有什么用?Shizuku(可选,Apache-2.0 许可,已内置在应用中)让智能体通过虚拟屏幕操作手机,不会占用你的真实显示屏;在设置好无线 ADB 后,可在 Android 14 及以上版本启用“勿扰”模式。
我能用它来控制电脑或服务器吗?可以。DSH-Android 可以通过 SSH 或 DSH Remote 连接到运行在电脑或服务器上的 DeepSeek Harness 实例;在纯远程模式下,手机甚至不需要安装本地引擎。
除了 DeepSeek,我还能用哪些 AI 模型?你可以添加 OpenAI、Claude、Gemini、Grok、OpenRouter、Kimi、智谱 GLM、通义千问 Qwen、火山方舟、MiniMax、硅基流动、阶跃星辰,或任何兼容 OpenAI 接口的端点:在 Settings > Model Services 中输入 API 密钥即可。
有哪些类似的项目?Mika, DSHA, buddy-android, Operit, andee, mobile-mcp, dsh-Go, dsh-ios
作者
jackwener
大小
4.2 MB
星标
998
时长
22天
提交 · 90 天