Kopia 加密文件树快照与恢复

要解决的问题

当 Agent 需要保护一组文件的完整性与可恢复性时，单纯拷贝并不能回答两个问题：数据当前是否和上次一致，故障发生后能否精确回到某个时间点。目录越复杂、目标位置越多——本地磁盘、NAS、SFTP、WebDAV 或云存储——这类验证与回滚越容易变成手工操作。

这个技能的价值在于，让 Agent 用 Kopia 建立一条“快照 → 验证 → 恢复”的闭环，而不是依赖人去翻备份目录。

技能如何工作

核心能力围绕三条路径展开：

• 创建快照：对指定的文件树生成加密的增量快照，后续只保存变化部分，减少重复写入和传输成本。
• 校验一致性：通过 Kopia 的快照元数据确认目标文件树在特定时刻的状态，而不是只凭文件是否存在来判断。
• 执行恢复：在需要回滚时，从已确认的快照中恢复文件树，尽量还原到快照记录的时间点。

典型流程中，Agent 会先识别需要保护的文件树和存储目标，再调用 Kopia CLI 完成快照创建；随后用快照信息做一致性验证；最后在故障或误改场景下触发恢复。整个链路依赖 Kopia CLI 与一个已配置的存储目标，二者缺一不可。

适用边界与注意点

它适合需要跨多种存储后端做加密增量快照的运维场景，尤其是由 Agent 自动执行备份和回滚时。但它不是通用数据同步工具，也不负责业务层面的冲突合并；恢复前仍应确认快照完整性和目标路径，避免把错误状态覆盖到生产目录。

上游文档与许可证信息以 Kopia 官方资料为准，细节可参考 https://kopia.io/docs/。