❯ reasonixv1.19

reasonix doctor --json

架构:配置驱动,拒绝黑盒

Reasonix 的行为由四层配置、一份白名单权限和可审计的事件输出决定。你随时可以看清它「为什么这么做」。

01

配置优先级

同一项配置,永远有一个确定的赢家。从上到下优先级递减。

P1 命令行 flag --model / --permission-mode / --effort …
▼ 覆盖
P2 ./reasonix.toml 项目级配置,随仓库走
▼ 覆盖
P3 ~/.config/reasonix/config.toml 全局用户配置
▼ 覆盖
P4 内置默认值 开箱即用的底线
密钥密钥从不写入配置文件本体——通过 api_key_env 指向的环境变量注入(如 DEEPSEEK_API_KEY)。reasonix setup 会生成 .env 模板。
02

权限模型

agent 能执行什么,由 permissions.allow 白名单决定。可以精确到具体命令与参数,而不是粗粒度的「允许所有 Bash」。

# reasonix.toml 示例 [permissions] allow = [ "Edit", # 允许修改文件 "Bash=go test ./...", # 只允许这一条 Bash "Bash=git status && git diff", # 精确到命令组合 "fleet", # 允许并行子任务 ]

运行时还可以用 --permission-mode 调整本次会话的权限策略,用 --allowed-tools 临时收紧工具集。

03

目录结构

Reasonix 的工作目录(~/.reasonix/)里每一块都职责单一,状态与配置分离。

~/.reasonix/
├── config.toml          # 全局配置(P3)
├── bot/                 # IM bot 网关状态
├── logs/                # 运行日志
├── mcp-state/           # MCP 服务器运行时状态
├── plugins/             # 插件即插即用
├── projects/            # 各项目的会话与记忆
├── skills/              # 技能 playbook
├── state/               # 会话状态
├── stats/               # 使用统计
└── plugin-packages.json  # 已安装插件包清单
04

输出与事件

同样的任务,输出可以是给人看的文本、给机器吃的 JSON,或一条脱敏事件流。

输出格式用途
--output-format text 人类可读的终端输出(默认)
--output-format json 结构化结果,供脚本/jq 消费
--output-format stream-json 流式 JSON,适合长任务实时接入
run --events-jsonl 脱敏结构化事件逐行输出,可灌入自己的流水线
05

扩展:MCP、插件、子智能体

三种扩展方式各有分工:MCP 接外部工具服务器,插件目录加本地能力,子智能体 profile 定义隔离的执行者。

reasonix mcp add

MCP 服务器

统一登记在 reasonix.toml,可 import 标准 .mcp.json。

plugins/

插件

插件目录即插即用,能力按需组装;plugin-packages.json 记录已装包。

subagent run

子智能体

独立 profile 定义提示词与工具白名单,隔离上下文并行干活。