第 04 模块 · 3 节

通知、Agent 仪表盘与会话历史

《Orca 进阶实战》04 终端、通知与 Agent 管理 · 本节时长 28 分钟

Orca 跑的是 Agent 而不只是终端它知道 Agent「真正干完」与「只是暂停」的区别,所以能排队三个任务后走开、第一个完成时被通知叫回来。本课讲通知、仪表盘与历史三件套。

通知与收件箱

Agent 从工作中转入空闲时,Orca 触发通知:系统通知 + 声音 + 工作树上的徽标

  • 持久铃铛:头部铃铛显示跨所有工作树的未读数;点通知跳到对应工作树与面板
  • macOS Dock 徽标同步未读数——Orca 不前台也能看到待处理 Agent 提示
  • 标记未读:右键通知可标记未读(已分流但稍后要回来看)
  • 分类开关:Settings → Notifications 关闭特定类别(系统 / 声音 / 仅徽标)
  • 自定义声音:每个类别可指定磁盘上的音频文件(MP3/WAV/OGG/M4A/AAC/FLAC),让「Agent 完成」与系统邮件/ Slack 声音区分开;音量同面板可调

Agent Dashboard(Agent 仪表盘)

实验性功能:Settings → Experimental → Agent Dashboard 开启后,左侧边栏多一个入口,展示跨工作树的 Agent 看板(kanban)+ 可选的 Agent Map 拓扑视图。

看板列

内容
Needs You 等待权限 / 问题(琥珀色卡片,显示待答问题摘要)
Working 正在运行
Done 已完成、等待你评审(绿色)
Idle 约 30 分钟未报告完成的安静 Agent(默认隐藏,可在看板设置开启)

卡片 = Agent 图标 + 会话名 + 状态符号 + 最近消息预览 + 项目/工作树 + 年龄。点卡片直接聚焦该 Agent 的实时终端。Codex/Claude 的嵌套子 Agent 显示为主行的可展开子行。

工具栏

  • Search:工作树 / 项目 / Agent 名
  • Filter:多选 Project、Workspace status、PR/MR status
  • Open as:In-window(侧边栏旁)或 Pop-out(独立窗口)

Agent Map

实验性拓扑视图:工作树环嵌套在项目环下,Agent 坐在自己的工作树环上;编排的父→子边在分发活跃或刚结束时绘制。地图有快速视图(Needs me / Stuck / Unread)、主机/提供方/状态/时间筛选,以及 Orchestration links 开关。

状态检测依赖 Agent CLI 发 OSC 事件与 hooks——从 combobox 启动的受支持 Agent 才有完整状态(基础课提过)。


Agent Session History(会话历史)

右侧边栏 → Agents 标签页。Orca 扫描受支持 Agent CLI 留在磁盘的会话转写,列出来供浏览与恢复:

  • 头部显示数量(如 12 shown · 47 recent)+ 搜索(按标题/目录/分支/模型/预览文本)
  • 作用域:Workspace / Project / All
  • 视图选项:按 Agent 开关扫描、排序(最后更新/创建)、分组(项目/文件夹/Agent)、隐藏空会话
  • Resume:点击恢复——Orca 在会话原 cwd 里跑 Agent 的恢复命令(claude --resume <id>codex resume <id>pi --session <路径> 等),免去手动记 ID
  • Copy resume command:把同款命令复制到剪贴板(远程工作树用)
  • Copy session ID / Open log / Open cwd 等详情操作

Resume 需要本地工作区(恢复命令在 Orca 所在机器跑);远程场景用 Copy resume command 自己到远端执行。


落地练习:让通知为你工作

  1. 让一个 Agent 跑一个较长任务,用 Cmd+Tab 切走
  2. 等它完成,观察系统通知、声音与铃铛未读数
  3. 点通知跳回对应工作树;右键练习标记未读
  4. 开启 Agent Dashboard,看 Needs You / Working / Done 分布
  5. 打开 Agent Session History,恢复一个过去的会话

怎么判断做对了?——你能说出通知的触发时机(工作→空闲转换),并熟练用 Dashboard 与 Session History 找回任何一次 Agent 会话。

卡住了怎么办? 没收到通知:检查 Settings → Notifications 分类是否被关、系统通知权限;Dashboard 不见:确认 Experimental 开关已开。


小结

  1. Agent 完成即通知:系统通知 + 声音 + 徽标 + Dock 角标
  2. Agent Dashboard:Needs You / Working / Done / Idle 看板 + Agent Map
  3. Session History:扫描磁盘转写,一键 Resume / Copy 恢复命令
  4. 三者共用同一套状态信号(OSC + hooks)

到这里,Orca 进阶课完成。你已经能把「并行干活 → 认真评审 → 就地交付」跑顺。下一门高级课,把 Orca 变成可脚本化、可远程、可自动化的工程基础设施。