跳转到内容

记忆系统

记忆系统 让 AI 拥有了”记忆力”。它不仅能在一次对话中持续追踪关键决策和进展,还能跨会话记住你的偏好、项目背景和工作习惯——越用越懂你。

记忆系统分为两层,各司其职:

Session MemoryUser Memory
作用域单个会话跨所有会话
生命周期会话期间长期保留
核心用途压缩摘要、跨轮次上下文个性化、知识传承
提取方式自动提取 + Agent 主动保存Agent 主动保存
容量上限20 条,~12K tokens1,000 条

Session Memory 将持续对话中的关键信息归纳为 5 个分类

分类说明示例
🎯 decision技术决策和设计选择“选择 PostgreSQL 作为数据库”
📍 context当前任务上下文“正在实现用户登录功能”
📊 progress任务进展和完成状态“已完成数据库 schema 设计”
🚧 issue遇到的问题和解决方案“CORS 错误,通过配置中间件解决”
💡 learnings学到的经验和教训“连接池可以显著提升性能”

Session Memory 通过 自动提取Agent 主动保存 两条路径持续积累:

自动提取 由后台 Agent 完成,触发条件:

条件说明
初始化阈值上下文 token >= 10,000
增长阈值token 增长 >= 5,000
工具调用tool call 数量 >= 3
对话断点token 满足 + 最后一轮无 tool call

💡 后台 Agent 与主对话共享 prompt cache,硬限制最多 5 轮对话,几乎不影响主对话性能。

限制项说明
最大条目数20 条存储上限,单个会话
总 token 上限~12,000存储上限,约等于 9 页文档
注入数量每轮 5 条,最多 5,000 tokens每轮对话注入到上下文中
超出策略删除最旧保留最新信息

User Memory 记录跨会话的长期知识,分为 4 个分类

分类说明示例
👤 user用户角色、目标、偏好“10 年 Go 经验,React 新手”
💬 feedback用户对工作方式的指导“不要在测试中 mock 数据库”
📁 project项目进展、目标、决策背景“2026-03-05 起合并冻结”
🔗 reference外部系统的指针“pipeline bug 在 Linear INGEST 项目”

每条 User Memory 都有重要性标注,影响检索优先级:

feedbackproject 类型的记忆还包含特殊结构:

规则/事实
Why: 用户给出的原因
How to apply: 这条指导何时/何地适用

📌 这种 Why + How to apply 结构帮助 AI 理解上下文,在正确的场景下应用正确的规则。

限制项说明
最大条目数1,000 条单个用户
单条 token 上限~1,000-
超出策略无自动淘汰仅支持手动删除(delete_user_memory 工具)

User Memory 采用 混合检索 策略,兼顾语义理解和精确匹配:

阶段策略说明
向量检索余弦相似度语义层面的匹配,Top 10
关键词检索全文检索 + 标签匹配精确关键词匹配,Top 10
融合排序RRF 算法score = Σ 1/(60 + rank),合并两路结果
加权过滤重要性 + 访问频率 + 时效性重要且常用的记忆优先
最终输出Top 5精选最相关的 5 条记忆

记忆通过精心设计的注入策略进入 AI 的上下文:

记忆类型注入时机注入数量触发条件
Session Memory每轮对话前5 条,最多 5,000 tokens自动
User Memory每轮对话按重要性动态过滤基于 Embedding 检索
Session Memory(压缩时)Auto Compact 触发全部作为压缩摘要

💡 User Memory 按重要性动态过滤:critical / high 全部注入,medium 每类最多 10 条,low 不注入。

当上下文需要压缩时,Session Memory 可以 零成本 充当摘要:

方案成本摘要质量速度
Session Memory Compact零 API 成本更高(持续更新)更快
标准 Auto Compact一次 LLM 调用一般(一次性生成)较慢

📌 Session Memory 是在对话过程中持续积累的,比压缩时一次性生成的摘要更完整、更准确。

功能说明
🌙 记忆整合(Dream Task)定期合并重复记忆、删除过时记忆、提取共性知识
👥 团队记忆支持团队共享的偏好、规范和最佳实践
📊 记忆可视化在 UI 中查看、编辑、搜索记忆,查看使用统计