DeepSeek-Reasonix：专为 DeepSeek 前缀缓存稳定性而设计的终端 AI 编码代理 #

TL;DR — DeepSeek-Reasonix（又名 Reasonix）是专门围绕 DeepSeek 模型构建的终端优先 AI 编码代理，专为前缀缓存稳定性而设计，可在长时间会话中使令牌成本大大低于竞争代理。 现实世界的用户报告 99.82% 的缓存命中率 — 每天为 4.35 亿个输入令牌支付约 12 美元，而不是在没有缓存的情况下支付约 61 美元。 MIT 许可，具有嵌入式 Web 仪表板、可配置搜索引擎、持久会话和完整的 MCP/技能/挂钩支持。

DeepSeek-Reasonix 是什么？ #

Reasonix 是一款适用于您的终端的 AI 编码代理。 与支持多个后端的通用代理不同，Reasonix 在设计上仅限于 DeepSeek——每一层都经过调整以利用 DeepSeek 的前缀缓存机制，以实现长时间编码会话的成本稳定性。

核心见解：缓存稳定性不是您打开的功能；而是您打开的功能。 这是循环设计的一个不变量。 通过围绕字节稳定前缀缓存设计整个代理循环，Reasonix 即使在日常大量使用的情况下也能保持成本可预测。

GitHub： esengine/DeepSeek-Reasonix · 星星： 23,000+ · 许可证： MIT · 语言： TypeScript（Go 重写正在进行中）

注意： 当前的 TypeScript 行 (0.x) 处于维护模式。 积极的开发已转移到 main-v2 分支上的 Go 重写。 有关详细信息，请参阅迁移指南。

三大支柱 #

1. 缓存优先循环 #

Reasonix 的代理循环旨在最大化前缀缓存命中率。 每一层——从如何构造提示到如何修复工具调用——都经过优化，以保持令牌流可缓存。 这是节省成本的基础。

2. 工具调用修复 #

当工具调用失败或产生意外输出时，Reasonix 会智能修复它，而不是重新启动整个对话。 这可以防止单点故障导致的缓存失效，并在扩展会话中保持前缀缓存的温暖。

3.成本控制 #

每个级别的内置成本跟踪和优化。 该代理维护一个 Web 仪表板，显示实时缓存命中率、令牌消耗和成本预测。 用户可以配置支出限额并接收警报。

真实世界成本案例研究 #

2026 年 5 月 1 日，单个用户一天内处理了 4.35 亿个输入令牌：

随着时间的推移，节省的费用会增加。 对于跨多个开发人员运行 Reasonix 的团队来说，每日成本可以从数百美元降至数十美元。

能力 #

• 计划模式 — 执行前结构化规划，减少代币浪费
• Cell-Diff Renderer — 代码更改的视觉差异输出
• MCP 服务器支持 — stdio、SSE 和 Streamable HTTP 传输
• 持久会话 — 具有自动检查点的每个工作区会话存储
• 技能系统 - 模型可以调用的 Markdown 剧本（内联或子代理模式）
• 内存系统 - 用户私有知识固定在对话前缀中（用户/反馈/项目/参考类型）
• Hooks — 生命周期事件上的 Shell 命令（PreToolUse gating、PostToolUse、UserPromptSubmit、Stop）
• 嵌入式 Web 仪表板 — 实时成本监控、会话管理和配置
• 可配置的网页搜索 — Bing（默认）、百度人工智能搜索、SearXNG、Metaso、Tavily、Perplexity、Exa、Brave 或 Ollama
• 语义索引 - 本地 Ollama 或任何 OpenAI 兼容的嵌入端点
• 成绩单重播 — 重播具有完整上下文的任何会话
• 事件日志 — 所有代理操作的详细审计跟踪
• 努力旋钮 — 控制每个任务的推理深度

安装 #

需要 Node.js ≥ 22。 适用于 macOS、Linux 和 Windows（PowerShell、Git Bash、Windows 终端）。

全局安装（推荐日常使用） #

npm install -g Reasonix
Reasonix 代码我的项目

首次运行时，粘贴您的 DeepSeek API 密钥 — 它会安全地保留。

一次性（无需全局安装） #

cd 我的项目
npx Reasonix 代码

始终使用最新的软件包版本。

短别名 #

npm install -g dsnix # 在 PATH 上公开 `dsnix`
npx dsnix@latest code # 通过更短的命令一次性完成

全局 npm install -g Reasonix 也会删除一个 dsnix 填充程序，因此两者可以互换。 裸“reasonix”（无子命令）会在当前目录中启动“code”。

