Reasonix 是 DeepSeek 官方推荐的终端 AI 编程助手,MIT 开源,专为 DeepSeek API 优化(缓存命中率 99%+,成本比 Claude Code 低 94-97%)。
一键安装
在 Termux 中按顺序执行:
bash
# 1. 安装系统依赖(git / python / NDK 编译链)
pkg install git python3 ndk-multilib -y
# 2. 克隆仓库
git clone https://github.com/esengine/DeepSeek-Reasonix.git ~/DeepSeek-Reasonix
# 3. 安装 + 构建
cd ~/DeepSeek-Reasonix
export npm_config_android_ndk_path=$PREFIX/opt/ndk-multilib
npm install --ignore-scripts
npm run build
npm link
完成后验证:
bash
reasonix --version # 应输出 0.50.1
日常使用
bash
reasonix code /path/to/project # 进入编码模式,直接在项目里写代码
reasonix chat # 纯文字聊天,不操作文件
reasonix run "一句话任务" # 一次性执行,不进入交互
reasonix --help # 查看所有命令
首次运行会提示输入 DeepSeek API key,去 platform.deepseek.com 注册获取。
TUI 内常用快捷键
| 命令 | 作用 |
|---|---|
/pro |
下一轮切换到 V4 Pro 模型(默认用 Flash 省钱) |
/undo |
撤销 AI 最近的修改 |
/help |
查看所有 slash 命令 |
/skill new |
创建自定义技能 |
卸载/重装
bash
rm -rf ~/DeepSeek-Reasonix ~/.reasonix
npm uninstall -g reasonix
# 然后重新执行一键安装
踩坑记录
以下是在手机上实际安装时遇到的问题和原因:
坑 1:npm install -g reasonix 直接报错
原因 :全局安装模式下 postinstall 脚本在子目录跑了 npm ci,与 -g 模式不兼容。
解决 :放弃 npm install -g,改用源码 git clone + npm install + npm link。
坑 2:tree-sitter-* 原生模块编译失败(缺少 Python)
gyp ERR! find Python --python was not set
原因 :tree-sitter-javascript、tree-sitter-java 等是原生 C 模块,依赖 node-gyp 编译,需要 Python。
解决 :pkg install python3 -y
坑 3:tree-sitter-java 编译报 android_ndk_path 未定义
gyp: Undefined variable android_ndk_path in binding.gyp
原因 :tree-sitter-java 的 binding.gyp 里写死了 android_ndk_path 变量,在 Android/Termux 上必须由外部传入。
解决:安装 NDK 并通过环境变量传递:
bash
pkg install ndk-multilib -y
export npm_config_android_ndk_path=$PREFIX/opt/ndk-multilib
坑 4:原生编译即使配好了也容易崩
make: *** No rule to make target ... Stop.
原因 :多个 tree-sitter-* 版本的 binding.gyp 不一致,Termux 的 make 工具链下交叉编译容易出各种问题。
解决 :跳过原生编译 ,用 npm install --ignore-scripts 只装 JS 部分。Reasonix 的 npm run build 会自动把 WASM 版的 tree-sitter-*.wasm 拷贝到 dist/grammars/,运行时用 WASM 代替原生模块,功能完全一致。
坑 5:reasonix --version 提示命令不存在
可能原因:
npm link失败 → 确认ls $(npm config get prefix)/bin/reasonix存在dist/cli/index.js不存在 → 确认npm run build成功执行- Shell 缓存 →
hash -r刷新