DeepSeek-Reasonix

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

一个 DeepSeek 原生的 AI 编程 agent（智能体），运行在你的终端中。

一个配置与插件驱动的框架——单个静态 Go 二进制文件，围绕 DeepSeek 的 prefix cache（前缀缓存）调优，在长会话中保持较低的 token 成本。

[!IMPORTANT] Community · 加入社区 — 双语 Discord，提供安装帮助（#help / #求助）、工作流展示和功能创意交流。→ https://discord.gg/XF78rEME2D

特性

• 配置驱动。 Provider、agent、启用的工具和插件都在 reasonix.toml 中声明，没有硬编码的模型。
• 多模型与可组合。 DeepSeek 作为预设内置；任何 OpenAI 兼容的 endpoint 都只是配置文件中的一项，无需编写新代码。可选地，在独立且缓存稳定的 session 中同时运行两个模型（执行者 + 规划者）。
• 插件驱动。 外部工具作为子进程通过 stdio JSON-RPC（MCP 兼容）运行。内置工具在编译时自动注册。
• 感知缓存的上下文维护。 启动时注入一份小而稳定的环境摘要；在摘要压缩前对过时的工具输出进行裁剪/精简；内置工具的模式契约有文档说明，便于回归审查。
• 零摩擦分发。 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 release 中均有提供。

路径 B：桌面应用

使用官方下载页面获取最新桌面版。

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

Windows 安装程序通过 SignPath.io 进行代码签名，证书由 SignPath Foundation 免费提供。

路径 C：VS Code 扩展

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

• 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                      # 配置 provider 和模型
reasonix                            # 启动交互式会话
reasonix run "implement the TODOs in main.go"

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

桌面应用

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

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

文档

• 入门： 指南 · CLI 参考 · 配置路径 · ACP 编辑器集成
• 特性与故障排查： Subagent 配置 · Context Engine v2 · 能力诊断 · 恢复与更新 · Bot 指南 · 检查点与回退
• 工程与迁移： 规范 · 任务契约与暂停策略 · 工具契约 · 从 0.x 迁移

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 设计项目 Logo，以及 AIGC Link 在小红书上推广该项目。

---

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

---

支持本项目

如果 Reasonix 对你有帮助，而你愿意表达感谢，你可以这样做。它是一杯咖啡的心意，而不是一份契约——捐赠不会换取功能优先级，也不会改变问题的处理方式。

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