基于 MiniVCS 的文件保护技能，提供修改回滚与删除恢复，支持增量 diff 与本地快照，保留策略自动过期清理。
说明：
## 核心功能
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 移除将导致技能失效
会员专属
