安卓免 root 部署duke5am/deepseek-harness-on-android

Android 上的 DeepSeek Harness (dsh) — Termux + proot-distro + Ubuntu 安装指南

License: MIT
dsh
Termux
PRoot
Ubuntu 26.04 LTS

一份完整、可直接复制粘贴的指南，教你如何在 Android 手机上通过 Termux、proot-distro 和 Ubuntu 安装并运行 DeepSeek Harness (dsh) —— 即 CLI + 浏览器 Web UI 的 agent harness。内容涵盖 Node.js/npm、dsh 安装、首次运行配置、环境技能（skills）以及 Python 依赖。已在 PRoot 下的 Ubuntu 26.04 LTS "Resolute Raccoon"（aarch64） 上验证 —— 无需 root。

DeepSeek Harness 是一个开源的 agent harness（CLI + 浏览器 Web UI），它会启动一个 profile —— 即按顺序堆叠的插件层 —— 来运行带有工具的 LLM agent。本仓库是一份循序渐进的 教程，教你如何在 Android 手机上通过 Termux + proot-distro（PRoot 下的 Ubuntu，无需 root）运行它，并附带来自 duke5am/skills-for-proot-distro-ubuntu 的配套环境技能。

快速开始（TL;DR）

整个安装流程浓缩为两个可直接复制粘贴的代码块：

--- 1. 在 Termux 中 ---
pkg update && pkg upgrade
pkg install proot-distro
proot-distro install ubuntu
proot-distro login ubuntu

--- 2. 在 Ubuntu 中（以 root 身份）---
apt update && apt install -y curl git
curl -fsSL https://deb.nodesource.com/setup_22.x -o /tmp/setup_node.sh && bash /tmp/setup_node.sh
apt install -y nodejs
npm install -g @deepseek-ai/dsh
git clone --depth 1 https://github.com/duke5am/skills-for-proot-distro-ubuntu.git /tmp/dsh-skills && cp -r /tmp/dsh-skills/{package-installation,python-usage,shell-usage,writing-skills} ~/.dsh/skills/ && rm -rf /tmp/dsh-skills
dsh web   # 浏览器 UI 位于 http://127.0.0.1:3080

继续阅读以获取详细的操作步骤（配置、Python 依赖以及故障排除）。

内容概览

- README.md —— 本循序渐进式安装指南
- setup.sh —— 自动化执行第 4–7 步（安装 dsh、克隆技能、核心 apt 软件包）
- requirements.txt —— 已验证 Python 环境的完整 pip3 freeze 快照
- LICENSE —— MIT

已验证环境

本指南基于以下确切版本编写并测试 —— 与生成 requirements.txt 快照的环境相同：

| 组件 | 版本 |
|---|---|
| 宿主机 | Android (arm64) + Termux (F-Droid) |
| 发行版 | 通过 proot-distro 安装的 Ubuntu 26.04 LTS "Resolute Raccoon" |
| Node.js | 22.23.2（NodeSource node_22.x） |
| npm | 10.9.8 |
| dsh | 0.1.1-rc.2 (@deepseek-ai/dsh) |
| Python | 3.14.4 |
| pip | 25.1.1（PEP 668 — 外部管理） |
| DSH_HOME | /root/.dsh |

第 1 步 — 安装 Termux

安装 F-Droid 版本（Play 商店版本已弃用且过时）：

- F-Droid 上的 Termux

pkg update && pkg upgrade

第 2 步 — 安装 proot-distro + Ubuntu

pkg install proot-distro
proot-distro install ubuntu
proot-distro login ubuntu

proot-distro install ubuntu 会将当前的 Ubuntu LTS 拉取到一个无 root 容器中。从这里开始，每条命令都在 Ubuntu 发行版内部以 root 身份运行（无需 sudo）。

第 3 步 — 安装 Node.js + npm（在 Ubuntu 内）

使用 NodeSource 的 node_22.x 仓库（与已验证的构建版本匹配）：

apt update
apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_22.x -o /tmp/setup_node.sh
bash /tmp/setup_node.sh
apt install -y nodejs
node --version   # v22.23.2
npm --version    # 10.9.8

将安装脚本下载到文件后再用 bash 执行，而不是 curl … | bash。
在 PRoot 下，对 fork/多线程进程进行管道传输可能会挂起 — 参见 skills 仓库中的 shell 注意事项。

第 4 步 — 通过 npm 安装 dsh

npm install -g @deepseek-ai/dsh
dsh --version   # 0.1.1-rc.2

由于 npm 的全局前缀为 /usr，二进制文件会安装到 /usr/bin/dsh。

第 5 步 — 首次运行与配置

dsh --help              # 列出子命令
dsh web                 # 启动浏览器 UI（默认：http://127.0.0.1:3080）
dsh --profile tui       # 终端 UI
dsh --profile headless "answer one task and exit"

首次启动时 dsh 会创建 ~/.dsh（即 $DSH_HOME，在 PRoot 下为 /root/.dsh）：

- .credentials.yaml — 提供商 API 凭据（在 web 引导过程中设置）
- settings.yaml — 默认模型、权限预设、shell 超时
- skills/ — 用户 skills 根目录（环境 skills 存放于此）
- profiles/、sessions/、storages/ — profile 层和会话状态

在手机浏览器中打开 web UI，地址为 http://127.0.0.1:3080（或通过 ssh/adb 转发端口以便从桌面访问）。

第 6 步 — 安装环境 skills

这四个 skills 会教会模型 PRoot/Termux 特有的规则（用 apt 而非 pip、管道挂起、FUSE 写入 EPERM 等），从而让子代理不再遇到执行和路径错误：

git clone --depth 1 https://github.com/duke5am/skills-for-proot-distro-ubuntu.git /tmp/dsh-skills
cp -r /tmp/dsh-skills/{package-installation,python-usage,shell-usage,writing-skills} ~/.dsh/skills/
rm -rf /tmp/dsh-skills

重启 dsh 会话以便重新扫描 skill 目录，然后确认这四个 skill 名称出现在会话的可用 skills 列表中。

第 7 步 — Python 依赖

requirements.txt 是已验证环境的完整 pip3 freeze 快照。有两种使用方式：

推荐 — apt（无需 venv，无需 pip）： Ubuntu 将科学计算栈打包为 python3-：

apt install -y python3-pandas python3-numpy python3-scipy python3-matplotlib \
python3-requests python3-pypdf python3-bs4 python3-openpyxl \
python3-lxml python3-httpx python3-yaml python3-dotenv \
python3-cryptography python3-tqdm python3-pil

精确复现 —— venv + requirements.txt： pip 在全系统范围内被 PEP 668 阻止，但 venv 中的 pip 不受此限制：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

自动化

setup.sh 一次性运行步骤 4–7（dsh 安装 → 克隆 skills → 核心 apt 软件包）：

chmod +x setup.sh
./setup.sh

故障排除

- pip install 因 externally-managed-environment 被拒绝 → 使用 apt install python3-（PEP 668）。
- 某条命令“卡住” → 不要通过管道传给 tail/head；重定向到文件，然后在另一条命令中读取它。
- harness 的 write 工具在 /sdcard 上因 EPERM 失败 → 通过 bash heredoc 或 Python 写入（FUSE 缺少原子重命名）。
- 复制的 skill 无法加载 → 对照 writing-skills 检查清单检查 SKILL.md 的 frontmatter（name/description）。

以上每一项的完整详情：duke5am/skills-for-proot-distro-ubuntu。

许可证

MIT —— 参见 LICENSE。