Reasonix

产品简介

Reasonix 是一款为 DeepSeek 模型原生打造的终端编程 Agent。它的设计出发点与多数通用编码 Agent 不同：整个对话循环围绕"前缀缓存字节稳定"这一不变量来设计，目标不是把功能堆满，而是让长会话里的 Token 成本真正降下来、让 Agent 可以长时间挂着跑而不烧钱。项目采用 MIT 协议开源，GitHub 星标约 3.58 万、fork 约 2460，当前活跃开发线已从 TypeScript 版（0.x，仅维护）迁移到 Go 重写版，并以 main-v2 作为新的默认分支。

核心功能

• 编码模式（code）：挂载文件系统工具与 shell 工具，是默认入口，也是唯一带编辑审阅流程的模式。
• 安全编辑审阅：助手只提出 SEARCH/REPLACE 形式的修改，必须执行 /apply 才会落盘，避免未经确认的批量改写。
• shell 工具带闸门：命令执行需要经过 gate 确认，不是无条件放行。
• 计划模式：内置 Plan 模式与 /todo，把长任务先拆步骤再执行。
• 纯对话模式（chat）：不挂文件系统与 shell 权限，适合只想要"带 MCP 的思路助手"的场景。
• 一次性执行：reasonix run "任务" 把结果直接流到标准输出，方便接进 shell 管道与自动化脚本。
• 会话回放与观测：提供 replay、diff、events、stats 等子命令，可回看一次会话到底发生了什么。
• Memory 与 MCP：支持项目级与全局记忆，配置中可挂 MCP 服务与联网搜索。

缓存稳定性与技术实现

Reasonix 只支持 DeepSeek，原因写在文档里：每一层都为 DeepSeek 的字节稳定前缀缓存机制做过调优，缓存命中率不是开关，而是循环设计的结果。官方给出的真实案例是：某用户单日消耗 4.35 亿输入 Token，缓存命中率 99.82%，总花费约 12 美元；同样是这批负载，在完全没有缓存的情况下按 v4-flash 计价约需 61 美元。也就是说，节省来自结构而非折扣。为了让前缀保持稳定，工具定义、系统提示词与记忆注入的顺序都被固定，会话中途切换工作目录也被有意禁止——因为消息日志与记忆路径会与旧根目录混淆。

安装与快速上手

1. 环境要求 Node 22 及以上，macOS、Linux、Windows（PowerShell、Git Bash、Windows Terminal）均可运行。
2. 进入项目目录执行 npx reasonix code，无需全局安装，每次都会拉取最新版。
3. 首次运行按提示粘贴 DeepSeek API Key，之后会记住，无需重复输入。
4. 想换工作区时用 --dir 参数传入其他路径启动，例如 npx reasonix code --dir /path/to/project，中途切换不被支持，需要退出重启。
5. 日常高频使用时执行一次 reasonix update，把命令装进 PATH。
6. 用 reasonix doctor 体检，检查 Node 版本、API Key 与 MCP 接线是否正常。

命令一览

reasonix code 是编码 Agent，应当优先使用；reasonix chat 是纯聊天模式；reasonix run "任务" 用于一次性任务并把结果输出到管道；reasonix doctor 做环境体检；reasonix update 升级自身。其余子命令包括 replay、diff、events、stats、index、mcp、prune-sessions，均可在帮助里查到。

远程通道

Reasonix 支持把现有的 chat、code 或桌面端会话延伸到 QQ 上，作为远程通道使用。命令行里先启动会话再执行 /qq connect，桌面端则在设置中的通用面板打开 QQ 通道。连接成功后，QQ 消息能进入当前会话，助手回复回到 QQ，后续的确认与追问也可以直接在 QQ 上完成。它扩展的是当前会话，而不是另开一个新的运行模式。

技能与配置

可以在项目内用 /skill new my-skill 创建技能，文件落在项目下的 .reasonix/skills 目录；加 --global 则写入 ~/.reasonix/skills，跨项目共用。技能文件的 frontmatter 里加 runAs: subagent 会让它以隔离的子 Agent 运行，而不是把正文内联进父提示词，从而控制上下文开销。配置是一个全局的 ~/.reasonix/config.json，加上项目级 .reasonix 目录下的覆盖项。

适用人群

长期用 DeepSeek 写代码的个人开发者、需要把 Agent 挂长时间跑的重构与大工程任务、想在 CI 或脚本里调用编码 Agent 的工程团队，以及关注 Token 成本与缓存命中的成本敏感型用户。

出品方与许可

项目由 esengine 团队开发维护，采用 MIT 许可证开源，提供中英双语 Discord 社区，包含求助、成果分享与反馈频道。

更新动态

项目当前处于两条线并存的状态：main 分支为 TypeScript 版 0.x，进入仅修 bug 的维护模式；活跃开发在 main-v2 的 Go 重写版上，官方提供了独立的迁移指南。仓库最近一次推送为 2026 年 10 月 20 日，属于高频迭代项目。

官方链接

GitHub 仓库：https://github.com/esengine/DeepSeek-Reasonix 官网：https://reasonix.io 文档站：https://esengine.github.io/DeepSeek-Reasonix/