Plakar 恢复工作流程

此技能仅涵盖恢复操作。创建快照由 openclaw-plugin-plakar 插件自动处理——您无需手动运行 plakar backup。

何时提供恢复选项

当用户表达以下类似意图时，提供从 Plakar 快照恢复的选项：

• “撤销刚才的操作”、“回滚到之前的状态”、“恢复我的文件”
• “出问题了，能退回之前的状态吗？”
• “上一个工具调用把东西搞坏了”

前置条件

• plakar 必须在 $PATH 环境变量中可执行
• 存储路径需在插件配置中通过 plakar.store 提供
• 始终传递 -no-agent 参数，以避免依赖正在运行的 Plakar 代理守护进程

CLI 语法（v1.0.6 及以上版本）

所有命令均采用以下格式：

plakar -no-agent at <store> <command> [options]

列出所有快照

plakar -no-agent at <store> ls

输出内容：快照 ID、时间戳、大小、路径。将列表展示给用户，并询问希望从哪个快照恢复。

查看快照的内容

plakar -no-agent at <store> ls <snapshotID>
plakar -no-agent at <store> ls -recursive <snapshotID>:/path

用于确认快照中包含预期的状态，再进行恢复操作。

对比两个快照

plakar -no-agent at <store> diff <snapshotID1> <snapshotID2>
plakar -no-agent at <store> diff -highlight <snapshotID1>:/file <snapshotID2>:/file

用于向用户展示两个时间点之间的具体变更内容。

恢复快照

将所有文件恢复到原始路径：

plakar -no-agent at <store> restore <snapshotID>

恢复到指定目录：

plakar -no-agent at <store> restore -to /tmp/restore-here <snapshotID>

恢复快照中的特定路径：

plakar -no-agent at <store> restore -to /tmp/restore-here <snapshotID>:/path/to/file

在执行恢复前必须获得用户确认——恢复操作会覆盖当前的实时文件。

示例代理交互

用户：“上一次编辑破坏了我的配置文件，你能撤销一下吗？”

1. 执行 plakar -no-agent at <store> ls，并展示最近的快照列表
2. 询问：“是否要从快照 <id>（创建于 <timestamp>）恢复？”
3. 用户确认后，执行：plakar -no-agent at <store> restore -to <original-path> <id>
4. 确认恢复完成，并邀请用户检查文件是否已正确还原