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 解锁高级设备控制）

1. 下载与本机匹配的 APK（见下一节）：真机选 arm64，模拟器选 x86_64。
2. 安装并首次启动。首次启动或升级后需要解压/刷新运行环境，可能需要几分钟到十余分钟，期间请勿强杀应用。
3. 按需开权限：无障碍、通知、Shizuku，应用内有引导。
4. 在设置里配置模型 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 提需求。

面向开发者

• 自己构建：构建与快照链在协调仓库 dsh-mobile 完成，本仓库是壳子仓库；环境要求见 CONTRIBUTING.md 与 docs/AGENTS/build-and-env.md。
• 桥协议（window.androidBridge）：见 docs/AGENTS/BRIDGE-API.md。
• 模型可见工具面：见 docs/AGENTS/modules.md（以当前代码为准）。
• 参与贡献：见 CONTRIBUTING.md。
• 版本历史：见 docs/AGENTS/changelog-archive.md（倒序，最新在最上）。

致谢

这个项目是靠社区一起做出来的。下面按代码贡献行数排序，致谢贡献最多的八位协作者（维护者本人与 AI 账号不计入；统计排除上游构建产物与 lockfile）：

#	协作者	主要贡献
1	@snoworwind	可来源审计的 ARM64 构建链、来源链可复现性修复、快照面板层级与遮罩修复
2	@cmyfqwq	AI root 权限授权开关与应用级 root 授权面、root 租约清算判据改写为真绑定实证、入口拆锁落地
3	@lemonhub-io	启动页与控制台 UI 重构、原生界面的设计令牌体系、应用命名与图标、版本号收编为单一来源
4	@daum110715	下载页整体改版为瑞士国际主义排印风格（网格、字阶、等宽数据）
5	@SinBC227	图片输入与视觉读图（含华为 WebView 兼容）、剪贴板桥、LaTeX 流式渲染、字体大小与沉浸式状态栏
6	@adeahejshshsh	通用设置里安卓自建项的行规与控件重做、语言跟随系统改为启动时解析
7	@wen0531	快照内 git SHELL_PATH 重定位、arm64 资产名口径、文件写入回退、预设播种修复
8	@FuRongJun-1999	灵枢（AEIS）长期记忆框架的快照构建工具与手机端测试指引

另外感谢最早一批通过 issue 与 PR 帮我们定位问题的成员：cdwlll、haitunlang、TACONailoong、X-SCI-TECH、Yangerwei、gr12-cmd，以及所有提交反馈与建议的用户。

欢迎加入用户群反馈

使用问题、机型兼容、功能建议都可以在群里直接提。一群已满或无法加入时，请扫码加入二群（群号 1038381236）。

支持我们

请在个人生活有余力且经济自主的前提下进行适当的自愿赞助。

• 第三方模型 API 中转站（非本开发者所属，仅作推广支持）：https://d1api.xin/sign-up?aff=mVa0
• 第三方模型 API 中转站（非本开发者所属，仅作推广支持）：https://aiapi.keniis.top/sign-up?aff=v5GFqLPO

微信赞赏与支付宝收款码：

License

MIT。第三方组件按各自许可，见 LICENSES/ 与 THIRD_PARTY_NOTICES.md。GPL 合规：copyleft 许可全文三形态在场——快照 usr/share/LICENSES/、仓库 LICENSES/、APK assets/licenses/。