README

English
   · 
  简体中文
   · 
  指南
   · 
  ACP
   · 
  扩展开发
   · 
  规格
   · 
  官方网站
   · 
  Discord
   · 
  QQ



  
  
  
  
  
  
  
  
  
  
  



  
  




开源 · MIT · 程序跑在你电脑上，模型自选
终端、桌面、浏览器、编辑器里都能用的 AI 编程助手。
它会读你的项目、改文件、跑命令和测试。每一步先问你，或在你划定的范围内自己做，由你选；它用编辑工具改过的文件可以退回去。第一次用，从桌面应用 Studio 开始。
维护者：Huahui Yu。

 [!IMPORTANT]
 加入社区 · Community — 双语 Discord，提供安装答疑（help / 求助）、工作流展示与功能想法。→ 

 QQ 群 DeepSeek-Reasonix官方群（群号 1093562660）→ （二维码）

 抖音：做游戏的小鱼（抖音号 22703872788）· 二维码

 ❤️赞助商

感谢 Right Code 赞助了本项目！Right Code 稳定提供 Claude Code、Codex、Gemini 等模型的中转服务，并可选按量、包月两种计费模式。充值即可开票，企业、团队用户一对一对接。通过此链接注册。感谢 PackyCode 赞助了本项目！PackyCode 是一家稳定、高效的 API 中转服务商，统一域名、统一密钥、智能容灾切换。通过此链接注册。

 它是什么

Reasonix 是一个开源的 AI 编程助手。程序跑在你的电脑上；AI 模型是你自己配置的服务，它读到的内容会发给这个服务。你用大白话描述任务，它在你选的项目文件夹里读代码、改文件、跑命令和测试，每一步都摆给你看。

模型你自己选：内置 DeepSeek 预设，其他兼容 OpenAI 接口的服务填一条配置就行，费用直接付给模型服务商。

 你能得到什么

- 读、改、跑：读你的项目、改文件、跑测试和命令，都在你选的项目文件夹里。
- 权限分档：每次都问你，或让日常操作自动放行；你设的禁止规则始终有效。想先看方案，就开计划模式，批准后它才动手。
- 可回退：改文件前先存快照，按对话轮次回退，不碰 git 历史。只覆盖编辑工具改的文件，命令行命令造成的改动不在内。

 30 秒上手

下载、填模型密钥、打开项目。第一次用，从桌面应用 Studio 开始。

1. 从发布页下载并安装桌面应用 Reasonix Studio。
2. 打开应用，按提示填入模型服务商和密钥。
3. 打开你的项目文件夹，写下想做的事，例如“给 http 客户端加上失败重试”。
4. 按你选的档位，该问你的操作它会先停下来问；同意就继续，不同意就拒绝。

更喜欢终端的话，下载 reasonix 命令行后运行 reasonix setup 配好模型，再运行 reasonix 即可。详见安装和快速开始。

 四种用法

- 桌面应用（Studio）：图形界面，适合第一次使用。
- 终端：全屏文字界面，也能用 reasonix run "任务" 在脚本里运行。
- 浏览器：reasonix web 在本机打开网页界面。
- 编辑器：VS Code 安装扩展即可；其他支持 ACP（Agent Client Protocol，编辑器接入某个 AI 助手的通用约定）的编辑器，可连接 reasonix acp。

四种用法背后是同一套程序。下面的内容写给进阶用户和贡献者。

 在 DeepSeek Harness 里使用

DeepSeek Harness（dsh）可以通过 ACP 把任务交给 Reasonix 作为子智能体去做。本仓库为此发布了一个插件索引：

1. 在运行 dsh 的机器上先运行 reasonix setup。在 DSH 网页界面打开“自定义插件市场”（插件，更多），再到 Discover 页添加这个索引：https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/studio/integrations/dsh-plugin/market-index.json
2. 从中安装“Reasonix subagent”。
3. 打开这个插件的页面，把它的开关打开。关着的时候模型没有 reasonix 工具，可能改在自己的 shell 里直接运行 reasonix -p，看起来像委派，其实不是。

