DSH-Android：安卓手机上的 AI Agent

项目简介

DSH-Android 让你不需要 root、不需要电脑、也不用 Termux，直接把 DeepSeek Harness（dsh）跑在安卓手机上。装一个 APK 就能让 Agent 操作手机上的 App、整理文件、修改系统设置，或者按条件自动执行任务。

引擎内嵌在 App 进程里：Node 24 编译成安卓原生共享库，通过 JNI 在 :engine 前台服务中启动，不用 proot，也不会碰到安卓 12 以后的“幽灵进程”限制。dsh 本身没有 fork，App 只通过 dsh 的 SDK 协议与它对话；设备能力全部由 Kotlin 侧实现，再通过私有 socket 通道暴露给 dsh。

主要功能

• 操作任意 App：基于无障碍服务读屏、点击、滑动、输入，例如用微信发消息、总结群聊、抓取小红书内容、在 BOSS 直聘上投递打招呼等。
• 随时呼起：悬浮球可直接对话、派活，也能把当前屏幕发给它问“这条怎么回”。
• 文件处理：查找、整理、移动、重命名、压缩解压，能读 PDF / Word / Excel / PPT 里的文字。
• 系统设置：亮度、音量、勿扰、闹钟、Wi‑Fi、蓝牙、定位；读取和回复通知，控制媒体播放。
• 自动化：定时执行，或在连上 Wi‑Fi/蓝牙、开始充电、到达某地、收到通知等条件下触发。
• 自带 Linux 环境：Agent 可以跑 Python、处理文件、运行自己写的脚本。
• 多模型服务：除 DeepSeek 外可添加 OpenAI、Claude、Gemini、Grok、OpenRouter、Kimi、智谱 GLM、通义千问、火山方舟、MiniMax、硅基流动、阶跃星辰或任意 OpenAI 兼容接口。
• 远程使用：通过 SSH 或 DSH Remote 连接电脑/服务器上的 DSH。
• 可选 Shizuku：安装后解锁更多系统开关；Android 14+ 支持“不打扰模式”，Agent 在虚拟屏幕上操作。

安装与使用

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

安装包约 110 MB，建议预留 500 MB 可用空间，并保证能访问 DeepSeek API。

注意事项

• 有安全锁屏时不能操作其他 App：这类任务会暂停并提示解锁；文件、设置、通知等系统 API 任务锁屏时照常执行。
• Shizuku 重启后需重新启动，建议开启“开机启动（无线调试）”（需 Shizuku 13.6+、Android 11+）。
• 国产 ROM：部分机型需手动允许“后台弹出界面”和“自启动”，悬浮球与后台自动化才能稳定工作，App 体检页会提示。
• 第三方模型：只支持 OpenAI 兼容的 Chat Completions 接口（HTTPS），上下文统一按 128K 计；联网搜索由 DeepSeek 提供，用第三方模型时需另配 DeepSeek API key。
• 安装被拦截：本 App 不在 Google Play 分发，可能被误判为有害应用，核对 SHA-256 后可在弹窗点“更多详情 → 仍要安装”；用 adb install 时手机上同样需要处理该弹窗。
• 冷启动：引擎冷启动目前约 5 秒。

本项目为社区项目，与 DeepSeek 官方无关联，采用 Apache-2.0 许可证。

本作品整理自 GitHub 开源项目 jackwener/DSH-Android，原作者 @jackwener，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。