本篇导读
预计阅读时间：8 分钟。读完你会明白 Agent 记忆的三个层次：上下文窗口、会话摘要、持久记忆文件，以及怎么让 Agent 真正「越用越懂你」。
上一节的 AGENTS.md 解决了「规矩」的留存。但规矩之外还有更碎的东西：你提过的需求、纠正过的错误、项目的来龙去脉——这些没法全写成制度，但又不想每次重讲。
这就轮到记忆系统出场了。Agent 的记忆分三层，从易逝到持久，一层层讲。
第一层：上下文窗口（工作记忆）
第 2 章讲过，模型一次能「看到」的内容上限叫上下文窗口。在记忆的语境下，它就是 Agent 的工作记忆：
- 当前会话里你说过的每一句话、它做过的每一步、读过的每个文件，全在这一层。
- 特点：随取随用、记忆鲜活，但容量有限，而且会话一关就清零。
这就是「它记不住你」的根源：聊得再多，关掉窗口，第二天全部归零。
第二层：压缩与摘要（会议纪要）
窗口快满的时候，Harness 会做一件聪明事：把早期的对话压缩成摘要，腾出空间继续干活。
就像开会开了八小时，散会前把过程浓缩成三页纪要——结论和关键决定都在，细节的来龙去脉丢了。所以长会话的后半程，Agent 可能记得「你之前要求过什么」，但记不清你当时原话怎么说的。
这一层是自动的，你不用操作，但要知道它的存在：长任务聊到后面它「忘细节」是正常现象，不是坏了。重要结论可以在聊天里让它记下来（下一层就派上用场）。
第三层：记忆文件（长期记忆）
真正解决「越用越懂你」的是这一层：把重要信息写成文件，存到硬盘上，下次会话开始时自动加载。
Zcode 里的实现就是用户目录 .zcode 文件夹下的记忆文件：一个索引文件加上一组记忆条目，每条记录一个事实。比如你某天纠正过它「部署前必须先构建」，它就可以把这条存进记忆，以后每次开工自动想起来。
工作方式有点像你自己的备忘录：
- 索引页（MEMORY.md）：列着所有记忆的标题，每次开工先扫一眼，知道「我都知道些什么」。
- 记忆条目：每个主题一个小文件，需要细节时再展开读。
这个「先看目录、按需取用」的设计很关键——它让 Agent 能带着几百条记忆工作，却不会撑爆上下文窗口。
怎么用好它
三句话实践指南：
- 该存的主动让它存。 聊出重要结论时说一句「记到记忆里」，比指望它自己判断靠谱。
- 记错的让它改。 记忆不是圣旨，发现它记了过时的信息，直接说「更新记忆：xxx 已经变了」。
- 规矩归 AGENTS.md，事实归记忆。 「回复用中文」这类制度写规则文件；「我的项目在 D 盘 xxx」这类事实存记忆。两者配合，缺一不可。
使用记忆系统需要注意
需要在 Zcode 里面手动开启「记忆」「工作区记忆」，否则它永远不会主动记录。
到这里你有了什么
规则文件 + 记忆系统，你的 Agent 已经「认识」你了。但它目前的能力边界还是你电脑里的东西。
下一节讲 MCP——一个让 Agent 接入整个外部世界工具的标准接口。学会它，你的 Agent 才算真正「联网上线」。