配置细节、权限策略和限制见 在 DeepSeek Harness 中使用 Reasonix。

 版本

Reasonix 分为两条版本线，调整的原因见版本路线公告。

| 版本线 | 分支 | 状态 | 获取方式 |
| --- | --- | --- | --- |
| Reasonix 2.x | studio（当前分支） | 活跃开发 | Studio 发布页 |
| Reasonix 1.x | main-v2 | 维护 / 稳定 | npm i -g reasonix · 桌面端下载 |

- 想要稳定：继续使用 1.x。它会持续收到 Bug 修复、Provider / API 兼容、
  更新器和安全修复，但不再扩展核心架构。
- 想体验新架构：使用 2.x Reasonix Studio。它仍在快速迭代，欢迎反馈问题。

1.x 中有价值的修复、测试和行为会逐项 review，适合新架构的会迁移或重新实现到 2.x。

- 从 1.x 迁移到 2.x（英文）：两条线共用哪些数据，以及如何在同一台
  机器上同时使用而不丢会话。
- 2.x 路线图（英文）：2.x 还要交付什么、如何发布、哪些决定尚未做出。

 特性

以下是写给进阶用户的技术要点。

- 配置驱动：provider、agent、启用的工具、插件全部在 reasonix.toml 中声明，
  内核无硬编码模型。
- 多模型 · 可组合：DeepSeek 作为预设内置；任何 OpenAI 兼容
  端点都只是一条配置。可选让两个模型协同（执行器 + 规划器），各自独立、缓存稳定的 session。
- 插件驱动：MCP server 提供工具、提示词和资源；Extension Protocol v1
  Sidecar 还可以拦截运行时事件、提供 Provider 与结构化 UI，并通过版本化插件包分发。
- 缓存友好的上下文维护：启动时注入稳定的环境摘要；旧工具输出会先 snip/prune，
  再进入摘要 compaction；内置工具 schema 合约有文档和回归测试保护。
- 零摩擦分发：CGO_ENABLED=0 单二进制；一条命令交叉编译到六个目标平台。
  产物是完全自包含的静态二进制——目标机器上除二进制本身外无需安装任何东西。

 安装

当前分支是 Reasonix 2.x，桌

Top issues

Discussions

Latest release

本版重新排版了手机端（标题栏、审批、输入区、模型菜单、设置），让设置更好找（搜索按相关度排序、每页有目录），并缩小了发给模型的工具定义、加快了启动和长会话的恢复与保存。

 新增

- 记忆按「星系」归类，带重要度和遗忘曲线：常用的越记越牢，久不用的慢慢淡下去，仍能搜到（da640949c、bfc838a3c）。
- 约束类和每轮常驻的记忆永不变淡（c22dd9495）。
- 设置里的记忆页改成三栏：左边分类，中间带搜索的列表，右边详情，可改类型、星系、重要度（d0289a4d0）。
- 刚记住的记忆放在「新的」里，一键「对 / 忘掉」；忘掉是归档，不是删除（d0289a4d0）。
- 手机宽度（≤520px）重新排版：标题栏保留会话列表、居中的标题和机器状态；断线时说明正在重连（411e19d87）。
- 手机上的审批卡是两个等宽的大按钮，拒绝在左、允许在右，其余选项收在「更多选项」后面（411e19d87）。
- 手机上的输入区只留添加、模型和发送，其余控件收在一个「更多工具」按钮后面；运行中发送变成圆形暂停键（ae46c30d3）。
- 手机上的模型菜单改为贴底的面板；推理深度是一条品牌色的深度线，松手时才选定（e8b13d13d、8c71d355b）。
- 手机上的设置全屏、单列，分类变成顶部可滑动的一排，鼠标滚轮也能横向滑动（37ec85381、081f35e9d）。
-