❯ reasonixv1.19

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 能执行哪些命令吗?
可以。配置里的 permissions.allow 是白名单列表,可以精确到具体命令与参数(如 Bash=go test ./...),详见架构页。
怎么接入我自己用的模型?
配置 provider 与 api_key_env,运行任务时用 --model 指定;配置优先级为 flag > ./reasonix.toml > 全局 config.toml > 内置默认。
会话中断了怎么办?
reasonix --continue 继续上次会话;reasonix session status / reasonix session recovery 可查询会话与恢复状态;冲突时可导出诊断 zip 排查。
如何更新?
reasonix upgrade 更新到最新正式版,reasonix upgrade --check 先检查版本。