获取 DeepSeek API 密钥 #

在 platform.deepseek.com/api_keys 获取一个。

CLI 命令 #

配置 #

~/.reasonix/config.json 中的一个 JSON 文件以及 <project>/.reasonix/ 下的每个项目覆盖。 完整的配置参考位于 esengine.github.io/DeepSeek-Reasonix/configuration.html。

基本配置文件 #

{
"model": "deepseek-chat",
"apiKey": "在此处询问您的密钥",
“搜索引擎”：“bing”，
“钩子”：{
"PreToolUse": ["echo '运行预工具挂钩'"],
"PostToolUse": ["echo '工具完成'"],
"Stop": ["echo '会话结束'"]
},
“权限”：{
"allowList": ["/usr/bin/git", "/usr/bin/docker"]
}
}

MCP 服务器配置 #

Reasonix 通过 stdio、SSE 和 Streamable HTTP 传输支持 MCP 服务器。 一种规范格式适用于“config.json”和“–mcp”标志：

# 启动 MCP 服务器并连接 Reasonix
Reasonix 代码 --mcp http://localhost:3000/sse

{
“mcp服务器”：{
“文件系统”：{
“命令”：“npx”，
“args”：[“-y”，“@modelcontextprotocol/服务器文件系统”，“/tmp”]
}
}
}

技能系统 #

技能是模型可以在“内联”或“子代理”模式下调用的 Markdown 剧本。 他们将领域知识直接编码到代理的工作流程中：

``降价 #

名称：我的自定义技能 模式：内联 #

我的自定义技能 #

当用户提到数据库迁移时，请执行以下步骤： 1.运行“reasonix doctor”检查健康状况 2.审查迁移计划 3. 执行迁移

### 内存系统

Reasonix 支持固定到对话前缀的四种类型的内存：

- **`user`** — 关于开发人员的个人知识（首选模式、编码风格）
- **`反馈`** — 从过去的会议中学到的更正和偏好
- **`项目`** — 架构决策、技术堆栈细节、团队约定
- **`参考`** — 文档摘录、API 参考、代码模式

### 挂钩和生命周期事件

挂钩是在生命周期事件上触发的 shell 命令。 使用 PreToolUse 来控制昂贵的操作：

````bash
# 只允许在批准的仓库中进行 git 操作
# .reasonix/hooks/pre-tool-use.sh
如果[[！ "$REPO_PATH" =~ ^(~/projects/app|~/projects/lib)$ ]]; 那么
echo“错误：存储库不在白名单中”
1号出口
菲

网络搜索引擎 #

使用 /search-engine 切换默认搜索引擎：

语义索引 #

为代码库感知搜索构建本地语义索引：

# 使用本地 Ollama 索引当前项目
Reasonix 索引 --provider ollama --model nomic-embed-text

# 或者使用任何 OpenAI 兼容的端点
Reasonix 索引 --provider openai --endpoint https://your-api.com/embeddings

权限系统 #

具有精确前缀匹配的每个工作空间 shell 允许列表可确保代理安全：

{
“权限”：{
“允许列表”：[
“/usr/bin/git”，
“/usr/bin/docker”，
“/usr/local/bin/”，
“〜/项目/myapp/”
]
}
}

实际使用示例 #

开始一个新项目 #

# 在新项目中初始化 Reasonix
mkdir my-app && cd my-app
原因代码。 

# 首次运行时，粘贴您的 DeepSeek API 密钥
# Reasonix 将分析您的项目结构并建议后续步骤

使用计划模式 #

Plan模式在执行前构造推理，减少代币的浪费：

# 要求 Reasonix 在实施之前进行规划
“我需要向此 Express.js 应用程序添加 OAuth2 身份验证。
请先规划实施，然后执行。”

Reasonix 将： 1.分析现有代码库 2. 提出架构 3.列出需要更改的文件 4. 通过 cell-diff 渲染执行更改

具有自动检查点的持久会话 #

Reasonix 自动保存会话状态：

# 恢复之前的会话
Reasonix 重播——最后

# 或者列出所有会话
Reasonix 事件——会话

# 修剪旧会话以节省磁盘空间
Reasonix 修剪会话——超过 30 天

使用嵌入式 Web 仪表板 #

启动仪表板以监控成本和管理会话：

# 启动仪表板（与编码会话一起运行）
Reasonix 仪表板

# 查看实时缓存命中率和token消耗情况
# 在浏览器中访问 http://localhost:3001

仪表板显示：

