reasonix --help
功能,一条命令一个入口
以下全部能力均来自 reasonix CLI 的真实命令。每个功能都对应一个入口、一组参数,和一份可审查的配置。
01
会话与任务 核心
交互式会话、一次性任务、断点继续,三种方式覆盖从「边聊边改」到「CI 里跑一次」的全部场景。
A
交互式会话
直接运行 reasonix 进入交互模式;用 --continue 接着上次会话继续,--resume 可恢复到指定会话(支持查询式恢复)。
$ reasonix # 新会话
$ reasonix --continue # 继续上次
$ reasonix --resume provider-config # 恢复指定会话
B
一次性任务
reasonix run 跑完整任务;-p/--print 适合管道场景(可输出 text/json/stream-json)。
$ reasonix run "把 main.go 里的 TODO 实现掉"
$ reasonix -p "总结这个仓库" --output-format json
$ echo "解释这段代码" | reasonix run
C
事件流输出
--events-jsonl 输出脱敏的结构化事件,适合接入自己的自动化流水线。
$ reasonix run --events-jsonl "补单元测试" > events.jsonl
02
多模型
模型不是写死的:flag、配置文件、环境变量三层都可以指定,密钥走 api_key_env 注入,不落盘。
$ reasonix run --model mimo-pro "给这个函数补单元测试"
配置密钥通过环境变量注入(如
DEEPSEEK_API_KEY),在 reasonix.toml 里只写 api_key_env 指向的变量名。
03
AI 代码审查
基于本地 diff 的审查,不把代码上传到第三方平台;可指定基准分支或某个提交。
$ reasonix review # 审查当前分支改动
$ reasonix review --base main # 相对 main 的改动
$ reasonix review --commit a1b2c3d # 审查某个提交
04
服务与接入 HTTP+SSE
把 agent 能力暴露成 HTTP+SSE 服务,可选 none / token / password 认证;也支持通过 stdio 提供 Agent Client Protocol。
$ reasonix serve --addr 0.0.0.0:8080 --auth token --token <你的token>
$ reasonix serve --auth password --hash-password # 生成密码哈希
$ reasonix acp # 以 Agent Client Protocol 提供能力
05
MCP 与插件
MCP 服务器统一登记在 reasonix.toml;插件目录即插即用,能力按需组装。
$ reasonix mcp add <name> # 添加 MCP 服务器
$ reasonix mcp list
$ reasonix mcp import .mcp.json
06
子智能体
用 profile 定义隔离子智能体:给它们专属的系统提示与工具白名单,让专精的 agent 干专精的活。
$ reasonix subagent create <name> # 创建 profile
$ reasonix subagent run review "审查当前改动" # 运行子智能体
$ reasonix subagent list
07
IM bot 网关
多渠道 IM bot:一条命令启动、诊断,微信渠道支持扫码登录。
$ reasonix bot start # 启动 bot 网关
$ reasonix bot weixin-login # 微信扫码登录
$ reasonix bot doctor # 诊断 bot 状态
08
隐私与遥测
默认不含内容的 CLI 使用统计,可一键关闭;崩溃报告先审阅、明确同意后才发送;诊断信息全部脱敏。
$ reasonix config telemetry off # 关闭遥测
$ reasonix report list # 审阅待发送的崩溃报告
$ reasonix doctor --json # 脱敏诊断信息
09
常见问题
Reasonix 需要联网才能用吗?
运行 agent 需要模型 API 的访问(通过
api_key_env 注入密钥)。代码审查、诊断等本地能力输出可保持脱敏;遥测可关闭。密钥存在哪里?
密钥不写在
reasonix.toml 里,通过环境变量注入。运行 reasonix setup 会生成 reasonix.toml 与 .env 模板。可以限制 agent 能执行哪些命令吗?
怎么接入我自己用的模型?
配置 provider 与
api_key_env,运行任务时用 --model 指定;配置优先级为 flag > ./reasonix.toml > 全局 config.toml > 内置默认。会话中断了怎么办?
reasonix --continue 继续上次会话;reasonix session status / reasonix session recovery 可查询会话与恢复状态;冲突时可导出诊断 zip 排查。如何更新?
reasonix upgrade 更新到最新正式版,reasonix upgrade --check 先检查版本。