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

开源 · MIT · 单个 Go 二进制

可以一直开着跑的编码 Agent。

一套本地引擎,四个入口——终端、桌面端、浏览器,或通过 ACP 接入你的编辑器。计划模式、权限、工作区沙箱与逐轮 checkpoint,让长时间自治运行始终可读、可撤销。

** ## 特性 - **配置驱动**：provider、agent、启用的工具、插件全部在 `reasonix.toml` 中声明， 内核无硬编码模型。 - **多模型 · 可组合**：DeepSeek 作为预设内置；任何 OpenAI 兼容 端点都只是一条配置。可选让两个模型协同（执行器 + 规划器），各自独立、缓存稳定的 session。 - **插件驱动**：MCP server 提供工具、提示词和资源；Extension Protocol v1 Sidecar 还可以拦截运行时事件、提供 Provider 与结构化 UI，并通过版本化插件包分发。 - **缓存友好的上下文维护**：启动时注入稳定的环境摘要；旧工具输出会先 snip/prune， 再进入摘要 compaction；内置工具 schema 合约有文档和回归测试保护。 - **零摩擦分发**：`CGO_ENABLED=0` 单二进制；一条命令交叉编译到六个目标平台。 产物是完全自包含的静态二进制——目标机器上除二进制本身外无需安装任何东西。 ## 安装 选择适合你的使用路径。CLI/TUI、桌面端和 VS Code 扩展都使用同一套本地 Reasonix 引擎。 ### 路径 A：CLI / TUI 任意支持的平台都可以通过 npm 安装原生二进制；macOS 也可以使用 Homebrew： ```sh npm i -g reasonix # 任意系统;自动拉取对应平台的原生二进制 brew install esengine/reasonix/reasonix # macOS ``` 预编译归档(`darwin|linux|windows × amd64|arm64`)和 `SHA256SUMS` 见每个 [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases)。 ### 路径 B：桌面端 前往[官方下载页](https://reasonix.io/?download=desktop#start)获取最新桌面版本。 | 平台 | 安装包 | 架构 | | --- | --- | --- | | macOS | 通用 `.dmg` 或 `.zip` | Apple Silicon / Intel | | Windows | 安装器 `.exe` 或便携 `.zip` | x64 / ARM64 | | Linux | `.deb` 或 `.tar.gz` | x64 | Windows 安装器通过 [SignPath.io](https://signpath.io/) 完成代码签名，证书由 [SignPath 基金会](https://signpath.org/) 免费提供。 ### 路径 C：VS Code 扩展 请先完成路径 A。扩展不内置 CLI，而是启动本机的 `reasonix acp` 后端， 并提供原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话。 - **VS Code：** [从 Visual Studio Marketplace 安装](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent) - **VSCodium / Eclipse Theia：** [从 Open VSX Registry 安装](https://open-vsx.org/extension/SivanLiu/reasonix-agent) - **扩展 ID：** `SivanLiu.reasonix-agent` · [源码与使用说明](https://github.com/SivanCola/reasonix-vscode) ### 路径 D：从源码构建 先克隆仓库： ```sh git clone https://github.com/esengine/DeepSeek-Reasonix.git cd DeepSeek-Reasonix ``` #### CLI CLI 构建需要 **Go 1.25+**。模块固定了 `toolchain` 指令； 保持 `GOTOOLCHAIN=auto` 让 Go 自动下载固定的工具链，或自行安装。 ```sh make build # -> bin/reasonix(.exe) make cross # -> dist/（darwin|linux|windows × amd64|arm64） ``` #### 桌面端 桌面端构建额外需要： - **Node 24+ 和 pnpm 10**（`npm install -g pnpm@10`）用于前端 - **Wails CLI**，与共享的 `.wails-version` 固定版本一致 ```sh make wails-install cd desktop wails build ``` 平台相关的 WebView 依赖和 Linux 构建标签见 [桌面端构建指南](desktop/README.md#prerequisites)。 ## 快速开始 ### CLI / TUI 以下命令仅适用于通过路径 A 安装的 CLI/TUI： ```sh reasonix setup # 配置 provider 和模型 reasonix # 启动交互式会话 reasonix run "把 main.go 里的 TODO 实现掉" ``` 需要项目指令时，可在交互式会话中运行 `/init`。 ### 桌面端 从[官方下载页](https://reasonix.io/?download=desktop#start)下载对应系统的安装包， 安装并启动 Reasonix，然后在应用内配置 provider 和模型即可使用。桌面端无需执行 上面的 CLI 命令。 CLI 进阶用法和详细配置见 **[CLI 命令参考](./docs/CLI.zh-CN.md)**、 **[指南](./docs/GUIDE.zh-CN.md)** 和 **[配置路径](./docs/CONFIG_PATHS.zh-CN.md)**。 ## 文档 - **开始使用：** [指南](./docs/GUIDE.zh-CN.md) · [CLI 命令参考](./docs/CLI.zh-CN.md) · [配置路径](./docs/CONFIG_PATHS.zh-CN.md) · [ACP 编辑器接入](./docs/ACP.zh-CN.md) - **功能与排障：** [子智能体 Profile](./docs/SUBAGENT_PROFILES.zh-CN.md) · [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.zh-CN.md) · [能力诊断](./docs/CAPABILITY_DIAGNOSTICS.zh-CN.md) · [恢复与安全模式](./docs/RECOVERY.zh-CN.md) · [机器人使用指南](./docs/BOT_GUIDE.zh-CN.md) · [Checkpoints 与 rewind](./docs/CHECKPOINTS.zh-CN.md) - **工程与迁移：** [规格](./docs/SPEC.zh-CN.md) · [任务合约与暂停策略](./docs/TASK_CONTRACT.zh-CN.md) · [工具合约](./docs/TOOL_CONTRACT.zh-CN.md) · [从 0.x 迁移](./docs/MIGRATING.zh-CN.md) - **扩展开发：** [扩展概览](./docs/EXTENSIONS.zh-CN.md) · [插件包与 Manifest v1](./docs/PLUGIN_PACKAGES.zh-CN.md) · [Extension Protocol](./docs/EXTENSION_PROTOCOL.zh-CN.md) · [Go SDK 与 starter](./sdk/go/README.md) ## Star 趋势
## 致谢 下面这些朋友的工作塑造了 Reasonix 今天的样子 —— 当前按 commit 数统计的前 20 名贡献者。 完整贡献者列表在 [GitHub](https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors?all=1)。 | Contributor | Contributor | Contributor | Contributor | | --- | --- | --- | --- | | [**SivanCola**](https://github.com/SivanCola) | [**esengine**](https://github.com/esengine) | [**ttmouse**](https://github.com/ttmouse) | [**lifu963**](https://github.com/lifu963) | | **reasonix** | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**light-front-theory**](https://github.com/light-front-theory) | | **merge-order-check** | [**Li-Charles-One**](https://github.com/Li-Charles-One) | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan** | | [**CVEngineer66**](https://github.com/CVEngineer66) | [**dependabot\[bot\]**](https://github.com/apps/dependabot) | [**lanshi17**](https://github.com/lanshi17) | [**SuMuxi66**](https://github.com/SuMuxi66) | | [**CnsMaple**](https://github.com/CnsMaple) | [**cyq1017**](https://github.com/cyq1017) | [**JesonChou**](https://github.com/JesonChou) | [**XTLine**](https://github.com/XTLine) | 特别感谢 [**Bernardxu123**](https://github.com/Bernardxu123) 设计的项目 logo和开场视频。

---

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

---

_{支持本项目}

如果 Reasonix 帮你省了时间或 token，欢迎请杯咖啡。捐助不会换来 feature 优先级，也不会影响 issue 的处理顺序——就是「谢谢」。 - **国内** — 微信支付（扫下方二维码） - **海外** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)