核心功能
mmxagent-guardian 是专为 OpenClaw 设计的文件保护技能，通过 MiniVCS 引擎实现版本化管理。该技能对用户的文件操作（修改、删除）建立索引，支持修改回滚与删除恢复，所有保护数据本地存储于 ~/.openclaw/minivcs/。
工作机制：文本文件修改时保存增量 diff 与完整快照，支持逐版本回滚；删除文件时移至本地 trash 目录而非永久删除；二进制文件因无法生成文本 diff，采用完整 .bak 备份方案。系统根据文件重要性自动设定 7 天（普通文件）或 14 天（重要文件）保留期，每次操作后自动扫描过期记录并提示清理。
显著优点
1. 零配置即用：首次运行时自动初始化存储目录，无需额外设置
2. 细粒度回滚：文本修改支持逐版本回滚，可精确恢复到任意历史状态
3. 智能分类管理：自动识别系统配置、密钥目录等重要路径，延长保留期
4. 防御性设计：强制用户确认机制，操作前明确告知本地存储行为与影响
5. 自动过期清理：内置保留策略，避免无限堆积，同时支持延期保留
潜在局限
- 首版无回滚：文件首次被记录时无历史快照，该版本无法回滚
- 二进制存储开销：>50MB 二进制文件触发大小警告，完整备份可能占用显著磁盘空间
- 无加密与远程同步：本地明文存储，跨设备恢复需手动迁移
- 依赖 Python 3：运行环境必须预装 Python 3，不可自动安装
- 路径排除限制：
node_modules、.git等 15 类缓存目录自动跳过，无法强制追踪
适合人群
- 频繁修改配置文件、脚本的原型开发者
- 需要安全网才敢执行删除操作的风险厌恶型用户
- 本地项目版本管理需求简单、不愿配置完整 Git 的轻量用户
常规风险
- 存储泄露风险：保护数据本地明文存放，共享设备需注意权限
- 磁盘空间膨胀：大体积二进制文件备份可能快速消耗磁盘
- 误操作覆盖：
restore命令直接覆盖现有文件，需谨慎确认 record_id - 过期不可挽回：保留期结束后记录被清理，数据永久丢失
- Python 依赖断裂：环境升级或 Python 移除将导致技能失效