mmxagent-guardian

核心功能

mmxagent-guardian 是一款面向 OpenClaw 用户的文件安全保护技能，基于 MiniVCS 引擎实现版本化管理。核心机制包括：文本文件采用增量 diff + 完整快照双备份策略，支持任意历史状态回滚；删除操作将文件移至隔离垃圾桶而非物理删除，支持一键恢复；所有记录按重要性分级（系统路径/配置文件保留 14 天，普通文件 7 天），自动扫描过期记录并提示清理。

显著优势

• 零配置即用：首次运行时自动初始化存储目录，无需手动设置
• 智能分级保护：自动识别重要文件（/etc/、~ 目录、.yaml 等配置），延长保留期
• 双向安全保障：修改可回滚、删除可恢复，形成完整操作闭环
• 过期主动提醒：每次操作后自动检测过期记录，避免静默数据堆积
• 跨平台兼容：支持 macOS、Linux、Windows，提供 Python 缺失时的完整安装指引（含中国大陆镜像）

局限性与注意事项

• 首条记录不可回滚：首次追踪某文件时缺乏历史基线，该次修改无法撤销
• 二进制文件存储开销大：图片、PDF 等无法生成 diff，每次保存完整副本，需提前告知用户存储成本
• 依赖 Python 3 环境：执行前必须检测并引导安装，增加首次使用门槛
• 手动确认流程较重：每次操作前需解释五项内容（路径、类型、目的、影响、保护范围），可能降低高频操作效率

适用人群

• 使用 OpenClaw 进行代码/配置文件批量处理的技术用户
• 对操作安全性要求高、担心误删误改的开发或运维人员
• 需要审计追踪和合规留存的企业场景

风险提示

• 二进制文件备份策略与文本文件差异显著，若未明确告知用户可能导致磁盘空间意外耗尽
• 过期记录清理需用户主动确认，长期忽略可能造成 ~/.openclaw/minivcs/ 目录膨胀
• Python 环境安装涉及系统级变更，需确保用户理解 Homebrew/apt 等包管理器的权限影响

核心用法

mmxagent-guardian 是一款轻量级文件版本管理 Skill，通过 MiniVCS 引擎为用户的文件操作提供完整保护。其工作流程分为四个阶段：

1. 前置检查：自动检测 Python 3 环境，缺失时提供跨平台安装指引（含中国大陆镜像加速）
2. 操作确认：每次修改或删除前向用户完整披露文件路径、操作类型、影响范围及保护机制
3. 版本记录：文本文件生成增量 diff 与完整快照，二进制文件保存 .bak 备份，删除文件移至 trash 目录
4. 过期清理：每次操作后自动扫描过期记录，由用户确认删除或延期

关键命令：

• record <file> — 修改后记录，形成可回滚链
• delete <file> — 安全删除（移至 trash）
• restore <record_id> — 恢复删除或回滚修改
• history / trash / cleanup — 历史查询与清理

显著优点

• 零依赖安全：仅使用 Python 标准库（os/sys/json/shutil/difflib），供应链攻击面为零
• 本地隐私优先：所有数据存储于 ~/.openclaw/minivcs/，无网络通信，符合 GDPR 最小化原则
• 细粒度回滚：文本文件支持逐版本回滚至任意历史状态，删除文件 7-14 天内可恢复
• 智能分级保留：自动识别重要文件（系统路径、配置文件、入口文件）延长保留至 14 天
• 操作可审计：完整记录文件路径、操作类型、时间戳、变更摘要及过期时间

潜在局限

• 二进制文件开销：图片、PDF 等无法生成 diff，每次记录保存完整副本，存储占用较高
• 首次记录无快照：文件首次被记录时无历史基线，该次修改无法回滚
• T3 来源可信度：个人/社区项目，无公开 GitHub 仓库，虽经 CLS-Certify 认证但仍依赖静态分析
• 需用户主动调用：非自动后台监控，每次修改后需手动执行 record

适合人群

• 开发者进行代码重构或配置文件调整，需要"后悔药"机制
• 运维人员管理系统关键文件，需保留操作痕迹与恢复能力
• 对数据隐私敏感、拒绝云同步服务的本地优先用户
• 希望获得类 Git 版本控制但无需学习复杂命令的轻量需求者

常规风险

• 存储膨胀：频繁修改的大文本文件或二进制文件可能迅速消耗磁盘空间
• 过期误删：未及时处理清理通知可能导致重要历史记录永久丢失
• 路径依赖：所有操作基于相对路径与 project-root，跨设备迁移需保持目录结构一致
• 权限问题：对系统目录操作可能需额外权限，但 Skill 本身未内置提权机制