DeepSeek-Reasonix：终端 AI 编程 Agent

English · 简体中文 · 指南 · ACP · 规范 · 网站 · Discord

一个原生 DeepSeek AI 编码 Agent，为你的终端而生。

一个配置驱动、插件驱动的工作框架 —— 一个静态 Go 二进制文件，围绕 DeepSeek 的前缀缓存优化，使得长会话中的令牌成本保持低廉。

社区

加入社区 —— 双语 Discord，提供设置帮助（#help / #求助）、工作流展示和功能建议。 → https://discord.gg/XF78rEME2D

特性

配置驱动。提供商、Agent、启用的工具和插件都在 reasonix.toml 中声明。没有硬编码的模型。

多模型和可组合。DeepSeek 作为预设配置提供；任何 OpenAI 兼容端点只需一个配置条目，无需新代码。可选择同时运行两个模型（执行器 + 规划器），在独立的、缓存稳定的会话中。

插件驱动。外部工具作为子进程通过 stdio JSON-RPC 运行（MCP 兼容）。内置工具在编译时自动注册。

缓存感知的上下文维护。启动时注入小型稳定环境摘要，陈旧的工具输出在摘要压缩前被删减/修剪，内置工具模式契约已文档化以供回归审查。

零摩擦分发。CGO_ENABLED=0 单个二进制文件；一条命令跨编译到六个目标。唯一的依赖是 TOML 解析器。

开始使用

选择与你想要使用 Reasonix 的方式相匹配的路径。CLI/TUI、桌面应用和 VS Code 扩展都使用相同的本地 Reasonix 引擎。

Path A: npm / Homebrew

在任何支持的平台上通过 npm 安装原生二进制文件，或在 macOS 上使用 Homebrew：

npm i -g reasonix                  # 任何操作系统；拉取预构建的原生二进制文件
brew install esengine/reasonix/reasonix   # macOS

预构建的存档（darwin|linux|windows × amd64|arm64）和 SHA256SUMS 在每个 GitHub 版本发布页面上。

Path B: 桌面应用

使用官方下载页面获取最新的桌面构建。

Windows 安装程序通过 SignPath.io 代码签名，使用 SignPath 基金会提供的免费证书。

Path C: VS Code 扩展

先完成 Path A。扩展不捆绑 CLI；它启动你的本地 reasonix acp 后端，并添加原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话。

VS Code: 从 Visual Studio Marketplace 安装

VSCodium / Eclipse Theia: 从 Open VSX Registry 安装

扩展 ID：SivanLiu.reasonix-agent · 源代码和使用指南

Path D: 从源代码构建

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)

用法

这些命令适用于通过 Path A 安装的 CLI/TUI：

reasonix setup                      # 配置提供商和模型
reasonix                            # 启动交互式会话
reasonix run "implement the TODOs in main.go"

在交互式会话中，当你希望 Reasonix 创建项目说明时，运行 /init。

对于桌面应用，从官方下载页面下载适合你平台的安装程序，安装并启动 Reasonix，然后在应用中配置提供商和模型。上述 CLI 命令对桌面应用不是必需的。

有关高级 CLI 用法和配置，请参阅 CLI 参考、指南和配置路径。

文档

入门：指南 · CLI 参考 · 配置路径 · ACP 编辑器集成

特性与故障排查：Subagent 配置文件 · Context Engine v2 · 能力诊断 · 恢复和更新 · Bot 指南 · 检查点和回退

工程与迁移：规范 · 任务契约与暂停策略 · 工具契约 · 从 0.x 迁移

贡献者

一个小名单，列出了对 Reasonix 影响最大的人 —— 按提交次数排列的当前前 20 名贡献者。完整的贡献者图在 GitHub 上。

同时特别感谢 Bernardxu123 设计了项目徽标，以及 AIGC Link 在小红书上推广了该项目。

许可证与赞助

MIT —— 见 LICENSE。由社区在 esengine/DeepSeek-Reasonix 构建

如果 Reasonix 对你有帮助，你想表达感谢，可以这样做。它只是一杯咖啡，不是合同 —— 捐赠不会购买功能优先级，也不会改变问题的分类方式。

国际版 —— PayPal: paypal.me/yuhuahui