GitHub 35.8K+ Star！缓存命中率 99.82%，这款开源 AI 编码工具火了

写代码重度使用 AI Agent 的开发者，明明 DeepSeek API 自带前缀缓存，命中后 Token 价格直接打 1 折，可自己用 Aider、Claude Code、通用客户端跑长会话，缓存命中率常年不足 20%，一天跑数亿 Token 账单直接爆炸。

有实测数据佐证：同等 4.35 亿输入 Token 工作量，无缓存优化工具账单 61 美元；而 Reasonix 实测缓存命中率 99.82%，最终仅消耗 12 美元，成本直降 97.7%。

曾经它是「只支持 DeepSeek」的专用工具，2026 年官方完成 Go 语言全量重写，发布 v1.x 稳定版（当前最新 v1.18.0），一口气开放 20+主流国产/海外大模型，同时完整保留独家缓存底层架构，兼顾极致省钱与多模型灵活切换。

01 为什么只有 Reasonix 能做到 99%+ 命中率 DeepSeek 前缀缓存核心规则

DeepSeek API 缓存机制逻辑极简：连续两次请求完整前缀字节完全一致，前缀部分按缓存价计费（0.28 美元 / 百万 Token，原价 1/10）；只要前缀任意一处 Token 变动，缓存直接清零。

通用工具缓存崩盘 3 大核心诱因： 系统提示注入动态变量：时间戳、Git 分支、实时文件列表，每轮请求前缀都变化； 工具定义列表随机序列化，数组顺序不固定； 历史消息从中间截断、推理内容混入上下文，破坏固定前缀。

市面上绝大多数 Agent 框架为兼容多模型，不会针对缓存做底层改造，自然命中率极低。

Reasonix 独家三层上下文隔离架构（官方设计不变量）

项目底层将请求上下文强制划分为三大隔离区域，从根源锁定前缀稳定，这是高命中率核心：

 ┌─────────────────────┐ │ 不可变前缀（全会话固定）│ 系统提示词+工具定义+项目记忆REASONIX.md 全程不修改，100%命中缓存 ├─────────────────────┤ │ 仅追加日志（只新增不修改）│ 对话历史仅向后追加，不删除、不重排旧消息 旧轮次前缀永久稳定，仅最新消息产生Miss ├─────────────────────┤ │ 易失暂存区（每轮重置，不传给API）│ 模型推理过程、临时计划草稿、临时状态 完全不参与缓存匹配，杜绝污染前缀 └─────────────────────┘

配套三重兜底优化： 工具调用自动修复流水线：解决 DeepSeek 参数截断、推理内容混入工具调用、重复调用等原生问题； 历史截断仅从尾部删除，绝不改动前端固定缓存区； 推理内容严格遵循 DeepSeek 官方规范，无工具调用时不回传推理文本。

双层成本控制：缓存 + 模型分级双重省钱

光靠缓存不够，Reasonix 内置智能模型调度策略，进一步压低账单：

Flash 优先自动升档 默认使用 deepseek-v4-flash（价格仅 Pro 的 1/5~1/10）；当检测到 3 次以上工具报错、解析失败、复杂任务，自动升级 v4-pro；也可手动输入/effort high/max切换推理强度。

/effort low：全程 Flash，极致省钱； /effort high：自动判断，复杂任务临时升级 Pro； /effort max：强制全程 Pro，追求推理质量。

单次临时升级命令/pro，仅下一轮生效，执行完毕自动回落 Flash，杜绝忘记切换导致高额账单。

自动上下文压缩 单轮工具返回超过 3000 Token 自动压缩为摘要，后续轮次仅携带精简文本；如需完整文件内容，Agent 按需重新读取，大幅减少冗余 Token 流转。

02 版本重大变革 新旧版本核心对比表（官方校准）

对比维度

0.53.x 旧版（TypeScript，遗产版）

v1.18.0 新版（Go 重写，主线稳定版）

底层技术

Node.js+TS，依赖系统 Node>=22

