| 1 | <p align="center"> |
| 2 | <img src="docs/logo-ghost-wave-effect.svg" alt="Reasonix" width="360"/> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="./README.md">English</a> |
| 7 | · |
| 8 | <strong>简体中文</strong> |
| 9 | · |
| 10 | <a href="./docs/GUIDE.zh-CN.md">指南</a> |
| 11 | · |
| 12 | <a href="./docs/ACP.zh-CN.md">ACP</a> |
| 13 | · |
| 14 | <a href="./docs/EXTENSIONS.zh-CN.md">扩展开发</a> |
| 15 | · |
| 16 | <a href="./docs/SPEC.zh-CN.md">规格</a> |
| 17 | · |
| 18 | <a href="https://esengine.github.io/DeepSeek-Reasonix/">官方网站</a> |
| 19 | · |
| 20 | <strong><a href="https://discord.gg/XF78rEME2D">Discord</a></strong> |
| 21 | </p> |
| 22 | |
| 23 | <p align="center"> |
| 24 | <a href="https://www.npmjs.com/package/reasonix"><img src="https://img.shields.io/npm/v/reasonix.svg?style=flat-square&color=cb3837&labelColor=161b22&logo=npm&logoColor=white" alt="npm version"/></a> |
| 25 | <a href="https://github.com/esengine/DeepSeek-Reasonix/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/esengine/DeepSeek-Reasonix/ci.yml?style=flat-square&label=ci&labelColor=161b22&logo=githubactions&logoColor=white" alt="CI"/></a> |
| 26 | <a href="./LICENSE"><img src="https://img.shields.io/npm/l/reasonix.svg?style=flat-square&color=8b949e&labelColor=161b22" alt="license"/></a> |
| 27 | <a href="https://www.npmjs.com/package/reasonix"><img src="https://img.shields.io/npm/dm/reasonix.svg?style=flat-square&color=3fb950&labelColor=161b22&label=downloads" alt="downloads"/></a> |
| 28 | <a href="https://github.com/esengine/DeepSeek-Reasonix/stargazers"><img src="https://img.shields.io/github/stars/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=dbab09&labelColor=161b22&logo=github&logoColor=white" alt="GitHub stars"/></a> |
| 29 | <a href="https://atomgit.com/esengine/DeepSeek-Reasonix"><img src="https://atomgit.com/esengine/DeepSeek-Reasonix/star/badge.svg" alt="AtomGit stars"/></a> |
| 30 | <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors"><img src="https://img.shields.io/github/contributors/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=bc8cff&labelColor=161b22&logo=github&logoColor=white" alt="contributors"/></a> |
| 31 | <a href="https://github.com/esengine/DeepSeek-Reasonix/discussions"><img src="https://img.shields.io/github/discussions/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=58a6ff&labelColor=161b22&logo=github&logoColor=white" alt="Discussions"/></a> |
| 32 | <a href="https://discord.gg/XF78rEME2D"><img src="https://img.shields.io/badge/discord-join-5865F2.svg?style=flat-square&labelColor=161b22&logo=discord&logoColor=white" alt="Discord"/></a> |
| 33 | </p> |
| 34 | |
| 35 | <p align="center"> |
| 36 | <a href="https://trendshift.io/repositories/27020?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-27020" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27020/monthly?language=Go" alt="esengine/DeepSeek-Reasonix | Trendshift" width="250" height="55"/></a> |
| 37 | <a href="https://trendshift.io/repositories/27020?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-27020" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/27020" alt="esengine/DeepSeek-Reasonix | Trendshift" width="250" height="55"/></a> |
| 38 | </p> |
| 39 | |
| 40 | <br/> |
| 41 | |
| 42 | <p align="center"><strong>开源 · MIT · 单个 Go 二进制</strong></p> |
| 43 | <h3 align="center">可以一直开着跑的编码 Agent。</h3> |
| 44 | <p align="center">一套本地引擎,四个入口——终端、桌面端、浏览器,或通过 ACP 接入你的编辑器。计划模式、权限、工作区沙箱与逐轮 checkpoint,让长时间自治运行始终可读、可撤销。</p> |
| 45 | |
| 46 | <div align="center"> |
| 47 | <video src="https://github.com/user-attachments/assets/ab2f3878-e224-4931-8254-060e7695cfb9" controls preload="metadata" width="560"></video> |
| 48 | </div> |
| 49 | |
| 50 | <br/> |
| 51 | |
| 52 | > [!IMPORTANT] |
| 53 | > **加入社区 · Community** — 双语 Discord，提供安装答疑（`#help` / `#求助`）、工作流展示与功能想法。→ **<https://discord.gg/XF78rEME2D>** |
| 54 | |
| 55 | ## 特性 |
| 56 | |
| 57 | - **配置驱动**：provider、agent、启用的工具、插件全部在 `reasonix.toml` 中声明， |
| 58 | 内核无硬编码模型。 |
| 59 | - **多模型 · 可组合**：DeepSeek 作为预设内置；任何 OpenAI 兼容 |
| 60 | 端点都只是一条配置。可选让两个模型协同（执行器 + 规划器），各自独立、缓存稳定的 session。 |
| 61 | - **插件驱动**：MCP server 提供工具、提示词和资源；Extension Protocol v1 |
| 62 | Sidecar 还可以拦截运行时事件、提供 Provider 与结构化 UI，并通过版本化插件包分发。 |
| 63 | - **缓存友好的上下文维护**：启动时注入稳定的环境摘要；旧工具输出会先 snip/prune， |
| 64 | 再进入摘要 compaction；内置工具 schema 合约有文档和回归测试保护。 |
| 65 | - **零摩擦分发**：`CGO_ENABLED=0` 单二进制；一条命令交叉编译到六个目标平台。 |
| 66 | 产物是完全自包含的静态二进制——目标机器上除二进制本身外无需安装任何东西。 |
| 67 | |
| 68 | ## 安装 |
| 69 | |
| 70 | 选择适合你的使用路径。CLI/TUI、桌面端和 VS Code 扩展都使用同一套本地 |
| 71 | Reasonix 引擎。 |
| 72 | |
| 73 | ### 路径 A：CLI / TUI |
| 74 | |
| 75 | 任意支持的平台都可以通过 npm 安装原生二进制；macOS 也可以使用 Homebrew： |
| 76 | |
| 77 | ```sh |
| 78 | npm i -g reasonix # 任意系统;自动拉取对应平台的原生二进制 |
| 79 | brew install esengine/reasonix/reasonix # macOS |
| 80 | ``` |
| 81 | |
| 82 | 预编译归档(`darwin|linux|windows × amd64|arm64`)和 `SHA256SUMS` 见每个 |
| 83 | [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases)。 |
| 84 | |
| 85 | ### 路径 B：桌面端 |
| 86 | |
| 87 | 前往[官方下载页](https://reasonix.io/?download=desktop#start)获取最新桌面版本。 |
| 88 | |
| 89 | | 平台 | 安装包 | 架构 | |
| 90 | | --- | --- | --- | |
| 91 | | macOS | 通用 `.dmg` 或 `.zip` | Apple Silicon / Intel | |
| 92 | | Windows | 安装器 `.exe` 或便携 `.zip` | x64 / ARM64 | |
| 93 | | Linux | `.deb` 或 `.tar.gz` | x64 | |
| 94 | |
| 95 | Windows 安装器通过 [SignPath.io](https://signpath.io/) 完成代码签名，证书由 |
| 96 | [SignPath 基金会](https://signpath.org/) 免费提供。 |
| 97 | |
| 98 | ### 路径 C：VS Code 扩展 |
| 99 | |
| 100 | 请先完成路径 A。扩展不内置 CLI，而是启动本机的 `reasonix acp` 后端， |
| 101 | 并提供原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话。 |
| 102 | |
| 103 | - **VS Code：** [从 Visual Studio Marketplace 安装](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent) |
| 104 | - **VSCodium / Eclipse Theia：** [从 Open VSX Registry 安装](https://open-vsx.org/extension/SivanLiu/reasonix-agent) |
| 105 | - **扩展 ID：** `SivanLiu.reasonix-agent` · [源码与使用说明](https://github.com/SivanCola/reasonix-vscode) |
| 106 | |
| 107 | ### 路径 D：从源码构建 |
| 108 | |
| 109 | 先克隆仓库： |
| 110 | |
| 111 | ```sh |
| 112 | git clone https://github.com/esengine/DeepSeek-Reasonix.git |
| 113 | cd DeepSeek-Reasonix |
| 114 | ``` |
| 115 | |
| 116 | #### CLI |
| 117 | |
| 118 | CLI 构建需要 **Go 1.26+**。模块固定了 `toolchain` 指令； |
| 119 | 保持 `GOTOOLCHAIN=auto` 让 Go 自动下载固定的工具链，或自行安装。 |
| 120 | |
| 121 | ```sh |
| 122 | make build # -> bin/reasonix(.exe) |
| 123 | make cross # -> dist/（darwin|linux|windows × amd64|arm64） |
| 124 | ``` |
| 125 | |
| 126 | #### 桌面端 |
| 127 | |
| 128 | 桌面端构建额外需要 **Node 24+ 和 pnpm 10**（`npm install -g pnpm@10`）， |
| 129 | 用于前端与 Electron 壳： |
| 130 | |
| 131 | ```sh |
| 132 | scripts/desktop-build.sh darwin/arm64 v0.0.0-dev # 每次构建一个平台 |
| 133 | ``` |
| 134 | |
| 135 | 无需安装系统 WebView 依赖：Electron 壳自带 Chromium。详见 |
| 136 | [桌面端构建指南](desktop/README.md#prerequisites)。 |
| 137 | |
| 138 | ## 快速开始 |
| 139 | |
| 140 | ### CLI / TUI |
| 141 | |
| 142 | 以下命令仅适用于通过路径 A 安装的 CLI/TUI： |
| 143 | |
| 144 | ```sh |
| 145 | reasonix setup # 配置 provider 和模型 |
| 146 | reasonix # 启动交互式会话 |
| 147 | reasonix run "把 main.go 里的 TODO 实现掉" |
| 148 | ``` |
| 149 | |
| 150 | 需要项目指令时，可在交互式会话中运行 `/init`。 |
| 151 | |
| 152 | ### 桌面端 |
| 153 | |
| 154 | 从[官方下载页](https://reasonix.io/?download=desktop#start)下载对应系统的安装包， |
| 155 | 安装并启动 Reasonix，然后在应用内配置 provider 和模型即可使用。桌面端无需执行 |
| 156 | 上面的 CLI 命令。 |
| 157 | |
| 158 | CLI 进阶用法和详细配置见 **[CLI 命令参考](./docs/CLI.zh-CN.md)**、 |
| 159 | **[指南](./docs/GUIDE.zh-CN.md)** 和 |
| 160 | **[配置路径](./docs/CONFIG_PATHS.zh-CN.md)**。 |
| 161 | |
| 162 | ## 文档 |
| 163 | |
| 164 | - **开始使用：** [指南](./docs/GUIDE.zh-CN.md) · |
| 165 | [CLI 命令参考](./docs/CLI.zh-CN.md) · [配置路径](./docs/CONFIG_PATHS.zh-CN.md) · |
| 166 | [ACP 编辑器接入](./docs/ACP.zh-CN.md) |
| 167 | - **功能与排障：** [子智能体 Profile](./docs/SUBAGENT_PROFILES.zh-CN.md) · |
| 168 | [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.zh-CN.md) · |
| 169 | [文件成果与 `present` 工具](./docs/PRESENT_TOOL.zh-CN.md) · |
| 170 | [能力诊断](./docs/CAPABILITY_DIAGNOSTICS.zh-CN.md) · |
| 171 | [恢复与安全模式](./docs/RECOVERY.zh-CN.md) · |
| 172 | [机器人使用指南](./docs/BOT_GUIDE.zh-CN.md) · |
| 173 | [Checkpoints 与 rewind](./docs/CHECKPOINTS.zh-CN.md) |
| 174 | - **工程与迁移：** [规格](./docs/SPEC.zh-CN.md) · |
| 175 | [任务合约与暂停策略](./docs/TASK_CONTRACT.zh-CN.md) · |
| 176 | [工具合约](./docs/TOOL_CONTRACT.zh-CN.md) · |
| 177 | [从 0.x 迁移](./docs/MIGRATING.zh-CN.md) |
| 178 | - **扩展开发：** [扩展概览](./docs/EXTENSIONS.zh-CN.md) · |
| 179 | [插件包与 Manifest v1](./docs/PLUGIN_PACKAGES.zh-CN.md) · |
| 180 | [Extension Protocol](./docs/EXTENSION_PROTOCOL.zh-CN.md) · |
| 181 | [Go SDK 与 starter](./sdk/go/README.md) |
| 182 | |
| 183 | ## Star 趋势 |
| 184 | |
| 185 | <a href="https://www.star-history.com/?repos=esengine%2FDeepSeek-Reasonix&type=date&legend=top-left"> |
| 186 | <picture> |
| 187 | <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/star-history/assets/star-history/star-history-dark.svg" /> |
| 188 | <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/star-history/assets/star-history/star-history-light.svg" /> |
| 189 | <img alt="Star History Chart" src="https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/star-history/assets/star-history/star-history-light.svg" /> |
| 190 | </picture> |
| 191 | </a> |
| 192 | |
| 193 | <br/> |
| 194 | |
| 195 | ## 致谢 |
| 196 | |
| 197 | 下面这些朋友的工作塑造了 Reasonix 今天的样子 —— 当前按 commit 数统计的前 20 名贡献者。 |
| 198 | 完整贡献者列表在 |
| 199 | [GitHub](https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors?all=1)。 |
| 200 | |
| 201 | <!-- reasonix-top-contributors:start --> |
| 202 | | Contributor | Contributor | Contributor | Contributor | |
| 203 | | --- | --- | --- | --- | |
| 204 | | [**SivanCola**](https://github.com/SivanCola) | [**esengine**](https://github.com/esengine) | [**ttmouse**](https://github.com/ttmouse) | [**lifu963**](https://github.com/lifu963) | |
| 205 | | **reasonix** | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**light-front-theory**](https://github.com/light-front-theory) | |
| 206 | | **merge-order-check** | [**Li-Charles-One**](https://github.com/Li-Charles-One) | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan** | |
| 207 | | [**CVEngineer66**](https://github.com/CVEngineer66) | [**dependabot\[bot\]**](https://github.com/apps/dependabot) | [**lanshi17**](https://github.com/lanshi17) | [**SuMuxi66**](https://github.com/SuMuxi66) | |
| 208 | | [**CnsMaple**](https://github.com/CnsMaple) | [**cyq1017**](https://github.com/cyq1017) | [**JesonChou**](https://github.com/JesonChou) | [**XTLine**](https://github.com/XTLine) | |
| 209 | <!-- reasonix-top-contributors:end --> |
| 210 | |
| 211 | 特别感谢 [**Bernardxu123**](https://github.com/Bernardxu123) 设计的项目 logo和开场视频。 |
| 212 | |
| 213 | <p align="center"> |
| 214 | <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors"> |
| 215 | <img src="https://contrib.rocks/image?repo=esengine/DeepSeek-Reasonix&max=100&columns=12" alt="esengine/DeepSeek-Reasonix 贡献者" width="860"/> |
| 216 | </a> |
| 217 | </p> |
| 218 | |
| 219 | <br/> |
| 220 | |
| 221 | --- |
| 222 | |
| 223 | <p align="center"> |
| 224 | <sub>MIT —— 见 <a href="./LICENSE">LICENSE</a></sub> |
| 225 | <br/> |
| 226 | <sub>由 <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors">esengine/DeepSeek-Reasonix</a> 社区共建</sub> |
| 227 | </p> |
| 228 | |
| 229 | --- |
| 230 | |
| 231 | <p align="center"><sub><strong>支持本项目</strong></sub></p> |
| 232 | |
| 233 | 如果 Reasonix 帮你省了时间或 token，欢迎请杯咖啡。捐助不会换来 feature |
| 234 | 优先级，也不会影响 issue 的处理顺序——就是「谢谢」。 |
| 235 | |
| 236 | - **国内** — 微信支付（扫下方二维码） |
| 237 | - **海外** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui) |
| 238 | |
| 239 | <p align="center"> |
| 240 | <img src=".github/sponsor/wechat-pay.jpg" alt="微信支付收款码" width="180"/> |
| 241 | </p> |
| 242 |