Reasonix 围绕前缀缓存稳定性设计——长会话下 token 成本始终低位运行，可以一直开着。一行 npx reasonix code 即可在终端里跑起来。
从缓存优先的核心循环，到 SEARCH/REPLACE 审阅、MCP、Skills 与内嵌仪表盘——一个终端代理覆盖日常编码全流程。
上下文切分为不可变前缀 / 只追加日志 / 易失草稿三段，让 DeepSeek 的字节级前缀缓存稳定命中，缓存输入仅按约 10% 计费。
flatten · scavenge · truncation · storm 四道修复管线，自动捞回藏在思维里的工具调用、修补截断 JSON、抑制重复调用风暴。
默认 auto 预设以 v4-flash 起步，难任务才升 v4-pro；回合末自动压缩长工具结果；模型可自报 <<<NEEDS_PRO>>> 显式升级。
code 模式下助手提出编辑块，未 /apply 不落盘。逐条审阅、按字节精确匹配，配 /undo 与编辑历史。
内置 MCP 客户端，支持 stdio · SSE · Streamable HTTP 传输。config.json 与 --mcp 共用同一种 spec，启动时注册到工具表。
Markdown 剧本可内联或以 subagent 隔离运行；记忆分 user/feedback/project/reference 四类钉进前缀；生命周期 Hooks 可拦截工具调用。
reasonix index 用本地 Ollama 或任意 OpenAI 兼容 embedding 建库；Web 搜索默认 Bing，可切百度、SearXNG、Tavily、Perplexity、Exa 等。
自带 HTTP 仪表盘 + REST API，可视化会话、缓存命中与成本。每回合 / 整会话花费在 TUI 顶栏按绿黄红着色，超支一眼可见。
会话以 JSONL 持久化，支持 replay / diff / events 重放回溯；/qq connect 还能把当前 chat/code 会话延伸到 QQ，手机上继续对话。
整个循环围绕三根支柱组织，每一根解决的都是通用 Agent 框架根本看不见的问题——因为它们是为另一种缓存机制设计的。
DeepSeek 对命中缓存的输入只按约 10% 计费，但自动前缀缓存仅在请求的字节前缀完全一致时才激活。多数 Agent 循环每回合重排、改写或注入新时间戳，命中率往往低于 20%。Reasonix 把上下文切成三个区域，守住前缀不变量：
命中率 prompt_cache_hit_tokens / (hit + miss) 每回合实时显示在 TUI 顶栏缓存格。读写工具还能按 parallelSafe 分组并行派发，同时保留读后写顺序。
针对 DeepSeek 实测的几类失败模式——工具调用被写进 <think> 里、参数过多时被丢弃、相同调用反复发起、max_tokens 截断 JSON——Reasonix 用四道修复管线兜底：
北极星指标是「便宜到可以一直开着」。三档预设权衡模型层级与推理强度，绝大多数情况无需手动调参：
| 预设 | 模型 | 推理 | 成本 |
|---|---|---|---|
| flash | v4-flash | max | 1× |
| auto (默认) | v4-flash → 难任务升 v4-pro | max | 1–3× |
| pro | v4-pro | max | ~12× |
回合结束时，超过 3000 token 的工具结果自动压缩；需要时再 read_file 重读，远比把 12KB 拖过每次请求便宜。模型也可在首行自报 <<<NEEDS_PRO>>> 触发升级——每一次 pro 调用都对用户可见，绝不静默升级。
推荐用 npx——不必全局安装，每次都拿最新版。首次运行粘贴 DeepSeek API Key，之后会记住。
# 进入你的项目目录
cd my-project
# 启动编码 agent — 首次运行粘贴 DeepSeek API Key
npx reasonix code# 天天用？把 reasonix 装进 PATH
npx reasonix update
# 之后直接调用
reasonix code
reasonix update # 升级 Reasonix 自身# 需要 Node ≥ 22
git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
npm install
npm run build # tsup → dist/到 platform.deepseek.com 创建 Key，首次运行 reasonix code 时粘贴即可，会保存到 ~/.reasonix/config.json。
reasonix doctor # 检查 Node 版本、API Key、MCP 接线直接对话即可。助手提出 SEARCH/REPLACE 编辑后，用 /apply 审阅落盘，用 /model pro 切换难任务模型，用 /plan 进入计划模式。
💡 code 还是 chat？ code 是默认入口，唯一带文件系统/shell 工具和 SEARCH/REPLACE 审阅；chat 是更轻量的纯对话壳，挂着 MCP 但没有磁盘权限，适合当「思路助手」。一次性任务用 reasonix run "task"，结果直接流到 stdout，方便 shell 管道。
几个 shell 子命令进入不同模式，会话内再用斜杠命令完成一切操作。
实测缓存命中率、成本与方法论收录在仓库 benchmarks/ 里——这些数会随模型定价变化。
| Reasonix | Claude Code | Cursor | Aider | |
|---|---|---|---|---|
| 后端 | DeepSeek | Anthropic | OpenAI / Anthropic | 任意（OpenRouter） |
| 协议 | MIT | 闭源 | 闭源 | Apache 2 |
| 单任务成本 | 低 | 高 | 订阅 + 用量 | 不一 |
| DeepSeek 前缀缓存 | 专门工程化 | 不适用 | 不适用 | 偶发命中 |
| 内嵌 web 仪表盘 | ✅ | — | 不适用 (IDE) | — |
| 持久化工作区会话 | ✅ | 部分 | 不适用 | — |
| 计划模式 · MCP · Hooks | ✅ | ✅ | ✅ | 部分 |
| 开放社区共建 | ✅ | — | — | ✅ |
有些事它刻意不做——列在这里，方便你为自己的工作挑对工具。
故意只做 DeepSeek。绑死一个后端是 feature，不是限制——每一层都为它的字节稳定前缀缓存调过。
终端优先。diff 在 git diff，文件树在 ls。仪表盘是 TUI 的伴生，不是 Cursor 的替代。
DeepSeek 在编程任务上有竞争力。若你的工作是"解 PhD 级证明"而非"修个 auth bug"，先用 Claude。
需要付费的 DeepSeek API Key。要离线零成本，看 Aider + Ollama 或 Continue。静默升级也被拒绝——每次 pro 调用都可见。
贡献者墙上的每一个头像，都对应一次真实合并的 PR。新手友好的 good first issue 都带背景、代码定位与验收标准。