文件修改可回滚，删除可恢复

基于 MiniVCS 的文件保护技能，提供修改回滚与删除恢复，支持增量 diff 与本地快照，保留策略自动过期清理。

基本信息

• 技能名称?mmxagent-guardian
• 中文名称?文件修改可回滚，删除可恢复
• 作者?oreoandyuumi
• 分类?专业技能
• 版本?1.0.3
• 标签?backup, version-control, file-protection, recovery, minivcs

使用方法

使用说明
核心功能
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 移除将导致技能失效