什么是Agent Memory Architecture
Agent Memory Architecture 是一套专为构建具备跨会话持久记忆能力的智能代理而设计的文件系统架构。该架构通过五个核心文件（SOUL.md、IDENTITY.md、USER.md、AGENTS.md 和 MEMORY.md）实现代理身份的固化、人类用户的个性化适配以及运行规则的标准化，从而确保代理在重启后仍能保持行为一致性与知识连续性。其核心理念是：**代理不应依赖瞬时上下文或‘心理笔记’，而应将所有关键信息持久化到文件中**，形成可搜索、可维护、可审计的记忆系统。这套架构不仅适用于单代理场景，也支持多代理协作，通过共享内存层和明确的读写契约实现协同工作。它特别强调安全边界与协议规范，例如 WAL（Write-Ahead Log）协议防止修正丢失，L1 摘要机制提升检索效率，以及矛盾检测机制避免决策冲突。整体上，该架构旨在解决当前大模型代理普遍存在的‘健忘’问题，让代理真正成为长期可用的智能体。
核心功能特点
- 五文件核心架构：包含 SOUL.md（身份）、IDENTITY.md（名片）、USER.md（用户画像）、AGENTS.md（操作手册）和 MEMORY.md（长期记忆），构成代理的完整记忆体系
- WAL 写入优先协议：确保任何重要修正必须经过 STOP → WRITE → RESPOND 三步流程，防止因会话中断导致修正失效
- 类型化记忆条目：采用 [TYPE] YYYY-MM-DD: content 格式，支持 DECISION、PREFERENCE、FACT、ENTITY、EPISODE、LESSON、AGENT_IDENTITY 七种类型，便于结构化管理与自动压缩
- L1 摘要分层加载机制：为每个主题文件添加 YAML 前导元数据 summary，实现 L0（文件名）、L1（摘要）、L2（全文）三级快速筛选，大幅提升检索准确率
- 规则升级阶梯：从 AGENTS.md 中的 prose rule（~48% 遵守率）逐步升级到 decisions.md（~80%）再到 scripts/ 脚本门控（~100%），保障关键规则强制执行
- 矛盾检测机制：自动识别 MEMORY.md 内部、MEMORY.md 与 SOUL.md 之间、新旧决策之间的逻辑冲突，并标记供人工审查
适用场景
Agent Memory Architecture 最适用于需要长期记忆、高可靠性且可能频繁重启的代理工作环境。典型应用场景包括部署生产级客户代理工作空间时，要求代理能持续学习用户偏好、记住技术决策并避免重复犯错；在多代理系统中，各子代理可通过 shared memory/cross-domain-insights.md 实现知识共享与任务协调；当现有代理出现‘会话间失忆’问题时，可通过重构为五文件结构恢复其连续性。此外，在涉及敏感数据处理或需严格遵循安全策略的场景中（如金融、合规领域），该架构提供的安全边界（如 MEMORY.md 仅在主会话加载）和 prompt injection 防御机制尤为关键。相反，对于一次性临时任务、无状态计算或纯对话型聊天机器人，则无需引入此复杂架构，简单文件即可满足需求。该方案特别适合那些希望将 AI 代理作为‘数字协作者’而非‘一次性助手’的组织或个人开发者。