Go 静态单二进制，无运行时依赖

模型限制

仅支持 DeepSeek，多模型不兼容

原生支持 20+模型：DeepSeek、Kimi K3、GLM、Qwen、MiMo、MiniMax、Ollama 等，兼容 OpenAI/Anthropic 协议

配置文件

config.json

reasonix.toml + .env，密钥隔离存储

安装方式

npm、桌面安装包，依赖 Node

npm 一键安装、brew、独立桌面安装包、VS Code 扩展

维护状态

v1 分支，仅修复严重 BUG，停止新功能迭代

main-v2 主线，高频更新，持续迭代

核心特性

仅基础缓存、简易 MCP

上下文引擎 v2、内置 Auto Research、无人值守心跳任务、IM 机器人、人民币计价、沙盒权限、双模型协同（规划器 + 执行器）

迁移规则

桌面端无法自动更新，必须手动重装；启动自动迁移旧配置/会话，支持/migrate手动迁移。

旧版用户必看迁移踩坑点

0.x 桌面端「检查更新」接口失效，无法在线升级，必须手动下载 v1.x 安装包重装；

npm 默认latest标签已指向 1.x Go 版，安装旧版需指定版本npm i -g reasonix@0.53.2；

旧版config.json密钥、MCP 配置会自动迁移至~/.reasonix/.env，不会丢失；

旧版自定义 Skill 部分不兼容，升级前建议备份.reasonix/skills目录；

Windows 系统新版修复 GBK 编码、窗口闪烁、WSL/Git Bash 双兼容问题。

03 全平台完整安装教程 方式 1：终端 CLI（全平台通用，推荐开发者）

1）一键安装

# macOSbrew install esengine/reasonix/reasonix# Windows/Linux/macOS 通用npm i -g reasonix# 验证版本（输出1.x即为新版Go二进制）reasonix --version

2）初始化配置向导

reasonix setup

按提示操作： 选择模型服务商（DeepSeek/Kimi/智谱等）； 填入对应平台 API Key（密钥仅存入本地.env，不会写入配置文件）； 设置界面语言、默认工作模式、权限兜底策略。

3）项目初始化 进入代码项目目录执行：

reasonix chat

会话内执行初始化，自动生成REASONIX.md项目记忆文件

/init

REASONIX.md兼容 Claude Code 的CLAUDE.md，可直接复用现有项目规范，记录技术栈、代码规范、禁止修改文件清单，每次会话自动加载，永久参与缓存固定前缀。

方式 2：桌面端 GUI（零命令行门槛，新手首选）

下载地址：

https://esengine.github.io/DeepSeek-Reasonix/

macOS：Universal .dmg（Apple Silicon/Intel 通用）；

新版已公证签名，无需再执行隔离放行命令；

Windows：签名 exe 安装包，弹出 SmartScreen 选择「更多信息 - 仍然运行」；

Linux：.deb/tar.gz 安装包；

首次启动引导填入 API Key，选择默认模型 deepseek-v4-flash；

界面四大分区功能： 左侧：会话列表，多标签并行项目隔离，每个标签独立工作目录；

中间对话区：文本、工具调用、文件 Diff、计划、推理过程分卡片渲染，支持 LaTeX 数学公式； 右侧面板：文件、MCP 工具、项目/用户记忆、权限规则；

顶部三色进度条实时展示缓存 Token 分布；

底部成本仪表盘：实时缓存命中率、本轮 Token 消耗、会话总费用，美元/人民币双币种切换；

四大编辑执行模式（输入框左侧切换）

Plan 模式：AI 仅读取文件，改动前提交多步骤计划，人工审批后执行；

Review 默认模式：文件修改逐条弹窗确认，Shell 命令强制审批；

Auto 模式：文件修改自动执行，终端命令仍需确认；

YOLO 模式：全自动化跳过确认，仅适合信任的小型项目，禁止生产环境使用。

方式 3：VS Code 扩展（IDE 深度联动）

