Skip to content

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 桌面端。不删除会话,不移动或删除磁盘上的文件夹。

FileKindSize
SKILL.mdskill md5.2 KB
---
name: kk-session-restore
description: 撤销 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)

1. **读快照和现状**:并行读取快照、列出全部会话(含已归档)、列出分区。
2. **算差异**,只处理快照里有的会话:
   - 标题和快照不同:现在的标题是 `<类型emoji> <主题>|…` 格式(kk-sessions 改的)→ 改回快照标题;不是这个格式 → 用户后来自己改过,跳过。
   - 所在分区和快照不同:现在在 kk-sessions 建的分区、地图里的分区或未分组 → 移回快照里的分区(那个分区已不存在就移回未分组);在用户自己建的其他分区 → 跳过。置顶的会话不动。
   - 快照里没有、现在存在的分区 → kk-sessions 新建的,列入待删除。
   - 分区 ID 还在、名字和快照不同 → kk-session-setup 对齐时改过名,改回快照里的名字。
   - 快照之后新建的会话不改标题;它们所在的分区被删除后会自动回到未分组。
3. **和用户确认**:给出几项数字(改回标题几个、移回分区几个、改回分区名哪几个、删除分区哪几个、跳过几个及原因),再列出前 10 条标题改动(现在 → 恢复后)。用户明确确认才执行。
4. **先存一份当前快照**,按下面「快照」的方法存,让这次恢复本身也能撤销。
5. **执行**:先改标题,再改回分区名,然后按目标分区批量移动,最后删除待删除的分区。当前 Agent 删除不了分区时,把名字列给用户手动删。
6. **收尾**:全部成功后,只把当前 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 天活动过的会话加上本次要改动的会话;恢复本来就只处理快照里记过的会话:

```json
{
  "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` 的目录,让用户自己决定。
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 323kUpdated Claude CodeCodexVerifiedInstall