dsh-mobile-apk — 手机上的 AI Agent（DeepSeek Harness 安卓壳）
English README
一个 APK 装下完整的 AI agent：AI 能操作浏览器与手机、真实执行 bash——无需 root，无需刷机。
DeepSeek Harness 的安卓壳。应用名 DeepCode，包名 com.dsharnessmobile.shell。
本项目基于 MIT 开源，欢迎二次开发，二次分发，为项目提交建议与反馈。
AI 生成内容与执行的操作请自行判断；实验性能力会在对应条目如实标注。
它能做什么
- 真实执行 bash：AI 跑的命令在内置 Termux 环境里真实生效，不是模拟输出。
- 后台持续运行与自动恢复：切走应用、锁屏，任务照跑；引擎异常自动探活恢复，手机重启后自动回到运行状态。后台耗电高于普通应用，建议按应用内引导允许忽略电池优化。
- AI 独立浏览器（实验特性）：AI 用一个独立窗口打开和操作网页，cookie 与登录状态和你的日常浏览器完全隔离，不碰你的账号。
- 虚拟屏（实验特性，需 Shizuku）：AI 在一块独立虚拟屏幕上启动并操作第三方 App，不占你正在用的屏幕，还能在浮窗里围观它操作。
- AI 操作手机：开启无障碍授权后，AI 能看到屏幕内容并替你点击、滑动、输入、截屏；默认只允许操作虚拟屏，要动真实屏幕需要你在设置里主动放开。
- 通知栏应答与审批：AI 的提问、审批直接推到通知栏，直接回复、选选项、批准或拒绝，不用切回应用（Android 13 及以上需在系统设置里允许通知）。
- 桌面悬浮球：实时显示 AI 进度，展开面板能直接回答 AI 的提问、看任务报告，三击状态行跳回应用；不想被打扰可一键隐藏。
- 稳定与自愈：页面被装坏的插件搞挂时自动摘除并恢复；环境被改坏可用安全模式启动修复；启动失败有修复助手与脱敏诊断包（仅你主动点击才会发出）。
界面速览
| 主界面与对话 | 双工作区分栏与悬浮小窗 |
|---|
| |
| 通知栏应答 | 侧边栏与会话管理 |
| |
截图来自真实任务运行。
快速开始
| 项目 | 要求 |
|---|
| 系统版本 | Android 8.0 及以上 |
| 安装包大小 | 约 150-160 MB，建议 Wi-Fi 下载 |
| root | 不需要（可选装 Shizuku 解锁高级设备控制） |
- 下载与本机匹配的 APK（见下一节）：真机选 arm64，模拟器选 x86_64。
- 安装并首次启动。首次启动或升级后需要解压/刷新运行环境，可能需要几分钟到十余分钟，期间请勿强杀应用。
- 按需开权限：无障碍、通知、Shizuku，应用内有引导。
- 在设置里配置模型 API，跑第一条命令。
进阶安装：adb install -r -t <apk>（同签名覆盖安装）。
下载与安装
最新版永远在这里：GitHub Releases（latest）。
访问 GitHub 困难时，用官方下载页（自动路由官方源与镜像加速源）。
| 包 | 适合 |
|---|
| arm64 版 APK | 绝大多数真机 |
| x86_64 版 APK | 模拟器 / x86_64 设备 |
ABI 必须与设备匹配：装错包引擎启动即崩（处理器架构不符），请按设备类型选包；装错了重装对应包即可。
请始终从同一渠道获取升级：应用自带应用内检查更新；跨渠道混装出问题时，先完整卸载重装再反馈。
覆盖升级会保留会话、设置与插件配置；若触发运行环境刷新，可能需要十余分钟，期间请勿强杀应用。
权限说明
| 权限 | 用途 |
|---|
| 网络连接 | 加载 AI 对话、探测本地引擎、检查更新（仅手动触发） |
| 通知 | 通知栏应答与任务提醒（Android 13 及以上需在系统设置里允许） |
| 前台服务 | 保活运行，让 AI 任务在后台持续跑 |
| 所有文件访问 | 使用外部工作区目录时需要，你在系统页手动授予 |
| 安装未知应用 | 应用内检查更新时唤起系统安装器，须你在系统页显式授权 |
选择目录与图片走系统选择器，无需额外权限。虚拟屏与特权操作需你自行安装、启动并授权 Shizuku。
常见问题
为什么必须给无障碍权限？
无障碍是 AI 看屏幕内容、替你操作的数据通道；不开启则仅虚拟屏可用。默认只允许 AI 操作虚拟屏，要动真实屏幕需要你在设置里主动放开范围。
后台被杀怎么办？
按应用内引导把本应用加入电池优化白名单；个别厂商的激进省电策略可能仍需手动加白。
应用出问题去哪反馈？
到 issues 反馈，请附机型、应用版本（关于页可见）与复现步骤；也可以加文末用户群直接说。
模型 API 从哪来、怎么配？
在设置页的模型条目里直接选择协议与思考档位，应用不内置任何模型服务。
armv7l / 老机型什么时候支持？
暂不支持，欢迎到 issues 提需求。
面向开发者
致谢
这个项目是靠社区一起做出来的。下面按代码贡献行数排序，致谢贡献最多的八位协作者（维护者本人与 AI 账号不计入；统计排除上游构建产物与 lockfile）：
另外感谢最早一批通过 issue 与 PR 帮我们定位问题的成员：cdwlll、haitunlang、TACONailoong、X-SCI-TECH、Yangerwei、gr12-cmd，以及所有提交反馈与建议的用户。
欢迎加入用户群反馈
使用问题、机型兼容、功能建议都可以在群里直接提。一群已满或无法加入时，请扫码加入二群（群号 1038381236）。
支持我们
请在个人生活有余力且经济自主的前提下进行适当的自愿赞助。
微信赞赏与支付宝收款码：
License
MIT。第三方组件按各自许可，见 LICENSES/ 与 THIRD_PARTY_NOTICES.md。GPL 合规：copyleft 许可全文三形态在场——快照 usr/share/LICENSES/、仓库 LICENSES/、APK assets/licenses/。
