📌 项目地址：esengine/DeepSeek-Reasonix | ⭐ 24,443 颗星 | 🔧 TypeScript | 📜 MIT
为什么需要Reasonix
用过AI编码代理的人都知道，长对话的token成本会迅速堆高。缓存能省钱，但大多数工具把缓存当可选项——对话历史一长，前缀偏移，缓存就断了，后面的token全价计算。
DeepSeek的API有一个字节级前缀缓存机制：如果请求的前n个字节和之前某次请求的前n个字节完全一致，那n个字节不算钱。问题在于，保持前缀字节序列不散，比想象中难得多。对话上下文增加、模型回复变化、你换了个提法——都可能破坏前缀。
Reasonix的设计思路和所有其他工具相反：它把“缓存稳定性”当作整个循环的不变式来设计，而不是一个事后优化。README原话是：
Cache stability isn’t a feature you turn on; it’s an invariant the loop is designed around.
翻译过来：缓存稳定性不是一个“你打开就能省钱的开关”，而是Reasonix每条请求循环必须遵守的底层假设。
怎么做到的
项目架构文档（docs/ARCHITECTURE.md）里详细说明了四个机制，统称Pillar 1：
- 请求分片：把已缓存的历史和新请求拆开，避免拼接时打乱前缀字节。
- 前缀对齐：确保每次请求的前缀字节序列和上次完全一致，包括控制字符和换行。
- 缓存窗口管理：对对话历史进行裁切，保证落入缓存窗口的部分稳定不变。
- 流式缓存感知：在流式输出时实时判断当前片段是否还能命中缓存，而不是等到整条回复完成再算账。
这些机制不是可选的插件，而是嵌入请求循环的逻辑。你不需要配置“开启极速模式”之类的选项，它默认就在跑。
一个真实案例
README贴了一个用户的一天数据（2026年5月1日）：
- 输入token：4.35亿
- 缓存命中率：99.82%
- 实际账单：约12美元
- 同等工作量走DeepSeek v4-flash且无缓存：约61美元
省了80%。请注意，这个命中率不是在项目跑了一周才达到的——它从第一次请求就开始生效，因为缓存机制是写死的循环属性。
如果你每天也有几百万token的消耗，这笔账值得细算。省下的钱足够覆盖其他工具的订阅费。
安装和用法
环境要求：Node ≥ 22。支持macOS、Linux、Windows（PowerShell / Git Bash / Windows Terminal）。
安装方式有两种：
全局安装（推荐日常使用）：
npm install -g reasonix
cd my-project
reasonix code # 首次运行会提示输入DeepSeek API key，自动保存一次性运行（试用）：
cd my-project
npx reasonix code # 每次用最新版，不污染PATH还有个短别名 dsnix，和 reasonix 互通：
npm install -g dsnix # 依赖reasonix，暴露dsnix命令
npx dsnix@latest code # 一次性运行全局安装 reasonix 后，也会自动生成 dsnix 软链接。
子命令只有两个：
| 命令 | 作用 |
|---|---|
reasonix / reasonix code [dir] |
编码代理，可以读写文件、执行shell命令 |
reasonix chat |
纯聊天，不碰文件系统和shell |
注意：裸打 reasonix 等价于 reasonix code .。API key 从 platform.deepseek.com/api_keys 获取。
一个必须知道的事：你现在装的TS版已是legacy
README 顶部有一个醒目的黄色警告块：
This is the legacy TypeScript line (Reasonix 0.x), in maintenance mode.
Active development moved to the Go rewrite — see themain-v2branch.
翻译一下：你现在 npm install -g reasonix 拿到的TypeScript版只修bug，不添新功能。真正的新开发已经转移到Go重写版（main-v2分支）。当前24443个star是TS版的累计，Go版还在早期。
如果你现在要试用，用的是TS版。未来要迁移到Go版，需要看 docs/MIGRATING.md 的迁移指南。项目README也给出了 main-v2 分支链接和迁移指南链接。
我的建议是：如果你已经是DeepSeek的重度用户，可以先拿TS版跑几周验证成本效果，等Go版稳定（留意GitHub release）再迁。如果只是好奇，没必要在安装上花太多时间——Go版才代表这个项目的未来。
什么时候值得折腾这套
我的判断标准很简单：如果一天token消耗低于50万，不建议为了缓存收益换工具。把Reasonix集成进工作流的时间成本可能比省下的钱还多。
适合的情况：
- 每天token消耗稳定在百万级别，DeepSeek账单是团队的固定开销
- 只用一个模型，不会在项目里混用Claude/GPT
- 愿意接受未来一次Go版迁移（看迁移指南）
不适合：
- 日常工作流需要频繁切换不同模型（比如一会儿用Claude做代码，一会儿用GPT写文档）
- DeepSeek只是偶尔用，主力是其他模型
- 完全不用命令行，需要图形界面
社区和更多资料
项目有中英文双语Discord，频道包括 #help、#求助、workflow展示、feature idea。在GitHub验证后会自动获得Contributor角色。入口在README的Community章节。
架构文档（docs/ARCHITECTURE.md）和Benchmark（benchmarks/real-world-cache/README.md）的链接也在README里。如果你对缓存细节感兴趣，直接读这些原始资料，比任何文章的概括都准确。