会话恢复
退出 DevAgent,再重新打开,即可从你上次离开的地方精确继续——worktree、拆分、回滚历史、聚焦的 标签页 全都在。
当你关闭 DevAgent 时,下次启动会重新还原整个工作区:每一个打开的 worktree、每一个终端 拆分、每个 窗格 中的回滚历史,以及你当时聚焦的 标签页。你不必去记哪些 agent 运行在哪些分支上——那是 DevAgent 的职责。
哪些内容会被恢复
- 打开的 worktree —— 你在侧边栏中打开的每一个 worktree。
- 标签页 和 拆分 —— 每个 worktree 的 窗格 布局,包括嵌套的 拆分 以及当时聚焦的是哪个 标签页。
- 运行中的 agent 进程 —— 你正在运行的 agent 会在 DevAgent 退出后继续运行。有一个后台 daemon 持有这些 PTY,因此关闭应用窗口不会在任务中途杀掉 Claude Code、Codex 或任何其他 agent CLI。下次启动时,DevAgent 会热重连到这些相同的进程。
- 终端回滚历史 —— 每个终端中的缓冲区,包括 DevAgent 关闭期间产生的输出。
- 聚焦的 worktree 和 标签页 —— DevAgent 会打开到你关闭时的同一视图。
哪些内容不会被恢复
daemon 会随主机的关闭而消亡,因此任何导致整台机器关闭的操作——重启、系统更新、内核崩溃、强制断电——都会结束所有正在运行的 agent。下次启动时,worktree、标签页、拆分 和最后已知的回滚历史都会回来,但 agent 进程本身已经没了。在任意 标签页 中重新运行该 agent 即可继续。
当 DevAgent 关闭期间 daemon 崩溃时,对它所持有的任何会话都有相同的影响,但布局和回滚历史仍会在下次启动时恢复。
恢复何时运行
会话恢复会在每次启动时运行。这些情况按 daemon 是否在间隔期间存活来划分:
daemon 存活 → agent 继续运行:
- Cmd-Q —— 正常的退出方式。agent 会在后台继续工作。
- 自动更新器重启 —— DevAgent 重启以安装更新;agent 不受影响。
- 应用崩溃 —— 如果 DevAgent 自身崩溃,daemon 会让你的会话保持存活,以便下次启动时热重连。
daemon 消亡 → agent 没了,但布局仍会恢复:
- 主机重启 —— 笔记本重启、系统更新、内核崩溃、强制断电。worktree、标签页、拆分 以及最后一次持久化的回滚历史仍会在下次启动时回来。
从头开始
如果你想要一个干净的起点,请在退出前显式关闭 worktree。没有"在新会话中打开"这种模式——DevAgent 总是会恢复。已关闭的 worktree 会保持关闭状态。
后续步骤
- Agent 与会话 —— 状态圆点以及 agent 会话的生命周期。
- 标签页、窗格与分屏布局 —— 你将要恢复的布局最初是如何构建的。