先完成 CLI 全局安装；

VS Code 市场搜索扩展SivanLiu.reasonix-agent；

扩展通过 ACP 协议连接本地 reasonix 后端，编辑器内直接对话、文件修改、工具审批，复用同一套配置与缓存引擎。

04 核心功能全拆解

1. 输入交互核心能力

@引用语法：一键引用项目文件、文件夹、剪贴板、MCP 资源；支持拖拽文件粘贴；

/斜杠命令面板（30+内置命令）高频清单： /effort high/low/max 切换推理强度 /pro 单次临时升级v4-pro /compact 安全压缩上下文，不破坏缓存前缀 /plan 切换计划模式并生成执行方案 /budget 5 设置本次会话软性预算上限（USD） /retry 重新生成上一轮回复 /mcp 管理MCP插件服务器 /migrate 手动迁移0.x旧版配置会话 /tree /branch /switch 对话分支、历史回溯

快捷键：Ctrl/Cmd+K打开命令面板、Ctrl/Cmd+Enter发送消息、Esc中断生成； 图片粘贴识别：截图直接粘贴输入框，多模态模型自动解析 UI、代码截图。

2. 记忆分层系统（跨会话持久化）

四层记忆隔离，优先级清晰，全部参与缓存不可变前缀：

• 项目记忆：项目目录REASONIX.md，当前项目专属技术规范；
• 用户记忆：全局~/.reasonix/memories/，跨所有项目通用个人偏好（命名规范、回复简洁度等）；
• 全局记忆：最高层级通用规则，全局生效；
• 会话临时记忆：仅当前对话生效，关闭会话自动销毁。

双传输协议支持：

stdio 本地子进程、Streamable HTTP 远程服务；

自动读取项目根目录.mcp.json，无需重复配置；

内置 MCP 市场，/mcp一键浏览、安装文件系统、数据库、浏览器等插件；

MCP prompts 自动转为斜杠命令，@server:uri直接引用 MCP 资源。

4. 独家进阶功能（v1.x 新增）

Auto Research 自动调研：内置技能，自动联网搜索、阅读文档、整理结论，复杂任务自动触发无需手动调用；

心跳无人值守定时任务：配置定时 AI 任务，定时扫描日志、检查迭代、跑自动化测试，后台持续运行；

IM 机器人通道：支持 QQ、飞书、Lark、微信机器人，手机远程下发任务、审批文件修改；

双模型协同架构：执行器（日常 Flash）+ 规划器（Pro）分离，规划任务单独使用强推理模型，执行代码使用低成本 Flash；

沙盒权限管控： 黑名单：永久阻断危险命令rm -rf、git push；

白名单：测试、本地构建命令自动放行； 文件写入强制限制在当前工作目录，阻断路径越界； 会话分支与检查点：支持对话分叉、历史回滚，误操作一键恢复历史状态；

技能管理：技能列表会标记安装副本与源文件夹的差异，支持预览文件改动，一键从源文件夹更新技能，更新失败会保留原有副本。

5. 多模型适配区分（核心差异）

DeepSeek 系列（一等公民，完整优化） 全套前缀缓存、原生 reasoning 协议、实时缓存命中率统计、人民币计价、工具调用修复流水线全部生效，成本优势拉满，重度编码首选。

国产/海外其他模型（完整公民，功能全可用） Kimi K3（104 万超长上下文 + 原生视觉）、通义千问、GLM、MiMo、MiniMax、Ollama 本地模型等，支持完整工具、MCP、记忆系统；但无专属缓存优化，计费遵循厂商原生规则。

自定义兼容端点 任意 OpenAI/Anthropic 协议私有网关、企业内网模型均可接入，自定义 API 地址、请求头、鉴权。

05 横向竞品对比

对比项

Reasonix v1.x

Claude Code

Cursor

Aider

开源协议

MIT 开源，可商用

闭源订阅

闭源

Apache2

底层模型