• 成本概览 — 实时支出以及缓存节省明细
• 会话管理器 — 浏览、恢复和比较会话
• 配置编辑器 — 可视化配置文件编辑器
• 事件日志 — 所有代理操作的时间戳审计跟踪
• 缓存热图 — 前缀缓存命中分布的可视化表示

一次性任务 #

对于无需启动交互式会话的快速任务：

 # 运行一次性任务并将输出流式传输到标准输出
 Reasonix run“重构此 Python 文件以使用类型提示”

 # 通过管道输出到另一个命令
 Reasonix run“列出该项目中的所有 TODO 注释”| grep -i “紧急”

 # 与 cron 一起使用进行自动代码审查
 Reasonix 运行“查看 git diff HEAD~1 中的所有更改”>> /tmp/review.log

医生健康检查 #

在开始会话之前，请验证所有配置是否正确：

理性医生
# 输出：
# ✅ Node.js v22.4.0
# ✅ API 密钥已配置
# ✅ MCP 服务器：2 个已连接
# ✅ 搜索引擎：Bing
# ✅ 工作空间：/home/user/my-project
# ⚠️ 未配置权限白名单

Reasonix 的比较 #

Reasonix 不是什么 #

Reasonix 固执己见。 有些事情它故意不做：

• 多提供商灵活性。 DeepSeek 的设计仅限于此。 耦合到一个后端是一项功能，而不是一种限制。
• IDE 集成。 终端优先。 diff 位于 git diff 中，文件树位于 ls 中。 仪表板是一个伴侣，而不是光标的替代品。
• 最难的排行榜推理。 Claude Opus 仍然赢得了一些基准测试。 DeepSeek 在编码方面具有竞争力； 对于“解决这个博士证明”而不是“修复这个验证错误”，请考虑克劳德。
• 气隙/完全免费。 Reasonix 需要付费的 DeepSeek API 密钥。 对于气隙或零成本运行，请参阅 Aider + Ollama 或 继续。

入门清单 #

1.安装Node.js≥22 2. 从 platform.deepseek.com 获取 DeepSeek API 密钥 3.安装：npm install -g Reasonix 4. 运行：reasonix code my-project 5. 首次运行时粘贴您的 API 密钥 6. 探索用于成本监控的嵌入式 Web 仪表板 7. 配置网络搜索：“/search-engine bing”（默认）或任何支持的提供商 8. 尝试使用“/search-engine searxng”进行自托管搜索

文档 #

• 架构 — 三大支柱：缓存优先循环、工具调用修复、成本控制
• CLI 参考 — 每个子命令、斜杠命令和键绑定
• 网站 — 入门、仪表板模型、TUI 模型
• 配置指南 — 完整双语参考（EN/ZH）
• 基准 — τ-bench-lite 工具、成绩单、成本方法
• 贡献 — 评论政策、错误处理规则、库手动滚动
• 迁移指南 — TypeScript → Go 重写

常见问题 #

问： Reasonix 是免费的吗？ #

是的。 Reasonix 已获得 MIT 许可。 没有跟踪，没有分析，没有云依赖。 一切都在您的计算机上本地运行。 您只需支付 DeepSeek API 密钥的费用，由于前缀缓存，它比 Claude 或 GPT-4 便宜得多。

问：我需要 DeepSeek API 密钥吗？ #

是的。 Reasonix 的设计仅限于 DeepSeek。 请前往 platform.deepseek.com/api_keys 获取一个。 前缀缓存工程意味着您的 API 成本通常比直接使用 DeepSeek（不使用 Reasonix 的缓存优化）低 70-80%。

问：我可以将 Reasonix 与其他 AI 模型一起使用吗？ #

不。Reasonix 特意只针对 DeepSeek。 前缀缓存稳定性是核心功能——耦合到一个后端允许每一层针对 DeepSeek 的特定缓存行为进行优化。 如果您需要多提供商支持，请考虑 Aider 或 Continue。

问：Go 重写与 TypeScript 版本有何不同？ #

Go 重写（分支“main-v2”）是积极开发的版本。 它提供了更好的性能、更低的内存使用量和更高的缓存稳定性。 TypeScript 版本 (0.x) 处于维护模式 - 只有错误修复。 有关详细信息，请参阅迁移指南。

问：Reasonix 适合团队吗？ #

是的。 Reasonix 支持每个工作区配置，允许每个开发人员拥有自己的设置，同时共享项目级约定。 持久会话系统和语义索引使新团队成员的加入变得容易。 嵌入式仪表板可帮助管理人员监控整个团队的 API 成本。

问：Reasonix 如何处理工具调用失败？ #

