把蓝色大肥鱼装进手机!DSHA(DeepSeek Harness 安卓启动器)保姆级安装教程
适用读者:想在手机上体验 DeepSeek Harness(俗称"蓝色大肥鱼")的朋友、不想折腾 Termux 和 ROOT 的安卓用户、AI 玩机党。本文按视频演示的三步流程展开:获取安装包 → 配置环境 → 启动使用,所有命令、版本、端口均来自官方 README,可放心照着做。
https://zhouruolin.cn/upload/01_cover-kAkS.png
一、DSHA 是什么
DSHA(DeepSeek Harness for
Android)是一个安卓启动器,把官方 DeepSeek
Harness(@deepseek-ai/dsh,类似 Claude Code 的 agent
harness)完整封装进一个 APK 里,让你在手机上直接跑——免 ROOT、免
Termux、不用敲一行命令。
- 内置完整的 Ubuntu 24.04 arm64 环境(离线 rootfs 打进 APK,无网也能完成环境部署);
- 装完即用:
apt、交互式 PTY、需要编译的原生模块、Python、git 都能用,跟服务器上是同一套东西; - 双运行时:默认
proot,可选proroot,按机型核验兼容; - 手机就是 agent 的手:无障碍读屏、ADB 无线直连(免 Shizuku)、独立虚拟屏、点按输入自动化全部内置;
- 前台服务 + 看门狗:Web 掉了自动拉起,不用手动重启;
- 无遥测:不上传任何日志或使用数据。
它和"桌宠"不是一回事:桌宠是把大肥鱼当作桌面小宠物养,DSHA 是正经把整个 DeepSeek Harness 运行环境装进手机,视频标题强调"不是桌宠"就是这个原因——这是一个可以真正干活的 agent 运行环境。
二、官方链接与版本信息
| 项目 | 地址 |
|---|---|
| GitHub 仓库 | https://github.com/DSH-APP/DSHA |
| 官网(插件目录) | https://dsha.cc |
| 爱发电(创作团队赞助页) | https://afdian.com/a/dsha_apk |
| QQ 群(交流反馈) | 975836806 |
| 最新 Release | https://github.com/DSH-APP/DSHA/releases/latest |
当前正式版:v0.2.1-rc.2 · build190(Standard 标准版,Android 11+ / arm64,约 278.66 MiB),内置 DSH 0.2.1-rc.2、移动 Web UI 3.2.1、Node.js 24、pnpm 10。
系统要求(重要,先核对你的手机):
| 项目 | 要求 |
|---|---|
| 架构 | 仅 arm64-v8a(32 位与 x86 设备不支持) |
| 系统 | Standard 版 Android 11+;Low 兼容版 Android 6+(旧版 Low 发布保留,不再新增) |
| 存储 | 预留约 1GB 以上空间(APK 本身 278MB,首次解压更多) |
三、第一步:获取安装包(二选一)
方式一:GitHub Releases 官方下载
- 打开 GitHub 仓库 Releases 页面:https://github.com/DSH-APP/DSHA/releases/latest
- 下载
dsha-0.2.1-rc.2.apk(Standard 版); - 建议同时下载
.sha256校验文件,安装前核对哈希,确保是官方原包。
方式二:爱发电创作团队页面
打开 https://afdian.com/a/dsha_apk ,在创作团队的主页/动态里可以获取安卓移植版安装包与更新说明(视频演示也是走的这条渠道,团队会同步 GitHub 正式版)。
提示:Android 默认不允许安装未知来源应用,下载后需在系统设置里允许"安装未知应用"(授权给浏览器/文件管理器),或使用系统文件管理器直接点开 APK 安装。
四、第二步:安装与配置环境
- 安装 APK:点开下载好的 APK 文件,按提示安装完成;
- 首次启动:DSHA 会自动准备内置离线 Ubuntu 环境(六步安装流水线:解压 → 基础工具 → Node.js → pnpm → dsh → 补丁,每步先探测再执行、装完即校验),这个过程无需联网也能完成;
- 授予文件权限:按应用提示允许"所有文件访问"权限(不授权时数据会留在私有目录,卸载即丢,自检会明确提示);可选开启通知栏运行状态;
- 等待就绪:环境解压完成进入主页后,Web 在后台启动;当页面出现 READY 就绪提示,说明环境配置完成,可以进入 Web UI。
如果某一步失败,不用重新来过:进入"安装与修复"页,它会逐项自检六项组件,只修复失败项(证书、npm 异常、DNS、会话写入补丁等),不会从头重装。
五、第三步:启动使用
- 进入 Web UI:DSHA 会自动拉起内置的移动端 Web UI(内置 dsh-web-mobile 3.2.1,支持手机快捷键与窄屏适配);
- 配置模型:在 Web UI 中配置模型 API Key(支持 DeepSeek 官方 API 及第三方兼容 API,如 API-Zeno、绿萝中转站等赞助商平台,或本地模型方案);
- 开始对话:在输入框输入指令即可使用,和桌面端一样可以写代码、跑命令、操作插件;
- 局域网访问(可选):同一局域网内,用电脑/平板浏览器直接访问手机上的 dsh,Web 端口可自定义,冲突时自动回退。
六、进阶玩法:设备能力与插件
手机就是 agent 的手(设备能力)
agent 通过本机 127.0.0.1:3090 桥调用设备能力(token
门控,/app/help 有完整端点清单):
- 无障碍读屏:不需要 ADB,读屏结构化输出 + 点按 + 输入 + 滑动 + 截屏;
- ADB 无线直连:内置无线配对(TLS 1.3-PSK + SPAKE2),不需要 Shizuku,重启手机自动恢复;
- 独立虚拟屏(实验):Standard / Android 11+,先授权 ADB、Shizuku 或 Root 任一通道;
- 其余:文件交换、传感器与定位(默认关闭逐项授权)、剪贴板、短信只读查询(默认每条确认)。
插件玩法(视频提到的扩展)
DSHA 支持在 App 内直接安装插件(GitHub 简写 / 压缩包直链 / 本地导入都可以),也可以到官网 dsha.cc 插件目录浏览社区插件。
视频演示里提到的
Coopanon(Coopanion,@takboo/dsh-coopanion)
就是面向 DSH 的动画桌面伙伴插件:接收 DeepSeek Harness
任务通知、支持会话聊天,装上之后大肥鱼就有"陪伴感"。再配合社区扩展包(如
QQ
群聊机器人扩展、绘画、游戏互动类插件),可以把手机上的大肥鱼变成会聊天、会画图、能在群里互动的玩伴。
内置主要插件还包括:dsh-web-mobile(移动端适配)、dsh-status-overlay(悬浮条,AI
输出像歌词一样贴在屏幕顶部)、dsh-task-notifier(回合完成通知)、dsh-computer-use-android(Android
Computer Use)、dsh-tool-vscreen(虚拟屏工具)等。
插件安装后会自动校验格式、路径、依赖与摘要,通过后自动启用;内置插件不可删除,用户禁用过的升级后保持禁用。
七、常见问题排查
| 问题 | 原因与解决 |
|---|---|
| 提示不支持架构 | DSHA 仅支持 arm64-v8a,32 位与 x86 设备无法安装 |
| 安装包损坏 | 核对 SHA-256 校验值,重新从官方 Releases 下载 |
| Web UI 打不开 | 看"安装与修复"页的组件自检,它会直接点名是哪个插件或组件故障;也可用独立应急 DSH |
| 网页起不来且报错是插件 | 进入安全启动模式(独立 profile 只加载官方基础组件),再处理具体插件 |
| 启动很慢 | 首次解压内置 Ubuntu 环境较慢属正常;慢启动保护不会把慢启动当故障误杀 |
| 与旧版冲突 | 新版包名 dsh.android.client 可与旧版
com.dsh.client 并排安装,数据迁移用备份导出/恢复 |
| 担心权限 | 最小配置(不给 ADB、不给文件权限、不开局域网)下 DSHA 照常运行,每项能力默认关闭、随时撤销 |
八、安全与风险声明
- 本文安装步骤、版本号、端口(3090/3081)、功能描述均来自 DSHA 官方 GitHub README 与官网,不构成任何第三方担保;
- DSHA 内置 bash 的沙箱隔离不可用(Android sepolicy
限制),约束靠 dsh 权限档位:默认
danger-full-access,可在配置页改成workspace-write或read-only,请自行判断风险; - API Key 由 Android Keystore 保护(AES/GCM,密钥不出 Keystore);桥 token
不进备份,
.credentials.yaml字段级剔除本机密钥; - 本项目由贡献者维护发布,遵循 MIT 许可;文中提到的插件为社区生态,安装第三方插件前建议查看其说明与安全扫描信息;
- 设备能力(无障碍、ADB、虚拟屏)涉及手机控制权限,请仅在你的自有设备上使用,并理解每项授权暴露的范围(详见官方安全模型文档)。
https://zhouruolin.cn/upload/02_star.svg
想要更多玩法?装上插件,把你的大肥鱼变成会聊天的桌面伙伴、会画图的群友、能自动操作的手机管家——玩出花来记得回来评论区分享。