DSHA

DeepSeek Harness 安卓启动器

在手机上跑完整的 deepseek-harness —— 免 ROOT，免 Termux，装完即用

English · 简体中文 · 官网 dsha.cc · 更新记录 · 安全模型 · AGENTS.md（给 AI / 开发者）

🤖 下一个 AI / 开发者请先读 AGENTS.md（项目结构、启动契约、踩过的坑），不要先全库扫描。

❤️ 赞助商

感谢 绿萝中转站 赞助本项目！绿萝中转站是一个包含多种厂家模型的 AI 平台，多款主流大模型随开随用，写代码、生成图片等等都能在同一平台调用。国内外模型应有尽有，上新及时，服务周到，价格美丽。使用本链接注册可享受充值 105% 优惠。

感谢 Axis AI 赞助本项目！Axis AI 是一个免费的公益 AI 平台，多款主流大模型随开随用，聊天、写代码、生成图片都能在同一平台内实现。

这是什么

DeepSeek Harness（@deepseek-ai/dsh）是 DeepSeek 官方的 agent harness，类 Claude Code。 它是为 glibc Linux 写的，直接在安卓上跑会撞上一堆事：原生模块编译不过、link(2) 被 SELinux 挡住、沙箱起不来、前端按桌面布局排版。

DSHA 把这些全部封在一个 APK 里。 装 APK、填 API key（或跳过）、点启动 —— 不需要 Termux、 不需要 ROOT、不需要敲一行命令。里面是一个完整的 Ubuntu 环境：apt 能用、 交互式 PTY 能用、需要编译的原生模块能装，跟你在服务器上用是同一套东西。

由贡献者 @ym2025szz 维护并发布，感谢原作者 @qiannianhuanxiang 和其他贡献者。

下载

当前正式版 v0.2.0-rc2 · build170（发布说明 · 完整更新记录），两个版本共享 com.dsh.client 包名与数据，不能并排安装：

• 升级：用同签名 APK 覆盖安装即可（证书指纹 e7e3a3…a53f5，验装方法见安全模型）。相同 Ubuntu 基础版本只更新受管组件，不重建整个环境。
• 本次下载：APK 与对应 SHA-256 以上表 GitHub Release 为准；校验方法。应用内更新另读取官网 dsha.cc 的发布清单。
• 历史版本：Releases。

本次为 GitHub 正式版 / Latest，不标记预发布；版本码 170，Ubuntu 基础环境编号仍为 10。对应源码。

本版更新与旧版对比

• DSH 升级至 0.2.0-rc.2，移动 UI 更新至 3.0.5，修复手机焦点、弹窗与插件卡片交互。
• 文件直接进入系统文档选择器，支持多选；修复图片草稿保存与恢复、ADB 首次离线依赖准备和聊天 shell 的 /tmp 问题。
• 网页增加原生分享与保存，补充虚拟屏开启说明、LAN 失效链接指引；作品导出、存储指南和技能统一放入“数据与备份”。
• 插件检查后自动启用，允许依赖安装脚本；新用户导出统一为无需密码的 .tar.gz，历史加密备份仍可读取。

两版各 45 项关联单测与 Release Lint 通过；Android13 真机验证正式包覆盖、两种网页内核附件/图片草稿、15 个离线 ADB 依赖准备及最终启动。完整无线配对、原 vivo Android16、Android6/7、16KiB 真机和原生 SAF 最终保存未在本轮覆盖。正式版完整说明 · build170 验收。

开始使用

1. 装 APK（仅 arm64；Android 11+ 选 Standard，更老的系统选 Low）
2. 首次启动解压并准备内置离线环境；耗时取决于机型，历史完整冷安装为 42.412 秒，尚未达到 30 秒目标
3. 「配置」页填 DeepSeek API key →「启动」页点启动 → 自动打开 Web UI

就这样。想跑得更细可以走「分步安装」，每步都能单独重装、单独更新。

为什么是 DSHA

核心模块

① 装机与环境

② 运行时

③ 数据与备份

④ 设备能力（让 agent 真正操作这台手机）

agent 通过本机 127.0.0.1:3090 桥调用以下能力（token 门控，/app/help 有完整端点清单）：

⑤ 终端

⑥ Web UI 与访问

⑦ 插件生态

主要内置插件包括：dsh-web-mobile（移动端适配）、dsh-status-overlay（悬浮条）、 dsh-task-notifier（回合完成通知）、dsh-device-shell-guide（设备能力引导）、 dsh-computer-use-android（Android Computer Use）、dsh-tool-vscreen（虚拟屏工具）、 dsh-auto-review（官方实验性 Auto review 入口）。

