文档 / 智能体 / 智能体会话历史

Orca 会扫描受支持的 agent CLI 在磁盘上留下的会话记录，并将其列在右侧边栏的 Agent Session History 面板中。选择一个过去的会话，点击 Resume，Orca 就会在一个全新的终端中运行该 agent 的恢复命令——使用相同的 cwd、相同的会话 ID，无需手动处理 --resume 标志。

打开面板¶

打开右侧边栏，切换到 Agents 标签页。面板标题显示为 “Agent Session History”。

标题区域会显示类似 12 shown · 47 recent 的计数和一个搜索框。输入内容可按会话标题、工作目录、分支、模型或对话中的预览文本进行筛选。

作用范围¶

面板顶部的范围切换器决定显示哪些会话：

• Workspace — 来自当前工作区或工作树的会话，具体取决于当前工作区上下文。
• Project — 解析到当前 Orca 项目的会话。
• All — Orca 在这台机器上的所有 agent 中找到的每个会话。

远程工作区可以浏览本地历史记录，但恢复操作只能从本地工作区运行——当活动工作树为远程时，Orca 会在面板中提示你这一点。

视图选项¶

视图选项菜单（搜索框旁）控制扫描哪些 agent，以及排序和分组方式：

• Agents — 逐个启用或禁用 CLI（Claude、Codex、Hermes、Pi、OMP、Prime Agent、Cursor、Gemini、Antigravity、Rovo Dev、Copilot、OpenCode、Grok、OpenClaw、Devin、Droid、Kimi）。扫描时会跳过被禁用的 agent。使用 Agents 标题中的 Select all / Clear 可一次切换所有 agent——Clear 会将选择清空，这样你只需打开关心的 CLI，而无需取消勾选一长串列表。空选择会显示 No agents selected，而不是通常的空筛选提示。
• Sort — Last updated 或 Created。
• Group — Project、Folder（每个 cwd 一个标题）或 Agent（每个 CLI 一个标题）。
• Hide empty sessions — 丢弃没有任何已记录消息的会话。

恢复会话¶

点击会话行可打开其详情：工作目录、分支、模型、消息数量、First prompt 以及最近的对话回合。当你展开详情时，First prompt 会从会话记录中加载未截断的第一条用户消息（列表行仅保留用于搜索的简短预览）。使用该卡片上的 Copy 将完整请求复制到剪贴板——这对于在不重新打开日志的情况下复用长提示词非常有用。你也可以将启用的会话行拖入工作区以恢复它。通过行上的操作，你可以：

• Resume — 在会话的 cwd 中打开一个新终端，并运行该 agent 的恢复命令（例如 claude --resume <id>、codex resume <id>、pi --session <session_file>、prime-agent --resume <path>、cursor-agent --resume <id>、acli rovodev run --restore <id>）。如果原始会话设置了 CODEX_HOME，Codex 会话还会重新导出该变量。

Pi 会从其 hooks 报告的磁盘会话文件（--session <path>）恢复，而不是使用裸会话 ID。如果该文件缺失，即使存在会话 ID，该行的 Resume 也不可用。

• Copy resume command — 将相同的 shell 命令复制到剪贴板，以便在外部终端中使用。
• Copy session ID / Copy log path — 用于编写脚本或将会话记录附加到 bug 报告中。
• Open log / Reveal log — 在 Orca 中打开原始会话记录文件，或在你的操作系统文件管理器中定位到该文件。
• Open cwd — 将会话的工作目录作为工作区打开。

Resume 会在 Orca 渲染所在的机器上运行 agent CLI。如果你连接到了远程工作区，在点击 Resume 之前，请先切换回本地工作区（或使用 Copy resume command 并在远程自行运行）。

会话记录来自哪里¶

Orca 会读取每个 agent 自己的磁盘会话存储——Codex 的 ~/.codex/sessions、Claude 的 ~/.claude 历史记录、Cursor 的会话日志、OpenCode 的旧版会话文件或 ~/.local/share/opencode/opencode.db，等等。无需额外启用任何功能；只要 CLI 写入会话记录，它就会在下次扫描后出现在面板中。使用标题中的 Refresh Session History 按钮可按需重新扫描。

后续步骤¶

• 热切换 Codex 账户 — 在无需重启活动会话的情况下切换其背后的 Codex 登录。
• Hooks 与记忆 — 控制 agent 在每次启动（包括恢复的会话）时获取哪些上下文。