第33章 Agent 与 Session（代理与会话）
Agents 与 sessions（代理与会话）状态点、重启按钮，以及 agent 会话的完整生命周期。
一个 agent 会话指的是在某个 worktree 的一个终端里运行的一个 CLI 代理。Orca 会追踪它的生命周期，让你一眼就知道哪些会话在干活、哪些在闲置——不用逐个点开标签页去查看。
每个 worktree 卡片上内联显示 agent 状态——工作时黄色，完成时绿色
状态指示
Agent 标签页和 worktree 行使用统一的状态符号：
Spinner — 正在工作 琥珀色问号 — 等待你处理（权限请求 / 需要输入）；侧边栏“Needs You”计数用的也是同一符号 祖母绿对勾（仪表盘）或祖母绿圆点（侧边栏）— 已完成 / 安静运行中 红点 — 被阻塞、被中断或失败 灰点 — 闲置 无指示 — 普通终端，不是 Orca 识别的 agent CLI
状态通过终端的 OSC 标题序列和 agent hooks 检测，Claude Code、Codex 等多个代理都会输出这些信息。
Agent 仪表盘
在 Settings → Experimental → Agent Dashboard 中开启后，Orca 会在左侧边栏新增一个 Agent Dashboard 入口：一个跨 worktree 的 agent 看板。
你可以在 Settings → Shortcuts 里给 Toggle Agent Dashboard 分配快捷键。它默认没有绑定快捷键，且在终端、编辑器或浏览器标签页获得焦点时同样可用。
看板列
Needs You — 等待权限或问题回复 Working — 正在运行 Done — 已完成、可能还需要你复查的会话 Idle — 约 30 分钟以上未报告完成的安静 agent。默认在看板上隐藏；需从窗口内或弹出面板上的看板设置控件（齿轮）中开启 Show idle agents——而不是在全局 Experimental 设置里。窗口内与弹出面板会保持同步。
对于 SSH 工作区和已配对的 Remote Orca Server，仪表盘卡片会显示主机徽标。悬停或聚焦徽标可查看保存的主机名，例如 SSH host · openclaw 或 Remote Orca host · Build Mac。本地工作区不显示主机徽标。
打开方式
可以显示在侧边栏旁边的窗口内看板，也可以 Pop-out 到独立窗口。
搜索与筛选
看板工具栏包含：
Search — 按 worktree、项目或 agent 名称搜索（有查询或筛选条件时显示结果数量） Filter — 多选 Project、Workspace 状态和 PR / MR 状态（Open、Draft、Merged、Closed、No review） 可移除的筛选标签和 Clear all filters 按钮
卡片
Header — agent 图标、会话对话名（可重命名、生成标题、AI Vault / agent 会话标题，或回退为 worktree 名）、状态符号 Preview — 有则显示最近一条用户 / agent 消息，否则显示任务摘要 Footer — 项目图标、worktree 名称（当 header 已显示会话名时）以及存在时长；如有缓存的 review 状态也会显示。Workspace 状态只保留在工具栏筛选中——卡片不再显示每个 worktree 的状态点。
Needs You 卡片带琥珀色调（并可能显示待处理问题摘要）；Done 卡片带绿色调；其他状态保持中性，这样有颜色就意味着“需要关注” 点击卡片可打开/聚焦该 agent 的实时终端——包括运行在已配对 Remote Orca Server 上的 agent，其预览内容来自运行它的主机 嵌套的 Codex/Claude 子代理可以在父行下方以可展开的子项形式出现
实验性看板关闭时，worktree 卡片仍会内联显示 agent 行并使用相同的状态符号。如果看不到状态指示，说明该会话里运行的 agent CLI 不是 Orca 认识的——请通过 agent 下拉框启动，而不是手动输入可执行文件。
启动默认参数
Orca 启动每个支持的 agent 时都会预先带上完全自主的权限标志——Claude 用 --dangerously-skip-permissions，Codex 用 --dangerously-bypass-approvals-and-sandbox，Gemini 用 --yolo，选择器中其他 agent 也各有对应标志。设计意图是让 worktree 本身充当沙箱：agent 可以放手干活，不用被逐个工具的审批提示打断流程。
如果你想为某个 agent 修改默认参数，打开 Settings → Agents，展开对应行并编辑它的启动参数——Orca 会记住覆盖值，并在之后每次启动时应用。字段旁的 Reset 按钮可以随时恢复为出厂标志。
重启按钮
当 agent 退出（正常或崩溃）时，标签页会显示一个 Restart 按钮。点一下即可用相同的工作目录重新拉起同一个 agent。Codex 的重启按钮还会保留当前账号（参见 Hot-swap Codex accounts）。
会话生命周期
Launch — 从下拉框选择一个 agent，Orca 启动该 CLI。 Work — OSC 标题更新状态；终端输出支持滚动、搜索、复制和 Ghostty 主题。 Idle — Orca 检测到从工作到闲置的状态变化时，发出 agent-finished 通知。 Exit — 进程结束，出现 Restart 按钮。
