Reasonix：DeepSeek 原生终端编程 Agent
Reasonix：DeepSeek 原生终端编程 Agent MIT | npm reasonix | Node ≥ 22 | DeepSeek 官方集成文档收
Gana · 2026-08-23 · 9 分钟阅读Reasonix：DeepSeek 原生终端编程 Agent
MIT | npm
reasonix| Node ≥ 22 | DeepSeek 官方集成文档收录
这是什么
Reasonix 是只对接 DeepSeek API 的终端编程 Agent（不走 Anthropic/OpenAI 翻译层）。核心设计是 Cache-First Loop：把上下文拆成不可变前缀 + 只追加日志 + 易失 scratch，让 DeepSeek 的字节级前缀缓存在长会话中持续命中（官方案例可达 70–99%+ 缓存率），把输入 token 成本压到约 1/5 缓存价。
@Lonely__MH 于 2026-05-26 推介：颜值在线的 Ink TUI、实时查看 DeepSeek 账户余额、Flash 优先的成本控制，称其为「DeepSeek 最佳伴侣」。
- 仓库：esengine/reasonix（npm 包
reasonix） - 活跃开发亦在 Go 重写线：DeepSeek-Reasonix
main-v2 - DeepSeek 官方文档：Integrate with Reasonix
适合谁 / 不适合谁
| 人群 | 是否推荐 | 原因 |
|---|---|---|
| 已用 DeepSeek API、长会话写代码 | ✅ 强烈推荐 | 专为 prefix cache 工程化 |
| 想控 token 成本、可接受终端 TUI | ✅ 推荐 | 默认 V4-Flash，/pro 单轮升 Pro |
| 需要 Cursor/IDE 一体化 GUI | ⚠️ 另选 | 终端优先；桌面客户端为 prerelease 伴侣 |
| 必须用 Claude/GPT 多模型 | ❌ 不适用 | DeepSeek-only 是设计选择 |
| 不愿自备 DeepSeek API Key | ❌ 不适用 | 按量付费，Key 存本地 ~/.reasonix/config.json |
安装与前置条件
- Node.js ≥ 22（DeepSeek 文档写 20.10+，仓库 README 要求 ≥ 22）
- DeepSeek API Key：DeepSeek Platform 创建
- 平台：macOS / Linux / Windows（PowerShell · Git Bash · Windows Terminal）
快速启动（无需全局安装）
cd /path/to/your-project
npx reasonix code
首次运行向导粘贴 API Key，写入 ~/.reasonix/config.json。
全局安装
npm install -g reasonix
reasonix code my-project
其他命令（框架模式）
npx reasonix chat # 命名会话，自动恢复
npx reasonix chat --session work
npx reasonix run "一次性问题" # stdout 流式
npx reasonix stats session.jsonl # 成本/缓存统计
核心用法
Cache-First 机制（简述）
| 层级 | 作用 |
|---|---|
| Immutable prefix | 系统提示 + 工具 schema，构造后不再变异 |
| Append-only log | 每轮只追加，不重排 |
| Volatile scratch | 每轮边界清空，避免污染前缀 |
目标：长会话保持 byte-stable prefix，让 DeepSeek 自动 prefix cache 持续命中。
TUI 与成本控制
- 默认 DeepSeek-V4-Flash 迭代
/pro— 下一轮用 V4-Pro/preset max— 整段会话用 Pro/help— 完整斜杠命令- TUI 面板：缓存命中率、成本、R1 推理预览（可选
--harvest等）
内置能力（README 归纳）
- Tool-Call Repair：扁平 schema、修复截断 JSON、抑制 call-storm
- Retry：408/429/5xx 指数退避
- MCP 一等公民、Plan 模式
- 编辑流程：SEARCH/REPLACE 提案，
/apply前不写盘
定价参考（DeepSeek API，非 Reasonix 本身）
Reasonix MIT 免费；费用来自 DeepSeek 按量。长会话 cached token 约为未缓存价的 1/5；官方称 V4-Flash 未缓存约 $0.07/Mtok、缓存约 $0.014/Mtok（以平台实时价为准）。
注意事项与风险
- DeepSeek-only：换模型需另选工具（如 [[给 Obsidian 接上免费 AI：opencode + 国产模型配置指南]] 的 MiMo 路线）。
- 版本线：TypeScript
reasonix0.x 维护模式；新功能关注 Gomain-v2与迁移指南。 - API Key 安全：
~/.reasonix/config.json勿提交 git。 - 推文来源：功能细节以 GitHub / 官网为准；Lonely 推文为体验向推介，非官方维护方。
- 抓取说明：X syndication API 返回空；正文经 fxtwitter API 获取。
与你现有工具的关系
| 工具 | 关系 |
|---|---|
| [[DeepSeek GUI：桌面智能体工作台]] | 同为 DeepSeek 生态；GUI 偏 Electron 项目工作台，Reasonix 偏终端 + 缓存经济学 |
| [[给 Obsidian 接上免费 AI：opencode + 国产模型配置指南]] | opencode 多模型 + Obsidian；Reasonix 单模型极致省钱 |
| [[Karpathy 编码行为准则：AI Agent 的 4 条铁律]] | 长会话 Agent 仍建议目标驱动与外科手术式改码 |
| [[skills-manage：20+ 平台 Agent Skills 中央统一管理]] | Reasonix 走 MCP/内置工具，非 Cursor Skills 目录体系 |
| [[Claude Code 源码泄露：51 万行 TypeScript 因 source map 意外公开]] | 对比：Reasonix 开源可审计，但注意本地 Key 与 supply chain |
FAQ
Q: 和 Cursor / Claude Code 有何不同？
A: Reasonix 是终端 TUI + 直连 DeepSeek，不做 IDE 插件；卖点是 prefix cache 工程化降本，不是多模型 IDE。
Q: 必须全局 npm install 吗？
A: 否，npx reasonix code 即可；DeepSeek 官方文档亦推荐此方式。
Q: 桌面版呢？
A: 官网提及 prerelease 桌面客户端（视觉伴侣）；主路径仍是 CLI。社区亦有 Electron 第三方客户端（非官方）。
Q: 推文说的「查余额」在哪？
A: TUI 内实时展示 DeepSeek 账户余额（据 @Lonely__MH 体验）；具体入口以安装版本 UI 为准。
相关链接
- 官网：https://reasonix.homes
- GitHub：https://github.com/esengine/reasonix
- npm：https://www.npmjs.com/package/reasonix
- 文档站：https://esengine.github.io/DeepSeek-Reasonix/
- DeepSeek 集成：https://api-docs.deepseek.com/quick_start/agent_integrations/reasonix
- Discord：https://discord.gg/XF78rEME2D
- 推文原文：https://x.com/Lonely__MH/status/2059284819046207596?s=20
- 本库相关：[[DeepSeek GUI：桌面智能体工作台]]、[[给 Obsidian 接上免费 AI：opencode + 国产模型配置指南]]
