一、事件一篇博客把整个记忆插件品类送上了被告席2026 年 10 月 3 日Kevin Liao 的一篇博客冲上了 Hacker News 首页第七位。抓取时点一百八十八个赞、一百零五条评论标题Agent 不需要记忆需要文档。这句话点名的是一个正在快速膨胀的品类——Agent 记忆插件。作者的结论不留任何余地整个品类都在解一道错题。这轮讨论的分量在于它不是哲学争论而是工程路线之争。他描述的典型产品形态你可能昨天才刚刚为它付过费。分析你的会话生成一千条孤立碎片塞进向量数据库。每次提问附上五条最相似的片段Agent 困惑就让它自己再搜。细想你要解决的问题这个方案其实相当奇怪。你想要的是 Agent 理解你的项目功能在哪、为何而建、约定了什么。你得到的却是一场围绕 RAG 碎片的抽奖祈祷正确的那几条浮上来。就算偶尔抽中了Agent 依然谈不上真正理解你的项目。Liao 用一年多的实践给出了反例一个纯 Markdown 的工作区。没有向量数据库没有嵌入模型没有任何后台守护进程。二、所有记忆插件拆开都是同一个 RAG市面上的记忆插件底层架构惊人地一致几乎是同一张图纸。第一步翻遍你的历史会话转录逐字逐句。第二步把转录切成上千条互不关联的所谓记忆碎片。第三步把这些碎片嵌入之后写入向量数据库。第四步每次提问检索五条最相似的片段注入提示词。第五步Agent 还是困惑就给它一个搜索工具自己去翻。这就是全部架构了各家产品的差异只在装修。有些产品做得更花哨支持对历史转录逐字搜索。有些实现了多层级记忆系统认真区分短期记忆与长期记忆。有些加了一整组后台守护进程负责审查、合并、去重记忆。还有所谓的 Dreamer趁你睡觉时把记忆重写一遍。还有持续上下文压缩、重排序器名目一天比一天多。但每一个新功能都是在给同一个有缺陷的架构打补丁。这套流程的每一步都在烧 token烧得越多看起来越智能。功能清单越长离真正要解决的问题反而越远。补丁烧的都是 token而病根一个也除不掉。三、回忆的五个结构性缺陷第一个缺陷碎片是靠相似度浮现的。相似度只衡量两段文字在嵌入空间里有多近仅此而已。它回答不了哪条正确、哪条当前、哪条缺失。第二个缺陷碎片是脱离上下文存储的。一条 RAG 片段容量有限装不下动机、教训、环境和前因后果。第三个缺陷过去被默认当作真相。代码库每天都在变化回忆却在原地一动不动。五百条关于认证模块的碎片有多少还在描述今天的现实。第四个缺陷Agent 搜不到自己不知道的东西。它不知道某个主题存在就不会在恰当时刻想起去搜索它。这是未知之未知检索工具在原理上就解不了。第五个缺陷记忆库不可审计。一万条嵌入躺在 SQLite 里哪条存在、哪条过期没人说得清。哪条从未被检索哪条错误且正在悄悄带偏 Agent更是黑箱。这五条缺陷彼此咬合补丁式创新只能缓解无法根治。因为它们共享同一个错误前提问题在于遗忘解法在于记住。前提错了后面每一层工程优化都在错误的方向上加速。四、三种路线同一种失败作者在对比文档里把市面上的路线归成三类。碎片捕获、RAG 检索、上下文压缩名字不同结局相同。碎片捕获丢上下文RAG 检索靠运气压缩丢信息。三条路线以同一种方式失败知识被切碎之后就再也拼不回去。这也是他敢下「整个品类失声」判断的依据。不是某家产品做得差而是这条技术路线本身走不通。认清这一点比多装一个记忆插件重要得多。五、人类从来不是靠回忆管理知识的没有人会重看三年前的会议录像去回忆某个功能的设计约束。工程师的做法是写下来然后用这些记录工作。这是整个行业处理知识唯一成熟的方式朴素但有效。记忆插件的共同假设却是Agent 会忘所以要让它记住。于是全部赌注押在捕获更多、索引更好、检索更聪明上。但给 Agent 一个能翻一千万 token 转录的搜索框不是解法。让模型从碎片里重建昨天发生了什么更不是解法。真正的解法是文档化记忆把知识写成连贯可维护的文档。人们早就知道 Agent 需要上下文所以才发明了 AGENTS.md。它确实有效但往往一个项目里就只有这一个文件。单个文件撑不起一个项目Agent 需要的是一整个大脑。一个能记录指令、规格、决策、研究和索引的结构化工作区。今天人们用 AI 光速产出功能却常常不读一行代码。在这种速度下文档恰恰比以往任何时候都更重要。六、循环改写从遗忘到更新没有记忆的 Agent工作循环是提示、构建、遗忘。Operator Memory 把这个循环改成提示、查阅、构建、更新。工作前Agent 先读大脑里的指令、代码索引、规格和指南。工作中这些知识支撑它做出符合项目历史的决策。工作后趁全图还在上下文里就地更新过时的文档。缺失的记录被补写陈旧的描述被修正判断被沉淀下来。项目真相变化时更新的是权威文件本身。而不是往碎片库里再塞一条无法关联也无法过期的新记录。记忆从外挂数据库变成可读、可改、可提交、可共享的工作区。这个转变的代价只是纪律回报是每次会话都不再从零开始。长项目里最贵的从来不是写代码而是反复重建上下文。七、工程实现三分区 Markdown 大脑Operator 把知识空间按所有权切成三个分区边界清晰。第一块是 .operator项目私有知识只留在本机。首次安装时 Helper 会自动把它加进 gitignore防止误提交。第二块是 .operator-shared随仓库发布的项目知识。它只在被显式激活后才创建不会擅自进入团队视野。第三块是 ~/.operator/user跨项目的个人规则与偏好。指令冲突时权威层级是私有大于用户、用户大于共享。记忆在这里不是独立数据库不是一个需要额外维护的系统。它是持续文档化自然产生的耐久知识本身。.operator/ # 项目私有本机留存默认 gitignore .operator-shared/ # 项目共享随仓库发布给团队 ~/.operator/user/ # 个人分区跨全部项目生效八、确定性加载什么进上下文什么留在磁盘每次会话开始Operator 只加载一小段确定性的序言。序言首先包含框架规则工作流、分区归属与权威顺序。其次是各分区 operator.md 里的常驻指令按权威层级合并。然后是每个分区的 catalog.md一份大脑文档的紧凑地图。再加上主项目索引 index.md整个仓库的结构地图。最后是畸形或缺失上下文的警告与诊断问题当面摆出。其余一切规格、计划、研究、指南都留在磁盘上等任务召唤。加载是确定性的同一次会话启动每次都得到同一份定向。没有相似度排序没有黑箱注入没有任何运气成分。这一点对可复现、可调试的 Agent 行为至关重要。当 Agent 行为异常时你怀疑的是文档而不是看不见的嵌入。九、两种地图目录管知识索引管代码目录和索引是两种不同的地图职责被严格分开。因为源码导航和耐久知识本来就是两件不同的事。分区目录映射大脑每条目说明一份文档覆盖什么、何时打开。项目索引映射代码每份索引携带描述和一个 read_if 条件。主索引进序言子索引只在条件命中当前任务时才被展开。自由文档永远经由目录指引被阅读。它们绝不被自动语义选择抽出来注入上下文。RAG 的做法相反把记忆切成碎片再对着查询排序。模型只收到一个有界的 top-k 切片。没被选中的一切对这次会话而言等于根本不存在。Operator 的赌注是连贯文档加显式地图胜过碎片加运气。赌的是显式路由的可预测性终将战胜相似度的概率性。十、对照表RAG 记忆插件 vs 文档大脑维度RAG 记忆插件Operator Memory存储形态向量库里的孤立碎片连贯的 Markdown 文档检索方式相似度 top-k 注入目录与索引显式路由可审计性黑箱无法核对普通文件可读可 diff过期处理碎片持续累积失真就地更新权威文件基础设施嵌入模型加守护进程零依赖纯文件团队共享绑死在个人库里git 提交随仓库发布十一、团队视角知识第一次可以随仓库走私有分区留在本机共享分区随仓库发布。新成员克隆仓库的同时就拿到了项目的大脑。文档变更可以走正常的 PR 流程知识第一次有了评审入口。记忆从个人资产变成了团队资产。这恰恰是向量库永远做不到的事你无法 review 一万条嵌入。谁的知识进仓库、谁的留在本机文件系统一目了然。这是工程管理问题而不是模型能力问题。团队知识管理缺的不是更聪明的检索而是正常的协作流程。十二、一年实践从 internal 文件夹到正式插件这个系统不是周末项目作者从一年多前就开始用 AI 写代码。最初的形态只是一个 internal 文件夹要求 Agent 把一切写下来。规格、计划、索引工作前读对应文档工作后更新。这组朴素的指令慢慢演化成一套正式系统。最终固化成插件 Operator Memory如今贯穿他所有项目。整条演进路径本身就是一个证据文档路线是长出来的。它不是凭空设计的理论而是被日常使用打磨出的形状。BSD 3-Clause 开源免费使用仓库公开可核对。本文全部事实均取自作者的博客原文与仓库公开文档。十三、接入成本一条 npm 命令六种 harness安装走 Operator Helper一条 npm 命令全局装好。npm install --global aerovato/operator-helper operator-helper install claude-code # 或 codex / opencode-v2 / pi / deepseek它目前完整支持 Claude Code、Codex、OpenCode V2 和 Pi。DeepSeek Harness 也在完整支持列表里OpenCode V1 是存量支持。配置过程本身被设计成一次对话而不是一份手册。先跑 /operator:user-init建立全局用户分区只需一次。再在每个项目里跑 /operator:project-init。脚手架、迁移既有文档、索引仓库一次完成。冷启动时大脑是稀疏的这完全正常不用慌。让 Agent 先为你最常改动的模块写下第一批规格即可。之后每次会话都会在普通工作中自动维护这些文档。大脑的价值随使用复利增长第一天看不出第三周离不开。十四、人在回路五句导航话术当 Agent 犹豫要不要新建、合并或拆分文档时人可以介入导航。让它先写规格再动手实现为这个功能先写一份规格。让它沉淀调研把这次研究记录下来避免重复调查。发现知识重叠时直接下令这两份文档重叠了合并它们。发现文档膨胀时同样直接这份文档太大了拆开它。团队协同时再推进一步把这份规格提升到共享分区。这些不是提示词技巧而是对工作区结构的正常维护动作。十五、失效可见与黑箱记忆最本质的差别大脑当然也会过期作者对此毫不讳言。上游大改之后或者 Agent 单纯忘了更新文档就会失真。但失败就躺在普通 Markdown 文件里摊在阳光下。可被检查、可被修正、可被 git diff 追责到人。这与一万条无法审计的嵌入形成最尖锐的对照。记忆的失败从隐性问题变成了普通的代码维护问题。而普通的代码维护问题是整个行业最擅长解决的那一类。把记忆变成文档等于把玄学变成了工程。十六、冷静判断文档路线也有账单这条路线的成本同样真实不必神化。文档时效性依赖 Agent 自觉维护这是最薄弱的一环。长会话里更新动作本身就可能被遗忘。路线图上的可靠大脑更新正是在补这个洞。观测引擎会把耐久的用户偏好与显式指令分开存放。缓存感知序言、无损上下文压缩也在排队。每一项都承诺显式开关随时可以退回纯文档体验。但方向已经清晰把记忆从检索问题改写成写作问题。检索的失效是隐性的悄悄发生、无人察觉。文档的失效是显性的显性失效才能被工程化管理。十七、落地清单如果你在维护 Agent 工作流本周就可以做三件事。第一把孤零零的 AGENTS.md 扩成有目录、有索引的文档分区。第二把工作后更新文档写进常驻指令而不是靠 Agent 自发。第三对任何记忆插件先问一句我能审计它存了什么吗。答不上来的记忆不如没有记忆。Agent 缺的从来不是回忆过去的能力而是写下当下的纪律。记忆插件时代或许不会立刻终结但文档路线的举证责任已经完成。下一次有人向你推销记忆插件时把这篇文章递给他。