Reasonix | Github发现 – 专为 DeepSeek 打造的终端 AI 编程 Agent

Reasonix 是一款能读取项目、调用工具并修改代码的开源编程 Agent。对已经使用 DeepSeek 的开发者，它的缓存管理、会话延续和用量显示值得关注；真正选用时，还要看版本、工具权限和改动是否容易检查。缓存优化可以减少重复输入的费用，但不能保证每个任务都低价、每次请求都命中缓存。

先分清版本，别把旧教程接到新引擎上

截至 2026 年 10 月 6 日核对，项目已经分为两个版本线。早期 0.x 的 TypeScript、Node.js 架构和“DeepSeek-only”说明，不能直接用于当前安装。当前采用 Go 本地引擎，DeepSeek 作为预设模型，也允许配置其他兼容接口。

版本线	当前定位	获取方式
Reasonix 1.x，main-v2 分支	维护与稳定使用，继续修复问题、兼容接口和更新安全相关实现	npm 安装 CLI；桌面包从官方下载页获取
Reasonix 2.x，studio 分支	新架构持续开发，桌面应用名为 Reasonix Studio	选择 studio-v2.* 发行包；标记 rc 的候选版属于预发布

日常使用可以先选维护中的 1.x；需要评估新架构时再选择 2.x。终端、桌面、浏览器和 ACP 编辑器接入都围绕本地引擎展开，但不同版本的配置、插件与发行包应对照对应分支，不能只凭包名混用教程。

费用要看本次会话，而不是宣传中的命中率

前缀缓存复用的是先前请求中可匹配的输入。Reasonix 会维护较稳定的上下文，并对过时工具输出做裁剪、摘要和压缩；模型、上下文变化及服务端缓存状态，仍会影响实际命中。

长会话里，系统说明、工具规格和历史信息常常反复发送，管理这些重复输入有实际价值。但短任务、频繁换模型、不断改写前文或大量重试，未必得到同样的收益。某次用户报告的高命中率，不能当作所有任务的保证，也不足以判断其他 Agent 的普遍表现。

用量与费用显示适合观察当前会话，再对照所选服务的账单；输入缓存、输出、模型档位和调用次数应一起看。框架采用 MIT 许可，模型 API 的账号、额度和费用另由服务商决定，使用终端客户端本身不会让云端推理变成免费或离线。

终端入门：安装、选模型，再进入项目

1.x 可以通过 npm 获取预编译的原生 CLI，不需要为了使用它先从源码编译 Go。以下命令用于终端路径：

npm i -g reasonix
cd my-project
reasonix setup
reasonix

1. 先确认安装的是所需版本线。npm 的普通安装入口是 1.x，2.x 使用对应 Studio 发行包。
2. 进入实际项目目录，运行 reasonix setup 配置 Provider、模型与凭据。桌面用户可在应用中设置，不需要重复执行整套 CLI 命令。
3. 首次任务给出明确对象和结果，例如请它说明某个函数的调用关系，再修改其中一个具体问题。先看它理解的范围，能减少无关文件被纳入任务。
4. 查看提出的改动和验证结果，再决定是否继续。单次非交互任务可使用 reasonix run "任务描述"，但仍受权限设置约束。

当前文档使用 TOML 配置。用户配置从 v1.8.1 起位于 macOS／Linux 的 ~/.reasonix/config.toml，Windows 的 %APPDATA%\reasonix\config.toml；项目配置叫 reasonix.toml。配置里保存凭据变量名，实际 Provider Key 放在全局 Reasonix 目录下的 .env，不应把密钥值写进共享项目配置。

改代码之前，弄清权限与回退分别管什么

Ask 模式会请求授权，工作区限制负责约束路径

以下权限与回退按 2.x 文档说明。工具权限决定允许、询问或拒绝；默认情况下，文件修改和 Bash 等写操作需要批准，已有规则也会影响后续行为。Ask 模式不是绝对只读，更不能概括为“所有改动必须统一经过 /apply 才落盘”。工作区限制则约束文件工具可以写入的路径，必要时还可以配置不可读取的位置。

系统级命令隔离依赖平台能力，当前文档明确提醒 Windows 的 Shell 命令不具备同样的系统沙箱边界。接到执行命令的请求时，需要看命令实际影响范围，不能把“文件编辑受工作区限制”当作所有命令都无法触碰其他数据。

检查点帮助恢复编辑，不是所有副作用的备份

2.x 的检查点和 /rewind 可以按回合恢复代码、对话或两者。当前快照主要跟踪 write_file、edit_file、multi_edit 等编辑工具的改动，文件移动与 Bash 命令的副作用并不全部纳入。安装依赖、修改数据库或执行外部命令前，不能只依赖会话回退。

需要扩展时，再接编辑器、MCP 和项目说明

• 喜欢在编辑器中工作：ACP 接入可把原生聊天、编辑器上下文和工具审批带进 VS Code 等入口；扩展需要本地 CLI 后端，不能只装扩展就当作已经准备完毕。
• 有专用工具或数据：MCP 可以贡献工具、提示与资源。扩展工具扩大了 Agent 能做的事，也需要相应配置与权限。
• 项目有固定约定：在交互会话中使用 /init 生成项目说明，再整理真正适用的开发要求；Skill 和扩展文档可承载重复工作流。

按需要增加功能，更容易判断问题来源：先选定版本和模型，完成一个范围清楚的任务，再按需要增加入口与工具。长期运行是否合算，应该由自己的任务成功率、检查成本和实际账单来判断。

• 源码与版本说明：https://github.com/esengine/DeepSeek-Reasonix
• 1.x 分支：https://github.com/esengine/DeepSeek-Reasonix/tree/main-v2
• 桌面获取入口：https://reasonix.io/?download=desktop#start
• npm 包：https://www.npmjs.com/package/reasonix