esengine / DeepSeek-Reasonix
esengine / DeepSeek-Reasonix
A DeepSeek-native AI coding agent for your terminal. A config- and plugin-driven harness — a single static Go binary, tuned around DeepSeek’s prefix cache so token costs stay low across long sessions. 这是一个专为终端设计的 DeepSeek 原生 AI 编程助手。它是一个由配置和插件驱动的工具，以单个静态 Go 二进制文件形式存在，并针对 DeepSeek 的前缀缓存（prefix cache）进行了优化，从而在长会话中保持较低的 Token 成本。
Important Community · 加入社区
Bilingual Discord for setup help (#help / #求助), workflow showcases, and feature ideas. → https://discord.gg/XF78rEME2D 双语 Discord 社区，提供设置帮助（#help / #求助）、工作流展示和功能建议。→ https://discord.gg/XF78rEME2D
Features
Config-driven. Providers, the agent, enabled tools, and plugins are all declared in reasonix.toml. No hardcoded models.
配置驱动。 提供商、代理、启用的工具和插件均在 reasonix.toml 中声明，无硬编码模型。
Multi-model & composable. DeepSeek ships as a preset; any OpenAI-compatible endpoint is a config entry, not new code. Optionally run two models together (executor + planner) in separate, cache-stable sessions. 多模型与可组合性。 DeepSeek 作为预设内置；任何兼容 OpenAI 的端点只需通过配置即可接入，无需编写新代码。支持在独立的缓存稳定会话中同时运行两个模型（执行者 + 规划者）。
Plugin-driven. External tools run as subprocesses over stdio JSON-RPC (MCP-compatible). Built-in tools self-register at compile time. 插件驱动。 外部工具通过 stdio JSON-RPC（兼容 MCP）作为子进程运行。内置工具在编译时自动注册。
Cache-aware context maintenance. Startup injects a small stable environment summary, stale tool output is snipped/pruned before summary compaction, and the built-in tool schema contract is documented for regression review. 缓存感知的上下文维护。 启动时会注入一个简短稳定的环境摘要，过期的工具输出在摘要压缩前会被剪裁/修剪，且内置工具的模式契约（schema contract）已记录在案，便于回归审查。
Zero-friction distribution. CGO_ENABLED=0 single binary; cross-compile to six targets with one command. The only dependency is a TOML parser.
零摩擦分发。 CGO_ENABLED=0 单一二进制文件；一条命令即可交叉编译至六个目标平台。唯一的依赖项是 TOML 解析器。
Install
Choose the path that matches how you want to use Reasonix. The CLI/TUI, desktop app, and VS Code extension all use the same local Reasonix engine. 选择适合你使用习惯的安装路径。CLI/TUI、桌面应用和 VS Code 扩展均使用相同的本地 Reasonix 引擎。
Path A: CLI / TUI
Install the native binary through npm on any supported platform, or use Homebrew on macOS: 通过 npm 在任何支持的平台上安装原生二进制文件，或在 macOS 上使用 Homebrew：
npm i -g reasonix # any OS; pulls the prebuilt native binary
brew install esengine/reasonix/reasonix # macOSPrebuilt archives (darwin|linux|windows × amd64|arm64) and SHA256SUMS are on every GitHub release. 预构建的压缩包（darwin|linux|windows × amd64|arm64）和 SHA256SUMS 可在 GitHub 的每个 Release 中找到。
Path B: Desktop app
Use the official download page for the latest desktop build. 请访问官方下载页面获取最新的桌面版构建。
| Platform | Package | Architecture |
|---|---|---|
| macOS | Universal .dmg or .zip | Apple Silicon / Intel |
| Windows | Installer .exe or portable .zip | x64 / ARM64 |
| Linux | .deb or .tar.gz | x64 |
Windows installers are code-signed through SignPath.io with a free certificate provided by the SignPath Foundation. Windows 安装程序通过 SignPath.io 进行代码签名，证书由 SignPath Foundation 免费提供。
Path C: VS Code extension
Complete Path A first. The extension does not bundle the CLI; it starts your local reasonix acp backend and adds native chat, editor context, tool-call approvals, model selection, and workspace sessions.
请先完成路径 A。该扩展不捆绑 CLI；它会启动你本地的 reasonix acp 后端，并增加原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话功能。
- VS Code: install from Visual Studio Marketplace
- VSCodium / Eclipse Theia: install from Open VSX Registry
- Extension ID:
SivanLiu.reasonix-agent· source and usage guide
Path D: Build from source
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)Quick start
CLI / TUI
These commands are for the CLI/TUI installed through Path A: 以下命令适用于通过路径 A 安装的 CLI/TUI：
reasonix setup # configure a provider and model
reasonix # start an interactive session
reasonix run "implement the TODOs in main.go"In an interactive session, run /init when you want Reasonix to create project instructions.
在交互式会话中，当你希望 Reasonix 创建项目说明时，运行 /init。
Desktop app
Download the installer for your platform from the official download page, install and launch Reasonix, then configure a provider and model in the app. The CLI commands above are not required for the desktop app. 从官方下载页面下载对应平台的安装程序，安装并启动 Reasonix，然后在应用内配置提供商和模型。桌面版无需使用上述 CLI 命令。
For advanced CLI usage and configuration, see the CLI reference, Guide, and configuration paths. 有关高级 CLI 使用和配置，请参阅 CLI 参考、指南和配置路径。
Documentation
- Getting started: Guide · CLI reference · Configuration paths · ACP editor integration
- Features & troubleshooting: Subagent profiles · Context Engine v2 · Capability diagnostics · Recovery and updates · Bot guide · Checkpoints & rewind
- Engineering & migration: Spec · Task contracts & pause policy · Tool contract · Migrating from 0.x
Acknowledgments
A small list of folks whose work has shaped Reasonix the most — the current top 20 contributors by commit count. The full contributor graph is on GitHub. 以下是为 Reasonix 做出最大贡献的部分人员名单（按提交次数排名的前 20 位贡献者）。完整的贡献者图表可在 GitHub 上查看。
Also a separate thank-you to Bernardxu123 for designing the project logo, and to AIGC Link for promoting the project on XiaoHongShu. 此外，特别感谢 Bernardxu123 设计了项目 Logo，感谢 AIGC Link 在小红书上对项目的推广。
Support this project
If Reasonix has been useful and you’d like to say thanks, you can. It stays a coffee, not a contract — donations don’t buy feature priority or change how issues get triaged. 如果 Reasonix 对你有帮助并想表示感谢，欢迎支持。这仅是一杯咖啡的赞助，而非合同——捐赠不会购买功能优先级，也不会改变问题处理的流程。
- International — PayPal: paypal.me/yuhuahui
- 国内 — 微信支付（扫码）