一个DeepSeek原生终端工具，把每月API账单从400块压缩到130块
先说钱的问题
AI编码工具用久了，成本是真的肉疼。一个月几百块的API账单，尤其你习惯把Agent长时间挂在后台跑任务时，token花费如流水。如何花小钱办大事，是开发人员的必修课了。
为什么专门做DeepSeek
Reasonix是DeepSeek原生的终端AI编码Agent，GitHub星标6000多，MIT协议开源。
市面上的Agent框架大多追求多后端兼容，但Reasonix选了DeepSeek-only。为什么？我理解下来是因为前缀缓存（Prefix Cache）这个机制。
DeepSeek的前缀缓存以字节0为起点对提示词做指纹计算，同一前缀的请求只计费一次缓存价格，约为常规价格的三分之一。cached token 0.014美元/百万，uncached 0.07美元/百万。
但有个前提：前缀必须字节级稳定。如果每次请求重排消息顺序、注入新时间戳，缓存立即失效。这就是为什么多数通用框架缓存命中率不到20%的原因。
Reasonix的所有抽象层都围绕这个不变式设计。选择DeepSeek不是限制，是把机制吃透之后的主动聚焦。
技术方案：Append-Only循环
Reasonix将对话上下文划分为三个区：
不可变前缀区：包含系统提示词、工具规范和Few-shot示例。这部分在会话开始时计算一次哈希并锁定，后续所有请求共享同一前缀。
追加日志区：助手消息、工具调用及结果按追加顺序序列化写入日志，历史记录从不修改、重排或压缩。只要写入顺序稳定，前缀缓存就能持续命中。
易失草稿区：R1推理过程和临时计划状态存本地，从不上传。在信息折叠到日志前会做提炼蒸馏。
约束很简单：日志条目按追加顺序序列化，不得rewrites；草稿区内容进入日志前必须经过提炼处理；前缀哈希在会话开始时计算一次并固定。
这套设计的本质是：让前缀缓存从碰运气变成必然命中。
Tool-Call Repair：模型输出的漏洞补上
光靠稳定前缀还不够。DeepSeek在实际调用中有几类常见失败：
- 模型在推理内容中生成工具调用，但未写入tool_calls字段
- Schema参数超过10个或嵌套层级过深时参数丢失
- max_tokens命中导致JSON截断
- 相同参数重复调用形成调用风暴
Reasonix内置了四重修复管道：
- flatten：自动将深层嵌套Schema转换为点号表示发给模型，本地执行前还原结构
- scavenge：用正则和JSON解析器扫描推理内容，捞出模型遗漏在tool_calls之外的调用
- truncation：检测截断的JSON并补全结构或请求续写
- storm：在滑动窗口内发现相同（工具、参数）元组时抑制调用并注入反思轮次
这套管道在模型端透明运行，不需要你感知或手动干预。实际使用时确实没遇到过工具调用失败的问题。
三档模型策略：成本控制的关键
Reasonix内置三种预设：
| 档位 | 模型 | 计费倍率 | 说明 |
|---|---|---|---|
| Flash | deepseek-chat | 1x | 默认档 |
| Auto | 自动切换 | 约3x | 简单轮次走Flash，复杂任务切Pro |
| Pro | v4-pro | 约12x | 高复杂度任务 |
自动切换时TUI顶部会显示黄色Pro Armed提示，告知下个轮次将使用高级模型。连续三次失败后触发Escalation模式（红色Pro Escalated提示），强制切换到Pro档。
所有辅助操作强制使用Flash档：工具结果摘要、子Agent生成、截断修复等都不需要Pro级推理能力，没必要为此付高价。
另外，每条工具结果超过3000Token的部分在轮次结束时自动压缩为摘要，提前40%上下文比例时还会触发预防性压缩，避免80%紧急阈值触发时产生突兀体验。
终端优先的设计
Reasonix是典型的终端优先设计，不是IDE插件。git diff处理差异，ls处理文件树，终端本身就是工作空间。
内置TUI基于Ink构建，同时提供Tauri桌面客户端，拥有独立Node运行时、多标签会话、实时成本缓存Token计数器。
MCP（Model Context Protocol）是一等公民，通过一行命令即可接入外部工具服务器：
--mcp "name=cmd args"
支持stdio、SSE、Streamable HTTP三种传输方式。服务器工具与内置工具共享同一注册表，统一加前缀命名，对模型透明。
每个工作空间的文件系统工具被沙箱隔离到启动目录；/plan模式打开只读审计门，所有写操作必须等待计划审批后才能执行。
Skill系统基于Markdown文件，前置元数据声明描述、运行身份和允许调用的工具，runAs: subagent可将执行体放到隔离子循环中运行。.claude/skills/目录下的Claude格式技能同样兼容，可以直接复用社区工具链。
快速上手
安装要求：Node 22及以上，支持macOS、Linux、Windows（PowerShell、Git Bash、Windows Terminal）。
不全局安装的推荐方式：
cd /path/to/my-project
npx reasonix code
首次启动会引导配置DeepSeek API密钥，可访问platform.deepseek.com/api_keys创建。密钥按量计费，缓存token五折。
全局安装：
npm install -g reasonix
reasonix code my-project
常用子命令：
reasonix chat- 纯聊天，无文件系统访问reasonix run "task"- 一次性任务，流式输出到stdoutreasonix doctor- 健康检查：Node、API密钥、MCP连接状态reasonix update- 升级Reasonix自身
总结
Reasonix解决的是一个很具体的问题：让DeepSeek的前缀缓存从碰运气变成必然，把API账单从每月几百压缩到原来的三分之一。
如果你已经在用DeepSeek API做编码任务，值得试试。
文档站：esengine.github.io/DeepSeek-Re…
文中数据来自公开benchmark
