记忆系统总览

aster 的记忆系统分为多个层级, 对应不同的作用域与存储后端:

• 短期记忆: 当前会话/任务的工作记忆, 由 Session + Working Memory 提供;
• 长期记忆(文本): 基于文件的长期知识库, 由 AgentMemoryMiddleware + memory.Scope 提供;
• 长期记忆(语义): 基于向量检索的语义记忆, 由 SemanticMemory + VectorStore + Embedder 提供;
• 项目记忆: 基于 AGENTS.md 的项目级持久化记忆, 由 memory/project 提供;
• 规则系统: Global/Project 两级规则管理, 由 memory/rules 提供;
• 自动记忆: 事件驱动的记忆捕获, 由 memory/auto 提供;
• 对话提取: 从对话中提取偏好, 由 memory/dialog 提供。

记忆模块

建议阅读顺序

基础概念

1. Memory 系统指南 – 短期/长期/语义记忆的统一概念与基本用法;
2. 带长期记忆的 Agent – 如何让 Agent 使用文件长期记忆;
3. 多用户/多场景记忆封装 – 使用 Scope 管理用户/项目/资源级记忆;

语义记忆

4. 语义记忆示例 与 工作流 + 语义记忆;
5. 从短期记忆到长期记忆 – Session → SemanticMemory 的桥接;
6. Memory 后端适配 – 各种后端类型与配置方式;

项目级记忆 (新)

7. 项目级记忆 – 基于 AGENTS.md 的持久化记忆;
8. 规则系统 – Global/Project 两级规则管理;
9. 自动记忆捕获 – 事件驱动的记忆捕获;
10. 对话偏好提取 – 从对话中自动提取偏好。

本章节主要作为导航页, 详细内容请跳转到对应的指南与示例。