## 项目概述 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** ```sh npm i -g reasonix # 任意 OS；拉取预编译原生二进制 brew install esengine/reasonix/reasonix # macOS ``` **路径 B：桌面应用** 从[官方下载页](https://reasonix.io/?download=desktop#start)下载对应平台安装包。 **路径 C：VS Code 扩展** 先完成路径 A，然后从 Visual Studio Marketplace 或 Open VSX Registry 安装扩展 `SivanLiu.reasonix-agent`。 **路径 D：从源码构建** ```sh 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。 **快速开始** ```sh reasonix setup # 配置 provider 和模型 reasonix # 启动交互式会话 reasonix run "implement the TODOs in main.go" ``` ## 典型使用方法 **交互式会话** ```sh reasonix reasonix --model deepseek-pro reasonix --profile delivery --effort high reasonix --dir /path/to/project ``` **一次性运行与自动化** ```sh 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 ``` **恢复会话** ```sh reasonix --continue reasonix --resume reasonix --resume reasonix --resume provider-config --copy ``` **权限模式** ```sh 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 ``` **机器人集成** ```sh reasonix bot start --channels qq,feishu,lark,weixin --dir /path/to/project ``` **ACP 编辑器接入** ```sh 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` 文件中（`/.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 仓库： - 官方网站： - npm 包： - Discord 社区： - VS Code 扩展： - 发布页面： ## 信息来源和分析时间 - 信息来源：GitHub 仓库 README、文档（docs/ 目录）、CHANGELOG.md、CONTRIBUTING.md。 - 分析时间：2026-08-10（基于最新发布版本 desktop-v1.23.0 的日期）。 - 注意：仓库资料未提供部分细节，如具体版本历史、完整配置选项列表，建议查阅官方文档。