排错手册：常见坑与自救指南

先等——大活（读几十个文件）本来就慢。真卡死了按 Esc 打断，换个说法重派。同一句话卡两次，就把活拆小：先只做第一步。

上下文满了（会话课的老朋友）。结论落文件 → /clear 或开新会话。长活用 /compact 续命。

高频改文件的活切 acceptEdits 挡（Shift+Tab）；同类操作选 [a] 本会话允许。但删除类弹窗永远逐个看——烦，是它在保命。

先别慌：「把 XX 文件恢复到你改之前的样子」——它记得自己的改动。恢复不了就用备份（Hook 课配的备份钩这时救命）。预防永远比抢救便宜：重要文件夹上门禁 + 自动备份。

八成是工作目录不对。问它「你现在在哪个文件夹工作」，或干脆用 @ 点名——@ 是精确制导，永远比口头描述「那个文件」可靠。

报 rate limit 就是额度到了：等恢复，或把不急的活挪到低峰期。网络类报错先重试一次，再检查网络——别急着怀疑自己配置。

按顺序查三样：电脑到点开着吗（本地任务）→ 手动跑那条命令还通吗 → 素材源还在原来的位置吗。这就是为什么心跳指标是必装件。