文件版本时间线
在 qqqide 里，保存从来不是「覆盖」——每一次改动都会在项目的时间线上留下一个版本点。改错了、删掉了、想对比昨天那版：都找得回来。
一、什么会被自动记录
- 编辑器里 Ctrl+S 保存（以及编辑器失焦时的落盘）；
- AI 每次写入文件——版本点带着来源标签，形如
q12f3＝第 12 个任务 · 第 3 层楼； - AI 执行的 shell 命令改动的文件（默认关，可在设置里打开，减少快照噪音）；
- 恢复操作自身也会留痕（
restore/guard保护快照）。
所有快照存在项目自己的 _qqq 家目录（_qqq/timeline/）里——本地全量留存、内容不可变、跨年不清理。
二、打开时间线（两个入口）
- AI 视口里右键任意文件 →「时间线」（AI 视口是什么）；
- 楼层卡片的 A4 文件快照 里点某个文件 → 直接开这次改动的对比。
打开的独立窗口里：左右两个版本下拉任选对比；顶部路径框可以直接键入别的文件（全库模糊匹配，记得文件名片段就能找到）；▼ 进入「记忆库」目录浏览器。
三、对比与恢复
- 仅差异 / 全文：左下角「仅差异」开关，切换后记住偏好。
- 编辑：点「编辑」进入右侧可编辑模式，保存会写盘并自动记一个新版本点。
- 写回此版本：选中任意历史版本 → op 菜单「写回此版本」。覆盖前会先给当前磁盘内容记一条保护快照——永远有后悔药。
- op 菜单还有：
open in qqqide（打开文件）／ 喂给 AI ／ Roam（定位到目录）。
四、找回已删除的文件
「磁盘上没有的，记忆里有」：
- 顶部路径框输入文件名，下拉里带 🗑️ 标记的就是已删除文件；或 ▼ 进记忆库，勾选「只看已删除」。
- 点开它：纯历史模式——只读浏览，禁止编辑。
- op 菜单 →「恢复文件」：父目录自动重建、按原文编码写回原路径。
五、和 git 的分工
- 时间线：全自动、本地、细颗粒（每个保存点），负责「找回来」与「对照最近改了什么」；
- git：手动提交、协作与发布，负责里程碑——见 git 指南。
一个典型配合：AI 连续改动把某文件改崩 → 时间线逐版本回放定位 → 挑一版「写回」或手动修好 → git 提交这一屏干净版本。
延伸阅读：家目录：_qqq（timeline 目录里到底存了什么）