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

面向终端的 DeepSeek 原生 AI coding agent。

由配置与插件驱动的极薄 harness——单一静态 Go 二进制，围绕 DeepSeek 的前缀缓存调优，长会话也能把 token 成本压低。

** ## 特性 - **配置驱动**：provider、agent、启用的工具、插件全部在 `reasonix.toml` 中声明， 内核无硬编码模型。 - **多模型 · 可组合**：DeepSeek 作为预设内置；任何 OpenAI 兼容 端点都只是一条配置。可选让两个模型协同（执行器 + 规划器），各自独立、缓存稳定的 session。 - **插件驱动**：外部工具以子进程形式运行，通过 stdio JSON-RPC 通信（MCP 兼容）； 内置工具在编译期自注册。 - **缓存友好的上下文维护**：启动时注入稳定的环境摘要；旧工具输出会先 snip/prune， 再进入摘要 compaction；内置工具 schema 合约有文档和回归测试保护。 - **零摩擦分发**：`CGO_ENABLED=0` 单二进制；一条命令交叉编译到六个目标平台。 唯一依赖是一个 TOML 解析库。 ## 安装 选择适合你的使用路径。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 make build # -> bin/reasonix(.exe) make cross # -> dist/（darwin|linux|windows × amd64|arm64） ``` ## 快速开始 ### 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) · [能力诊断](./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) ## 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**（anonymous） | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**light-front-theory**](https://github.com/light-front-theory) | | **merge-order-check**（anonymous） | [**Li-Charles-One**](https://github.com/Li-Charles-One) | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan**（anonymous） | | [**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， 以及 [AIGC Link](https://xhslink.com/m/80ngts127cA) 在小红书上的推广。

---

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

---

_{支持本项目}

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