为什么只用 DeepSeek?
这不是一个多模型代理框架。Reasonix deliberately 只做 DeepSeek,原因是前缀缓存。
DeepSeek 的 API 支持前缀缓存——如果连续两次请求的前缀内容相同,缓存部分按极低价格计费。但问题是,一般的 AI 代理框架会在对话中不断插入新的系统提示、工具结果、文件内容,把前缀打乱,缓存就失效了。
Reasonix 的设计思路反过来了:不是"打开缓存功能",而是整个循环围绕前缀不变来设计。系统提示、工具格式、上下文排列全部固定,保证每次请求的前缀字节级稳定。这样 DeepSeek 端的缓存命中率就能维持在高位。

效果:一个真实用户一天的数据——4.35 亿输入 token,缓存命中率 99.82%,花了大约 12 美元。同样的工作量,如果不做缓存优化,大概要花 61 美元。
怎么用?
需要 Node.js 22 以上。一行命令就能跑:
npm install -g reasonix reasonix code my-project
第一次运行会提示你粘贴 DeepSeek API key,之后会持久保存。不想全局安装也可以用 npx 一次性运行:
cd my-project npx reasonix code
还有一个短别名 dsnix,少敲几个字母。

有三种模式:
reasonix code:编程代理,有文件系统读写、Shell 工具、SEARCH/REPLACE 编辑审查reasonix chat:纯聊天,没有磁盘访问,适合当思考搭档reasonix run "task":一次性执行,输出到标准输出,适合管道
三个核心设计
Reasonix 的架构围绕三个支柱:
第一,缓存优先循环。 前面说了,所有排列固定,保证前缀稳定。会话也是持久的——同一个项目目录下,对话上下文会保留,不用每次从头开始。
第二,工具调用修复。 AI 生成的工具调用偶尔会格式错误,一般框架直接报错重来。Reasonix 会尝试修复格式,减少无效重试浪费的 token。
第三,成本控制。 内置成本仪表盘,实时显示 token 消耗、缓存命中率和费用。还有一个 /effort 参数可以控制模型的工作强度,省 token。
还能做什么?
支持 MCP 服务器接入、自定义技能(Markdown 格式写 playbook,支持 inline 和 subagent 两种模式)、项目级和全局的记忆系统、生命周期钩子(可以在工具使用前/后执行 Shell 命令)、网页搜索(默认 Mojeek,也可切换 SearXNG 或 Metaso)、语义索引(本地 Ollama 或任意 OpenAI 兼容 embedding)。
技能格式兼容 Claude Code——.claude/skills/ 目录下的技能也能直接加载。如果你已经用 OpenSpec 之类的工作流,不用改格式。
还有一个 Tauri 做的桌面客户端(预览版),多标签页、右侧面板显示本会话读写过的文件、底部显示费用/缓存/token 仪表盘。和 CLI 共用同一个配置和 API key。
和同类工具的对比
| Reasonix | Claude Code | Cursor | Aider | |
|---|---|---|---|---|
| 后端 | DeepSeek | Anthropic | OpenAI/Anthropic | 任意 |
| 许可证 | MIT | 闭源 | 闭源 | Apache 2 |
| 前缀缓存优化 | 工程设计 | 不适用 | 不适用 | 偶然命中 |
| 持久会话 | 支持 | 部分 | 不适用 | 不支持 |
| 开源社区开发 | 是 | 否 | 否 | 是 |
它不做什么
Reasonix 有自己的立场,有些功能它故意不做:
不做多模型。只用 DeepSeek 是特性,不是限制。如果你需要 Anthropic 或 OpenAI,可以看看 Claude Code 或 Cursor。
不做 IDE 集成。终端优先,diff 看 git diff,文件树看 ls。桌面客户端是补充,不是 Cursor 的替代品。
不做最难的理论推理。Claude Opus 在某些基准上还是更强。如果你的工作是"解博士级证明题"而不是"修认证 bug",用 Claude 更合适。
不是完全免费的。需要付费的 DeepSeek API key。想要零成本跑可以看看 Aider + Ollama。
适合谁?
如果你已经在用 DeepSeek 的 API,Reasonix 基本上是目前最省 token 的编程代理方案。前缀缓存命中率接近 100% 的情况下,同样的工作量费用能差五倍。
如果你用 Claude Code 或 Cursor 已经习惯了,换到 Reasonix 需要适应终端交互模式——没有 IDE 的可视化界面,但 diff 审查和 /apply 流程做得还行:代理提出编辑,你审查后才写入磁盘。
MIT 许可证,社区开发,代码透明。想看的可以直接去 GitHub 仓库。