esengine /DeepSeek-Reasonix

A reliable coding agent for complex software engineering tasks.

★ 36,122⑂ 2,564👁 98⑃ 0● 0▤ 365
GoMITCreated 2026-04-21reasonix.io/
下载:Reasonix Studio v2.61.0studio-v2.61.0 ↓2.61.02026-11-12
-7
日增长
-16
周增长
+352
月增长
36,122
stars
2,564
forks
98
watchers
0
prs
0
issues
365
releases

README

[!WARNING]
 Reasonix 已于 2026-11-12 起停止维护。 最后一个版本为 v2.61.0,此后不再发布新版本、修复缺陷或处理 Issue。项目采用 MIT 协议,欢迎 fork。详见公告。


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



  
  
  
  
  
  
  
  



  
  




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

 它是什么

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,桌面端是 Reasonix Studio;CLI、Studio 和编辑器集成
都运行同一套本地 Reasonix 引擎。

 Reasonix Studio(2.x)

从最新的 Studio 发布
下载对应平台的安装包(标签为 studio-v2.;-rc.N 等候选版本标为预发布):

| 平台 | 安装包 | 架构 |
| --- | --- | --- |
| macOS | .dmg 或 .zip | Apple Silicon(arm64)/ Intel(amd64) |
| Windows | 安装器 -installer.exe 或便携 .zip | x64 |
| Linux | .de

Discussions

Latest release

Reasonix Studio v2.61.0 studio-v2.61.0 2026-11-12
本版是最后一个版本:移除软件内的反馈建议、崩溃报告上传和匿名统计,并修复文件树、提交历史等一批问题。

 新增

- 工作台的文件树可以拖动边缘调整宽度,宽度会被记住,双击边缘恢复默认 (376376843)
- 新增「进程」按钮,点开列出本会话正在运行的后台任务和子智能体 (3807e411d)
- 新增设置「允许模型直接打开工作区内的文件夹」,默认关闭;打开后模型把本工作区内的文件夹加入项目时不再弹批准卡 15090

 修复

- 公式不再被裁掉上标的顶部 15092
- 没有伪控制台的 Windows 上,终端会说明原因,而不是报"shell 启动失败" 15091
- 在 Cygwin 或 MSYS 终端里运行时,会提示界面无法在这里运行以及该怎么办 15091
- Windows 上安装前端依赖(pnpm install)不再失败 15067
- 操作被拒绝时的原因不再被输入框盖住 (f4b815ecd)
- 读取内核失败时,窗口会说明内核无法连接以及是哪一次读取,而不是只显示"Failed to fetch" 15070
- 窄栏里「更改」标题行的按钮换行显示,不再挤成竖排并出现横向滚动条 (a717dcd34)
- 提交历史会在新提交出现、分支变化时自动刷新 (803583e4a)
- 选了资源管理器后,右边不再留着已经打开的启动菜单 (0a17f7774)
- 归

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON