先运行hermes doctor和hermes envcheck定位缺失项；若命令未找到，则需先换清华源、更新pkg、安装python≥3.11及必备原生命令（rg/ffmpeg/nodejs等），再建专用venv并配置jiter桩文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一键脚本在 Termux 中执行失败，不是脚本本身有问题，而是安卓环境的依赖链比桌面系统更脆弱——网络、架构、权限、Python 版本四者稍有不匹配，脚本就会中断。关键不是重试脚本，而是分层定位缺失环节。
先确认到底缺什么
别急着重装，先让 Hermes 自己说话：
- 运行 hermes doctor —— 它会逐项检查 rg、ffmpeg、python 模块、网关服务等是否就绪，MISSING 条目就是你的突破口
- 再跑 hermes envcheck —— 看 Python 虚拟环境路径、ANDROID_API_LEVEL、PATH 是否被正确识别
- 如果两个命令都报“command not found”，说明核心二进制根本没装上，跳过诊断，直接进下一步
Termux 环境基础必须稳住
很多失败源于 Termux 自身状态不健康：
- 换清华或北外镜像源：termux-change-repo → 选 tuna 或 bfsu；若命令不存在，手动改源：
sed -i 's@^\(deb.*stable main\)$@#\1\ndeb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main@' $PREFIX/etc/apt/sources.list - 清理并更新：pkg clean && pkg update && pkg upgrade —— 确保 pkg、python、clang 等基础工具是最新版
- 验证 Python 版本：python --version，必须 ≥ 3.11；若只有 3.9 或 3.10，执行 pkg install python 升级（Termux 的 python 包默认指向最新稳定版）
系统级工具一个都不能少
Hermes 不只靠 Python，它调用大量原生命令：
- 必装项（一行搞定）：pkg install -y git ripgrep ffmpeg nodejs clang rust make pkg-config libffi openssl
- 特别注意：ripgrep（rg） 和 ffmpeg 是高频缺失项，脚本常静默跳过，但运行时直接崩溃
- Node.js 必须 ≥ 18：node -v 查版本；若太低，pkg install nodejs 后再 pkg install npm
Python 环境要干净且隔离
Termux 默认 Python 环境容易和系统残留冲突：
- 不用系统 Python，建专用 venv：python -m venv ~/hermes-venv && source ~/hermes-venv/bin/activate
- 激活后装依赖：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -e '.[termux]'（进项目目录再执行）
- ARM 设备（绝大多数安卓手机）需额外一步：为 jiter 创建 Python 桩文件，否则 Rust 组件启动失败
echo '#!/data/data/com.termux/files/usr/bin/python3\nimport sys\nsys.argv = ["jiter"] + sys.argv[1:]\nexec(open("/data/data/com.termux/files/usr/lib/python3.12/site-packages/jiter/__main__.py").read())' > ~/hermes-venv/bin/jiter && chmod +x ~/hermes-venv/bin/jiter
