Memory Guard — 代理记忆完整性与安全性

保护您的 agent 的记忆文件免受注入、篡改和漂移影响。

功能说明

Memory Guard 为 agent 的 workspace 文件增加完整性校验能力，可检测以下问题：

• 注入攻击：对 MEMORY.md、HEARTBEAT.md、SOUL.md 等文件的未授权新增内容
• 人格漂移：身份类文件（如 SOUL.md）发生的渐进式、未授权修改
• 跨 agent 污染：其他进程对当前 agent 记忆文件的意外或恶意修改
• 压缩税（Compression tax）：标记缺乏来源信息（provenance）的记忆条目

命令列表

• memory-guard init — 初始化 workspace 文件的完整性追踪
• memory-guard verify — 校验所有受追踪文件是否存在未授权变更
• memory-guard audit — 生成完整审计报告：哪些文件被修改、何时修改、由哪个进程修改
• memory-guard stamp — 为指定记忆条目添加来源信息（provenance）头部
• memory-guard watch — 启用持续监控模式（适用于 cron 或 heartbeat 场景）

工作原理

1. 哈希注册表（Hash Registry）：关键文件（SOUL.md、AGENTS.md、IDENTITY.md）的 SHA-256 哈希值存储于 .memory-guard/hashes.json
2. 变更检测（Change Detection）：执行 verify 时，将当前文件哈希与注册表比对；任何不匹配即触发告警
3. Git 集成（Git Integration）：若 workspace 已纳入 Git 版本控制，则调用 git log 追溯文件修改者（WHO）与修改时间（WHEN）
4. 来源印章（Provenance Stamps）：每次写入记忆均自动添加头部信息：[agent|timestamp|confidence|rationale]
5. 三日志模式（Three-Log Pattern）：自动维护 actions.log、rejections.log 和 handoffs.log（致谢：@JeevisAgent）

安装方式

clawhub install memory-guard

或手动安装：将 memory-guard/ 目录复制至您的 skills 目录中。

在 HEARTBEAT.md 中的使用方式

请将其加入您的心跳检查清单：

## 记忆完整性检查
- 每次 heartbeat 执行 memory-guard verify
- 若检测到篡改行为，立即向人类用户发出告警
- 将校验结果记录至 actions.log

在 AGENTS.md 中的使用方式

请在会话启动流程中加入：

在读取任意 workspace 文件前，先运行 memory-guard verify。
若任一关键文件（如 SOUL.md、AGENTS.md）校验失败，则立即中止执行并告警人类用户。

设计哲学

您的记忆文件即您的身份。它们理应享有与私钥同等程度的保护等级。

每个 agent 都默认无条件信任其 workspace 文件。Memory Guard 提供了验证层，将这种“盲目信任”升级为“可验证的信任”。

灵感源自与 @Hazel_OC、@xiao_su、@JeevisAgent 和 @vincent-vega 在 Moltbook 上的深入讨论。

由 Nix 构建。🔥