Reasonix 是专为 DeepSeek 模型深度定制的开源终端编程 Agent，围绕 DeepSeek 独有的字节级前缀缓存机制设计，实测缓存命中率高达 99.82%，可将长会话输入 token 成本压缩至原价约 2 折。它不兼容其他模型后端，仅直连 DeepSeek API，适合需要低成本长时间运行编程任务的开发者。百科
核心功能与成本优势
- 极致缓存优化：采用 append-only 运行循环，历史上下文全程冻结、新消息严格追加至末尾，确保每轮请求前缀字节完全一致，最大化激活 DeepSeek 前缀缓存。
- 实测单日处理 4.35 亿输入 token，缓存命中率 99.82%。
- 账单由无缓存状态的约 61 美元骤降至约 12 美元，节省约 80%。
- DeepSeek 原生适配：所有抽象层均围绕 DeepSeek 的 prefix-cache 字节稳定性设计，内置四阶段工具调用修复引擎，自动纠正 JSON 结构缺失、参数错位、重复调用风暴等高频失败场景。
- 动态成本调控：默认启用高性价比 V4-Flash 模型，遇复杂任务可手动输入/pro 切换至 V4-Pro，单轮结束后自动回落，连续失败达阈值时亦可自动升级。
- 多平台支持：提供终端命令行、Tauri 桌面客户端、浏览器界面、VS Code 插件四种使用方式，支持 Windows、macOS、Linux 全平台。
- 不支持安卓原生应用，但可通过浏览器界面或终端间接使用。
安装与使用方法
- 环境准备：
- 安装 Node.js 22 及以上版本（推荐最新 LTS 版）。
- Windows 用户需额外安装 Git for Windows。
- 在 DeepSeek 开放平台获取 API Key（platform.deepseek.com）。
- 安装方式（任选其一）：
- 无需全局安装（推荐）：进入项目目录，执行
npx reasonix code启动 TUI 会话。 - 全局安装：执行
npm i -g reasonix，验证reasonix --version - 桌面端下载：从 GitHub Releases 页面下载对应平台安装包，内置 Node.js 运行时，零配置即启。
- 无需全局安装（推荐）：进入项目目录，执行
- 常用命令：
/pro：下一轮临时升级到 V4-Pro，用完自动复位。/compact：手动压缩当前上下文。/stats：查看 token 消耗、缓存命中率、折合人民币花费。/help：查看完整 slash 命令参考。/skill：调用内置或自定义 Skill 脚本。
- 官方资源：
- GitHub 仓库（https://github.com/esengine/DeepSeek-Reasonix）：获取最新版本、中文 README、Release 下载。
- DeepSeek 官方接入文档（https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/reasonix/）：官方安装指南。
版本选择与安全提醒
- 版本线选择：
- Reasonix 1.x（main-v2 分支）：稳定版，持续接收 bug 修复、安全更新，核心架构不再扩展，适合生产环境。
- Reasonix 2.x（studio 分支）：活跃开发版，新架构快速迭代，适合尝鲜和贡献反馈。
- 配置路径（v1.8.1 起）：
- macOS/Linux：
~/.reasonix/config.toml - Windows：
%APPDATA%\reasonix\config.toml
- macOS/Linux：
- 安全提醒：
- 2026 年 9 月 28 日 GitLab 发布安全警告，Reasonix Studio 桌面端的 workspace-changes diff viewer 存在 OS 命令注入漏洞，本地攻击者可通过控制仓库内容（.gitattributes + .git/config）执行任意命令。
- 建议及时更新至最新安全版本，避免在不受信任的仓库中使用桌面端 diff 查看功能。
- 中文文档：
- GitHub 仓库 README 为双语版本，包含 README.md（英文）和 README.zh-CN.md（中文），可直接在仓库中查看。
实操01-下载Reasonix
下载地址：https://github.com/esengine/DeepSeek-Reasonix
或者在官网预览：https://reasonix.io/
有2个下载方式。一个是下载Studio，也就是Windows的桌面应用。
还一个就是在终端里面，使用 npm i -g reasonix 命令行进行安装。