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 定义提示词与工具白名单,隔离上下文并行干活。