Eason Soul Guardian（灵魂守护者）是一款专为智能体工作区设计的文件完整性守护工具，核心功能是检测并防止关键配置文件的无授权变更。它通过建立文件基线、实时监控和自动恢复机制，确保如 SOUL.md、AGENTS.md 等重要文档始终处于受控状态。当检测到未经批准的修改时，Soul Guardian 不仅能自动将文件恢复到原始版本，还会生成清晰的告警信息供用户审查。该工具特别适用于需要高安全性与可审计性的开发环境，能够有效应对误操作或潜在的安全威胁。
Soul Guardian 的设计理念基于“预防优于修复”的原则，采用哈希校验（SHA-256）比对当前文件内容与已批准的基线版本。其内置的审计日志采用链式结构存储，具备防篡改特性，为事后追溯提供了可靠依据。此外，工具支持静默检查模式，可与心跳脚本集成，实现自动化监控流程。所有操作均避免直接处理符号链接，并通过原子写入方式执行恢复动作，进一步保障系统稳定性。
尽管 Soul Guardian 无法识别具体是谁修改了文件（即无法确证操作者身份），但它通过记录变更时间、触发者和补丁差异等方式提供尽可能多的上下文信息。官方建议将状态目录置于工作区之外，以增强整体防护能力。总体而言，这是一款轻量级但功能完备的安全守护程序，旨在为 AI 代理的工作流提供一道坚实的安全防线。
核心功能特点
- 自动检测关键配置文件（如 SOUL.md、AGENTS.md）的未授权变更
- 支持自动恢复被篡改文件至批准基线，并生成详细告警信息
- 维护防篡改的审计日志，采用哈希链技术确保操作可追溯
- 提供静默检查与持续监控两种运行模式，适配不同使用场景
- 输出格式专为 TUI/聊天界面优化，便于即时通知用户
适用场景
Soul Guardian 最适用于对配置一致性要求严格的智能体开发环境。例如，在团队协作中，多个成员可能同时编辑 SOUL.md 或 AGENTS.md 文件，容易因并发修改导致内容冲突或意外覆盖。此时，启用 Soul Guardian 可自动拦截此类漂移行为，并在第一时间通知负责人，避免系统偏离预期行为模型。对于部署在共享服务器上的长期运行代理，该工具还能防止恶意脚本或自动化任务误改核心文档，提升整体系统健壮性。
另一个典型应用场景是 CI/CD 流水线集成。开发者可在 HEARTBEAT.md 中嵌入 Soul Guardian 的检查命令，使其定期验证工作区完整性。一旦发现异常，立即中断流程并上报错误，从而实现“零容忍”的配置管理策略。此外，在安全敏感项目中，即使攻击者短暂获取了工作区访问权限，只要无法同时控制状态目录，Soul Guardian 仍能有效阻止其对关键文件的持久化篡改。
日常运维层面，Soul Guardian 也极具实用价值。无论是本地调试还是远程部署，用户均可通过 watch 模式实现后台持续监控，设置合理的时间间隔（如每30秒一次），实时掌握文件变动情况。若确认某次变更为合法更新，还可使用 approve 命令将其标记为正式基线，形成闭环管理机制。这种灵活性与自动化结合的能力，使其成为现代智能体工作流不可或缺的安全组件。