esengine / DeepSeek-Reasonix

esengine/DeepSeek-Reasonix

open_in_new前往仓库

为终端打造的DeepSeek原生AI编程代理，围绕前缀缓存稳定性设计，可常驻运行。

项目概览

项目概述

DeepSeek-Reasonix 是一个面向终端的 DeepSeek 原生 AI 编程代理，由 Go 语言编写，以 MIT 许可证开源。项目围绕 DeepSeek 前缀缓存稳定性进行工程设计，旨在提供一个可以长时间持续运行的编码代理。它提供四种接入方式：终端 CLI/TUI、桌面应用、浏览器以及通过 ACP 协议接入编辑器。项目采用单一 Go 二进制文件分发，支持跨平台编译，并可通过 npm、Homebrew 或 GitHub Releases 获取。

核心功能

  • 配置驱动：通过 reasonix.toml 声明式配置 Provider、代理、工具和插件，无硬编码模型。
  • 多模型与可组合：内置 DeepSeek 预设，支持任意 OpenAI 兼容端点；可选双模型（执行器 + 规划器）在独立缓存稳定会话中运行。
  • 插件驱动：支持 MCP 服务器贡献工具、提示词和资源；Extension Protocol v1 侧车可拦截运行时事件、贡献 Provider 和结构化 UI。
  • 缓存感知上下文维护：启动时注入稳定环境摘要，压缩前修剪过期工具输出，内置工具 schema 契约文档化。
  • 零摩擦分发：CGO_ENABLED=0 单二进制，一条命令交叉编译六个目标平台。
  • 计划模式、权限、工作区沙箱和逐轮检查点：支持长时间自主运行的可读性和撤销。
  • 机器人集成：支持飞书、Lark、微信和 QQ 机器人，可在 IM 中触发任务、审批和查看状态。
  • 远程 SSH：支持远程主机上的完整代理运行，包括端口转发和 SFTP 文件访问。

适用与不适用场景

适用场景：

  • 需要长时间运行的自主编码任务，如实现 TODO、修复 bug、跨文件重构。
  • 对 DeepSeek 模型有依赖，并希望利用前缀缓存降低成本和延迟。
  • 需要在终端、桌面、浏览器或编辑器等多种环境中使用同一代理引擎。
  • 需要通过 IM 机器人（飞书、Lark、微信、QQ）远程触发和审批任务。
  • 需要代码回退（rewind）和检查点功能，以安全地撤销编辑。

不适用场景：

  • 需要严格只读模式（计划模式不是只读，Ask 模式批准后仍可执行写操作）。
  • 需要跟踪 bash 副作用（如 rm、数据库写入、部署），这些无法通过 rewind 撤销。
  • 需要嵌入向量语义搜索（项目使用 CodeGraph 符号/调用图，而非嵌入模型）。
  • 需要 Windows 上的 OS 级沙箱（Windows shell 命令无 OS 沙箱）。
  • 需要非 DeepSeek 模型作为唯一后端（虽然支持 OpenAI 兼容端点，但设计围绕 DeepSeek 优化）。

技术架构与依赖

  • 语言：Go 1.25+（CLI 核心），TypeScript（桌面前端，Node 24+ 和 pnpm 10），Wails（桌面壳）。
  • 核心组件：cmd/reasonix（CLI 入口）、internal/agent（代理循环）、internal/cli（TUI）、internal/control（控制器）、internal/config（TOML 配置）、internal/tool/builtin（内置工具）、internal/provider（模型后端抽象）、internal/plugin（MCP 客户端）、internal/event（事件流）、internal/hook（钩子）、internal/memory（记忆）、internal/skill（技能）、internal/sandbox（沙箱）、internal/serve（HTTP/SSE 服务器）、internal/checkpoint（检查点）。
  • 依赖：Go 标准库、tree-sitter（CodeGraph）、bubblewrap（Linux 沙箱）、Wails（桌面）、React（桌面前端）。
  • 协议：ACP v1（Agent Client Protocol）、MCP（Model Context Protocol）、Extension Protocol v2。

安装与快速开始

路径 A：CLI/TUI

npm i -g reasonix                  # 任意 OS；拉取预编译原生二进制
brew install esengine/reasonix/reasonix   # macOS

路径 B：桌面应用

从官方下载页下载对应平台安装包。

路径 C：VS Code 扩展

先完成路径 A，然后从 Visual Studio Marketplace 或 Open VSX Registry 安装扩展 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)

桌面构建需要 Node 24+、pnpm 10 和 Wails CLI。

快速开始

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

典型使用方法

交互式会话

reasonix
reasonix --model deepseek-pro
reasonix --profile delivery --effort high
reasonix --dir /path/to/project

一次性运行与自动化

reasonix -p "summarize this repository"
reasonix run "implement the TODOs in main.go"
reasonix run --auto "implement the TODOs in main.go"
echo "explain this code" | reasonix run

恢复会话

reasonix --continue
reasonix --resume
reasonix --resume <session-id>
reasonix --resume provider-config --copy

权限模式

reasonix --permission-mode plan
reasonix --permission-mode acceptEdits
reasonix run -y "apply the requested changes"
reasonix --allowed-tools "Bash(go test ./...)" --allowed-tools read_file

机器人集成

reasonix bot start --channels qq,feishu,lark,weixin --dir /path/to/project

ACP 编辑器接入

reasonix acp
reasonix acp --model deepseek-pro
reasonix acp --profile delivery

配置与部署要点

  • 配置路径：全局配置位于 ~/.reasonix/config.toml（macOS/Linux）或 %APPDATA%\reasonix\config.toml（Windows）；项目配置为 ./reasonix.toml。可通过 REASONIX_HOME 覆盖。
  • 凭据管理：API 密钥存储在全局 .env 文件中（<Reasonix home>/.env），不写入配置文件。
  • 配置优先级：命令行参数 > 项目 reasonix.toml > 全局 config.toml > 兼容旧配置 > 内置默认值。
  • 沙箱：Linux 使用 bubblewrap，macOS 使用 OS 沙箱，Windows 无 OS 级沙箱。
  • 缓存优化：保持系统提示词和工具 schema 稳定，避免动态数据进入前缀；使用 --profile 切换工作模式会影响缓存前缀。
  • 远程部署：支持 reasonix serve 无头模式，可通过 SSH 远程运行完整代理。
  • 升级：使用 reasonix upgrade 更新 CLI，桌面应用通过官方渠道更新。

限制、风险与许可证

  • 许可证：MIT。
  • 安全风险：代码扩展（Extension Protocol v2）是完全信任的，可绕过沙箱和权限；安装前需完全信任。YOLO 模式跳过普通审批，但硬性 deny 规则仍生效。
  • 功能限制：bash 副作用不可回退；Windows 无 OS 沙箱；非 UTF-8 文件在 ACP 中不适用。
  • 兼容性：ACP v1 兼容，但扩展 Manifest v1 未公开发布，无迁移路径。
  • 依赖风险：依赖第三方 MCP 服务器和扩展，可能引入安全或稳定性问题。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、文档（docs/ 目录）、CHANGELOG.md、CONTRIBUTING.md。
  • 分析时间：2026-08-10（基于最新发布版本 desktop-v1.23.0 的日期）。
  • 注意：仓库资料未提供部分细节，如具体版本历史、完整配置选项列表，建议查阅官方文档。