终端编码代理 esengine/DeepSeek-Reasonix

· 指南 · 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 分为两条版本线，调整的原因见版本路线公告。

| 版本线 | 分支 | 状态 | 获取方式 |
| 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 | .deb、.rpm 或 .AppImage（只提供下载） | x64（amd64）/ ARM64（arm64，aarch64） |

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

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

安卓版在同一个发布页上，文件名是 ReasonixMobile-<版本>.apk（arm64，Android 8.0 及以上）。

这个 APK 用 Android 发布密钥签名，不走 minisign，因此只有一个 .sha256，没有 .minisig。

该密钥缺失时产物名为 ReasonixMobile-<版本>-unsigned.apk。Android 不接受未签名的包，这类构建只留作 workflow 产物供自行签名，发布页上不会挂 APK。

内核与界面都跑在手机上，Agent 通过 SSH 连接你自己的服务器；与电脑配对时扫它显示的二维码。

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。

| Contributor | Contributor | Contributor | Contributor |
| SivanCola | KHG420 | ttmouse | chuiwenwei |
| lifu963 | XTLine | HUQIANTAO | xxoingr |
| Harbor404 | GTC2080 | mchenziyi | Li-Charles-One |
| light-front-theory | imcreazy | eghrhegpe | noreply |
| par73e | Bernardxu123 | lancy69 | Guan0923 |

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

MIT —— 见 LICENSE

由 esengine/DeepSeek-Reasonix 社区共建

支持本项目

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

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