DeepSeek-Reasonix:一个能挂在终端长期运行的编码 Agent
esengine/DeepSeek-Reasonix 是一个面向终端的 AI 编码代理,在 GitHub 上累计获得 35.2k star、2.3k fork,以 MIT 协议开源,最新桌面版为 Reasonix Desktop v1.31.4(2026 年 8 月 25 日发布)。它的定位可以用一句话概括:一个能放着跑的编码 Agent——用单个 Go 二进制启动,同一个本地引擎提供终端、桌面应用、浏览器、编辑器四种入口,目标机器上除这个二进制外无需再装任何东西。
定位:单引擎,四个入口
项目把终端命令行工具、桌面应用、VS Code 插件和浏览器入口统一到一个本地 Reasonix 引擎之上。对使用者来说,同一套 agent 行为可以在不同界面之间切换,不必为每个入口单独维护一套配置。
设计:配置驱动,模型与插件不写死在代码里
provider、agent、启用的工具和插件全部在 reasonix.toml 里声明,不硬编码模型。仓库面向的核心是 DeepSeek 系列模型,出厂即提供 DeepSeek 预设;任意 OpenAI 兼容端点只是一条配置项,无需改动代码。它还支持同时运行两个模型(executor 执行者 + planner 规划者),放在各自独立、缓存稳定的会话里。
长跑:让自治运行可读、可撤销
针对长时间自主运行,项目做了几项机制:
- 权限控制与 workspace 沙箱:agent 的操作被限制在可审计的边界内;
- 每轮 checkpoint:每一轮执行都留有检查点,可以随时回看与撤销;
- cache-aware 上下文维护:启动时注入稳定的环境摘要,过期的工具输出在摘要压缩前会被裁剪,工具的 schema 契约有文档可查。
扩展:MCP 与插件协议
MCP server 可以为 agent 提供工具、提示词与资源;Extension Protocol v1 的 sidecar 还能拦截运行时事件、贡献 provider 与结构化 UI,并发布带版本号的插件包。
分发与安装
项目强调零摩擦分发:通过 CGO_ENABLED=0 编译成单个静态二进制,一条命令交叉编译六种平台目标(darwin / linux / windows 与 amd64 / arm64 的组合)。安装路径有四条:
- CLI/TUI:
npm i -g reasonix,macOS 也可用 Homebrewbrew install esengine/reasonix/reasonix; - 桌面应用:从官网下载页获取 macOS / Windows / Linux 安装包,Windows 安装包经 SignPath 免费证书签名;
- VS Code 扩展:扩展 ID 为
SivanLiu.reasonix-agent,不内置 CLI,而是启动本地后端并提供原生聊天、编辑上下文、工具审批、模型选择与会话; - 源码构建:CLI 需要 Go 1.25+,桌面端还需 Node 24+、pnpm 10 与 Wails CLI。
基本用法是 reasonix setup 配置 provider 与模型,reasonix 进入交互会话,reasonix run 直接执行任务;在交互会话里输入 /init 会生成项目说明。
结论
DeepSeek-Reasonix 的价值集中在两点:一是把 agent 从「一次性命令」变成「可以长期挂着跑」的持久进程,靠沙箱、权限与 checkpoint 保证可撤销;二是用单二进制和配置驱动把部署成本压到最低,DeepSeek 模型开箱即用,切换其他 OpenAI 兼容端点也无需改代码。如果需要一个能在本机长时间运行、可以随时查看和回滚的编码 agent,这是一个值得试用的选项。