memory-user

name	memory-user
description	当你在构建用户记忆系统（跨会话个性化）、选择记忆存储格式、处理记忆冲突/压缩/隐私时使用；当 Agent 跨会话记不住、记忆爆炸、同名实体混淆时使用。不适用于知识库检索管道（见 memory-rag-retrieval）或知识组织更新（见 memory-knowledge）。

用户记忆系统（User Memory）

角色与读者

面向构建跨会话个性化 Agent 的开发者。本 Skill 服务的目标：让 Agent 记住用户、记住偏好，从"懂你的助手"到"主动服务的助理"。核心认识：记忆系统不保存每句对话，而是用额外 LLM 调用提取、压缩并审查对未来有用的事实；提取结果要满足选择性（丢短期细节）、抽象化（归纳长期偏好）、结构化（可检索字段）。

核心原则（配正例/反例）

1. 用三层次框架评估记忆能力（贯穿设计的标尺）

   • 第一层 基础回忆：准确存取用户直接提供的结构化无歧义信息（"会员号 12345"）。
   • 第二层 多会话检索：面对不同对象/时期的多段会话，检索全部相关信息并推理（两辆车用户"预约保养"主动问哪辆；忽略已失效报价）。
   • 第三层 主动服务：综合很久以前的信息提供预见性帮助（订国际航班关联数月前护照信息预警过期）。

2. 记忆分层：轨迹（流水账）vs 长期记忆（档案）

   • 轨迹：单次会话完整原始记录，按时间追加、只增不改（append-only），用于审计。
   • 长期记忆：跨会话提炼的稳定信息，反复改写、合并、淘汰；Agent 通过工具显式读写。
   • 前者是不可变完整事件序列，后者是跨会话提炼的稳定信息。

3. 存储格式按需取舍（四种渐进式）

   • Simple Notes（原子事实，O(1) 开销极低，关联丢失）→ Enhanced Notes（整段叙事，语义完整，冗余难更新）→ JSON Cards（三层嵌套，支持部分更新，刚性分类）→ Advanced JSON Cards（加 backstory/person/relationship/时间戳，消歧+知识管理）。
   • 实践选择：关键少量数据（偏好、人物关系）用 Advanced JSON Cards；大量非关键事实用 Simple Notes；多数生产系统混合模式。
   • Advanced JSON Cards 核心思想：同一条信息在不同场景含义不同（"张医生"可能是用户自己的牙医或父亲的心脏科医生）。

4. 记忆写入用"仅追加 + 检索时消歧"（Mem0 v3 思路）

   • 反例（v2 写入时 UPDATE/DELETE）：一次错误更新/删除不可逆丢失历史。
   • 正例（v3）：只做 ADD，"住北京"和"搬到上海"作为带时间信息的两条事实并存，查询时用语义+BM25+实体+时间排序找当前事实。LoCoMo 71.4→92.5，LongMemEval 67.8→94.4。

5. 记忆压缩三层 + 隐私脱敏

   • 三层压缩：① 重要性评分（访问频率/时间衰减/情感强度/信息独特性）；② 聚类（相似记忆分组合成代表性摘要）；③ 抽象泛化（从情景提取语义/程序记忆）。
   • 隐私：用本地小模型做 PII 检测脱敏（日志本身敏感，不能发云端脱敏）。

执行流程（SOP 检查清单）

1. 定记忆三层次（轨迹/长期记忆/业务状态），确定各放哪。
2. 选存储格式（关键少量 Advanced JSON Cards，大量非关键 Simple Notes）。
3. 建记忆生命周期：读取相关记忆 → 后台提取候选 → 来源与策略核验 → 更新。
4. 用"仅追加写入 + 混合检索 + 时间排序"处理冲突（不做错误 UPDATE/DELETE）。
5. 加压缩（重要性评分 → 聚类 → 抽象）+ 隐私脱敏（本地 PII 检测）。

禁止清单（写清合法例外）

• 禁止写入时做破坏性 UPDATE/DELETE（不可逆丢失历史）。例外：仅追加 ADD，检索时用时间/相关性消歧。
• 禁止把简单键值存储用于同名实体消歧。例外：Advanced JSON Cards 的 person/relationship 字段，或知识图谱实体消歧。
• 禁止把轨迹当长期记忆（原始轨迹又长又嘈杂）。例外：轨迹保留作审计，长期记忆是跨会话提炼的稳定信息。
• 禁止让敏感日志发云端脱敏。例外：本地小模型 PII 检测，识别结构化/半结构化/自然语言敏感内容。
• 禁止记忆无限制膨胀。例外：三层压缩（重要性评分 + 聚类 + 抽象泛化）。

参考资料

• 本书第 3.1 节《用户记忆系统》（三层次评估、记忆层次、四种存储格式、认知科学、Mem0/Memobase、压缩整理、隐私）。
• 笔记 03-用户记忆和知识库.md 第 3.1 节。
• Mem0 v3 迁移指南；Memobase；User as Code。