交互模式

入口页只负责交互入口；REPL 指令、状态切换和输入约束继续看这里。重点是讲清进入 REPL 之后能做什么、怎么切状态、哪些输入适合留在交互模式里。 --agent 不属于 REPL 状态；它是独立的订阅模式，另见 订阅模式。

先判断是不是这页的范围

你要连续试多个目标，并在同一会话里来回切 chat / fast / plan / xtra：看这里
你要查 /help /model /apikey /attach /quit 这些 REPL 指令：看这里
你要理解 --agent 的订阅链路：这页不展开，直接看 订阅模式
你要理解单次命令行入口和 --code 批跑，不要先从交互模式文档开始
你只是偶尔跑一条命令，不一定需要先读这页

怎么读这页

先看“启动与提示”和“四种状态”，建立 REPL 的基本运行心智
再看指令索引，确认切换状态、更新模型和退出的方式
最后看输入约束，判断什么时候继续留在 REPL，什么时候该切回 --code

启动与提示

mind 进入循环后，会持续读取用户输入，并在 CHAT / FAST / PLAN / XTRA 四种互斥状态之间切换执行。

顶部 banner 会随模式变化：Chat / Fast / Plan / Xtra
每轮输入提示：ready 输入目标或 /help
mind_loop() 会为一次会话生成 cid / sid，用于链路追踪与调用元数据

一句话理解：

REPL 是连续交互入口
真正决定执行行为的是 CHAT / FAST / PLAN / XTRA 四种状态

指令索引

/help, /h：指令索引
/license, /lic：授权许可信息
/quit, /q, quit, exit：安全退出
/model <name>：切换推理引擎
/apikey <key>：更新访问凭证
/attach <path|dir|glob>：添加本轮待发送附件
/attachments：查看当前待发送附件
/detach <index|path>：移除一个待发送附件
/attach-clear：清空当前待发送附件
/chat：切到 CHAT
/fast：切到 FAST
/plan：切到 PLAN
/xtra：切到 XTRA

外接模式入口继续看：

/xtra 配合 Playwright 外接工具实战
/xtra 配合 DBHub 外接工具实战

四种状态

状态	说明	适合场景
`CHAT`	对话驱动的流式工具闭环	探索、问答、临场协作
`FAST`	裁剪工具集后的快速执行通道	接口、文本、媒体短链路
`PLAN`	先生成计划，再按步骤顺序执行，并承载执行期规则判断	需要结构化步骤和更稳路径的任务
`XTRA`	外接 MCP 工具与 Helix 通用工具协作通道	数据库、浏览器、外部服务协作

如果你切到 XTRA 之后要继续看专项用法，直接跳：

补充： - 执行期规则判断只属于 PLAN 执行面 - --code 中的 global_rule / rule 是星图规则层，不等同于执行期规则判断 - XTRA 会读取外接服务配置；外接服务需提前可访问，外接失败只进入 debug 日志

切换成功后，终端会输出： - Exchange -> Chat - Exchange -> Fast - Exchange -> Plan - Exchange -> Xtra

`/model` 指令

示例：

/model gpt-4o-mini

当输入无效或缺失时，会打印候选列表并提示：

model invalid: /model <...>

切换成功后，本轮循环后续调用都会使用新的 model。

`/apikey` 指令

当输入无效或缺失时，会打印格式提示，例如： - sk-... - gsk_... - ds-... - <token>

并输出：

apikey invalid: /apikey <...>

切换成功后，本轮循环后续调用都会使用新的 apikey。

附件指令

/attach <path|dir|glob>：把本地文件加入当前待发送附件列表
/attachments：查看当前已挂载但尚未发送的附件
/detach <index|path>：按序号或路径移除单个附件
/attach-clear：清空当前待发送附件

约定： - 当前允许挂载任意普通文件；图片会保留 image 分类，其它文件按 file 处理 - 目录会批量挂载当前层文件；递归请使用通配符，例如 ./docs/**/*.md - CHAT / FAST / XTRA 会在发送前自动上传附件 - PLAN 当前不支持附件；如有待发送附件，需要先切回 CHAT / FAST / XTRA 或清空 - 一轮消息发送后，待发送附件会自动清空，避免串到下一轮

`/license`

/license 或 /lic：展示授权许可信息页

退出

任意时刻输入以下任一指令即可退出：

/quit
/q
quit
exit

输入约束

REPL 当前支持单行和多行输入
多行输入适合临时探索、长提示和分段目标描述
需要批跑、重复执行或多任务编排时，优先使用 --code 配合 cfg.repeat / loop