思考级别（/think 指令）

功能说明

  • 在任何消息中使用内联指令：/t <级别>、/think:<级别> 或 /thinking <级别>。
  • 级别（别名）：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。
  • Provider 注意事项：
    • Z.AI（zai/*）只支持二元思考模式（on/off）。任何非 off 的级别都会被视为 on（映射到 low）。

解析优先级

  1. 消息中的内联指令（仅对该消息生效）。
  2. Session 覆盖设置（通过发送纯指令消息设置）。
  3. 全局默认值（配置文件中的 agents.defaults.thinkingDefault）。
  4. 回退默认值：支持推理的模型为 low；其他模型为 off。

设置 Session 默认值

  • 发送一条仅包含指令的消息（允许空格），例如 /think:medium 或 /t high。
  • 这会在当前 Session 中生效（默认按发送者区分）；通过 /think:off 或 Session 空闲重置来清除。
  • 系统会发送确认回复（Thinking level set to high. / Thinking disabled.）。如果级别无效（例如 /thinking big），命令会被拒绝并提示，Session 状态保持不变。
  • 发送 /think（或 /think:）不带参数可查看当前思考级别。

Agent 应用方式

  • Embedded Pi：解析后的级别会传递给进程内的 Pi Agent Runtime。

详细输出指令（/verbose 或 /v）

  • 级别：on（最小）| full（完整）| off（默认）。
  • 纯指令消息会切换 Session 的详细输出模式，并回复 Verbose logging enabled. / Verbose logging disabled.；无效级别会返回提示而不改变状态。
  • /verbose off 会存储一个显式的 Session 覆盖设置；通过 Sessions UI 选择 inherit 来清除。
  • 内联指令仅影响该消息；否则应用 Session/全局默认值。
  • 发送 /verbose（或 /verbose:）不带参数可查看当前详细输出级别。
  • 当 verbose 开启时，发出结构化工具结果的 Agent（Pi、其他 JSON Agent）会将每个工具调用作为独立的纯元数据消息发送回来，前缀为 <emoji> <工具名>: <参数>（如果有路径/命令）。这些工具摘要会在每个工具启动时立即发送（独立气泡），而不是作为流式增量。
  • 当 verbose 为 full 时，工具输出也会在完成后转发（独立气泡，截断到安全长度）。如果你在运行过程中切换 /verbose on|full|off，后续的工具气泡会遵循新设置。

推理可见性（/reasoning）

  • 级别：on|off|stream。
  • 纯指令消息会切换是否在回复中显示思考块。
  • 启用时，推理会作为独立消息发送，前缀为 Reasoning:。
  • stream（仅 Telegram）：在生成回复时将推理流式传输到 Telegram 草稿气泡中，然后发送不含推理的最终答案。
  • 别名：/reason。
  • 发送 /reasoning（或 /reasoning:）不带参数可查看当前推理级别。

相关内容

Heartbeat

  • Heartbeat 探测消息体是配置的 heartbeat Prompt（默认：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.）。Heartbeat 消息中的内联指令照常应用（但避免从 heartbeat 中更改 Session 默认值）。
  • Heartbeat 传递默认只发送最终负载。要同时发送独立的 Reasoning: 消息（如果有），设置 agents.defaults.heartbeat.includeReasoning: true 或针对单个 Agent 设置 agents.list[].heartbeat.includeReasoning: true。

Web 聊天界面

  • Web 聊天的思考级别选择器会在页面加载时镜像 Session 存储/配置中的级别。
  • 选择其他级别仅对下一条消息生效（thinkingOnce）；发送后，选择器会回弹到存储的 Session 级别。
  • 要更改 Session 默认值，发送 /think:<级别> 指令（如前所述）；选择器会在下次重新加载后反映该设置。