上个周末我在 GitHub 上划到一个项目，点进去看了五分钟就开始装，装完用了两小时，然后决定写这篇。

这个东西叫 Reasonix。DeepSeek 原生的终端 AI 编程 Agent。MIT 开源，TypeScript 写的，社区驱动。

1779846443606

它跟 Claude Code、Aider 这些同类工具最大的区别不是“谁更聪明”，而是它对 DeepSeek 的适配成本质级别。不是“支持 DeepSeek”，而是“专门为 DeepSeek 设计”。

缓存这件事，大部分工具根本没认真做

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。

首先去 https://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 界面，如下图：

1779843751487

需要先执行 /init 命令，对项目进行初始化，会增加 REASONIX.md 文件：

1779844114206

当初始化完成后输入 y 或者 「回车」进行确认，如果不满意可以使用其他指令拒绝并重新生成。

在最下方可以看到 Tokens 消耗、缓存命中率以及余额：

1779845031513

键盘按 Shift+Tab 切换模式：

1779845317299

  • review 模式为审查模式，有一部分需要确认的命令会自动帮你执行，但是敏感风险操作依然会让你确认

  • AUTO 模式为自动模式，所有命令会让你确认

  • YOLO 模式为自由模式，所有命令都不会询问，直接帮你执行。

输入 /model + 空格 进行模型切换：

1779845510688

到这里肯定会有不少同学说终端用不习惯怎么办？

别着急，reasonix 自带网页控制台，在终端安装完有没有注意到网页链接的显示？

1779844845936

http://127.0.0.1:11555/?token=

复制到浏览器打开即可：

1779844901690

页面操作是不是直观多了

输入 / 调出命令：

1779844950864

模式切换：

1779845620004

模型及推理强度切换：

1779845643242

除了 code 编程模式，还有几个常用命令：

命令 干什么
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 服务器，比如 "fs=npx -y @modelcontextprotocol/server-filesystem /tmp" 就把文件系统 MCP 挂上了。内置 MCP 市场，/mcp 命令可以直接浏览和安装。

Skills。 Markdown 写的剧本，模型可以自动调用。支持内联模式和子 Agent 模式。/skill new my-skill 在当前项目里建一个，--global 建全局的。而且兼容 Claude Code 的 skills 路径（.claude/skills/），不用转换格式。

持久记忆。 项目级和全局级两层。可以用 /memory 管理，模型自己也能在对话里写入和读取。

Hooks。 工具调用前/后、用户提交 prompt、会话停止四个生命周期，都能挂自定义的 shell 命令。想加个安全审计、自定义日志、自动格式化，写个脚本扔进配置就行。

权限控制。 终端命令默认需要你审批。editMode 有三个级别：review（每次编辑都要确认）、auto（编辑自动执行但终端命令还是要批）、yolo（全自动，别在生产环境开）。

Web 搜索。 默认 Mojeek，可以通过 /search-engine 切到自托管 SearXNG 或 Metaso。

语义索引。 reasonix index 用本地 Ollama 或 OpenAI 兼容的 embedding 接口给代码建索引。

QQ 通道。 这是中文用户特别实用的功能——把当前会话延伸到 QQ，手机上就能继续跟 Agent 对话。CLI 里跑 /qq connect 就行，桌面端在设置里打开。

桌面客户端。 Tauri 做的原生桌面应用，多标签页，右侧面板实时显示 Agent 读过和改过的文件，底部有成本和缓存仪表。目前是 prerelease，macOS 第一次打开需要走一次 Gatekeeper：xattr -dr com.apple.quarantine /Applications/Reasonix.app。或者右键 → 打开 → 确认。Windows 会弹 SmartScreen，点“更多信息 → 仍然运行”就行。

跟 Claude Code、Cursor、Aider 放一起比

Reasonix Claude Code Cursor Aider
后端 DeepSeek Anthropic OpenAI/Anthropic 任意
开源 MIT 闭源 闭源 Apache 2
单任务成本 低 高 订阅+用量 看模型
DeepSeek 前缀缓存 工程化 不适用 不适用 偶发
内嵌仪表盘 有 无 IDE 内建 无
持久化会话 有 部分 无 无
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 替代品

装好之后先试这几件事

  1. 进一个项目目录，跑 npx reasonix code
  2. 输入 /init——它会扫描项目结构，自动生成一份 REASONIX.md 作为项目记忆
  3. 提一个简单的改代码需求，看看 SEARCH/REPLACE 编辑预览长什么样
  4. 输 /apply 确认写入，或者 /discard 放弃
  5. 敲 /stats 看一眼花了多少钱

这套流程走下来，你大概就能理解它跟其他 Agent 工具到底有什么不一样了。

项目地址：https://github.com/esengine/DeepSeek-Reasonix 官网：https://esengine.github.io/DeepSeek-Reasonix/ API Key 申请：https://platform.deepseek.com/api_keys

123