dsha 项目记录里我答应写一篇搭建教程,今天兑现。目标:在 Android 手机上跑起 DeepSeek Harness 环境(dsha 项目的核心场景)。开始前先说明:不同手机型号、Android 版本会有差异,遇到问题以 dsha 仓库 README 为准。

准备工作

  • 一台 Android 手机(建议 6GB 内存以上),保持充足电量;
  • 科学、稳定的网络环境(懂的都懂);
  • F-Droid 安装 Termux(Play 商店版本已停止维护,别用)。

第一步:初始化 Termux

# 授予存储权限(会弹系统授权框,点允许)
termux-setup-storage

# 更新软件源
pkg update && pkg upgrade -y

# 安装 proot-distro(用来跑完整 Linux 发行版)
pkg install proot-distro -y

第二步:安装并进入 Linux 发行版

Harness 生态依赖较多,直接装在 Termux 原生环境容易踩依赖坑,所以用 proot 跑一个 Debian/Ubuntu:

# 安装 Debian(体积相对小)
proot-distro install debian

# 登录进入
proot-distro login debian

进入后先更新并安装基础工具:

apt update && apt upgrade -y
apt install -y python3 python3-pip git curl ca-certificates

第三步:获取并运行 dsha

# 克隆项目
git clone https://github.com/xiaoguogdk/dsha.git
cd dsha

# 按 README 安装依赖并启动(依赖清单以仓库为准)
cat README.md

首次启动会比较慢——手机 CPU 和解压依赖都需要时间,耐心等日志输出即可。

常见问题

  • 存储空间不足:proot 发行版 + 依赖可能占 2~3GB,先在「设置 → 存储」里确认剩余空间;
  • 卡在下载依赖:多半是网络问题,检查代理设置,或换 Debian/Ubuntu 镜像源;
  • 后台被杀:手机省电策略会杀 Termux 进程,去系统设置里把 Termux 设为「不限制」;
  • 内存不足:少开几个后台 App,必要时用 free -h 观察内存。

写在最后

在手机上跑 AI Harness 的意义不在性能——手机再强也比不过服务器。它的意义在于:AI Agent 可以跟着你随时随地在身边跑。下一步我打算写插件与技能(MCP)的接入教程,想看的话留言告诉我。