首页 / 开源热榜 / Reasonix / 使用教程

Reasonix 中文教程：先在测试分支审查一次完整任务

更新于 2026-09-23 · 约 8 分钟

Reasonix 是本地编码代理，引擎以 Go 单二进制运行，可从终端、桌面、浏览器或 ACP 编辑器接入。它可以读写文件和调用工具，所以第一次试用的重点是看清计划、权限请求、检查点与最终 diff。

当前版本：Reasonix CLI 最新稳定版为 v1.38.11，发布于 2026-09-20。本版改善会话迁移、跨端接管和导出，修复 Windows 凭据与 Shell，并完善图片附件。桌面端使用 desktop-v*，Studio 使用 studio-v*，三个版本线要分别核对。

1. 安装预编译 CLI

任选一种官方路径。npm 包会拉取原生二进制；macOS 可通过项目的 Homebrew tap 安装。发行页也提供 macOS、Linux、Windows 的 amd64/arm64 归档和 SHA256SUMS。

# 任意受支持平台
npm i -g reasonix

# 或 macOS
brew install esengine/reasonix/reasonix

只有从源码构建 CLI 才需要 Go 1.26+。桌面源码构建还要求 Node 24+ 与 pnpm 10，单纯安装 CLI 不需要这些构建环境。

2. 准备一份能回退的工作区

cd /path/to/test-repo
git status
git switch -c try-reasonix

先提交或备份已有改动，避免代理修改和未提交工作混在一起。给测试用 provider 单独发放低权限密钥，不要让会话读取生产凭据、SSH 私钥或工作区之外的目录。

3. 配置 provider，再给一个小任务

reasonix setup
reasonix

# 熟悉审批过程后再试一次性命令
reasonix run "解释 main.go 中的 TODO，先不要修改文件"

reasonix.toml 声明 provider、agent、启用工具和插件。DeepSeek 是预设，也可以接 OpenAI 兼容端点。初次会话先让它只读解释，再允许改一两个文件；每次工具请求都检查目标路径和命令。

权限边界：工作区沙箱、权限确认和逐轮检查点能缩小事故范围，但仍要用 Git 分支和外部备份。任何涉及依赖安装、删除文件、网络上传或执行脚本的请求，都应单独审查。

4. 检查结果后再继续

git status --short
git diff --stat
git diff

确认改动只落在预期文件，测试命令来自你信任的项目，再决定是否运行。VS Code 扩展需要本机 CLI，它会启动 reasonix acp；安装扩展不会自动补齐 CLI。

与 Aider 对比

Aider 官方项目强调终端结对编程、代码库 map、自动 Git 提交、lint/test 和 /undo。Reasonix 更侧重一个引擎贯通 CLI、桌面、浏览器和 ACP 编辑器，并把计划、权限、工作区沙箱、逐轮检查点和插件协议纳入运行时。喜欢紧凑的终端加 Git 流程，可以先看 Aider；需要跨入口接管会话与细粒度工具控制，可以评估 Reasonix。

验证状态：本轮只核对官方 main-v2 README、CLI v1.38.11 Release、Security Policy、检查点文档与 Aider 官方仓库；没有下载安装包、核对本地校验和、配置 provider、启动会话或批准工具执行。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

适合在终端里完成代码阅读、局部修改、测试与长会话，也适合需要在 CLI、桌面和编辑器之间接管同一会话的开发者。它能调用工具并修改工作区，敏感仓库应从最小权限、独立分支和受限凭据开始。

采用建议

Reasonix 适合需要长会话、多个入口和明确工具审批的编码工作。先在可丢弃分支中试用，逐项审核计划、权限和 diff；只有确认工作区边界与凭据隔离后，才让它承担更长的自动任务。

原教程未展开的系统信息

核心功能

可回看的长任务
计划模式、权限、工作区沙箱与逐轮检查点用于限制工具操作，并让长任务能够检查和回退。

架构与数据流

Reasonix 的 Go 引擎负责会话、上下文、工具、权限和 provider。CLI/TUI 可直接运行，桌面端和浏览器提供图形入口，编辑器通过 ACP 连接本地后端。MCP server 可贡献工具、提示和资源；Extension Protocol v1 sidecar 还能接入 provider、结构化界面和运行时事件。

常见问题

Reasonix CLI v1.38.11 是什么时候发布的？

官方 GitHub Release 记录的发布日期是 2026-09-20，更新重点包括会话迁移、跨端接管、导出、Windows 修复和图片附件。

安装 Reasonix CLI 必须先装 Go 吗？

使用 npm、Homebrew 或发行页预编译包时不需要 Go；只有从源码构建 CLI 才要求 Go 1.26+。

Reasonix 的 VS Code 扩展自带 CLI 吗？

不带。官方 README 要求先完成 CLI 安装，扩展随后启动本机 reasonix acp 后端。

Reasonix 的检查点能替代 Git 备份吗？

不能。检查点便于逐轮回退，实际代码仍应放在独立分支并保留 Git 提交，运行前还要限制工作区和凭据权限。