项目文件夹

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

开源 · MIT · 程序跑在你电脑上，模型自选

终端、桌面、浏览器、编辑器里都能用的 AI 编程助手。

它会读你的项目、改文件、跑命令和测试。每一步先问你，或在你划定的范围内自己做，由你选；它用编辑工具改过的文件可以退回去。第一次用，从桌面应用 Studio 开始。

维护者：Huahui Yu。

Important

加入社区 · Community — 双语 Discord，提供安装答疑（#help / #求助）、工作流展示与功能想法。→ https://discord.gg/XF78rEME2D

QQ 群 DeepSeek-Reasonix官方群（群号 1093562660）→ https://qm.qq.com/q/i59b0z2R8s（二维码）

抖音：做游戏的小鱼（抖音号 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 分为两条版本线，调整的原因见版本路线公告。

• 想要稳定：继续使用 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 等候选版本标为预发布）：

每个安装包都附带 .minisig 签名，发布页另有 SHA256SUMS。安装后 Studio 会在 应用内自行更新。

同一个发布页也提供 2.x 的 reasonix CLI 归档（darwin|linux|windows × amd64|arm64）。

Reasonix 1.x（稳定版）

1.x CLI 在任意支持的平台上都可以通过 npm 安装，macOS 也可以使用 Homebrew：

npm i -g reasonix                  # 任意系统;自动拉取对应平台的原生二进制
brew install esengine/reasonix/reasonix   # macOS

1.x 桌面端请前往官方下载页。 Windows 安装器使用 Certum 代码签名证书签名。

VS Code 扩展

扩展不内置 CLI，而是启动本机的 reasonix acp 后端，并提供原生聊天、编辑器 上下文、工具调用审批、模型选择和工作区会话。请先安装 1.x CLI。

• VS Code： 从 Visual Studio Marketplace 安装
• VSCodium / Eclipse Theia： 从 Open VSX Registry 安装
• 扩展 ID： SivanLiu.reasonix-agent · 源码与使用说明

从源码构建

克隆仓库；studio 构建 2.x，main-v2 构建 1.x：

git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
git switch studio

CLI

CLI 构建需要 Go 1.25+。模块固定了 toolchain，保持 GOTOOLCHAIN=auto 即可让 Go 自动下载对应工具链，也可以手动安装。

make build      # -> bin/reasonix(.exe)
make cross      # -> dist/（darwin|linux|windows × amd64|arm64）

Studio

Studio 的前端还需要 Node 24+ 与 pnpm 10（npm install -g pnpm@10）。

make studio

各平台的 webview 依赖和 Linux 构建标签见 Studio 构建指南。

快速开始

Reasonix Studio

安装并启动 Studio，然后在应用内连接 provider 和模型即可使用，无需配置 CLI。

CLI / TUI

reasonix setup                      # 配置 provider 和模型
reasonix                            # 启动交互式会话
reasonix run "把 main.go 里的 TODO 实现掉"

需要项目指令时，可在交互式会话中运行 /init。

CLI 进阶用法和详细配置见 CLI 命令参考、 指南 和 配置路径。

文档

• 开始使用： 指南 · CLI 命令参考 · 配置路径 · ACP 编辑器接入 · 在 DeepSeek Harness 中使用
• 功能与排障： 子智能体 Profile · Context Engine v2 · 能力诊断 · 恢复与安全模式 · Checkpoints 与 rewind
• Agent 预设： 会话级组合
• 工程与迁移： 规格 · 任务合约与暂停策略 · 工具合约 · 从 1.x 迁移到 2.x · 2.x 路线图
• 扩展开发： 扩展概览 · 插件包与 Manifest v1 · Extension Protocol · Go SDK 与 starter

Star 趋势

致谢

下面这些朋友的工作塑造了 Reasonix 今天的样子 —— 当前按 commit 数统计的前 20 名贡献者。 完整贡献者列表在 GitHub。

特别感谢 Bernardxu123 设计的项目 logo和开场视频。

_{MIT —— 见 LICENSE
由 esengine/DeepSeek-Reasonix 社区共建}

_{支持本项目}

如果 Reasonix 帮你省了时间或 token，欢迎请杯咖啡。捐助不会换来 feature 优先级，也不会影响 issue 的处理顺序——就是「谢谢」。

• 国内 — 微信支付 / 支付宝（扫下方二维码）
• 海外 — PayPal: paypal.me/yuhuahui