思考级别(/think 指令)
功能说明
- 任何入站消息体中的内联指令:
/t <level>、/think:<level>或/thinking <level>。 - 级别(别名):
off | minimal | low | medium | high | xhigh(仅限 GPT-5.2 + Codex 模型)- minimal → "think"
- low → "think hard"
- medium → "think harder"
- high → "ultrathink"(最大预算)
- xhigh → "ultrathink+"(仅限 GPT-5.2 + Codex 模型)
highest、max映射到high。
- 提供商说明:
- Z.AI(
zai/*)仅支持二进制思考(on/off)。任何非off级别都将被视为on(映射到low)。
- Z.AI(
解析顺序
- 消息上的内联指令(仅应用于该消息)。
- 会话覆盖(通过发送仅包含指令的消息设置)。
- 全局默认值(配置中的
agents.defaults.thinkingDefault)。 - 回退:具有推理能力的模型为 low;否则为 off。
设置会话默认值
- 发送一条仅包含指令的消息(允许空格),例如
/think:medium或/t high。 - 该设置将在当前会话中保持(默认按发送者区分);通过
/think:off或会话空闲重置清除。 - 将发送确认回复(
Thinking level set to high./Thinking disabled.)。如果级别无效(例如/thinking big),命令将被拒绝并提示,会话状态保持不变。 - 发送不带参数的
/think(或/think:)可查看当前思考级别。
按代理应用
- 嵌入式 Pi:解析后的级别将传递给进程内 Pi 代理运行时。
详细指令(/verbose 或 /v)
- 级别:
on(最小)|full|off(默认)。 - 仅包含指令的消息会切换会话详细模式并回复
Verbose logging enabled./Verbose logging disabled.;无效级别会返回提示而不改变状态。 /verbose off存储显式会话覆盖;通过会话 UI 选择inherit来清除。- 内联指令仅影响该消息;否则应用会话/全局默认值。
- 发送不带参数的
/verbose(或/verbose:)可查看当前详细级别。 - 当详细模式开启时,发出结构化工具结果的代理(Pi、其他 JSON 代理)会将每个工具调用作为单独的仅包含元数据的消息发送回来,在
<emoji> <tool-name>: <arg>可用时添加前缀(路径/命令)。这些工具摘要会在每个工具启动时立即发送(独立气泡),而不是作为流式增量。 - 当详细模式为
full时,工具输出也会在完成后转发(独立气泡,截断到安全长度)。如果在运行过程中切换/verbose on|full|off,后续工具气泡将遵循新设置。
推理可见性(/reasoning)
- 级别:
on|off|stream。 - 仅包含指令的消息会切换回复中是否显示思考块。
- 启用时,推理会作为单独的消息发送,带有
Reasoning:前缀。 stream(仅限 Telegram):在生成回复时将推理流式传输到 Telegram 草稿气泡中,然后发送不包含推理的最终答案。- 别名:
/reason。 - 发送不带参数的
/reasoning(或/reasoning:)可查看当前推理级别。
相关
- 提升模式文档位于 提升模式。
心跳
- 心跳探测消息体是配置的心跳提示(默认:
Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.)。心跳消息中的内联指令照常应用(但避免从心跳更改会话默认值)。 - 心跳传递默认仅传递最终负载。要同时发送单独的
Reasoning:消息(如果可用),请设置agents.defaults.heartbeat.includeReasoning: true或按代理设置agents.list[].heartbeat.includeReasoning: true。
Web 聊天 UI
- 页面加载时,Web 聊天思考选择器会镜像来自入站会话存储/配置中存储的会话级别。
- 选择其他级别仅应用于下一条消息(
thinkingOnce);发送后,选择器会恢复到存储的会话级别。 - 要更改会话默认值,请发送
/think:<level>指令(如之前所述);选择器将在下次重新加载后反映该更改。