文档 / 模型 / Agents 与会话

一个 代理会话 是在一个 worktree 中的一个终端里运行的一个 CLI 代理。Orca 会跟踪其生命周期，因此你始终知道哪些会话正在工作，哪些会话空闲 — 而无需点击每个标签页进行检查。

状态指示器¶

代理标签页和 worktree 行使用共享的状态字形：

• Spinner — 工作中
• Amber question mark — 正在等待你（权限 / 需要输入）；侧边栏“需要你”计数使用相同字形
• Emerald check（仪表板）或 emerald dot（侧边栏） — 完成 / 静默活动
• Red dot — 被阻塞、被中断或失败
• Gray dot — 空闲
• No indicator — 普通 shell，不是受识别的代理 CLI

状态从终端的 OSC 标题序列和代理钩子中检测，Claude Code、Codex 以及多个其他代理会发出这些信号。

代理仪表板¶

打开 设置 → 实验性功能 → 代理仪表板。Orca 会在左侧边栏添加 代理仪表板 条目：跨 worktree 的代理看板。

你可以在 设置 → 快捷键 下为 切换代理仪表板 分配键盘快捷键。它没有默认绑定，并且可以在终端、编辑器或浏览器标签页获得焦点时工作。

列¶

• 需要你 — 正在等待权限或问题
• 工作中 — 正在主动运行
• 已完成 — 你可能仍想查看的已结束会话
• 空闲 — 约 30 分钟未报告完成的安静代理。默认隐藏在面板上；在窗口内或弹出界面上的仪表板 面板设置 控件（齿轮）中启用 显示空闲代理 — 而不是从全局实验性设置中启用。窗口内和弹出界面保持同步。

仪表板卡片会为 SSH 工作区和配对的 远程 Orca 服务器 显示主机徽章。将鼠标悬停在徽章上或聚焦徽章，可查看已保存的主机名，例如 SSH 主机 · devbox 或 远程 Orca 主机 · build-host。本地工作区不显示主机徽章。

打开方式¶

窗口内 面板位于侧边栏旁边，或 弹出 在单独窗口中。

搜索和筛选¶

面板工具栏包括：

• 搜索 — worktree、项目或代理名称（当查询或筛选处于活动状态时显示结果数量）
• 筛选 — 多选 项目、工作区状态 和 PR / MR 状态（打开、草稿、已合并、已关闭、无审查）
• 可移除的筛选标签和 清除所有筛选

卡片¶

• 头部 — 代理图标、会话 对话名称（重命名、生成的标题、AI Vault / 代理会话标题，或回退到 worktree 名称）、状态字形
• 预览 — 可用时显示最后一条用户 / 代理消息；否则显示任务摘要
• 页脚 — 项目图标、worktree 名称（当头部已显示会话名称时）以及持续时间；存在时显示缓存的审查状态。工作区状态仅保留在工具栏筛选中 — 卡片不再显示每个 worktree 的状态圆点。
• 需要你 卡片呈琥珀色（并可显示待处理问题摘要）；已完成 卡片呈绿色；其他状态保持中性，因此着色表示“请查看这里”
• 点击卡片可打开/聚焦该代理的实时终端
• 嵌套的 Codex/Claude 子代理可作为可展开的子项显示在父行下方

当实验性面板关闭时，worktree 卡片仍会内联显示带有相同字形的代理行。如果看不到状态指示器，则该会话中的代理 CLI 不是 Orca 识别的代理 — 请通过代理组合框启动它，而不是手动输入二进制文件。

启动默认值¶

Orca 启动每个受支持的代理时，都会预先应用其完全自主权限标志 — Claude 使用 --dangerously-skip-permissions，Codex 使用 --dangerously-bypass-approvals-and-sandbox，Gemini 使用 --yolo，选择器中其他每个代理使用相应标志。其意图是让 worktree 本身成为沙箱：代理可以自行操作，而不会因逐工具审批提示而中断流程。

如果你希望某个代理使用不同的默认值，请打开 设置 → 代理，展开该代理的行，并编辑其 启动参数 — Orca 会记住覆盖设置，并在每次后续启动时应用。字段旁边的 重置 按钮可在你想还原时恢复默认标志。

重启徽章¶

当代理退出（正常或崩溃）时，标签页会显示 重启 徽章。单击即可使用相同的工作目录恢复同一代理。Codex 的重启徽章还会保留当前账户（参见 热切换 Codex 账户）。

会话生命周期¶

1. 启动 — 从组合框中选择一个代理；Orca 启动 CLI。
2. 工作 — OSC 标题更新状态；终端输出可滚动，并支持搜索、复制和 Ghostty 主题。
3. 空闲 — Orca 检测到工作→空闲转换，并触发 代理完成通知。
4. 退出 — 进程结束；重启徽章出现。

有关确切的检测规则，请参阅 Orca CLI 中的 terminal wait --for tui-idle 命令。