输入状态

​

默认值

• 直接聊天：模型循环开始后，立即开始输入。
• 带提及的群聊：立即开始输入。
• 不带提及的群聊：当已准入的运行出现用户可见活动时开始输入，例如 harness 执行活动或消息文本。
• Heartbeat 运行：如果解析后的 Heartbeat 目标是支持输入指示器的聊天，且未禁用输入指示器，则在 Heartbeat 运行开始时开始输入。

​

模式

• never - 永远不显示输入指示器。
• instant - 模型循环一开始就开始输入，即使该运行之后只返回静默回复令牌。
• thinking - 在第一个推理增量时开始输入，或在轮次被接受后的活跃 harness 执行时开始输入。
• message - 在第一个用户可见的回复活动时开始输入，例如活跃 harness 执行或非静默文本增量。像 NO_REPLY 这样的静默回复令牌不计为文本活动。

​

配置

{
  agents: {
    defaults: {
      typingMode: "thinking",
      typingIntervalSeconds: 6,
    },
  },
}

{
  session: {
    typingMode: "message",
    typingIntervalSeconds: 4,
  },
}

​

注意事项

• message 模式不会从静默回复令牌开始，但活跃执行仍可能在任何 assistant 文本可用前显示输入状态。
• thinking 仍会响应流式推理（reasoningLevel: "stream"），也可以在推理增量到达前由活跃执行启动。
• Heartbeat 输入指示器是解析后的投递目标的存活信号。它在 Heartbeat 运行开始时启动，而不是遵循 message 或 thinking 的流式时序。设置 typingMode: "never" 可禁用它。
• 当 Heartbeat 目标为 "none"、无法解析目标、Heartbeat 的聊天投递被禁用，或渠道不支持输入指示器时，Heartbeat 不会显示输入状态。
• typingIntervalSeconds 控制的是刷新节奏，不是开始时间。默认值：6 秒。

​

相关