SuperAPI AI 工具集

session-recovery

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:当 Copilot CLI 会话因终端崩溃、断网、重启或误关窗口而中断时,该技能教代理通过只读方式查询 session_store 数据库(用 sql 工具,database: "session_store"),定位中断会话并恢复工作。

主要能力:查询 sessions 表按时间窗口查找最近会话并附最后检查点;通过 turns 表过滤 keep-alive、heartbeat 等自动化会话;用 search_index(FTS5)按关键词检索,需自行扩展同义词;按工作目录筛选;在恢复前查看会话上下文,包括 turns(对话轮次)、checkpoints(检查点进度)、session_files(触及文件)、session_refs(关联 PR/issue/commit);结合 session_refs 发现遗留 issue 工作,并与 gh issue list --label "status:in-progress" 交叉核对。

使用方式:先按模式执行只读查询,拿到完整 UUID 后直接运行 copilot --resume SESSION_ID 恢复。

限制:FTS5 是关键词检索而非语义检索;查询需转义特殊字符(路径用双引号包裹);检索会话 ID 必须用完整 UUID;不应恢复已成功完成的会话;不跳过自动化会话过滤,否则结果会被大量噪点淹没;需重视检查点数据以判断确切中断位置。