上周末我在 GitHub 上发现了一个项目，点进去看了五分钟就开始安装，用了两小时后决定写一篇介绍。这个东西叫 Reasonix——一个专为 DeepSeek 设计的终端 AI 编程 Agent，MIT 开源，TypeScript 编写，社区驱动。
它跟 Claude Code、Aider 等同类工具最大的区别不在于"谁更聪明"，而是对 DeepSeek 的适配达到了本质级别。不是简单的"支持 DeepSeek"，而是专门为 DeepSeek 的 API 特性深度优化。
前缀缓存：大部分工具没认真做的事
DeepSeek API 自带前缀缓存机制：连续两次请求的前缀完全一致时，缓存的输入 token 只收 10% 的费用。听起来很诱人？问题在于，在通用客户端中跑长会话，缓存命中率能到 60% 就算不错。原因每轮对话消息会重排、工具定义重新序列化、思维链挤入 prompt——前缀只要变一个字节，缓存就失效了。
Reasonix 的解法是把整个对话循环拆成三个独立区域：
- 不动层：系统提示词、工具定义、few-shot，会话启动后锁定，一个字节都不变
- 只追加层：对话记录永远向后追加，不重排、不原地修改
- 临时层：思维链和临时计划放在缓存区外，不参与下次请求的前缀匹配
这套架构的实际效果：某真实用户单日 4.35 亿输入 token，缓存命中率 99.82%，实际花费 $1.38。同样跑量如果不走缓存，DeepSeek 后台显示 $61。省了 97.7%，不是调参数调出来的，是架构设计决定的。
苏米注：这个三层架构设计很精妙。不动层保证前缀稳定，只追加层避免重排破坏缓存，临时层把可变内容隔离出去。思路清晰，执行到位。
安装教程
前置条件：Node.js 22 以上，一个 DeepSeek API Key。
- 前往 platform.deepseek.com/api_keys 创建 API Key
- 进入项目目录（无需全局安装，进入目录即用）：
cd your-project npx reasonix code - 首次运行会弹出输入框粘贴 API Key，输入后自动记住，无需配置环境变量或修改配置文件
如需安装全局命令：
npm install -g reasonix
reasonix code your-project安装完成后，直接敲 reasonix 等价于 reasonix code，自动打开当前目录。支持 macOS、Linux、Windows，Windows 上推荐 Windows Terminal 或 PowerShell，Git Bash 也可运行。
还有一个短别名 dsnix，敲击更快，与 reasonix 完全等价。
使用教程
安装后进入 Reasonix 界面：
首先需要执行 /init 命令初始化项目，会生成 REASONIX.md 文件：
初始化完成后输入 y 或按回车确认，不满意可用其他指令拒绝并重新生成。
界面底部显示 Tokens 消耗、缓存命中率及余额：
键盘按 Shift+Tab 切换模式：
- review：审查模式，部分命令自动执行，敏感操作仍需确认
- AUTO：自动模式，所有命令需确认
- YOLO：自由模式，所有命令直接执行（生产环境慎用）
输入 /model + 空格切换模型：
终端用不习惯？Reasonix 自带网页控制台。安装后终端会显示网页链接：
http://127.0.0.1:11555/?token=***
网页操作更直观。输入 / 调出命令菜单：
模式切换：
模型及推理强度切换：
核心命令速查
| 命令 | 功能 |
|---|---|
reasonix code [目录] |
编程模式，带文件读写和终端，主入口 |
reasonix chat |
纯聊天，不碰文件和终端 |
reasonix run "任务" |
一次性跑完，结果输出到 stdout，适合脚本管道 |
reasonix commit |
自动写 commit message 并执行 git add -A && git commit |
reasonix doctor |
体检：Node 版本、API Key、MCP 接线、配置合法性 |
reasonix update |
自我升级 |
还有 reasonix sessions 管理会话、reasonix diff 比较两个 transcript 的成本差异、reasonix stats 看账单分析、reasonix index 建本地语义索引——项目文档翻一下很容易上手。
不只是写代码的工具箱
Reasonix 虽然叫"coding agent"，但实际上把 AI Agent 生态里能想到的扩展机制都做了：
- MCP（Model Context Protocol）：支持 stdio、SSE、Streamable HTTP 三种传输协议。配置写在 ~/.reasonix/config.json 里，一条字符串接一个 MCP 服务器。内置 MCP 市场，/mcp 命令直接浏览安装
- Skills：Markdown 写的剧本，模型自动调用。支持内联模式和子 Agent 模式。兼容 Claude Code 的 skills 路径（.claude/skills/），无需格式转换
- 持久记忆：项目级和全局级两层，用 /memory 管理，模型在对话中自动读写
- Hooks：工具调用前/后、用户提交 prompt、会话停止四个生命周期都能挂自定义 shell 命令
- 权限控制：终端命令默认需审批。editMode 三级：review（每次编辑确认）、auto（编辑自动执行但终端命令需批）、yolo（全自动）
- Web 搜索：默认 Mojeek，可切到自托管 SearXNG 或 Metaso
- 语义索引：用本地 Ollama 或 OpenAI 兼容 embedding 接口给代码建索引
- QQ 通道：中文用户特别实用——把会话延伸到 QQ，手机上继续跟 Agent 对话
- 桌面客户端：Tauri 原生桌面应用，多标签页，右侧面板实时显示 Agent 读写文件，底部成本和缓存仪表
与 Claude Code、Cursor、Aider 对比
| 特性 | Reasonix | Claude Code | Cursor | Aider |
|---|---|---|---|---|
| 后端 | DeepSeek | Anthropic | OpenAI/Anthropic | 任意 |
| 开源 | MIT | 闭源 | 闭源 | Apache 2 |
| 单任务成本 | 低 | 高 | 订阅+用量 | 看模型 |
| DeepSeek 前缀缓存 | 工程化优化 | 不适用 | 不适用 | 偶发 |
| 内嵌仪表盘 | 有 | 无 | 部分有 | 无 |
| 持久化会话 | 有 | 无 | 无 | 无 |
| MCP/Hooks/Skills | 齐全 | 有部分 | 无 | 无 |
这张表最核心的一行就是成本。Claude Code 和 Cursor 好不好？好。但用它们跑一下午重构代码，账单可能是 Reasonix 的 10 倍起步。Aider 支持 DeepSeek，但对话循环没为 DeepSeek 缓存机制做专门设计，命中率全靠运气。
什么人该用
用 DeepSeek API 写代码的人，没有理由不试。特别是：
- 长时间改代码、重构、补测试的——缓存能压到你感觉不到在花钱
- 预算敏感的个人开发者——v4-flash 默认档跑日常够用
- 喜欢终端工作流的——不依赖 IDE 插件
- 想自己看源码改源码的——MIT 协议 + TypeScript + 模块拆分清晰
什么人不适合
- 用 Claude 或 GPT 写代码的——它只认 DeepSeek，不是选配，是唯一后端
- 做极致数学/逻辑推理的——Claude Opus 在部分 benchmark 上还是更强
- 非要带 GUI 的完整 IDE 的——它不是 IDE 替代品
装好之后先试这几件事
- 进一个项目目录，跑
npx reasonix code - 输入
/init——它会扫描项目结构，自动生成 REASONIX.md 作为项目记忆 - 提一个简单的改代码需求，看看 SEARCH/REPLACE 编辑预览长什么样
- 输
/apply确认写入，或/discard放弃 - 敲
/stats看一眼花了多少钱
这套流程走下来，你大概就能理解它跟其他 Agent 工具到底有什么不一样了。
项目地址：github.com/esengine/DeepSeek-Reasonix
官网：esengine.github.io/DeepSeek-Reasonix
API Key 申请：platform.deepseek.com/api_keys