分层记忆

Alius Agent 通过分层记忆系统在 Session 间持久化知识。记忆分为项目记忆和全局记忆两个范围，每个范围包含多个存储层。

项目记忆 vs 全局记忆

存储层

Alius 的记忆系统包含以下存储层：

Context 记忆（工作记忆）

Session 活跃期间的短期记忆。保存当前对话上下文、最近的工具输出和活跃计划状态。

• 限定在当前 Session
• Session 结束时清除
• 为每个 Turn 提供即时上下文
• 通过 ConversationStore 和 SessionStore 管理

Episodic 记忆（经验记忆）

过去经验的记录——什么有效、什么无效、在之前的 Run 中学到了什么。

• 跨 Session 持久化
• 捕获开发轮次中的经验教训
• 帮助避免重复错误
• 通过 EpisodicStore 管理

Semantic 记忆（事实记忆）

提取的关于项目的事实和知识——架构决策、API 契约、命名约定和领域知识。

• 跨 Session 持久化
• 构建关于项目的知识库
• 使 Agent 无需重新阅读代码即可理解项目上下文
• 通过 SemanticStore 管理

Procedural 记忆（过程记忆）

操作流程和步骤的记录——如何完成某类任务的标准流程。

• 跨 Session 持久化
• 记录成功的操作模式
• 支持工作流自动化的基础
• 通过 ProceduralStore 管理

检索引擎

RetrievalEngine 负责从各记忆层中检索相关信息，为 Agent 的当前上下文提供支撑。

管理记忆

/memory save <text>     # 保存一个事实或教训
/memory list            # 查看已保存的记忆
/memory clear           # 清除全局记忆（需要确认）

记忆如何帮助你

1. 更快恢复 — 上下文被保留，无需重复解释
2. 从经验中学习 — 过去的 Run 指导未来的决策
3. 构建项目知识 — 事实积累为项目特定的知识库
4. 自我进化 — 每次迭代使 Agent 对你的项目更有效

运行时记忆 vs 工作空间文档

Alius 区分两种不同的数据存储：

两者存储在不同目录，服务于不同目的。记忆是运行时自动管理的数据，工作空间文档是项目的设计和规划资料。

记忆与隐私

所有记忆存储在本地的 .alius/memory/ 目录中。除非你明确配置远程存储，否则不会向外部服务发送任何数据。