核心功能
mmxagent-guardian 是一款面向 OpenClaw 用户的文件安全保护技能，基于 MiniVCS 引擎实现版本化管理。核心机制包括：文本文件采用增量 diff + 完整快照双备份策略，支持任意历史状态回滚；删除操作将文件移至隔离垃圾桶而非物理删除，支持一键恢复；所有记录按重要性分级（系统路径/配置文件保留 14 天，普通文件 7 天），自动扫描过期记录并提示清理。
显著优势
- 零配置即用：首次运行时自动初始化存储目录，无需手动设置
- 智能分级保护：自动识别重要文件（
/etc/、~目录、.yaml等配置），延长保留期 - 双向安全保障：修改可回滚、删除可恢复，形成完整操作闭环
- 过期主动提醒：每次操作后自动检测过期记录，避免静默数据堆积
- 跨平台兼容：支持 macOS、Linux、Windows，提供 Python 缺失时的完整安装指引（含中国大陆镜像）
局限性与注意事项
- 首条记录不可回滚：首次追踪某文件时缺乏历史基线，该次修改无法撤销
- 二进制文件存储开销大：图片、PDF 等无法生成 diff，每次保存完整副本，需提前告知用户存储成本
- 依赖 Python 3 环境：执行前必须检测并引导安装，增加首次使用门槛
- 手动确认流程较重：每次操作前需解释五项内容（路径、类型、目的、影响、保护范围），可能降低高频操作效率
适用人群
- 使用 OpenClaw 进行代码/配置文件批量处理的技术用户
- 对操作安全性要求高、担心误删误改的开发或运维人员
- 需要审计追踪和合规留存的企业场景
风险提示
- 二进制文件备份策略与文本文件差异显著，若未明确告知用户可能导致磁盘空间意外耗尽
- 过期记录清理需用户主动确认，长期忽略可能造成
~/.openclaw/minivcs/目录膨胀 - Python 环境安装涉及系统级变更，需确保用户理解 Homebrew/apt 等包管理器的权限影响