DeepSeek/Kimi/GLM/Qwen/Ollama 等20+

仅 Claude

OpenAI/Anthropic

任意模型

DeepSeek 缓存优化

底层架构级深度优化，命中率90%+

不支持

不支持

无专门适配，命中率随机

成本结构

按量付费，缓存大幅降价，无订阅

高额订阅+用量

订阅制

随所选模型波动

三端统一引擎

CLI/桌面/VS Code扩展共用一套内核

仅IDE内

仅IDE

仅终端

MCP插件生态

完整支持stdio/HTTP，兼容Claude配置

支持

基础支持

部分兼容

中文本地化

全中文界面、人民币计价、IM机器人

英文为主

中文有限

无原生中文

沙盒安全管控

文件/命令双层沙盒，黑名单阻断高危操作

基础审批

基础提示

无强制沙盒

不适合场景

极致数学/博士级推理（Claude Opus更强）

预算敏感、国产模型用户

想要独立桌面端、终端工作流

需要稳定缓存、多模型统一入口

06 分人群选型方案 1. 首选 Reasonix 的人群

每日长时间写代码、重构、写单元测试，API 用量大、预算敏感； 同时持有 DeepSeek、Kimi、GLM、通义千问等多家模型 Key，需要统一操作入口； 偏好开源工具，所有配置本地存储，无厂商锁定； 习惯终端开发，同时需要可视化桌面端备用； 需要 MCP 插件、自动化定时任务、手机远程 IM 控制。

2. 不推荐主力使用，仅作辅助

以超复杂数学、学术证明、重度逻辑推理为主（Claude Opus 能力上限更高）； 完全依赖 Cursor 深度 IDE 一体化内联补全，无法适应终端/桌面工作流； 只使用 GPT 系列，完全不需要国产模型生态。

07 常见踩坑

缓存命中率极低 排查：是否混用动态变量、频繁切换模型、中途修改系统提示；解决方案：固定 REASONIX.md内容，历史消息仅追加不删除，默认使用 deepseek-v4-flash。

0.x 旧版无法自动更新 解决方案：卸载旧桌面端，前往 GitHub Releases 下载 v1.x 全新安装包，执行/migrate迁移数据。

MCP 插件加载失败 检查：配置文件格式、环境变量密钥是否注入；新版支持直接读取项目.mcp.json，无需重复写入 toml。

Windows 启动报错、编码乱码 解决方案：使用 v1.10 + 以上版本，原生修复 GBK 编码，切换 Windows Terminal/PowerShell，避免老旧 CMD。

Pro 模型账单过高 解决方案：关闭/effort max，日常默认 auto 模式，仅复杂任务临时/pro单次升档。

桌面端启动无 Node 报错（旧版遗留问题） 新版 Go 二进制无依赖，彻底解决该问题，无需安装 Node。

同Git仓库多个项目写入互相等待：同一Git仓库下所有项目共用写入域，会出现任务排队等待；新版会弹出明确提示，可通过拆分独立仓库、创建独立工作区副本规避该问题。

08 全文总结

Reasonix 从最初「DeepSeek 专属缓存工具」进化为全模型兼容、三端统一、开源免费的 AI 编码 Agent，核心竞争力从未改变：独家三层上下文架构把 DeepSeek 前缀缓存利用率拉满，实现行业独一档的低成本；同时 v1.x 重写后补齐多模型、桌面可视化、自动化任务、IM 远程控制等短板，兼顾省钱与灵活。

对于国内开发者，它是目前适配国产大模型最完善、成本控制最强的开源工具，无论是个人开发者日常编码，还是团队自动化迭代，都能显著降低 API 开销。

项目地址：

https://github.com/esengine/DeepSeek-Reasonix

官网：

https://esengine.github.io/DeepSeek-Reasonix/

DeepSeek API Key 申请：

https://platform.deepseek.com/api_keys

关注我持续分享高质量内容

终身学习，深耕AI领域

持续分享，优质AI开源

感谢关注，携手AI同行