记忆系统

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

OKF 统一架构

记忆系统基于 OKF（Open Knowledge Format） 统一模型，所有记忆存储在同一个知识库中，通过 作用域（Scope） 字段区分归属：

📌 Global Memory 目前在 OKF 模型中已定义，但尚未开放 Agent 读写工具。预留用于未来的团队共享知识场景。

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

Session Memory 由后台 Agent 自动提取，将持续对话中的关键信息归纳为 5 个分类：

自动提取 由后台 Agent 完成，触发条件：

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

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

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

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

feedback 和 project 类型的记忆还包含特殊结构：

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

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

User Memory 采用 词级 OR 匹配 的关键词检索策略，兼顾召回率和排序质量：

阶段	策略	说明
分词	按空格拆分	查询 `"saveMemory tool test"` 拆为 3 个词
匹配	词级 OR	每条记忆匹配任一词即命中（title/content/description）
排序	时间倒序	最近更新的结果排在前面
输出	Top N	默认返回 5 条，可配置

💡 词级 OR 匹配相比短语匹配有更高的召回率——查询 "saveMemory tool test" 会匹配包含 saveMemory、tool 或 test 中任意一词的记忆。搜索使用 SQL LIKE 模糊匹配，PostgreSQL 下自动使用 ILIKE（不区分大小写）。

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

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

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

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

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