产品与定位
Reasonix（仓库名仍为 esengine/DeepSeek-Reasonix）是一个「可以一直开着不管」的编码 Agent：一个本地引擎，四种进入方式 —— 终端（CLI/TUI）、桌面应用、浏览器、以及通过 ACP 接入的编辑器。
它最初的差异化是围绕 DeepSeek 自动前缀缓存做架构设计：系统提示词前缀在会话中保持字节级稳定，缓存命中率极高，从而把长会话的成本压下来。这个「Cache-First」思路至今仍是它的设计底色，但今天的 Reasonix 已经扩展成一个完整的多入口 Agent 运行时：DeepSeek 只是内置预设之一，任何 OpenAI 兼容端点都只是一个配置项。
功能速览
| 功能 | 说明 |
|---|---|
| 配置驱动 | 供应商、Agent、启用工具、插件全部声明在 reasonix.toml，无硬编码模型 |
| 双模型协同 | 可选 executor + planner 两模型协同，运行在各自缓存稳定的独立会话中 |
| 缓存感知上下文 | 启动注入精简稳定的环境摘要，陈旧工具输出先裁剪再压缩，保住前缀缓存 |
| MCP 与插件 | MCP 服务器贡献工具/prompt/资源；Extension Protocol v1 侧车可拦截运行时事件 |
| 四种入口 | 终端 TUI、桌面应用、浏览器、编辑器（ACP）共用同一引擎 |
| 计划与权限 | plan mode、权限系统、workspace 沙箱、每轮 checkpoint，长任务可读可回滚 |
| 零依赖分发 | CGO_ENABLED=0 单个静态二进制，一条命令交叉编译六个目标平台 |
| 编辑器集成 | VS Code / VSCodium 扩展，ID SivanLiu.reasonix-agent |
| 子智能体 | 内置 explore / research / review / security-review 等 profile |
| 本地 Web UI | reasonix serve 可在浏览器中操作，支持 --auth token 鉴权 |
常用命令
| 命令 | 作用 |
|---|---|
reasonix setup | 配置供应商与模型 |
reasonix | 启动交互式会话 |
reasonix run "任务" | 非交互执行一个任务 |
/init | 让 Reasonix 生成项目指令文件 |
reasonix acp | 以 ACP 协议接入编辑器后端 |
调用与兼容性
# 任意平台（npm 拉取预编译原生二进制）
npm i -g reasonix
# macOS
brew install esengine/reasonix/reasonix
# 从源码构建（需要 Go 1.26+，保持 GOTOOLCHAIN=auto）
make build # -> bin/reasonix(.exe)
make cross # -> dist/（darwin|linux|windows × amd64|arm64）桌面端另有独立安装包（macOS .dmg/.zip、Windows .exe/.zip、Linux .deb/.tar.gz），Windows 安装包通过 SignPath.io 做了代码签名。每个 GitHub Release 都附带 darwin|linux|windows × amd64|arm64 预编译包与 SHA256SUMS。
版本与更新注意
- MIT 许可，仓库约 35,676 stars、2,417 forks（截至 2026-09-22），最近提交 2026-09-22，维护非常活跃。
- 版本号需注意区分：当前 Release 标签为
desktop-v1.38.11（桌面端，2026-09-20 发布），npm 包reasonix的版本同为 1.38.11 —— CLI 与桌面端共用同一版本号，但 Release 标签带desktop-前缀。GitHub 侧总计约 1,886 个 open issues，issue 量较大但开发持续。 - 命名已简化：项目对外使用 Reasonix，官网
reasonix.io；仓库名仍保留DeepSeek-Reasonix，仓库 description 也仍写「DeepSeek-native」。但实际它并非 DeepSeek 专属 —— DeepSeek 只是内置预设，任何 OpenAI 兼容端点都只是一条配置。早期资料中「DeepSeek 独占」的描述已过时。 - 默认分支是
main-v2（不是main），v2 与旧 0.x 差异较大，从旧版本升级请先读docs/MIGRATING.md。 - Windows 沙箱已退役：v1.38.11 更新日志明确说明 Windows 侧不再强制执行操作系统级沙箱；需要强隔离请用其他平台或自行容器化。
- 桌面端从源码构建需要额外准备 Node 24+ 与 pnpm 10。
- 仓库主语言为 Go（CLI 内核），桌面端为 Electron + TypeScript。
- 默认配置解析优先级：命令行标志 > 项目
./reasonix.toml> 用户配置文件 > 内置默认值。 - 社区以中文开发者为主，Discord 提供
#help/#求助双语频道；国内文档与讨论资料相对丰富。
选型建议
- 需要长时间自主运行且要能事后审阅、回滚 → 每轮 checkpoint + workspace 沙箱是这个场景的刚需。
- DeepSeek 重度用户、会话很长 → 前缀缓存友好的设计能显著压低成本。
- 想要一份配置、多种入口统一体验 → 终端/桌面/浏览器/编辑器共用同一引擎。
- 需要 Go 单体二进制、部署环境不能装 Node 或 Python →
CGO_ENABLED=0静态二进制最省事。 - 只需要在终端里快速改几个文件、不需要桌面端与沙箱 → Claude Code 或 OpenCode 更轻。