用途
Memory System 用于为智能体提供持久化、可搜索的跨会话记忆。它让智能体记住用户偏好、项目约定和过往决策，从而不必在每个新会话中重新解释这些内容。其核心理念是：不要重新发现已经学到的东西。
主要能力
- 跨会话持久记忆：记忆在会话结束后依然保留，并在后续会话中被读取和应用。
- 结构化索引：通过 MEMORY.md 作为轻量索引，指向各个主题文件。
- 主题文件分类：包括 user-preferences.md（用户角色、风格、工具）、project-conventions.md（编码标准、模式）、tech-decisions.md（过往架构决策）、feedback-history.md（用户喜欢/不喜欢的内容），以及按需新增的其他主题文件。
- 记忆分类体系：分为 user（角色、偏好、工具、沟通风格）、feedback（用户对智能体输出的喜好反馈）、project（编码标准、技术选型、约定）、reference（非敏感基础设施笔记、公开 URL、配置）四类。
- 四类操作：保存、回忆、搜索、清理。
- Token 影响说明：加载索引约增加 1,000 tokens，但通过消除重复发现可节省 3,000 至 10,000 tokens。
使用方式
索引格式
MEMORY.md 是轻量指针文件，规则为：总行数最多 200 行；每条约 150 字符以内；格式为「- [类型] 摘要 → 主题文件.md」；类型为 [user] [feedback] [project] [reference]。
示例条目：
- [user] Prefers dark mode, uses Windows 11, PowerShell → user-preferences.md
- [project] Always use bun instead of npm → project-conventions.md
- [feedback] User likes concise responses, no filler → feedback-history.md
- [reference] Squid proxy runs on port 3128 → infrastructure-notes.md
主题文件格式
每个主题文件包含 frontmatter 和结构化内容，例如：
type: user | feedback | project | reference created: 2026-04-01 updated: 2026-04-01
User Preferences
Development Environment
- OS: Windows 11
- Shell: PowerShell
- Editor: Cursor / Windsurf
- Package Manager: bun (NOT npm)
Communication Style
- Prefers concise responses
- Likes tables for comparisons
- Dislikes verbose explanations
保存操作
触发条件：用户说「remember」「save」「don't forget」。步骤：识别信息类型（user/feedback/project/reference）；检查相关主题文件是否存在；若存在则追加到现有主题文件；若不存在则创建带 frontmatter 的新主题文件；用一行指针更新 MEMORY.md 索引；向用户确认「Saved to memory: [summary]」。
回忆操作
触发条件：会话开始，或用户问「what do you remember about X」。步骤：读取 .agents/memory/MEMORY.md 索引；扫描与当前任务匹配的相关条目；若找到匹配则读取所引用的主题文件；静默应用回忆到的上下文（除非被询问，否则不背诵记忆）。
搜索操作
触发条件：用户问「do I have any notes about X」。步骤：在 .agents/memory/*.md 中 grep 搜索词；返回带文件引用的匹配条目；若用户需要细节，可提供读取完整主题文件的选项。
清理操作
触发条件：索引超过 200 行。步骤：警告「Memory index is getting large (X lines). Review recommended.」；建议合并相关条目；建议将旧条目归档到 memory/archive/；绝不自动删除，始终先询问用户。
会话开始协议
每次会话开始时：检查 .agents/memory/MEMORY.md 是否存在；若存在则读取索引并静默应用相关上下文；若不存在则无记忆继续，在首次「remember」触发时创建。应用记忆时不背诵它——错误做法是「I remember you prefer dark mode and use bun...」，正确做法是静默应用偏好，例如在命令中使用 bun。例外：若用户问「what do you remember?」，则背诵相关记忆。
适用场景
- 需要跨多个会话保持用户偏好和沟通风格一致的智能体。
- 需要记住项目编码标准、技术选型和约定的开发协作场景。
- 需要保留过往架构决策和用户反馈历史的长期项目。
- 需要记录非敏感基础设施笔记和公开配置的参考场景。
限制
不应保存的内容
- 密钥、凭据、令牌、密码、私钥或 API 密钥：记忆是持久的，且可能跨会话共享。
- 可从代码推导的信息：应读取 package.json 而非记忆依赖。
- 临时调试上下文：会杂乱记忆，日后无用。
- 精确代码片段：代码会变化，记忆会过时。
- 可能移动的文件路径：应使用 glob 模式或描述代替。
- 完整对话记录：记忆只用于提炼后的洞见。
记忆与计划、任务的区别
- Memory：跨会话知识，永久保留直到被清理，位于 .agents/memory/。
- Plan：当前项目的任务分解，保留到项目完成，位于项目根目录。
- Task：当前会话的进度跟踪，保留到会话结束，位于 artifact 目录。
即：Memory = 你知道什么；Plan = 你将做什么；Task = 你正在做什么。
其他说明
关于该工具的收费、价格、支持平台等具体信息，资料中暂未提供。