DeepSeek-Reasonix

English · 简体中文 · Spec · Website · Discord

[!IMPORTANT] Reasonix 1.0 已使用 Go 语言彻底重写 —— 此分支 (main-v2) 为新的默认分支，也是当前主要的开发方向。 早期的 0.x TypeScript 版本现已成为遗留版本，维护于 v1 分支（仅提供维护）。 请查阅 迁移指南。npm i -g reasonix 依然是安装命令 —— 1.0.0 及以上版本提供 Go 二进制文件，而 0.x 是旧版的 TS 构建版本。（请注意：1.0.0 尚未发布到 npm，目前请通过源码构建。）

专为终端设计的 DeepSeek 原生 AI 编程助手。 这是一个由配置和插件驱动的 AI 工具，打包为单一静态 Go 二进制文件。它专门针对 DeepSeek 的前缀缓存（prefix-cache）进行了优化，确保在长时间的开发会话中保持低 Token 成本。

[!IMPORTANT] Community · 加入社区 —— 欢迎加入中英双语 Discord 频道，获取安装帮助 (#help / #求助)、展示工作流以及交流功能建议。

功能特性

• 配置驱动：Provider、Agent、启用的工具以及插件均在 reasonix.toml 中声明，无硬编码模型。
• 多模型与可组合性：内置 DeepSeek (flash/pro) 和 MiMo 预设；任何 OpenAI 兼容的终端均可作为配置条目，无需编写新代码。支持在独立的缓存稳定会话中同时运行两个模型（执行器 + 规划器）。
• 插件驱动：外部工具通过 stdio JSON-RPC（兼容 MCP 标准）作为子进程运行。内置工具在编译时自动注册。
• 零依赖分发：CGO_ENABLED=0 单一二进制文件；一条命令即可交叉编译至六个目标平台。唯一依赖仅为 TOML 解析器。

安装 / 构建

make build      # -> bin/reasonix
make cross      # -> dist/ (darwin|linux|windows × amd64|arm64)

快速开始

reasonix setup                      # 配置向导 → 生成 ./reasonix.toml
export DEEPSEEK_API_KEY=sk-...      # 或将其放入 .env 文件 (参考 .env.example)
reasonix chat                       # 然后运行 /init 以生成 AGENTS.md (项目记忆)
reasonix run "implement the TODOs in main.go"
reasonix run --model mimo-pro "add unit tests for this function"
echo "explain this code" | reasonix run

配置

解析优先级：命令行参数 > ./reasonix.toml > ~/.config/reasonix/config.toml > 内置默认值。密钥通过 api_key_env 从环境变量获取，且永远不会存储在配置文件中。

default_model = "deepseek-flash"   # 执行器；设置 [agent].planner_model 可添加规划器
# language    = "zh"               # UI 语言；留空则自动从 $LANG / $REASONIX_LANG 检测

[agent]
# planner_model = "mimo-pro"          # 可选：低频规划器
# subagent_model = "deepseek-pro"     # 可选：subagent 技能的默认模型
# subagent_models = { review = "deepseek-pro", security_review = "deepseek-pro" }
auto_plan = "ask"                  # off|ask|on；复杂的对话任务会以规划模式启动
# auto_plan_classifier = "deepseek-flash"   # 可选；仅在模糊任务时调用

[[providers]]
name        = "deepseek-flash"
kind        = "openai"
base_url    = "https://api.deepseek.com"
model       = "deepseek-v4-flash"
api_key_env = "DEEPSEEK_API_KEY"
# 同样预设: deepseek-pro, mimo-pro (mimo-v2.5-pro), mimo-flash (mimo-v2-flash) @ api.xiaomimimo.com/v1

[tools]
enabled = []   # 省略或留空 = 启用所有内置工具

[permissions]
mode  = "ask"                                # 当规则不匹配时的写入回退：ask|allow|deny
deny  = ["bash(rm -rf*)", "bash(git push*)"] # 在任何模式下均被硬拦截
allow = ["bash(go test*)"]                   # 从不提示

[sandbox]
# workspace_root = ""          # 文件写入限制区域；留空 = 当前目录
# allow_write    = ["/tmp"]    # write_file/edit_file/multi_edit 可操作的额外目录

[[plugins]]
name    = "example"
command = "reasonix-plugin-example"

权限控制每个工具调用：deny > ask > allow > 回退（读取器总是允许；写入器回退到 mode 设置）。reasonix chat 在执行写入前会进行询问（y 允许一次 · a 本次会话一直允许 · n 不允许）；reasonix run 保持自动执行，但仍会遵守 deny 规则。完整架构和规范请参考 docs/SPEC.md。

权限是“策略”（决定允许还是提示），而 sandbox（沙箱） 是“强制执行”：文件写入器（write_file / edit_file / multi_edit）会拒绝任何超出 [sandbox] workspace_root（默认为当前目录）的路径，并通过解析符号链接和 .. 来防止路径逃逸。读取操作不受限制。在 macOS 上，bash 本身默认被隔离（[sandbox] bash，使用 Seatbelt）：命令仅能写入相同的根目录（以及临时目录和工具链缓存），且仅在设置了 [sandbox] network 时才能访问网络。其他平台目前暂时在无限制状态下运行（详情请参阅 docs/SPEC.md 第 9 节关于逃逸提示和即将支持的 Linux 环境）。

插件 (MCP)

Reasonix 是一个 MCP 客户端。[[plugins]] 部分定义了扩展插件。