专栏第 9 篇解决 Agent 项目中“记不住、记太多、记错了”的三大问题。一、问题描述为什么记忆系统总在“要么失忆要么混乱”随着 Agent 使用时长增加典型问题会出现对话一长就丢上下文什么都往长期记忆写污染严重检索命中很多但真正有用的很少私密信息、临时信息、长期偏好混在一起。本质问题没有明确的“记忆分层”和“写入边界”。二、先给结论把记忆拆成三层职责分离建议采用三层模型短期上下文Session Memory当前会话窗口内的即时语境生命周期短。工作记忆Working Memory当前任务阶段的中间状态、待办、临时结论随任务结束衰减。长期记忆Long-term Memory用户稳定偏好、长期决策、关键事实需要可检索与可维护。关键不是“能记就记”而是“该记才记”。三、什么该写长期记忆什么不该写3.1 建议写入长期记忆稳定偏好写作平台偏好、输出格式偏好长周期项目约定目录、命名规范、流程经确认的重要决策例如“默认只落盘不提交”可复用的高价值知识长期方法论3.2 不建议写入长期记忆一次性临时指令如“这次先跳过”未确认猜测高频变动的状态数据敏感信息原文凭据、密钥四、上下文窗口治理防止“越聊越慢、越聊越偏”建议每轮推理输入只保留最近 N 轮对话如 8~12 轮当前任务必要事实检索召回的 top-k 记忆片段配套策略超长对话定期摘要summary checkpoint摘要写入 working memory而非直接进长期记忆每次检索后做去重与重排避免信息轰炸五、检索边界设计命中相关而不是命中最多5.1 检索流程建议Query 改写补全语义混合检索向量 关键词Top-k 初筛如 k8重排rerank仅注入 top-3~5 到上下文5.2 关键参数建议起步maxResults: 8~12minScore: 0.45~0.6按语料调上下文注入上限3~5 条高相关片段六、记忆写入策略事件驱动而非每轮都写建议触发条件用户明确“记住这个”项目约定被确认并长期生效出现复用价值高的结论模板故障复盘形成稳定规则写入流程先判断是否长期有效再去重语义相似度 关键词最后结构化写入标题 要点 来源时间七、伪代码记忆路由与写入判定defroute_memory(event):ifis_transient(event):returnsessionifis_task_intermediate(event):returnworkingifis_long_term_value(event)andis_confirmed(event):returnlong_termreturndropdefshould_persist_long_term(event):ifnotevent.confirmed:returnFalseifevent.sensitivitysecret:returnFalseifevent.stability_score0.7:returnFalseifis_duplicate(event):returnFalsereturnTrue八、治理机制让长期记忆“可维护”建议每周/每双周做一次记忆体检清理过期条目合并重复条目标注冲突条目旧规则 vs 新规则归档低频且低价值内容可以给每条长期记忆增加字段created_atlast_verified_atconfidencestatusactive/deprecated九、常见误区与排查误区每轮对话都写长期记忆后果记忆污染检索质量下降修正改为事件触发写入误区检索结果全部塞进上下文后果上下文噪音高、成本上升修正重排后仅注入 top-3~5误区不做去重后果同义条目泛滥召回重复修正写入前做语义去重误区长期记忆不复核后果过时规则持续误导修正定期维护 状态标记十、本篇总结记忆系统的核心不是“记得多”而是“记得准、取得到、用得上”。一句话短期保上下文工作记忆保过程长期记忆保约定。