一、Reasonix 是什么?
Reasonix 是一款DeepSeek 原生的终端 AI 编码 Agent,由社区开发者 esengine 开源(MIT 协议),GitHub 已获 17K+ Star。它的设计完全围绕 DeepSeek API 展开——Cache-First 循环、Flash 优先的成本控制、工具调用自动修复——直接对接 api.deepseek.com,不需要任何协议转换层。
与 Claude Code、Cursor、Aider 等工具不同,Reasonix 不做"多模型兼容"的万金油框架,而是深度绑定 DeepSeek,将前缀缓存稳定性发挥到极致。Reasonix 1.0 已用 Go 语言完全重写,编译为单个静态二进制文件,性能大幅提升。
二、核心特性
2.1 缓存优先架构,成本直降 80%+
这是 Reasonix 最核心的竞争力。它采用只追加、不修改的会话逻辑,针对 DeepSeek 的字节稳定前缀缓存做了深度优化:
- 未缓存令牌:$0.07 / 百万
- 缓存命中后:仅 $0.014 / 百万(便宜 5 倍)
- 长期会话缓存命中率可达 94%
- 长期写项目的费用仅相当于普通 AI 工具的 1/3
2.2 配置驱动,灵活可控
所有 providers、agent、工具、插件均通过 reasonix.toml 声明式配置。无需硬编码模型,支持:
- DeepSeek V4-Flash(默认,日常迭代控制成本)
- DeepSeek V4-Pro(/pro 一键切换,处理复杂任务)
- MiMo 系列模型(MiMo-v2.5-Pro / MiMo-v2-Flash)
- 任何 OpenAI 兼容端点
2.3 双模型协作
可同时运行两个模型:Executor(执行者,高频交互)+ Planner(规划者,低频决策),各自拥有独立的缓存稳定会话。适合复杂项目中对成本敏感的场景。
2.4 MCP 插件生态
Reasonix 是完整的 MCP(Model Context Protocol)客户端:
- 本地插件:stdio JSON-RPC 子进程
- 远程插件:Streamable HTTP 连接
- 兼容现有
.mcp.json配置,直接读取 - 内置参考插件
reasonix-plugin-example可供复制开发
2.5 安全沙箱
双重保护机制确保代码安全:
- 目录沙箱:文件写入工具仅能操作项目目录,符号链接和
..穿越会被拦截 - 计划审核:
/plan开启只读模式,AI 改代码需手动确认 - 权限分级:deny(硬阻止)> ask(询问)> allow(放行),bash 命令可精确匹配
2.6 自定义技能 (Skills)
用 Markdown 编写可复用的技能脚本,放在 .reasonix/skills/ 目录下即自动注册为斜杠命令。支持 subagent 模式(隔离子代理运行),适合代码审查、安全扫描、测试运行等场景。
2.7 桌面版可视化
Reasonix 同时提供基于 Tauri 的桌面客户端:
- 零配置开箱即用,自带 Node 运行环境
- 多标签会话,同时管理多个项目
- 实时仪表盘:成本、缓存命中率、令牌消耗一目了然
- 与 CLI 版共用
~/.reasonix配置,换端无需重新设置
三、快速上手
3.1 环境准备
需要 Node.js 20.10 及以上版本。Windows 用户需额外安装 Git for Windows。
3.2 获取 API Key
访问 DeepSeek 开放平台 注册并创建 API Key。
3.3 安装方式
方式一:npx 零安装(推荐)
cd /path/to/my-project
npx reasonix code
首次启动会有内置向导询问 API Key 并持久化到 ~/.reasonix/config.json,无需手动配置环境变量。
方式二:全局安装
npm install -g reasonix
reasonix code
方式三:macOS Homebrew
brew install esengine/reasonix/reasonix
3.4 基础命令
reasonix setup # 配置向导
reasonix chat # 交互式对话
reasonix run "实现 main.go 中的 TODO" # 单次执行
reasonix run --model mimo-pro "添加单元测试" # 指定模型
3.5 常用斜杠命令
| 命令 | 作用 |
|---|---|
/pro | 下一轮切换到 DeepSeek-V4-Pro |
/plan | 进入只读计划模式,改代码需确认 |
/compact | 压缩上下文,释放缓存 |
/new | 开启新会话 |
/tree | 查看对话分支树 |
/branch | 从当前节点创建分支 |
/mcp | 列出已连接的 MCP 服务器 |
/memory | 管理持久化记忆 |
/help | 查看完整命令列表 |
四、@ 引用功能
在对话中直接引用文件和 MCP 资源:
@path/to/file.go—— 注入本地文件内容@src/—— 注入目录列表@stripe:customers/list—— 注入 MCP 资源
输入 / 或 @ 会弹出自动补全菜单。
五、与同类工具对比
| 特性 | Reasonix | Claude Code | Cursor |
|---|---|---|---|
| 后端模型 | DeepSeek 专属 | Claude 专属 | 多模型 |
| 前缀缓存优化 | ✅ 核心特色 | 一般 | 一般 |
| 缓存命中率 | 94% | 取决于实现 | N/A |
| 成本(长会话) | 极低 | 高 | 中 |
| 许可证 | MIT 开源 | 专有 | 专有 |
| 桌面版 | ✅ Tauri | ❌ CLI only | ✅ Electron |
| MCP 支持 | ✅ 原生 | ✅ 原生 | 有限 |
| 自定义技能 | ✅ Markdown | ✅ CLAUDE.md | ✅ .cursorrules |
| 安全沙箱 | ✅ 目录+权限 | 权限系统 | N/A |
六、适用场景
- 全栈开发者:长期需要 AI 辅助编码,在意使用成本
- 个人开发者 / 小团队:预算有限,但需要稳定的 AI 编码能力
- 终端用户:习惯命令行工作流,不喜欢臃肿的 IDE 插件
- 多项目管理:需要同时维护多个代码仓库并追踪成本
七、总结
Reasonix 不是又一个"AI 编程助手",而是一个围绕成本效率深度设计的工程工具。它通过缓存优先架构、Go 语言重写的单二进制分发、MCP 插件生态和完善的安全沙箱,为 DeepSeek 用户提供了一个真正可长期使用的 AI 编码方案。
如果你已经在用 DeepSeek API、或者觉得 Claude Code / Cursor 太贵想找平替,Reasonix 值得一试。MIT 开源协议意味着你可以自由使用、修改和分发。
GitHub:esengine/DeepSeek-Reasonix | 官方文档:esengine.github.io/DeepSeek-Reasonix | Discord 社区:discord.gg/XF78rEME2D