⑧ 可靠性与应急

⑨ 安全（默认最小权限）

👉 每项权限到底暴露了什么、agent 碰得到手机的哪些部分，见 安全模型。

与同类方案的关系

安卓上跑 dsh 目前有两条路，各有代价，说清楚比互相贴标签有用：

已知限制

诚实列出来，省得你装完才发现：

架构

┌──────────────────────── APK ────────────────────────┐
│ 原生 Android（Java 17 · Material3 · 单模块 :app）    │
│  ├ 启动 / 安装修复 / 配置 / 工作区 / 插件 / 终端     │
│  ├ 网页内核：系统 WebView（Standard）/ Gecko（Low）  │
│  ├ 前台服务 + 看门狗 + 通知 + 画中画                 │
│  ├ App 桥 :3090（无障碍 / 虚拟屏 / 交互 / 文件）     │
│  ├ LAN 代理 :3081 · ADB / Shizuku / Root 设备通道    │
│  └ 悬浮条（TYPE_APPLICATION_OVERLAY）                │
├─────────────────────────────────────────────────────┤
│ proot（默认）/ proroot（可选，依机型兼容）           │
├─────────────────────────────────────────────────────┤
│ Ubuntu 24.04 arm64 · Node.js 24 · pnpm 10           │
│  └ @deepseek-ai/dsh  →  Web UI :3080                │
└─────────────────────────────────────────────────────┘

数据：实际位置以“数据与备份 → 存储指南”为准；旧 Documents/dshdata 数据继续兼容读取。 API key 由 Android Keystore 保护，本机密钥与自动副本不保证卸载后存续。

ADB 无线配对（设备 Shell 能力）

配好之后 agent 就能直接操作这台手机，不需要 Shizuku。

首次配对（约 1 分钟）

1. 系统设置 →「关于手机」→ 连点「版本号」7 次开启开发者选项
2. 开发者选项 → 打开「无线调试」
3. 进入「无线调试」→「使用配对码配对设备」，记下 IP:端口 与 6 位配对码
4. 回到 DSHA →「设备能力授权」页 → 填入 → 配对

无线调试的配对码需要 Android 11+；老系统可走 Shizuku / Root 通道，或直接用无障碍能力（读屏、点按、输入不需要任何配对）。

无线调试尚未开启时，“验证已有连接”可以先准备内置离线依赖；出现 ADB_OFFLINE_READY 仅表示依赖就绪。之后仍需打开无线调试并完成配对或连接验证。

配对之后：DSHA 自己维护连接（保活 + 重连），重启手机后也会自动恢复，不用再操作。

验证：内置终端里跑 adb shell id，输出 uid=2000(shell) 即成功。

让 agent 用起来：把技能包复制到 agent 的技能目录：

cp -r agent-skills/device-shell ~/.agents/skills/
cp -r agent-skills/screen-ocr-operator ~/.agents/skills/

device-shell 覆盖 ADB / Shizuku / Root 三通道的命令用法； screen-ocr-operator 提供截屏 + OCR + 批量屏幕操作（无障碍读屏拿不到内容的 WebView / 游戏画面用）。

构建

本地构建需要 JDK 17、Android SDK（API 37）、NDK 26 与 Python 3.9+，详见 BUILD.md：

bash build.sh                                # 默认构建 Standard Debug
bash build.sh :app:assembleLowRelease        # 构建 Low Release
bash build.sh :app:testStandardDebugUnitTest # 纯逻辑单测
python tools/verify-stability.py             # 稳定性验收门禁

离线 rootfs 不提交 Git；发布流程（签名、门禁、真机验收、产物替换）见 BUILD.md 与 docs/releases/。

文档索引

致谢

• deepseek-ai/deepseek-harness —— 本体
• proot / proroot —— 免 ROOT 容器（见 THIRD_PARTY_NOTICES.md）
• Termux terminal-view / terminal-emulator（Apache-2.0）—— PTY 终端
• dsh-web-mobile —— 内置移动端适配
• Shizuku —— 备用设备命令通道

交流

QQ 群 975836806 —— 测试版、问题反馈、插件交流。

许可

MIT。第三方组件许可见 THIRD_PARTY_NOTICES.md。

Star History

由 tools/gen-star-history.py 按周读取 GitHub 星标时间并更新（workflow）。浅色、深色 SVG 保存在本仓库；曲线按当前仍保留的星标汇总。