kkfor30/kk-sessions / skills/kk-session-restore
kk-session-restore
Verified撤销 kk-sessions 对侧栏做过的改动:按首次使用前存下的快照,把会话标题和所在分区恢复原样,删除 kk-sessions 新建的分区。用户说"撤销 kk-sessions 的改动""恢复会话原样""回滚会话整理""kk-session-restore"时使用,通常在停用或卸载 kk-sessions 之前;卸载后也能用(见「卸载后」)。支持 Claude Code 桌面端和 Codex 桌面端。不删除会话,不移动或删除磁盘上的文件夹。
kk-session-restore
输入
- 快照目录:
~/.agent-rules/kk-sessions/snapshots/,文件名<agent>-<YYYYMMDD-HHMMSS>.json(agent为claude或codex)。默认用当前 Agent 最早的一份,那是 kk-sessions 第一次改动侧栏之前的状态;用户指定了某一份就用那份。 - 快照格式和存法见下面「快照」;六个动作的做法见 kk-session-route 的「适配」一节,这里用列出全部会话、改标题、移入分区,外加删除分区。
没有当前 Agent 的快照时,说明无法自动恢复,列出地图里的分区名,建议用户手动删除这些分区,然后结束。
Codex:直接跑脚本
在 Codex 里一律运行脚本,不要按下面「流程(Claude Code)」逐个调用工具:脚本几秒就完成,逐个操作要几分钟,还容易漏(不调模型,需要 Codex 桌面端开着):
python ~/.agent-rules/kk-sessions/restore/restore.py # 先列出要改什么
python ~/.agent-rules/kk-sessions/restore/restore.py --apply # 用户确认后执行
把第一条的输出给用户看,用户明确确认后再加 --apply。脚本按下面第 2 步的规则算差异,执行前记下恢复前的状态,执行后把快照收进 restored-<时间>。
流程(Claude Code)
- 读快照和现状:并行读取快照、列出全部会话(含已归档)、列出分区。
- 算差异,只处理快照里有的会话:
- 标题和快照不同:现在的标题是
<类型emoji> <主题>|…格式(kk-sessions 改的)→ 改回快照标题;不是这个格式 → 用户后来自己改过,跳过。 - 所在分区和快照不同:现在在 kk-sessions 建的分区、地图里的分区或未分组 → 移回快照里的分区(那个分区已不存在就移回未分组);在用户自己建的其他分区 → 跳过。置顶的会话不动。
- 快照里没有、现在存在的分区 → kk-sessions 新建的,列入待删除。
- 分区 ID 还在、名字和快照不同 → kk-session-setup 对齐时改过名,改回快照里的名字。
- 快照之后新建的会话不改标题;它们所在的分区被删除后会自动回到未分组。
- 标题和快照不同:现在的标题是
- 和用户确认:给出几项数字(改回标题几个、移回分区几个、改回分区名哪几个、删除分区哪几个、跳过几个及原因),再列出前 10 条标题改动(现在 → 恢复后)。用户明确确认才执行。
- 先存一份当前快照,按下面「快照」的方法存,让这次恢复本身也能撤销。
- 执行:先改标题,再改回分区名,然后按目标分区批量移动,最后删除待删除的分区。当前 Agent 删除不了分区时,把名字列给用户手动删。
- 收尾:全部成功后,只把当前 Agent 的快照文件(
claude-*.json或codex-*.json)移到同级的restored-<YYYYMMDD-HHMMSS>/里,另一个 Agent 的快照留在snapshots/,不要整个目录改名,表示已恢复(安装脚本据此允许卸载;以后再用 kk-sessions 会重新存一份起点快照)。报告改了几处、哪些没成功。提醒用户:要彻底移除,就停用或卸载 kk-sessions 插件(用安装脚本装的,运行python install.py --uninstall);工作区地图~/.agent-rules/workspace-map.md会保留,不需要可自己删。
卸载后
kk-sessions 改过侧栏后,会把回退工具复制到 ~/.agent-rules/kk-sessions/restore/:restore.py(Codex 用)和 RESTORE.md(就是本文件)。插件卸载或停用后:
- Codex:照样运行上面的
restore.py。 - Claude Code:在新会话里说「读 ~/.agent-rules/kk-sessions/restore/RESTORE.md,按里面的流程撤销 kk-sessions 的改动」。
快照
kk-session-setup、kk-session-tidy、kk-session-route 在第一次改动侧栏之前都要检查快照目录:已有当前 Agent 的快照就跳过,没有就存一份。本 Skill 在恢复前也存一份。
存法:列出全部会话(含已归档)和分区,写成 JSON。会话超过 100 个时,只记最近 30 天活动过的会话加上本次要改动的会话;恢复本来就只处理快照里记过的会话:
{
"agent": "claude",
"created": "2026-11-11T09:30:00+08:00",
"sections": [{"id": "cg-…", "name": "🟣 内容制作"}],
"sessions": [{"id": "local_…", "title": "原标题", "section": "cg-…或 null", "archived": false}]
}
只记标题、分区和是否归档,不记聊天内容。
边界
- 不删除会话,不归档或取消归档,不改置顶。
- 不移动、不删除磁盘上的文件夹:kk-session-route 建的主题目录里可能已经有产物。需要清理时列出快照之后新建、只有
README.md的目录,让用户自己决定。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |