esengine DeepSeek-Reasonix

esengine DeepSeek-Reasonix

English · 简体中文 · Guide · ACP · Extensions · Spec · Website · Discord

一个面向终端、以 DeepSeek 为原生的 AI 编程代理。一个由配置和插件驱动的工具框架——单个静态 Go 二进制文件，围绕 DeepSeek 的前缀缓存进行调优，确保在长会话中保持较低的 token 成本。

重要

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

功能特性

• 配置驱动。 提供商、代理、启用的工具和插件都在 reasonix.toml 中声明。没有硬编码的模型。
• 多模型且可组合。 DeepSeek 作为预设提供；任何兼容 OpenAI 的端点都是一个配置条目，而非新代码。可选地，可以在独立的、缓存稳定的会话中同时运行两个模型（执行者 + 规划者）。
• 插件驱动。 MCP 服务器贡献工具、提示词和资源；扩展协议 v1 侧车还可以拦截运行时事件、贡献提供商和结构化 UI，并发布带版本号的插件包。
• 缓存感知的上下文维护。 启动时注入一个小的稳定环境摘要，过时的工具输出在摘要压缩前会被裁剪/修剪，内置工具模式契约有文档记录，便于回归审查。
• 零摩擦分发。 CGO_ENABLED=0 单个二进制文件；一条命令即可交叉编译到六个目标平台。唯一依赖是一个 TOML 解析器。

安装

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

路径 A：CLI / TUI

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

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

预构建归档（darwin|linux|windows × amd64|arm64）和 SHA256SUMS 在每个 GitHub 发布版本中都有。

路径 B：桌面应用

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

| 平台 | 包格式 | 架构 | |------|--------|------| | macOS | 通用 .dmg 或 .zip | Apple Silicon / Intel | | Windows | 安装程序 .exe 或便携版 .zip | x64 / ARM64 | | Linux | .deb 或 .tar.gz | x64 |

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

路径 C：VS Code 扩展

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

• VS Code： 从 Visual Studio Marketplace 安装
• VSCodium / Eclipse Theia： 从 Open VSX Registry 安装
• 扩展 ID： SivanLiu.reasonix-agent · 源代码和使用指南

路径 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)

快速开始

CLI / TUI

以下命令适用于通过路径 A 安装的 CLI/TUI：

reasonix setup # 配置提供商和模型
reasonix # 启动交互式会话
reasonix run "实现 main.go 中的 TODO"

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

桌面应用

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

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

文档

• 入门： Guide · CLI reference · Configuration paths · ACP editor integration
• 功能与故障排除： Subagent profiles · Context Engine v2 · Capability diagnostics · Recovery and updates · Bot guide · Checkpoints & rewind
• 工程与迁移： Spec · Task contracts & pause policy · Tool contract · Migrating from 0.x
• 扩展开发： Extensions · Plugin packages and Manifest v1 · Extension Protocol · Go SDK and starter

Star 历史

致谢

以下是一小部分对 Reasonix 影响最大的人员名单——按提交数排名的当前前 20 位贡献者。完整的贡献者图表在 GitHub 上。

| 贡献者 | 贡献者 | 贡献者 | 贡献者 | |--------|--------|--------|--------| | SivanCola | esengine | ttmouse | lifu963 | | reasonix (匿名) | HUQIANTAO | GTC2080 | light-front-theory | | merge-order-check (匿名) | Li-Charles-One | eghrhegpe | wufengfan (匿名) | | CVEngineer66 | dependabot[bot] | lanshi17 | SuMuxi66 | | CnsMaple | cyq1017 | JesonChou | XTLine |

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

许可证

MIT — 参见 LICENSE

由社区在 esengine/DeepSeek-Reasonix 构建

支持本项目

如果 Reasonix 对你有用，而你想表达感谢，你可以这样做。这只是一杯咖啡，而非一份契约——捐赠不会购买功能优先级，也不会改变问题被处理的方式。

• 国际： PayPal: paypal.me/yuhuahui
• 国内： 微信支付（扫码）