weiyi
项目MewCode

长期记忆与会话状态

让跨任务有价值的信息被检索回来,同时区分原始执行记录、项目指令与可更新的长期记忆。

会话结束后,用户偏好和项目约定仍可能有价值;临时错误、一次性的路径与过期状态却未必适合长期保存。记忆系统的重点是选择与更新,而不是无限保留所有聊天内容。

项目中的四类状态

会话 JSONL 保存消息和工具执行过程,用于恢复当前会话。长期记忆以 Markdown 文件保存跨任务知识,并通过 MEMORY.md 建立索引。用户与项目指令参与每轮行为约束,来源和作用范围独立于记忆。上下文摘要则是当前长任务的压缩状态。

这几类内容的更新时机和可信程度不同。一次工具输出中的文字不能自动变成用户指令,过去保存的项目状态也不能覆盖最新文件事实。

文件模型为何适合当前规模

用户级记忆位于 ~/.mewcode/memory,项目级记忆位于 .mewcode/memory。Markdown 允许查看、编辑和版本管理,前置元数据为检索提供简短描述,正文保留细节。

这个方案省去了独立向量数据库的部署成本,但检索规模、并发写入与文件冲突需要额外处理。记忆增多后,还要考虑失效时间、重复合并和来源追踪。

抽取怎样避免反复处理

Extractor 在任务轮次之后处理新增内容,通过增量游标记录已经分析的位置。它选择用户偏好、项目事实和长期可复用结论,并更新对应文件与索引。

游标减少重复扫描,但不能代替内容去重。相同偏好被多次表达时仍需合并;事实改变时需要修订旧记录。敏感凭据、短期执行噪声和未确认推测不应进入长期记忆。

相关记忆怎样返回主任务

旁路模型先读取记忆前置描述,候选上限约 200 条,再选择最多 5 条相关内容。主任务等待约 3 秒后可以继续,因此记忆召回是有时限的辅助路径。

每条用户消息可能触发预取,而启动时的索引注入还有单独的一次性状态控制。不能把这两条路径都描述成每轮固定加载全部记忆。超时后未及时返回的记忆也不应阻塞所有正常工具操作。

正确性与成本边界

基于描述的选择可以控制正文加载量,但描述过于宽泛会选入无关内容,描述缺少关键主题又会漏掉有价值信息。最多 200 条候选还意味着索引规模增长后需要新的候选生成方式。

记忆存在过期与误抽取风险。执行高影响操作前,应以当前仓库、实时接口和用户最新指令复核。并发更新文件时需要原子写入与合并策略,避免一条记忆覆盖另一条更新。

面试中怎样讲清楚

用“用户偏好怎样跨会话保留”串起文件存储、增量抽取、描述检索和限时注入。进一步说明为何没有直接上向量数据库、如何处理过期知识,以及原始会话记录为什么不能直接作为长期事实库。

本文整理依据

内容依据项目复习材料整理,本次发布没有重新审计源码或复跑历史实验。相同主题按专项笔记和较新复盘统一,原始笔记保留在本机。

  • Co Coder/MewCode_记忆系统设计与源码分析.md
  • Co Coder/code-golang简历题分析.md