Reasonix 使用其“工具调用修复”支柱来智能地修复失败的工具调用，而不是重新启动整个对话。 这可以防止单点故障导致缓存失效。 例如，如果 shell 命令失败，Reasonix 会分析错误、调整命令并重试，同时保持前缀缓存正常。

问：我可以将 Reasonix 与 GitLab 或 Bitbucket 一起使用吗？ #

是的。 Reasonix 可与任何 Git 存储库配合使用，无论托管提供商如何。 该代理与您的本地文件系统和 git 命令交互，因此无论您的存储库位于 GitHub、GitLab、Bitbucket 还是自托管上都无关紧要。 reasonix doctor 命令将验证您的工作区设置。

问：计划模式和常规编码有什么区别？ #

计划模式在做出改变之前构建代理的思维。 Reasonix 不会立即修改文件，而是：

1. 分析代码库
2. 提出架构或方法 3.列出所有需要更改的文件
3. 通过 cell-diff 渲染执行更改

这减少了浪费的令牌，对于复杂的重构任务特别有用。

问： Reasonix 支持 Windows 吗？ #

是的。 Reasonix 通过 PowerShell、Git Bash 或 Windows 终端在 Windows 上工作。 唯一的要求是 Node.js ≥ 22。包括 MCP 服务器、技能和挂钩在内的所有功能在 Windows 上的工作方式相同。

问：如何向 Reasonix 添加自定义技能？ #

按照技能格式创建一个 Markdown 文件，并将其放置在项目的 .reasonix/skills/ 目录中。 每个技能都可以处于“内联”模式（作为主循环的一部分执行）或“子代理”模式（作为单独的推理步骤运行）：

``降价 #

名称：django-最佳实践 模式：内联 #

Django 最佳实践 #

使用 Django 项目时：

1. 始终使用基于类的视图来处理复杂的逻辑 2.使用Django ORM方法而不是原始SQL 3.应用中间件进行身份验证检查
2. 谨慎使用 Django 信号

然后在提示中引用它：“/django-best-practices 重构此视图以使用基于类的视图。”

### 问：我可以使用 Reasonix 进行代码审查吗？ 

绝对地。 使用 `reasonix diff` 命令显示待处理的更改，或使用 `reasonix run "Review allchanges in git diff HEAD~1"` 进行自动代码审查。 单元差异渲染器可以轻松准确地看到代理建议更改的内容。 

### 问：如何从 Claude Code 迁移到 Reasonix？

这两种工具都使用相同的技能和 MCP 服务器格式。 主要区别是：
- Reasonix 使用 DeepSeek 而不是 Anthropic 模型
- Reasonix 获得 MIT 许可； 克劳德代码是闭源的
- Reasonix 有一个嵌入式网络仪表板； 克劳德代码仅适用于终端
- Reasonix 是终端优先的； Claude Code 具有 IDE 集成

大多数技能和 MCP 配置直接转移。 主要调整是 API 密钥和成本配置文件。 

### 问：Reasonix 的非目标是什么？ 

Reasonix 故意不：
- 支持多个 AI 提供商（仅限 DeepSeek）
- 与 VS Code 等 IDE 集成（终端优先）
- 在最难的排行榜推理基准上竞争
- 在气隙或零成本环境中工作（需要付费 API 密钥）

如果这些是您的优先事项，请考虑 Aider + Ollama 或继续等替代方案。 

Reasonix 拥有一个活跃的双语 Discord 社区，其中包含设置帮助 (`#help` / `#Help`)、工作流程展示、功能创意和仅限贡献者的公关协调渠道。 

- **不和谐：** [discord.gg/XF78rEME2D](https://discord.gg/XF78rEME2D)
- **GitHub 讨论：** 功能愿望清单、设计反馈以及展示和讲述
- **Good First Issues：** 范围内的入门票，包含背景、代码指针和接受标准
- **倡导者徽章：** 由持续的社区贡献者获得

## 来源

- [GitHub 上的 DeepSeek-Reasonix](https://github.com/esengine/DeepSeek-Reasonix)
- [Reasonix 网站](https://esengine.github.io/DeepSeek-Reasonix/)
- [配置指南](https://esengine.github.io/DeepSeek-Reasonix/configuration.html)
- [架构文档](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/ARCHITECTURE.md)
- [基准测试](https://github.com/esengine/DeepSeek-Reasonix/tree/main/benchmarks)

---

**想要以极低的成本使用 AI 进行编码？** Reasonix 设计的前缀缓存稳定性可提供 99% 以上的缓存命中率 - 将 61 美元/天变成 12 美元。 

**加入Dibi8社区：** [Telegram Group](https://t.me/DIBI8_Group/2)