跳到正文

Recipes 与会话恢复 ​

“显示”菜单可把当前标签保存成 .asterrecipe,或重新打开 Recipe。Recipe 可保存 tab/window 作用域、完整嵌套分屏及比例、Pane 类型、目录、文件、可选命令和内容级别,不保存 PID、令牌或文件描述符。每次打开都会生成新的 Pane 身份,因此同一 Recipe 可安全重复使用。外部 Recipe 必须是受大小限制的普通文件,引用的编辑资源也有累计预算。

外部 Recipe 的命令默认先完整列出全部命令并确认,不会隐藏第 21 条及后续内容;可在“设置 → Recipes”选择从不重放、一次确认、逐条确认或仅对相同 SHA-256 内容信任。信任跟随文件内容而非路径,文件修改后必须重新确认。“逐条确认”会在每条命令真正写入终端前提供运行、跳过和停止选项。命令只在 Shell Integration 已就绪且停在空闲 Prompt 时串行发送,上一条收到完成标记后才发送下一条。

“设置 → Shell → 会话恢复”决定退出并重新打开 Aster 时,各终端 Pane 里正在运行的东西如何回来:

  • 恢复复用器会话:快照时前台是 tmux / screen,重启后在首个 Prompt 自动执行 tmux attach -t <会话> 或 screen -r <会话>(解析不出会话名时用无参附着)。
  • 恢复 Code Agent 会话:Claude / Codex / OpenCode 以原生 --resume 重连(与“智能体”页是同一开关)。
  • 项目最近一次 Agent 会话 = 补全首选项:Agent(Claude Code、Codex、Grok Build 等)退出时,窗口顶部会提示该会话的 resume 命令(如 claude --resume <session-id>),Aster 记住“这个项目目录最近一次的会话”。之后在同一目录的任何终端 Pane 里,空 prompt 的 inline 补全 ghost 直接显示整条 resume 命令,候选面板里它排第一(图钉图标,描述“恢复 Claude Code 会话”),按 Tab 接受、回车执行;输入 cl 之类前缀时仍排第一。命令按 provider 区分:Claude / Grok 是 claude --resume <id> / grok --resume <id>,Codex 是 codex resume <id>,OpenCode / Kimi / Pi 是 --session <id>。只记录有原生 resume 能力的 provider;每个目录只保留最新一条,再次结束会覆盖。直接关闭仍在运行 Agent 的 Pane、标签或退出 Aster 同样算作结束并登记。Claude Code 与 Codex 不依赖 hook:Aster 会读取它们自己写在 ~/.claude/projects/<目录编码>/ 与 ~/.codex/sessions/ 下的会话文件,在运行中就把 session ID 绑定到该 Pane(会话标题、Fork、复制 ID 随之可用),结束时也据此登记;本次运行没有写出新会话文件(例如只跑了 claude --version)但目录里有旧会话时,补全首选退化为 claude --continue / codex resume --last。它不会自动执行任何命令。
  • 终端恢复协议(OSC 88):程序可以声明自己重启后应如何被拉起。printf '\e]88;query\a' 会收到 \e]88;supported;v=1\a;printf '\e]88;restart=nvim .\a' 声明恢复命令,\e]88;clear\a 撤销。声明只写入工作区快照,恢复时作为普通输入发送,不会被解释执行。
  • 恢复时重新运行进程:“不重启 / 仅白名单内 / 所有运行中的进程”。白名单按逗号分隔、按命令前缀匹配(npm run 匹配 npm run dev)。

优先级为 OSC 88 声明 > 复用器 > 普通进程;绑定了 Agent 会话的 Pane 只走 Agent 重连。恢复命令都在 Shell 首个 Prompt 出现时发送,用户在此之前输入任何内容即取消;开关在发送时读取,改完设置无需重新退出一次。

误关 Pane 或标签后按 ⇧⌘T 可按最近关闭顺序逐个恢复。关闭历史跨正常退出和崩溃保留;正常退出会恢复主窗口和仍打开的附加窗口,连续崩溃三次会绕过可能损坏的快照并打开干净 Shell。恢复期间若后台项目目录检查失败,Aster 会继续恢复工作区,缺失的项目信息按当前目录处理。可序列化布局会恢复,但不会持久化 PID、文件描述符或只读等临时状态。

MIT License · 崩溃报告与 CLI Agent 记忆提炼默认关闭