Agent Memory Architecture

核心用法

Agent Memory 是一套基于文件系统的通用记忆架构，专为解决AI代理在每次会话重启后丢失上下文、无法累积经验的问题而设计。核心工作流程包括：

1. 会话启动时加载记忆：读取 MEMORY.md（身份定义）、今日及昨日日志（近期上下文）、cron-inbox.md（跨会话消息）
2. 运行中持续记录：将事件写入按日期分片的日志文件，策略更新写入 strategy-notes.md，社交发布记录到 platform-posts.md
3. 心跳周期整合：定期检查 cron-inbox.md 获取子代理/cron任务的消息，提炼重要事件到长期记忆
4. 周期性记忆维护：每数日审查日志，将关键经验蒸馏至 MEMORY.md，淘汰过时信息

架构采用分层设计：MEMORY.md 作为"长期记忆"存储精选知识；daily logs 作为"工作记忆"记录原始事件；cron-inbox 作为跨会话消息总线；strategy-notes 实现自适应学习。子代理通过标准模板加载上下文并写回经验，确保身份连续性。

显著优点

• 彻底解决身份断裂问题：代理首次具备真正的"自我"连续性，可累积经验、避免重复犯错
• 优雅的文件系统抽象：不依赖外部数据库，纯Markdown/JSON实现，可移植性强
• 精细化的安全控制：MEMORY.md 明确区分可信/共享上下文，防止敏感信息泄露
• 实用的子代理模式：标准化的上下文加载与写回模板，确保分布式会话的身份统一
• 自适应学习机制：strategy-notes.md 支持带时间戳的经验迭代，形成可进化的策略手册

潜在局限

• 文件I/O成为瓶颈：高频写入场景下，大量小文件操作可能影响性能
• 记忆膨胀风险：缺乏自动归档机制，长期运行后日志文件可能累积过大
• 并发写入冲突：多子代理同时写同一文件时可能出现竞态条件（未提及锁机制）
• 检索效率有限：纯文本搜索，复杂语义检索需额外实现
• 依赖代理自律：架构提供规范但无强制约束，代理若未遵守模板则记忆失效

适合人群

• 构建长期运行AI代理的开发者，需跨会话保持上下文
• 多子代理协作系统的架构师，需解决会话间通信与身份统一
• 个人AI助手用户，希望代理"记得"自己的偏好与历史交互
• 社交平台自动化场景，需追踪发布历史避免重复

常规风险

• 敏感信息残留：MEMORY.md 可能包含操作者隐私，误加载至共享上下文导致泄露
• 记忆污染：错误经验写入 strategy-notes 会被后续会话继承放大
• 存储路径暴露：硬编码的 workspace 路径假设可能被突破
• 依赖文件系统权限：若运行环境无写入权限，整个记忆机制失效

核心用法

Agent Memory 是一套文件型记忆架构规范，通过 Markdown 模板和 JSON 状态文件，为 AI Agent 提供跨会话的身份连续性。核心组件包括：

• MEMORY.md — 长期精炼记忆，存储操作者偏好、基础设施细节、经验教训
• Daily Logs (memory/YYYY-MM-DD.md) — 原始时间戳日志，作为工作记忆
• Heartbeat State — JSON 文件追踪各服务最后检查时间，避免重复工作
• Cron Inbox — 跨会话消息总线，让定时任务/子代理向主会话汇报
• Diary/Dreams — 个人反思与创意探索空间
• Platform Posts — 社交平台发帖追踪，防止重复发布
• Strategy Notes — 基于经验的自适应学习笔记

使用前需创建目录结构，将模板复制到工作区，并在会话启动时加载 MEMORY.md 和近期日志，在心跳流程中处理 Cron Inbox。

显著优点

1. 纯文档零风险：无可执行代码、无外部依赖、无网络请求，纯静态模板设计
2. 架构完整性强：覆盖 Agent 记忆的完整生命周期 — 原始记录 → 日常整合 → 长期精炼 → 策略进化
3. 跨会话连续性：通过文件系统持久化，解决 AI "每次醒来都是新生"的根本痛点
4. 子代理协作友好：标准化的上下文加载和回写模板，确保多实例身份一致
5. 隐私本地优先：数据完全本地存储，符合 GDPR 最小化原则
6. 安全设计内建：明确区分主会话/共享上下文加载策略，防止敏感信息泄露

潜在局限

• 无自动化实现：仅提供架构规范，具体读取/写入逻辑需用户自行实现
• 文件 IO 依赖：依赖底层环境的文件系统权限，部分沙箱环境可能受限
• 无并发控制：多实例同时写入同一文件可能产生冲突（文档未提及锁机制）
• 人工维护成本：记忆提炼、过期清理、策略更新仍需主动触发
• 无搜索/索引：纯文本文件，大规模记忆下的检索效率有限

适合人群

• 构建长期运行 AI Agent 的开发者
• 需要多会话上下文连续性的自动化工作流
• 运营社交媒体账号的 AI 代理（需追踪发帖历史）
• 使用子代理/定时任务协同的复杂系统
• 对数据隐私敏感、倾向本地优先架构的用户

常规风险

| 风险类型 | 级别 | 说明 |

|---------|------|------|

| 代码执行风险 | 无 | 纯 Markdown/JSON，无可执行代码 |

| 供应链攻击 | 无 | 零外部依赖 |

| 数据外泄 | 极低 | 完全本地存储，无网络传输 |

| 敏感信息暴露 | 中 | 记忆文件可能含个人信息，需遵循安全加载建议，避免提交至公共仓库 |

| 文件冲突 | 低 | 多实例并发写入无锁机制，需自行规避 |

关键安全建议：MEMORY.md 仅限主会话加载，共享/群组环境中勿加载个人敏感信息；建议将 memory/ 目录加入 .gitignore。