核心用法
mmxagent-guardian 是一款为 OpenClaw 用户设计的文件保护与版本管理 Skill，基于 MiniVCS 实现。核心功能包括：
修改保护：每次编辑后调用 record_modify，系统自动生成增量 diff 和完整快照，支持随时回滚到任意历史状态。首次记录时无快照（无法回滚），此后每次修改都保存前状态，形成可回溯的修改链。
删除保护：不直接删除文件，而是调用 record_delete 将完整文件移至 ~/.openclaw/minivcs/trash/，支持随时恢复至原路径。
智能保留策略：系统文件、配置文件、入口文件等重要文件保留 14 天，普通文件保留 7 天。每次操作后自动扫描过期记录，提示用户清理或延期。
二进制文件支持：无法生成文本 diff，改用完整 .bak 备份，需提前告知用户存储开销。
显著优点
- 零配置初始化：首次使用自动创建存储目录，无需手动设置
- 操作前强制确认：每次删除/修改前必须说明目的、影响及本地存储行为，降低误操作风险
- 双重恢复机制：修改支持回滚到任意历史版本，删除支持从回收站完整恢复
- 过期自动提醒：操作后自动检测过期记录，避免存储无限增长
- 跨平台兼容：支持 macOS、Linux、Windows，自动适配
python/python3命令差异
潜在缺点与局限性
- Python 3 强依赖：无 Python 环境则完全不可用，且禁止自动安装或修改系统配置
- 首次记录无回滚：新文件的首次修改无法回滚，存在操作窗口风险
- 本地存储无加密：保护数据明文存储于
~/.openclaw/minivcs/，无远程同步，设备损坏或更换时数据丢失 - 二进制文件开销大：图片、PDF 等文件需完整备份，频繁操作大文件将显著占用磁盘空间
- 手动清理机制：过期记录需用户主动确认删除，无法自动归档或压缩
适合人群
- 频繁修改配置文件、代码的开发者，需要"后悔药"机制
- 处理重要系统文件的管理员，对误删除风险敏感
- 本地工作环境稳定、磁盘空间充足的用户
- 不需要团队协作或云端备份的个人用户
常规风险
- 存储目录意外删除：
~/.openclaw/minivcs/被清空将导致所有保护数据丢失 - 保留期误判：用户可能误以为"删除恢复"是永久功能，忽略 7/14 天过期限制
- 二进制文件存储未确认：未提前告知用户存储开销可能导致磁盘空间突然不足
- Python 环境变动：系统升级或虚拟环境切换可能导致 Skill 突然失效