AI 简明手册
Pi 源码解读 · 会话与上下文Steer 与 Follow-up 双队列

Steer 与 Follow-up 双队列

先盯住一个动作

运行中输入被分成 steer 与 follow-up:steer 在当前 assistant turn 的工具调用结束后送入,follow-up 等 Agent 完成当前全部工作后再送入。两者解决的是不同的插话时机。

沿执行轨迹走

  1. 交互按键对应两条队列

    交互模式用 Enter 排队 steer,用 Alt+Enter 排队 follow-up;Escape 中止当前运行并把排队消息恢复到编辑器,Alt+Up 也可主动取回。

    [repo] [docs]

  2. Agent 核心按边界轮询

    Agent 核心提供独立的 steering 与 follow-up 消息获取函数及 one-at-a-time/all 等投递模式;turn 完成后先处理 steer,整项工作收束后才轮到 follow-up。

    [repo]

每一步改变了什么

  • 纠正正在执行的方向用 steer;追加一个不应打断当前链条的新任务用 follow-up。

  • 宿主实现队列时要把“收到消息”和“何时进入模型上下文”分开,否则插话会在不可预测的位置生效。

这条轨迹没有说明什么

  • steer 不会撤销已经完成的外部副作用;需要硬停时应取消运行,再检查已执行工具的状态。

来源与核验

  1. [repo] Pi 官方源码(固定 revision)
  2. [docs] Pi 官方文档

Revision:853a80d26c90a14c1886f0ebb8ffaae133ca2185 · 核验日期:2026-08-31