用途:为编码智能体运行时设计或评审会话生命周期,包括会话身份、转录持久化、恢复流程、缓存清理与跨 worktree 恢复。
主要能力:定义会话模型(项目、worktree、session_id、标题、运行模式);区分可还原状态(转录、摘要、工具状态、任务状态、提供方缓存元数据)与需重算的缓存;支持按 UUID 精确恢复、标题匹配与选择器/搜索回退;明确同仓库 worktree 采用与跨项目恢复的不同路径;覆盖检查点回退(/rewind、Esc Esc)与摘要式回退模式。
使用方式:文档给出 ASCII 流程(新调用或恢复→会话身份→状态还原→分支决策 continue/rewind/compact/clear/fork/精确恢复→活动轮次)及参考文件索引,按主题(生命周期、转录恢复、上下文分支、子智能体分叉、恢复路径决策树、Codex 会话协议)展开。
限制:仅覆盖会话运行时状态,不含项目记忆(另见 agents-memory);检查点只跟踪编辑器工具所做的文件改动,不覆盖 bash 命令等外部改动;同仓库与跨项目恢复须走不同代码路径;恢复失败需有直接日志回退。文中未提供价格或平台支持范围信息。