第 04 模块 · 2 节

会话恢复与 Agent 状态指示

《Orca 基础入门》04 窗口、导航与会话 · 本节时长 26 分钟

两个核心概念agent session = 一个 Agent CLI 跑在一个工作树的一个终端里;② Orca 会恢复你在哪、开了什么、Agent 干到哪了——你不需要记住。

Agent 状态指示

Orca 通过 Agent CLI 发出的 OSC 终端标题序列与 hooks 检测状态。Agent 标签页与侧边栏工作树行共用同一套状态符号:

状态 符号 含义
工作中 转圈 spinner Agent 正在跑
等你输入 黄色问号 需要权限 / 有问题要答
完成 绿色勾(仪表盘)/ 绿点(侧边栏) 干完活了
阻塞 红点 中断 / 失败
空闲 灰点 安静待命
无指示 普通 shell,不是被识别的 Agent CLI

提示:从 agent combobox 启动(而不是手敲二进制命令)才能获得状态检测。Codex 的 Task 子 Agent、Claude 的子 Agent / Teams 队友会显示为主 Agent 下的可展开子行。


会话恢复(Session restore)

关掉 Orca 再打开,整个工作区原样回来

恢复项 说明
打开的工作树 侧边栏一个不少
标签与分屏 每个工作树的布局、焦点标签
运行中的 Agent 进程 后台 daemon 持有 PTY,关窗不杀 Agent
终端滚动缓冲 包括 Orca 关闭期间产生的输出
焦点位置 回到你关闭时的视图

什么时候 Agent 会丢

关键区别在于 daemon 是否存活

  • daemon 存活(正常 Cmd+Q、自动更新重启、应用崩溃)→ Agent 继续在后台跑,下次启动热重连
  • daemon 死亡(整机重启、内核崩溃、强制断电)→ 布局和滚动缓冲恢复,但 Agent 进程没了,需要重新启动

想要干净起点

没有「新会话模式」——Orca 总是恢复。想从零开始就显式关闭工作树再退出。


启动默认与权限

  • Orca 以全自主权限标志启动受支持的 Agent(Claude --dangerously-skip-permissions、Codex --dangerously-bypass-approvals-and-sandbox 等),理由见模块二
  • Settings → Agents 可改每个 Agent 的 launch arguments
  • Settings → Agents → Agent Permissions 可全局在 Yolo / Manual 之间切换未自定义过的 Agent

落地练习:验证恢复

  1. 启动一个 Agent 让它干活(比如让它跑一个长测试)
  2. 趁它运行直接 Cmd+Q 退出 Orca
  3. 重新打开:确认布局恢复、滚动缓冲还在
  4. 观察 Agent 是否仍在运行(daemon 场景)还是需要重启
  5. 把 Agent 干完活的工作树休眠,再打开,验证恢复

怎么判断做对了?——你能区分「daemon 存活(Agent 续跑)」与「daemon 死亡(Agent 需重启)」两种情形,并说出判定依据。

卡住了怎么办? Agent 丢了就重启它——会话内容可以用 claude --resume / codex resume 找回(进阶课 Agent 会话历史会讲)。


小结

  1. Agent session = 一个 CLI Agent 在一个工作树的一个终端
  2. 状态符号:转圈 / 黄问号 / 绿 / 红 / 灰
  3. Session restore 恢复布局、滚动缓冲与运行中的 Agent
  4. daemon 决定 Agent 是否跨关闭存活
  5. 想从零开始就显式关闭工作树

下一节,导航利器:快速打开与 Jump Palette。