DevAgent Docs

简体中文

English

简体中文

English

主题

Agent 会话历史 ​

从 DevAgent 右侧边栏浏览并恢复过往的 Claude、Codex、Cursor、Gemini 及其他 agent 会话。

DevAgent 会扫描受支持的 agent CLI 在磁盘上留下的会话转录，并将其列在名为 Agent Session History 的右侧边栏面板中。选择一个过往会话，点击 Resume，DevAgent 就会在一个全新的终端里运行该 agent 的恢复命令——相同的 cwd、相同的 session ID，无需手动折腾 --resume 参数。

打开面板 ​

打开右侧边栏并切换到 Agents 标签页。面板标题为 "Agent Session History"。

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

范围 ​

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

  • Workspace — 来自当前 workspace 或 worktree 的会话，具体取决于当前的 workspace 上下文。
  • Project — 归属于当前 DevAgent 项目的会话。
  • All — DevAgent 在本机上跨所有 agent 找到的每一个会话。

远程 workspace 可以浏览本地历史，但恢复操作只能从本地 workspace 运行——当当前 worktree 为远程时，DevAgent 会在面板中提示你这一点。

视图选项 ​

视图选项菜单（在搜索框旁边）控制扫描哪些 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 会让所有 agent 都不被选中，这样你无需在长列表中逐个取消勾选，就能只开启你关心的那个 CLI。当选择为空时会显示 No agents selected，而不是通常的空过滤器提示。
  • Sort — Last updated 或 Created。
  • Group — Project、Folder（每个 cwd 一个标题）或 Agent（每个 CLI 一个标题）。
  • Hide empty sessions — 去掉记录消息数为零的会话。

恢复会话 ​

点击某个会话行以打开其详情：工作目录、分支、模型、消息数、First prompt 以及最近的几轮对话。展开详情时，First prompt 会从转录中加载未截断的首条用户消息（列表行为了搜索只保留了简短预览）。使用该卡片上的 Copy 可将完整的请求复制到剪贴板——在无需重新打开日志的情况下复用长提示时很有用。你也可以把一个已启用的会话行拖入 workspace 来恢复它。从该行的操作中你可以：

  • 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>）恢复，而不是从裸的 session id 恢复。如果该文件缺失，即使存在 session id，该行的 Resume 也不可用。

  • Copy resume command — 将相同的 shell 命令复制到剪贴板，供在外部终端使用。
  • Copy session ID / Copy log path — 用于编写脚本或将转录附加到缺陷报告。
  • Open log / Reveal log — 在 DevAgent 中打开原始转录文件，或在操作系统的文件管理器中跳转到它。
  • Open cwd — 将会话的工作目录作为 workspace 打开。

Resume 需要本地 workspace

Resume 会在渲染 DevAgent 的那台机器上运行 agent CLI。如果你连接的是远程 workspace，请先切回本地 workspace（或使用 Copy resume command 并自行在远程运行），再点击 Resume。

转录从何而来 ​

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

后续步骤 ​

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

DevAgent 桌面客户端文档

© 2026 Clouditera。保留所有权利。