Reasonix 是一个 DeepSeek-native 的终端编码 agent，运行时是一个 Go 静态二进制。它的整个设计围绕 DeepSeek 的 prefix cache，让长会话的 token 成本维持在低位。在 Ubuntu 上有三条安装路径，根据你机器已有的工具挑一条即可。
安装前的准备
在一台干净的 Ubuntu 24.04 LTS 上，你需要先准备：
curl（多数桌面镜像已经有）- DeepSeek API key（去 platform.deepseek.com/api_keys 申请）
- 下面三选一：Node.js + npm、GitHub release 的 .deb、Go 工具链
Reasonix 本身是 CGO_ENABLED=0 的静态二进制，二进制一旦进入 $PATH，运行时就不再依赖别的。
路径 A — npm（最快，几乎通用）
sudo apt update && sudo apt install -y curl ca-certificates
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
npm i -g reasonix
reasonix --versionnpm i -g reasonix 现在不再下载 TypeScript 运行时——reasonix@1.0.0 之后，npm 包会拉预编译的 Linux 原生二进制到 npm 的全局 bin 目录。如果 reasonix --version 提示命令找不到，跑 npm bin -g 看一下，再把输出路径加进 shell 的 rc 文件。
路径 B — GitHub release 的 .deb（不依赖 Node）
不想装 Node 的时候走这条。从 releases 页面 找对应 CPU 架构的 .deb：
VERSION="1.17.19" # 改成当前 release tag
cd /tmp
curl -fsSLO "https://github.com/esengine/DeepSeek-Reasonix/releases/download/v${VERSION}/reasonix_${VERSION}_amd64.deb"
sudo apt install -y ./reasonix_${VERSION}_amd64.deb
reasonix --version装之前对照同 release 里的 SHA256SUMS 校验：
grep "reasonix_${VERSION}_amd64.deb" SHA256SUMS | sha256sum -c -最小镜像、CI runner、任何不想为这个工具引入 Node 的服务器，都适合用这条路径。
路径 C — 源码编译
sudo apt install -y build-essential git
git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
git checkout main-v2 # Go 1.0+ 分支；v1 是老的 TypeScript
make build # -> bin/reasonix
./bin/reasonix --versionmake cross 会跨平台编译到 darwin|linux|windows × amd64|arm64，结果放在 dist/。想用最新代码、调试 bug、或者要发 patch 的时候走这条。
配置 Provider
二进制装好之后，Reasonix 还不知道要调用哪个模型。跑交互式向导：
export DEEPSEEK_API_KEY="sk-..."
reasonix setup向导会把配置写到 Linux 下的 ~/.reasonix/config.toml，API key 存到 ~/.reasonix/.env。不喜欢交互式向导也可以直接手写这两个文件。
一份最小的 ~/.reasonix/config.toml：
default_model = "deepseek-flash"
[[providers]]
name = "deepseek-flash"
kind = "openai"
base_url = "https://api.deepseek.com"
model = "deepseek-v4-flash"
api_key_env = "DEEPSEEK_API_KEY"解析顺序是 命令行参数 > ./reasonix.toml > ~/.reasonix/config.toml > 内置默认，所以在一个项目里再放一份 reasonix.toml，该项目的设置会盖过用户级配置。
第一次会话
reasonix # 进交互 TUI；先 /init 生成 AGENTS.md
reasonix run "explain the auth flow in main.go"
reasonix run --model deepseek-pro "add unit tests for this function"
echo "refactor the parser" | reasonix run/init 会扫当前目录并写一份 AGENTS.md，后面会话就记住项目布局了。/plan on 把 agent 切到只读规划模式。/pro 在硬重构时调用更强的模型。/doctor 用来检查 API key、配置、hooks 和项目状态——启动失败的时候先跑它。
升级与卸载
# npm 路径
npm i -g reasonix@latest
# .deb 路径
sudo apt install -y --reinstall ./reasonix_<new_version>_amd64.deb
# 彻底重置：清掉用户配置
rm -rf ~/.reasonixReasonix 只在 ~/.reasonix/ 留下配置。卸载二进制 + 删掉这个目录就是完整的重置。
Reasonix 1.0 之后发生了什么
npm i -g reasonix 命令一直存在，但安装进去的东西不一样了。1.0 之前是 TypeScript 运行时，v1 分支现在依然如此；从 1.0.0 开始，npm 包是预编译 Go 二进制的薄壳。如果你从老版本升上来出问题，先确认旧 v1 分支的残留是不是还在 $PATH 上。
| 版本 | 关键变化 |
|---|---|
0.x（legacy） |
TypeScript 构建，停在 v1 分支，只修安全漏洞。 |
1.0.0 |
全量 Go 重写，迁到 main-v2。npm i -g reasonix 开始发 Go 二进制。 |
1.8.x |
用户配置统一到 ~/.reasonix/config.toml。Desktop 单独走 release tag。 |
1.17.x |
当前稳定线，本篇指南以此为准。 |
几个常见坑
npm i -g之后reasonix: command not found— 当前 shell 没读到npm bin -g。重启 shell 或者把打印出来的路径加进~/.bashrc。setup: api_key not set— 向导从 shell 的$DEEPSEEK_API_KEY或~/.reasonix/.env读 key。key 字符串本身不要进config.toml。- agent 改错了文件 — 在项目里放一份
reasonix.toml并设permissions = "ask"，让每个工具调用都要人工确认。 - 误把
v1分支 clone 下来 — 显式git checkout main-v2，TypeScript 构建已经不再是支持路径。
评论