Kilo Code Checkpoints 怎么把 AI 改错的代码回滚到之前状态【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode让 Kilo Code 的 agent 连续改了几个文件之后结果发现方向错了想恢复到它动手之前的代码状态——这就是 Checkpoints在新版 VS Code 扩展里叫snapshots要解决的问题。Kilo Code 在执行任务时会自动对工作区文件做版本化快照你不需要手动打 tag 或提交 Git直接在聊天界面点击消息上的Revert to here按钮就能把工作区文件恢复到某条用户消息发送之前的状态同时把聊天回退到那个时点。本文基于仓库文档 Checkpoints 整理覆盖 VS Code 扩展与 CLI 两种界面下的回滚操作。前提确认 Git 可用且快照已启用Checkpoints 依赖系统安装的 Git。文档明确说明如果 Git 不可用或者工作区不是 Git 仓库Kilo 会自动跳过 checkpoints不需要你手动关闭。先验证 Git 是否可用git --version各平台的安装方式文档给出macOSbrew install git推荐或xcode-select --install通过 Xcode Command Line Tools 安装Debian/Ubuntusudo apt update sudo apt install gitFedorasudo dnf install gitArch Linuxsudo pacman -S git快照snapshots在新版扩展中默认开启。如果之前被关掉过可以在配置文件kilo.jsonc或~/.config/kilo/kilo.jsonc中确认{ snapshot: true }也可以在 VS Code 扩展里通过 Settings齿轮图标→Checkpoints选项卡切换 snapshot 开关。两点机制说明理解它们能帮你判断回滚为什么生效或不生效快照存储在项目目录之外的专用 Git 仓库中路径为~/.local/share/kilo/snapshot/project-id/worktree-hash/。你项目自己的.git历史不会被快照系统修改。快照在每个模型调用步骤的边界自动采集步骤开始前、步骤结束且工具执行完成后各一次但回滚粒度是按用户消息你只能回退到某条用户消息发送之前不能回退到 agent 单次回复内部的中间步骤。如果 agent 在一次回复里分多步改了多个文件回滚会一次性撤销这些改动。快照遵循.gitignore规则被忽略的文件如node_modules/、dist/、.env不会进入快照。VS Code 扩展回滚到之前状态的操作步骤第一步查看 agent 这一轮改了哪些文件每个修改过文件的 agent 回复都会显示一个可折叠的 diff 摘要列出改动文件及增删行数。点击摘要可展开点击具体文件会在 VS Code 编辑器中打开并排 diff。先确认改错的范围再执行回滚。第二步点击 Revert to here将鼠标悬停在用户消息上会显示一个左箭头图标的Revert to here按钮注意回滚点只出现在用户消息上agent 回复本身不提供回滚点。点击Revert to here会同时做两件事恢复工作区文件到该消息发送之前的状态隐藏之后所有的聊天消息让你看到该时点的会话。该按钮只在 agent 空闲时可用agent 正在运行时按钮处于禁用状态防止操作中途回滚。第三步在 Revert Banner 上确认或撤销回滚后聊天底部会出现Revert Banner显示被回滚的消息数如 1 message reverted 或 3 messages reverted每个被撤销文件的增删行数明细提示语 Send a new message to make this permanent。Banner 提供两个动作Redo— 逐条消息向前恢复重新应用下一条被回滚消息的改动Redo All— 把工作区恢复到最新状态并显示全部消息仅在回滚了多条消息时显示。此时回滚仍是非破坏性的你可以反复 Redo / Redo All 对比不同状态不会丢失任何内容。确认要放弃 agent 的改动后发送一条新消息即可从回滚点分叉被回滚的消息会从会话中永久删除agent 从恢复后的状态继续。这就是撤销 agent 的工作、换一种做法的标准路径。回滚后文件没有被恢复看 Banner 的警告如果点击 Revert 后 Banner 提示只回退了会话、没有恢复文件文档给出了两种原因及对应处理Snapshots disabled快照被禁用文件改动未被恢复。Banner 会提供Enable snapshots按钮点击后跳转到 Settings → Checkpoints 打开开关。No checkpoint available回滚范围内没有存储的快照例如回滚到了 checkpoints 启用之前的区间工作区改动仍留在磁盘上。CLI三种回滚方式在 CLI 的终端界面中checkpoints 同样作为回滚点出现在会话里通过选择对应的消息回退。文档列出的能力包括Full revert把工作区回滚到会话中的任意时点Undo a revert恢复到最后一次回滚之前的状态Per-file revert只撤销指定文件的改动保留其他文件的修改。CLI 中快照同样由kilo.jsonc配置文件的snapshot布尔值控制启用后系统会在任务的每个步骤自动采集快照。限制与注意事项以下边界来自文档回滚前值得对照检查范围Checkpoints 只捕获 Kilo Code 任务执行期间发生的改动任务之外的修改手动编辑、其他工具不在其中。未保存的工作恢复会覆盖工作区中未保存的改动。大文件非常大的二进制文件可能影响性能。清理策略快照数据按项目存放并定期清理后台进程每小时执行git gc --prune7.days删除超过 7 天不可达的快照对象。由于快照以原始 tree hash 存储不是 ref 或 commit较早的快照可能被垃圾回收清除即使会话仍引用它们——所以回滚到很早之前并不总是有 checkpoint 可用。完成一次回滚后用 Banner 上的文件级增删明细对照你第一步看到的 diff 摘要即可核对恢复结果是否符合预期。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考