# DeepSeek-Reasonix **Repository Path**: psdnfu/DeepSeek-Reasonix ## Basic Information - **Project Name**: DeepSeek-Reasonix - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main-v2 - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-04 - **Last Updated**: 2026-06-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

English · 简体中文 · 规格 · 官方网站 · Discord

> [!IMPORTANT] > **Reasonix 1.0 是用 Go 从零重写的版本** —— 本分支(`main-v2`)已是新的默认分支,后续开发都在这里。 > 早期的 `0.x` TypeScript 版本转为 **legacy**,保留在 [`v1`](https://github.com/esengine/DeepSeek-Reasonix/tree/v1) 分支(仅维护)。 > 详见**[迁移指南](./docs/MIGRATING.md)**。`npm i -g reasonix` 仍是安装命令——`1.0.0`+ 装的是 Go 二进制,`0.x` 是 legacy TS 版。

面向终端的 DeepSeek 原生 AI coding agent。

由配置与插件驱动的极薄 harness——单一静态 Go 二进制，围绕 DeepSeek 的前缀缓存调优，长会话也能把 token 成本压低。

> [!IMPORTANT] > **加入社区 · Community** — 双语 Discord，提供安装答疑（`#help` / `#求助`）、工作流展示与功能想法。→ **** ## 特性 - **配置驱动**：provider、agent、启用的工具、插件全部在 `reasonix.toml` 中声明，内核无硬编码模型。 - **多模型 · 可组合**：DeepSeek（flash/pro）与 MiMo 作为预设内置；任何 OpenAI 兼容端点都只是一条配置。可选让两个模型协同（执行器 + 规划器），各自独立、缓存稳定的 session。 - **插件驱动**：外部工具以子进程形式运行，通过 stdio JSON-RPC 通信（MCP 兼容）；内置工具在编译期自注册。 - **零摩擦分发**：`CGO_ENABLED=0` 单二进制；一条命令交叉编译到六个目标平台。唯一依赖是一个 TOML 解析库。 ## 安装 ```sh npm i -g reasonix # 任意系统;自动拉取对应平台的原生二进制 brew install esengine/reasonix/reasonix # macOS ``` 预编译归档(`darwin|linux|windows × amd64|arm64`)和 `SHA256SUMS` 见每个 [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases)。 ### 代码签名 Windows 构建使用 [SignPath 基金会](https://signpath.org/) 提供的免费代码签名证书, 通过 [SignPath.io](https://signpath.io/) 完成签名。 ### 从源码构建 ```sh make build # -> bin/reasonix(.exe) make cross # -> dist/（darwin|linux|windows × amd64|arm64） ``` ## 快速开始 ```sh reasonix setup # 配置向导 → ./reasonix.toml export DEEPSEEK_API_KEY=sk-... # 或写入 .env（见 .env.example） reasonix chat # 然后在会话里运行 /init 生成 AGENTS.md（项目记忆） reasonix run "把 main.go 里的 TODO 实现掉" reasonix run --model mimo-pro "给这个函数补单元测试" echo "解释这段代码" | reasonix run ``` ## 配置优先级：**flag > `./reasonix.toml` > `~/.config/reasonix/config.toml` > 内置默认值**。密钥经环境变量通过 `api_key_env` 注入，绝不写入配置文件。 ```toml default_model = "deepseek-flash" # 执行器；设 [agent].planner_model 可加规划器 # language = "zh" # 界面语言；为空则按 $LANG / $REASONIX_LANG 自动检测 [agent] max_steps = 0 # 执行器工具调用轮数；0 表示不限 planner_max_steps = 12 # 规划器只读工具调用轮数；0 表示不限 # planner_model = "mimo-pro" # 可选的低频规划器 # subagent_model = "deepseek-pro" # runAs=subagent skill 的默认模型 # subagent_models = { review = "deepseek-pro", security_review = "deepseek-pro" } auto_plan = "off" # off|on；off 表示计划模式仅手动开启 # 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 = [] # 省略/为空 = 全部内置工具 bash_timeout_seconds = 120 # 前台安全上限；设为 0 表示不设工具层超时 [skills] # paths = ["~/my-skills", "../shared/skills"] # 额外的自定义技能目录 # excluded_paths = ["~/.agents/skills"] # 隐藏约定来源，不删除目录 # disabled_skills = ["review"] # 隐藏技能，直到 /skill enable [permissions] mode = "ask" # 无规则命中时 writer 的兜底：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` > 兜底。Bash 和文件修改都要审核；只读工具一般不需要。审核规则不是按“按钮文案”存，而是按权限规则匹配，比如 `Bash(npm run build)`、`Bash(npm run test:*)`、`Edit(docs/**)` 这种形式。 `reasonix chat` 会在 writer 调用前征求同意（普通工具为 `1` 本次 · `2` 本会话允许此范围 · `3` 总是允许此范围（保存） · `4` 拒绝；Bash 可额外选择命令前缀授权）；其中 Bash 默认按具体命令记，也可按安全推导出的命令前缀记（如 `Bash(go test:*)`）；文件编辑类工具的本会话授权按编辑能力记，持久授权则写入 `Edit()` 文件路径规则； `reasonix run` 保持自主运行但仍然遵守 `deny`。完整 schema 与契约见 [`docs/SPEC.md`](docs/SPEC.md)。权限是**策略**（哪些调用放行/询问），**沙盒**是**强制**：文件写工具（`write_file` / `edit_file` / `multi_edit`）拒绝 `[sandbox] workspace_root` 之外的任何路径（默认当前目录，编辑不出项目），并解析符号链接与 `..`，使链接无法打洞越界。读不受限。`bash` 本身在 macOS 默认进沙盒（`[sandbox] bash`，Seatbelt）：命令只能写这些 root（外加临时目录与工具链缓存），`[sandbox] network` 为真时才能联网；其它平台暂回退为不沙盒运行（越界问一次与 Linux 支持见 `docs/SPEC.md` §9）。 ### 插件（MCP） Reasonix 是一个 MCP 客户端。`[[plugins]]` 的 `type` 选择传输：`stdio`（默认）启动本地子进程（`command`/`args`/`env`）；`http`（Streamable HTTP）连接远程 `url`，可带静态 `headers`（`${VAR}` / `${VAR:-default}` 从环境展开，密钥不入文件）。工具以 `mcp____` 暴露给模型，与 Claude Code 一致；声明 MCP `readOnlyHint: true` 的工具会参与并行调度并命中权限层的只读默认放行。服务器的 **prompts** 会暴露成 `/mcp____` 斜杠命令（命令后空格分隔参数）；**resources** 通过在消息里写 `@:` 拉入；`/mcp` 列出已连接服务器及各自暴露的内容。`make build` 还会产出 `bin/reasonix-plugin-example`——一个可直接运行的 stdio 参考实现（`echo`、`wordcount`、一个 `review` prompt、一个 style-guide 资源），可照抄。 ```toml [[plugins]] # 本地 stdio 服务器 name = "example" command = "reasonix-plugin-example" [[plugins]] # 远程 Streamable HTTP 服务器 name = "stripe" type = "http" url = "https://mcp.stripe.com" headers = { Authorization = "Bearer ${STRIPE_KEY}" } ``` **已有 Claude Code 的 `.mcp.json`？** 直接放到项目根目录，Reasonix 会原样读取——其 `mcpServers` 规范（`command`/`args`/`env`、`type`/`url`/`headers`、`${VAR}` 展开）与 `[[plugins]]` 字段一一对应。两处来源会合并加载；同名时以 `reasonix.toml` 为准。 ```json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"] }, "stripe": { "type": "http", "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer ${STRIPE_KEY}" } } } } ``` **从 `0.x` 升级？** 旧的 `~/.reasonix/config.json` 仍会被读取(读其 `mcpServers`、并遵从 `mcpDisabled`),作为最低优先级来源——所以 MCP 服务器照常可用;方便时再把它们挪进 `reasonix.toml` 的 `[[plugins]]` 或 `.mcp.json`。 ### 斜杠命令 `reasonix chat` 里,内置命令(`/compact`、`/new`、`/clear`、`/rewind`、`/tree`、`/branch`、`/switch`、`/todo`、`/model`、`/effort`、`/mcp`、`/help`)在本地执行。 `/new` 会开启新会话,同时保存之前的 transcript 供历史记录和恢复使用;`/clear` 会二次确认,确认后丢弃当前上下文且不保存。 `/tree` 查看已保存的对话分支,`/branch [name]` 从当前对话末端分支,`/branch [name]` 从较早的 checkpoint 轮次分支,`/switch ` 切换到另一个分支。**自定义命令** 是放在 `.reasonix/commands/`(项目)或 `~/.config/reasonix/commands/`(用户)下的 Markdown 文件—— `review.md` 即 `/review`,子目录构成命名空间(`git/commit.md` → `/git:commit`)。文件正文是 prompt 模板,调用即作为一轮对话发出。 ```markdown --- description: Review the staged diff argument-hint: [focus-area] --- Review the staged diff. Focus on $ARGUMENTS, list bugs with file:line. ``` `$ARGUMENTS` 展开为全部空格分隔参数,`$1`…`$N` 为位置参数。MCP prompts 也以 `/mcp____` 形式出现在这里。 ### @ 引用在消息里写 `@` 引用,Reasonix 会在发送前解析成带标签的上下文块:`@path/to/file`(或 `@dir`)注入本地文件内容(或目录清单),`@:` 注入 MCP 资源。本地路径**只有真实存在**时才当作引用,普通 `@mention` 保持原文。敲 `/` 或 `@` 会弹出补全菜单——斜杠命令,或**逐层**的文件导航(一次只列当前一层目录、可下钻进子目录)外加 MCP 资源。 ### 双模型协同（可选） `reasonix setup` 刻意保持首次体验极简：选 provider → 输入 key（所选 provider 的所有 SKU 都会启用）。若要让两个模型协同（执行器 + 规划器，各自独立、缓存稳定的 session），向导后手动在 `reasonix.toml` 加一行即可： ```toml [agent] planner_model = "deepseek-pro" # 作为低频规划器 planner_max_steps = 12 # 暂停前允许的只读工具调用轮数 ``` Planner 会看到已加载的 `REASONIX.md` / `AGENTS.md` 记忆，并拿到一小组只读研究工具，因此可以先检查相关文件再把计划交给执行器。写入类和流程类工具仍只给执行器使用。 `max_steps` 限制执行器；`planner_max_steps` 只限制规划器，两者都可设为 `0` 表示不限。个人偏好的轮数上限建议放在用户级配置。只有当某个仓库确实需要团队共享覆盖时，再写进项目的 `./reasonix.toml`，例如超大代码库需要更高的 planner 上限。 Subagent skills 默认继承执行器模型。设置 `subagent_model` 可让它们统一走另一个已配置模型；设置 `subagent_models` 则只覆盖 `review`、`security_review` 等指定 skill。交互式前端中，计划模式默认手动开启。设置 `agent.auto_plan = "on"` 后，看起来复杂的任务会自动进入 plan mode：Reasonix 先只读生成计划，待用户批准后才编辑文件或执行有副作用的命令。`auto_plan_classifier` 可以指定便宜的 provider，例如 `deepseek-flash`；它只在边界输入上调用，分类失败会回退到启发式规则。也可以用 `reasonix chat` 里的 `/auto-plan off|on` 修改用户级设置，或在 shell/脚本里用 `reasonix config auto-plan off|on`。只有明确想写项目级覆盖时，才给 shell 命令加 `--local`。 ## 架构三层可扩展性，全部藏在内核按名解析的 registry 之后： 1. **Registry**：`Provider` 与 `Tool` 是接口；内核没有 `switch model`。 2. **编译期内置**：provider（`provider/openai`）和 tool（`tool/builtin`）通过 `init()` 自注册，`main` 用 blank import 拉入。新增内置 = 一个文件 + 一行 import。 3. **运行时插件**：配置里声明的可执行文件，通过 stdin/stdout 上的 newline-delimited JSON-RPC 2.0（MCP stdio 约定）通信，每个远程 tool 适配成 `Tool` 接口。 ## 状态已完成：基于 registry 的 provider/tool、OpenAI 兼容流式 + 工具调用（429/5xx 有界重试）、九个内置工具（read_file、write_file、edit_file、multi_edit、bash、ls、glob、 grep、web_fetch）、TOML 配置、交互式 `reasonix setup` 向导、双模型协同（执行器 + 规划器，各自独立、缓存稳定的 session）、低频上下文压缩、子 agent（`task`）、bubbletea 聊天 TUI（markdown、plan mode、上下文仪表盘、`/compact` `/new` `/tree` `/branch` `/switch`）、会话持久化 + 恢复、逐次调用**权限**（allow/ask/deny 规则；chat 在 writer 前询问，deny 在各模式硬阻断）、 **工作区沙盒**（把文件写工具限制在项目内，符号链接/`..` 安全）、 MCP 客户端——**stdio + Streamable HTTP** 传输、工具（`mcp__server__tool`,支持 `readOnlyHint`）、prompts（斜杠命令）、resources（`@` 引用）、`/mcp`，可经 `[[plugins]]` 或 Claude 风格的项目 `.mcp.json` 配置——自定义斜杠命令（`.reasonix/commands/*.md`）、`@file` / `@resource` 引用、外加可运行的参考插件（`cmd/reasonix-plugin-example`）、harness 主循环、CLI。chat 在终端普通缓冲区运行(原生 scrollback)并带 `/` 与 `@` 输入补全。后续:给 `bash` 套 OS 级沙盒（macOS Seatbelt / Linux bubblewrap，"盒子里放行、边界上询问"）、Anthropic 原生 provider、MCP OAuth + legacy SSE。见 `docs/SPEC.md` §9。
## Star 趋势

## 支持本项目如果 Reasonix 帮你省了时间或 token，欢迎请杯咖啡。捐助不会换来 feature 优先级，也不会影响 issue 的处理顺序——就是「谢谢」。 - **国内** — 微信支付（扫下方二维码） - **海外** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)

微信支付收款码

## 致谢下面这些朋友的工作塑造了 Reasonix 今天的样子 —— 综合 commit 数和代码量两个维度。 **按字母顺序排列，排名不分先后。** 完整贡献者列表在 [GitHub](https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors)。 - [**ctharvey**](https://github.com/ctharvey) - [**dimasd-angga**](https://github.com/dimasd-angga)（Dimas D. Angga） - [**Evan-Pycraft**](https://github.com/Evan-Pycraft) - [**ForeverYoungPp**](https://github.com/ForeverYoungPp) - [**GTC2080**](https://github.com/GTC2080)（TaoMu） - [**kabaka9527**](https://github.com/kabaka9527) - [**lisniuse**](https://github.com/lisniuse)（Richie） - [**wade19990814-hue**](https://github.com/wade19990814-hue) - [**wviana**](https://github.com/wviana)（Wesley Viana）另外特别感谢 [**Bernardxu123**](https://github.com/Bernardxu123) 设计的项目 logo，以及 [AIGC Link](https://xhslink.com/m/80ngts127cA) 在小红书上的推广。

---

_{MIT —— 见 LICENSE}
_{由 esengine/DeepSeek-Reasonix 社区共建}