DeepSeek-Reasonix

项目概述

Reasonix 是一款可以长时间无人值守运行的编程智能体（coding agent）。项目以单一 Go 二进制作为本地核心引擎，向外提供四种入口：终端 TUI、桌面应用、浏览器以及通过 ACP（Agent Communication Protocol）接入的编辑器。MIT 开源许可证，核心设计目标是让长时自治任务依然可读、可控、可回退。

引擎在每次回合（turn）之间维护计划模式、权限策略、工作区沙箱以及检查点（checkpoint），使长时间运行既自主又便于事后审查与撤销。

核心特性

• 配置驱动：reasonix.toml 中声明 Provider、智能体、可用工具与插件，模型无需硬编码。
• 多模型可组合：DeepSeek 以预设形式内置；任何兼容 OpenAI 协议的端点只需新增一条配置即可接入。还可同时启用执行者（executor）与规划者（planner）两个模型，分别跑在独立且缓存稳定（cache-stable）的会话中。
• 插件体系：MCP 服务器贡献工具、提示与资源；Extension Protocol v1 的 sidecar 进程可进一步拦截运行时事件、注入 Provider 与结构化 UI，并打包为带版本号的插件分发。
• 缓存感知的上下文维护：启动时注入简洁稳定的环境摘要，摘要压缩前会先对过时工具输出做裁剪/剪枝，内置工具的 schema 契约亦有文档以便回归审阅。
• 零摩擦分发：CGO_ENABLED=0 单二进制，一条命令即可交叉编译到六个目标平台，产物是自包含的静态可执行文件，部署机无需额外运行时依赖。

安装方式

A. CLI / TUI

npm i -g reasonix                          # 任意平台，自动拉取预编译二进制
brew install esengine/reasonix/reasonix   # macOS

预编译压缩包覆盖 darwin | linux | windows × amd64 | arm64，并在每次 GitHub Release 中附带 SHA256SUMS。

B. 桌面应用

前往官方下载页获取安装包：macOS（Universal .dmg/.zip，Apple Silicon 与 Intel）、Windows（.exe 安装包或便携 .zip，x64/ARM64，Windows 安装包由 SignPath Foundation 免费证书完成代码签名）、Linux（.deb 或 .tar.gz，x64）。

C. VS Code 扩展

需先完成 A 路径安装 CLI；扩展本身不内嵌 CLI，而是启动本地的 reasonix acp 后端，并在编辑器内提供原生聊天、编辑器上下文、工具调用审批、模型选择与工作区会话。扩展 ID 为 SivanLiu.reasonix-agent，同时发布于 Visual Studio Marketplace 与 Open VSX Registry。

D. 从源码构建

git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix

make build      # CLI -> bin/reasonix(.exe)
make cross      # 交叉编译 -> dist/

CLI 构建要求 Go 1.25+，模块固定了 toolchain 指令，建议保留 GOTOOLCHAIN=auto 让 Go 自动拉取。桌面构建还需 Node 24+、pnpm 10 与版本文件中指定的 Wails CLI，先执行 make wails-install 再在 desktop/ 目录运行 wails build。

快速上手

reasonix setup                      # 配置 Provider 与模型
reasonix                            # 启动交互会话
reasonix run "implement the TODOs in main.go"

交互会话中可执行 /init 让 Reasonix 生成项目级指令文件。桌面应用安装后直接在应用内配置 Provider 与模型，无需使用 CLI 命令。

文档导航

• 入门：Guide、CLI 参考、配置文件路径、ACP 编辑器集成。
• 特性与排错：子智能体配置、Context Engine v2、能力诊断、恢复与更新、机器人指南、检查点与回退。
• 工程与迁移：规范说明、任务契约与暂停策略、工具契约、从 0.x 版本迁移指南。
• 扩展开发：扩展总览、插件包与 Manifest v1、Extension Protocol 协议、Go SDK 与脚手架。