### [Reasonix使用教程](https://li8.net/doc/142)

**Published:** 2026-10-21T01:10:55

**Author:** 生产力吧

**Excerpt:** ‌Reasonix 是专为 DeepSeek 模型深度定制的开源终端编程 Agent‌，围绕 DeepSeek…

‌**Reasonix 是专为 [DeepSeek](https://www.baidu.com/s?wd=DeepSeek&rsv_idx=2&tn=baiduhome_pg&usm=2&ie=utf-8&rsv_pq=fac81f82000e0605&oq=Reasonix&rsv_t=2744inQL5C0%2F6soV3%2BOKYkrdxDw10mDVUkgGfosyu3S6RyPMbsghD%2FmqSb9%2Fiu4wazkG&rsv_dl=re_dqa_generate&sa=re_dqa_generate) 模型深度定制的开源终端编程 Agent**‌，围绕 DeepSeek 独有的字节级前缀缓存机制设计，实测缓存命中率高达 99.82%，可将长会话输入 token 成本压缩至原价约 2 折。它不兼容其他模型后端，仅直连 DeepSeek API，适合需要低成本长时间运行编程任务的开发者。‌‌百科‌

### 核心功能与成本优势

1.  ‌**极致缓存优化**‌：采用 append-only 运行循环，历史上下文全程冻结、新消息严格追加至末尾，确保每轮请求前缀字节完全一致，最大化激活 DeepSeek 前缀缓存。
    -   实测单日处理 4.35 亿输入 token，缓存命中率 99.82%。
    -   账单由无缓存状态的约 61 美元骤降至约 12 美元，节省约 80%。‌‌‌
2.  ‌**DeepSeek 原生适配**‌：所有抽象层均围绕 DeepSeek 的 prefix-cache 字节稳定性设计，内置四阶段工具调用修复引擎，自动纠正 JSON 结构缺失、参数错位、重复调用风暴等高频失败场景。‌‌‌
3.  ‌**动态成本调控**‌：默认启用高性价比 V4-Flash 模型，遇复杂任务可手动输入/pro 切换至 V4-Pro，单轮结束后自动回落，连续失败达阈值时亦可自动升级。‌‌‌
4.  ‌**多平台支持**‌：提供终端命令行、Tauri 桌面客户端、浏览器界面、VS Code 插件四种使用方式，支持 Windows、macOS、Linux 全平台。
    -   ‌**不支持安卓原生应用**‌，但可通过浏览器界面或终端间接使用。‌‌‌

### 安装与使用方法

1.  ‌**环境准备**‌：
    -   安装 Node.js 22 及以上版本（推荐最新 LTS 版）。
    -   Windows 用户需额外安装 Git for Windows。
    -   在 [DeepSeek 开放平台](https://www.baidu.com/s?wd=DeepSeek%20%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0&rsv_idx=2&tn=baiduhome_pg&usm=2&ie=utf-8&rsv_pq=fac81f82000e0605&oq=Reasonix&rsv_t=90ca505GDGFvdKdqwAtv8YzXHHE06psgZG6cz%2FGqs2DZCBHwtjfH7jEcVJ5n5Fy2AxUo&rsv_dl=re_dqa_generate&sa=re_dqa_generate)获取 API Key（platform.deepseek.com）。‌‌‌
2.  ‌**安装方式**‌（任选其一）：
    -   ‌**无需全局安装**‌（推荐）：进入项目目录，执行`npx reasonix code`启动 TUI 会话。
    -   ‌**全局安装**‌：执行`npm i -g reasonix`，验证`reasonix --version`
    -   ‌**桌面端下载**‌：从 GitHub Releases 页面下载对应平台安装包，内置 Node.js 运行时，零配置即启。‌‌‌
3.  ‌**常用命令**‌：
    -   `/pro`：下一轮临时升级到 V4-Pro，用完自动复位。
    -   `/compact`：手动压缩当前上下文。
    -   `/stats`：查看 token 消耗、缓存命中率、折合人民币花费。
    -   `/help`：查看完整 slash 命令参考。
    -   `/skill`：调用内置或自定义 Skill 脚本。‌‌‌
4.  ‌**官方资源**‌：
    -   GitHub 仓库（[https://github.com/esengine/DeepSeek-Reasonix](https://github.com/esengine/DeepSeek-Reasonix)）：获取最新版本、中文 README、Release 下载。
    -   DeepSeek 官方接入文档（[https://api-docs.deepseek.com/zh-cn/quick\_start/agent\_integrations/reasonix/](https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/reasonix/)）：官方安装指南。‌‌‌

### 版本选择与安全提醒

1.  ‌**版本线选择**‌：
    -   ‌**Reasonix 1.x**‌（main-v2 分支）：稳定版，持续接收 bug 修复、安全更新，核心架构不再扩展，适合生产环境。
    -   ‌**Reasonix 2.x**‌（studio 分支）：活跃开发版，新架构快速迭代，适合尝鲜和贡献反馈。‌‌‌
2.  ‌**配置路径**‌（v1.8.1 起）：
    -   macOS/Linux：`~/.reasonix/config.toml`
    -   Windows：`%APPDATA%\reasonix\config.toml`‌‌‌
3.  ‌**安全提醒**‌：
    -   2026 年 9 月 28 日 GitLab 发布安全警告，Reasonix Studio 桌面端的 workspace-changes diff viewer 存在 [OS 命令注入漏洞](https://www.baidu.com/s?wd=OS%20%E5%91%BD%E4%BB%A4%E6%B3%A8%E5%85%A5%E6%BC%8F%E6%B4%9E&rsv_idx=2&tn=baiduhome_pg&usm=2&ie=utf-8&rsv_pq=fac81f82000e0605&oq=Reasonix&rsv_t=dae2Z%2BAU%2FrNSSbOzdKVhO7aunYhPxlO80yqy2R%2BUwjYih5jIBIHWCATz1h04ifuS7KRO&rsv_dl=re_dqa_generate&sa=re_dqa_generate)，本地攻击者可通过控制仓库内容（.gitattributes + .git/config）执行任意命令。
    -   建议及时更新至最新安全版本，避免在不受信任的仓库中使用桌面端 diff 查看功能。‌‌‌
4.  ‌**中文文档**‌：
    -   GitHub 仓库 README 为双语版本，包含 README.md（英文）和 README.zh-CN.md（中文），可直接在仓库中查看。‌‌‌

## **实操01-下载Reasonix**

下载地址：[https://github.com/esengine/DeepSeek-Reasonix](https://github.com/esengine/DeepSeek-Reasonix)

或者在官网预览：[https://reasonix.io/](https://reasonix.io/)

![](https://img.cg9.net/2026/10/20261021092341344.png)

![](https://img.cg9.net/2026/10/20261021092429790.png)

有2个下载方式。一个是下载Studio，也就是Windows的桌面应用。

还一个就是在终端里面，使用 `npm i -g reasonix` 命令行进行安装。



---