ByteNoteByteNote
三步把跨会话记忆收进一棵 git 树
字

字节笔记本

2026年10月10日 · 约 5 分钟读完

三步把跨会话记忆收进一棵 git 树

API中转
¥120

跨会话一断,agent 就把上次的命名约定、慢查询和那条改过的偏好忘干净。聊天窗口里塞长记忆,既不好检索,也难和并行的几个会话对齐。Cognition 后来把这套做法收成开放规范 Agent Memory Repo:记忆就是一个 git 仓库,条目互相用维基链接跳。规范仓在 GitHub 的 AgentMemoryRepo/agentmemoryrepo,MIT 许可,本轮看到 668 星、34 叉、13 次提交。说明页在 cognition.com 的 agent-memory-repo。这些是仓库和说明页口径,不是本轮替你跑过一轮做梦。

规范页封面

先弄清仓库里到底记什么

目录可以自定。说明页给的样子是每人一棵树,根上放 MEMORY.md,下面再分笔记、项目、指标,后头还可以加编队目录。MEMORY.md 是每轮开场要先读的短索引,写必须知道的事,再指向详细条目。事实用一行一条的要点,末尾可以挂来源或写入日期。条目之间用双方括号写路径,笔记文件可以省略后缀。记忆本体不进公开的规范仓,默认只在本地,除非你自己加远程。

多人可以同时打开几棵树。写入要对上所属的那一棵;拿不准就先问。所有权、权限和日志分开留,后面再拼也还分得清。四个并行 agent 共用一个编队目录时,git 负责撞车。规范原文写得很短:agent 跨会话记得住,会更好用;条目互相指着,就可以当维基逛。说明页还写了几种用法:留下个人偏好、用公共目录协调并行工人、把一组人的发现转一圈、同一次运行里混几棵树但所有权仍分开。

仓库页的试用日期出现过 2026-10-15 和 2026-09-03 这样的标签示例,只说明条目可以挂日期,不代表本轮仓库在那天提交。十三次提交都在主分支,热度在规范和说明页,不在提交频率。

三步把仓库接进会话

第一步装规范,不要先改提示词。Devin 插件写成 devin plugins install AgentMemoryRepo/agentmemoryrepo。其它客户端可以用 npx skills add AgentMemoryRepo/agentmemoryrepo --skill agent-memory-repo。装完先在本机建一棵不带远程的记忆树,写进一条偏好,比如摘要只要短要点,下一轮把完整路径指回去,看它还找不找得到。这一步只验证读写,不启自动做梦,也不要把记忆推到公开远程。

第二步把每轮会话收成固定四拍。拉最新、检索或顺着链接跳、按新发现自己改、改完立刻推。缺任何一拍,下一次克隆到的就不是刚才那版。检索可以按关键字,也可以顺着双方括号往下走。改动由 agent 自己做,不要等人把笔记誊一遍。推送是闭环,不是可选项。说明页把这一圈写成固定循环,而不是可插可不插的插件。

每轮会话的四拍

第三步再谈编队和定期整理。四个角色一起查结账变慢时,共用目录里放目标、发现、问题和各自身上的笔记。说明页里的数字是:中位 80 毫秒,最慢百分之一到 2.4 秒;后来对上每十秒整表重做的 2 GB 缓存,增量刷新后尾巴收到 310 毫秒。过程里还出现过 400 毫秒的回收停顿和容量 20 的连接池被饿死。另有一条复用存下来的查询,补全保留率从 31% 掉到 24%,提问的人不用把字段再讲一遍。这些是官方举例,不是本轮压测。

官方例子里的结账尾巴

做梦写成定期专项:一边从多轮会话里抽出新模式写成新条目,一边合并重复、丢掉过期、核来源,把互相打架的说法收干净。它不是每次推送都跑。说明页把做梦的两项职责写得很清楚:加新记忆,以及做清理。本轮没有代开做梦任务,也没有把规范接到某一家云端会话产品上联调。

若只是想让单窗口少忘一句偏好,本地一棵树就够。若几路 agent 要共用发现,先把写入边界划清,再让 git 处理冲突。规范只规定仓库长什么样、每轮怎么走,不替你选模型,也不保证做梦一定能消掉自相矛盾。站点里已有多篇会话记忆产品稿,这篇只写开放规范和本机接法,不把某一家专有记忆系统的数字挪过来。

复现时不要把规范仓本身当成记忆仓来写。规范仓是公开标准,记忆树要另建,而且默认不要加远程。本轮按仓库页和说明页核对,没有代跑四个角色的结账例子,也没有核对待办插件市场之外的其它客户端是否已经认这套技能名。

相关文章

分享: