待处理队列

什么是待处理队列？

待处理队列支持暂存当前会话的消息，而无需立即发送给智能体。

待处理消息具备以下特性：

• 会话级共享：凡对共享会话拥有编辑权限的成员，均可查看和管理这些消息。
• 有序排列：你可以自主控制消息的处理顺序。
• 支持编辑：在消息执行前，你可以随时编辑、删除或调整其顺序。
• 随会话一同存储：待处理内容采用与会话记录相同的存储模式（默认加密；在采用明文存储的部署环境中则为明文）。

待处理消息不会影响“未读”状态指示，而是会显示一个独立的待处理计数角标。

功能展示位置

会话列表角标

在会话列表中，包含待处理消息的会话会显示待处理计数角标（例如 3 或 99+）。

会话视图

当会话中存在待处理消息时，会话视图中会显示 “Pending (N)”（待处理 N 项）指示器。点击即可打开待处理消息面板。

对于可恢复的非活跃会话，即使其对应设备处于离线状态，输入框仍保持可用。发送消息后，系统会将其持久化保存在该队列中，而不会假装会话在线。随后，输入框横幅会展示具体的恢复状态：

• 正在按所选的自动恢复策略等待设备重新连接；
• 设备可访问，正在等待守护进程启动会话；
• 保持排队状态以待手动恢复；或
• 启动失败，并提供明确的重试操作。

对于手动排队的离线消息，点击上线时处理即可在不更改账户设置的情况下，授权自动处理该条特定消息。通过横幅，你也可以让该消息继续排队，或打开自动恢复选项。启动失败不会无限重试；仅凭设备重新连接并不会重新发起已失败的请求。

管理待处理消息（界面操作）

点击会话视图中的指示器，打开待处理消息面板。

待处理消息操作

针对每条待处理消息，你可以执行以下操作：

• 上移 / 下移：调整智能体处理消息的先后顺序。
• 编辑：在消息执行前修改其文本内容。
• 移除：删除待处理消息（后续将不再处理）。
• 立即发送：中止当前轮次并立即发送该消息。

已舍弃消息

在某些情况下，消息会被归入已舍弃消息区域（例如，当会话从远程切换至本地、且待处理队列不可继续执行时）。

在“已舍弃消息”中，你可以执行以下操作：

• 重新排队：将消息放回待处理队列。
• 移除：永久删除该消息。
• 立即发送：立即发送该消息。

消息发送设置

前往设置 → 会话 → 消息发送。

发送后自动恢复

向可恢复的非活跃会话发送消息时，该设置项生效：

• 立即或待设备重新上线时恢复：Kaiwu 会将消息加入队列，并授权所属守护进程恢复该会话。若设备处于离线状态，请求将挂起等待，直至其守护进程重新连接。
• 仅在设备在线时恢复（默认）：仅在目标设备当前可访问的前提下，Kaiwu 会在发送时尝试恢复一次。若设备不可用，或恢复尝试因设备断连而产生竞态冲突，消息将保持排队状态，且不会授权后续自动启动。
• 从不自动恢复：Kaiwu 仅将消息加入队列，不会请求启动会话。后续你可以在输入框横幅中手动恢复。

修改此设置仅对后续发送生效，既不会静默取消已有队列消息的启动请求，也不会为它们追加请求。横幅中的上线时处理操作仅对当前展示的那条排队消息有效。

在智能体中排队（当前）

各项服务均在线时的默认行为：

• 消息会立即写入会话记录
• 智能体就绪后便会进行处理

安全回退机制：

• 若会话处于离线、恢复中，或智能体尚未就绪，Kaiwu 可能会将消息先暂存至待处理队列，以防丢失。
• 在附加/本地控制流程中，若会话当前正处于本地控制状态，Kaiwu 会将消息排队挂起，直至会话准备好恢复远程处理。

打断并发送

中止当前轮次（若有），随后立即发送你的消息。

若会话需要恢复（或处于离线状态），Kaiwu 可能会将消息先暂存至待处理队列，待智能体就绪后再行投递。

排队等待就绪

将消息暂存至会话的待处理队列，待智能体就绪后自行拉取处理。

在以下场景中，推荐使用此选项：

• 需要排队发送多条消息并控制其处理顺序；
• 希望在智能体开始处理前保留消息的可编辑状态；
• 避免在智能体离线或尚未就绪时遗失消息。

本地控制会话

本地控制意味着提供商 TUI 正在终端中处于活跃状态。远程控制则意味着 Kaiwu 正在后台为应用驱动同一个提供商会话。

对于 Claude 和 Codex，本地控制是互斥排他的。当提供商 TUI 独占会话时，Kaiwu 不会将应用端的消息直接注入到该终端进程中。而是采取以下处理方式：

• 应用将消息保存在会话待处理队列中；
• 本地 Kaiwu 进程监听待处理消息；
• 若当前没有正在运行的本地轮次，Kaiwu 可将该会话切回远程处理模式，并投递排队的消息；
• 若本地轮次仍在运行，Kaiwu 会等待该轮次完成、中止或退出后，再切换回远程模式。

这种机制避免了打断正在进行的 Claude 或 Codex 本地轮次。若不经过等待便直接向繁忙的终端 TUI 发送应用消息，可能会导致当前的提供商轮次被取消或异常损坏。

对于 OpenCode，本地控制则是共享模式。OpenCode TUI 与 Kaiwu 应用可以同时连接到同一个 OpenCode 会话，因此应用消息不需要走这种排他性控制的交接链路。

在消息执行前，你随时可以在待处理消息面板中检查排队的消息。

混合版本行为（服务端 / 智能体兼容性）

待处理队列功能需要以下两端的协同支持：

• 服务端（提供待处理队列端点及更新支持）；
• 负责处理会话的智能体/CLI（必须具备将待处理内容具体写入会话记录的能力）。

若你的环境不支持待处理队列，应用将回退至常规的消息发送行为，且无法使用待处理队列的相关操作。

重新连接后的自动恢复功能，还额外依赖最新版本的服务端以及会话所属特定设备上的守护进程。若服务端或守护进程版本较旧，Kaiwu 会保持原有的直接恢复兼容逻辑，而不会默认支持无人值守激活。

使用技巧

• 如果连续排队了多个想法，可使用上移 / 下移来确保智能体按你的预期顺序进行处理。
• 如果发现某条内容不再相关，可在其执行前点击移除。
• 如果需要立刻处理某项事务，立即发送是最快的途径。
• 从本地切换至远程的过程中，出现短暂的排队或等待状态属于正常现象，这有助于防止消息丢失或打断正在运行的本地轮次。