WorkBuddy 记忆系统拆解：为什么它记得那件事、忘了这条规矩

WorkBuddy 是腾讯出品的全场景 AI 办公工作台。本专题 46 篇课程，覆盖"认识工具—设计任务—验收结果—扩展能力—自动化协作—长期维护—实战案例—进阶方法—岗位行业—底层机制"完整路径，包含 100+ 真实使用场景。

一句话结论

WorkBuddy 的「记住」和「忘记」不是玄学，是三层记忆加限额蒸馏机制的结果；你可以在 ~/.workbuddy 里直接看到它记了什么，并手动治理。

这一课拆解 WorkBuddy 的记忆系统：三层存储各自放什么、每条记忆的限额规则、以及「随每次请求注入的记忆说明书」如何工作。学完你能解释三个高频困惑，并掌握喂记忆、清记忆的实操方法。

WorkBuddy 的记忆按作用域分三层，文件都在 ~/.workbuddy 下：

层	位置	存什么	生效范围
用户级长期记忆	`~/.workbuddy/MEMORY.md`	跨项目的工作偏好、长期规则	所有会话
项目级记忆	`<项目>/.workbuddy/memory/MEMORY.md` 和每日日志	本项目的约定、决策、踩坑记录	该项目内会话
服务端画像	云端（会话启动时注入）	服务器根据历史对话总结的用户画像	所有会话（只读）

三层的关系：会话开始时，服务端画像 + 用户级记忆自动注入；项目记忆在项目工作区内注入。当你说「记一下这个规则」时，WorkBuddy 会判断写到哪层——跨项目的偏好写用户级，项目约定写项目级。

限额：记忆文件不是无限增长的。每日日志按天分文件，长期 MEMORY.md 有容量上限（用户级约 4000 字符/次写入）。超限时旧内容需要被蒸馏进主题条目，而不是无限追加——这就是为什么有些细节「消失」了：它们被压缩合并了。

蒸馏：日常工作日志里重复出现的模式，会被提炼成长期记忆里的主题条目。日志是流水账，MEMORY.md 是精华笔记。这也是官方建议「30 天以上日志蒸馏进 MEMORY.md 再删旧日志」的原因。

覆盖：当记忆之间冲突时，新记忆覆盖旧记忆；项目级规则可以覆盖用户级默认。你立的新规矩会生效，但如果它和更早的强规则冲突，行为可能不稳定——解法是把旧规则显式改掉，而不是只加新的。

「为什么它忘了我的规矩？」 规矩说「以后都这样」时，如果只是口头约定没有落盘，它可能在限额蒸馏中被压缩掉，或者被后续对话的新指令覆盖。解法：重要规则让它「写进 MEMORY.md」——落盘的规则每次会话稳定注入，不依赖对话历史。

「为什么它记得三周前的八卦？」 会话检索机制（对历史会话的搜索）可能召回了相关片段。记忆不止 MEMORY.md 一个来源，历史会话本身就是记忆。这是特性也是风险：你以为是新对话，它可能带着旧上下文的偏见。解法：敏感话题在新会话里明确说「这是全新任务，不考虑之前的讨论」。

「换个项目它还记得 A 项目的事，怎么隔离？」 用户级记忆是跨项目的。A 项目里立的规矩写进了用户级，B 项目自然也会用。解法：项目专属规则让它写项目级 .workbuddy/memory/，跨项目偏好才写用户级。

想让 WorkBuddy 长期稳定地记住你的偏好，最可靠的方式是直接维护记忆文件：

写入原则：写「必须遵守的硬规则」和「反复出现的事实」，不写一次性任务细节（那些留在日志里就好）。

记忆会过期变毒药——业务规则变了、团队换了、旧偏好不再适用：

想知道这次会话到底带了哪些记忆？直接问它：「列出你当前上下文里注入的记忆内容」。它会如实转述注入的记忆块。发现不该在的内容，就按上面两步治理。