企业官网建设流程全解析

AI Agent一关会话就失忆？agent-memory：免API密钥的纯Markdown长期记忆运行时完全指南

【免费下载链接】agent-memoryLong-term memory runtime for AI agents — plain Markdown as the source of truth, local ranked retrieval, and an independent sleep-time Manage layer. Claude Code and Codex share one store. No API key.项目地址: https://gitcode.com/gh_mirrors/age/agent-memory

AI Agent 长期记忆一直是编码助手的痛点：会话一关，学到的一切瞬间清零。agent-memory正是一个免 API 密钥的纯 Markdown 长期记忆运行时——用磁盘上的 Markdown 文件作为唯一事实来源，本地 SQLite 索引只做可丢弃的缓存，Claude Code、Codex CLI、Muse Code 等多个 Agent 共享同一个记忆库，且整条读取路径不联网、不烧 Token。🧠

为什么 AI Agent 一关会话就失忆？

主流 Agent 的记忆能力来自两个方向的架构，但都有硬伤：

• 检索引擎派：嵌入向量、知识图谱、排序管线，找得准，但交给 Agent 的是无法检查的"黑盒块"，迁移成本极高；
• 文件系统派：直接把 Markdown 丢给 Agent 用ls、grep翻，可读且零成本，但没有排序，目录一多就失控。

agent-memory 把两者合进同一个库：检索引擎为 Agent 也能直接阅读的目录建立索引，关联关系写在记忆文件内部的links里，每一条召回结果都能落回磁盘上一个完整的 Markdown 文件。召回拥有图谱和向量检索的精度，同时保留了 Agent 可以"漫步"的普通目录。

核心设计：5条让你安心的原则

agent-memory 的设计承诺在 README.md 中写得非常直白，这里挑出对普通用户最重要的几条：

1. 文件是真理，索引是缓存。rm -rf .index/ && mem rebuild不会丢失任何知识——这一点由测试强制执行，而非文档口头保证。你的记忆始终可 grep、可入 git、可整体迁移；
2. 写入不靠 Agent 自觉。蒸馏（distillation）在会话边界自动触发，完整对话轨迹会先被归档，"蒸馏漏掉了"绝不等于"系统弄丢了"；
3. 独立时钟的 Manage 层。睡眠期整合（consolidation）按价值遗忘、更新记忆，删除永远只以"提案"形式出现，等你确认；
4. 库内零 LLM 客户端。判断能力借用宿主 Agent 自己的 CLI，无需安装任何密钥、没有计费面，且每条写入都可见于你的会话记录；
5. 多宿主共享一个库。9 种有序的"写者/读者"组合全部通过测试——一个宿主写入的内容，另一个宿主能找到，细节完整。

按路径召回、分层阅读：上下文省 90%

agent-memory 的召回从不把文本粘贴进你的上下文，而是返回一份 L0 清单——一行摘要、文件路径、锚点、分数——然后由 Agent 按任务需要打开到对应深度：

mem recall "为什么用文件而不是数据库" # L0 清单，默认 8 条 mem read <name> --level outline # 只要标题；也可 abstract 或 full mem context "为什么用文件而不是数据库" # 一次调用：搜索 + 展开前几条 mem trace <name> # 需要时查看被引用的原始消息

索引行 → 摘要 → 全文 → 原始素材：每一层比上一层贵一个数量级，且每一层都是可以随时停下的位置。这套分层读取策略的实现在 packages/core/src/agent_memory/core/recall.py，而 Agent 侧的使用约定写在 skills/agent-memory/SKILL.md。

存储结构：一眼看懂记忆存在哪里

一条记忆就是一个文件，存放在如下目录中（默认位于~/agent-memory-store）：

$AGENT_MEMORY_STORE/ ├── MEMORY.md # 根索引，每条记忆一行——会话启动时唯一注入的内容 ├── config.toml # 全部可调参数，未知配置项会在加载时拒绝 ├── schemas/ # 每种类型的字段定义 ├── decision/ # 记忆按 <类型>/<分组>/<名称>.md 存放 ├── archive/ # 只增不改：蒸馏证据 + 完整会话轨迹副本 ├── dream-reports/ # 每次睡眠一份报告：动了什么、提案了什么 ├── .index/ # 完全可重建：内容哈希清单、FTS5、访问日志 └── .state/ # 运行时状态：蒸馏水位线、写锁

valid_from与可选的invalid_at定义记忆的有效期；被替换或删除的文件仍保留在库中，recall --as-of可以回答"某日当时的记忆是什么"——更新永不销毁。

快速安装：3 条命令搭好 Agent 长期记忆库

要求 Python 3.12+ 与 uv（README 中提及的工具），目前从源码安装：

git clone https://gitcode.com/gh_mirrors/age/agent-memory cd agent-memory uv sync --all-packages export PATH="$PWD/.venv/bin:$PATH"

接着初始化并验证"删索引不丢知识"的核心承诺：

mem init mem record --type decision --field project=agent-memory \ --abstract "Markdown 文件是唯一事实来源" \ --body "索引是可重建的缓存。" mem --json recall "事实来源" rm -rf ~/agent-memory-store/.index && mem rebuild

写一条、召回它、扔掉整个索引重建——三步走完，你对这套 agent-memory 长期记忆系统就有了直觉级的信任。✅

接入你的 Agent：一条 setup 命令

mem setup --host claude-code # 或：--host codex / muse-code

setup 会探测宿主、把mem-hook命令按宿主的钩子方言追加到配置（桌面客户端不读 shell PATH 也没问题）、安装 agent-memory skill，且不动其余设置。生命周期映射非常干净：

支持 MCP 的 Agent 还能通过mem-mcp获得同一套核心调用（memory_recall、memory_read、memory_record、memory_correct、memory_supersede、memory_merge、memory_delete等）；只会跑 shell 命令的 Agent 则直接用 CLI——CLI 是更宽的通用入口，context、sleep与提案账本目前仅 CLI 提供。各宿主的适配器边界设计见 docs/design/host-adapters.md。

让它睡一觉：独立的 Manage 层

mem sleep --reason host # 整合；T0 规则直接应用，T1 生成提案 mem proposals # 查看等待你确认的提案 mem decide <id> --accept

睡眠整合借用你指定的宿主 CLI 进行推理，为每次通行写一份 dream report，无人值守状态下永不删除任何东西——T0 只做规则内操作（日期、权重、链接、目录），T1 只会新建文件或把旧文件标记为失效，每类操作每次睡眠都有上限，一次睡眠对应一次 git 提交。物理删除只有人类手动命令才能执行。这套安全边界的完整契约见 docs/design/management-operation-boundaries.md，架构总览见 docs/design/index.md。

实测数据：记忆真的有用吗？

在 LongMemEval-S 上的测量（120 个 episode、Haiku 4.5 宿主、两个考试回放）：

没有记忆的 Agent 准确率只有 5.8%——这就是"一关会话就失忆"的量化代价。跨宿主的"一库三宿主"测试同样通过：Claude Code、Codex CLI、Hermes 之间 9 种写/读配对全部成功，净贡献从 2/36 提升到 13/36（p=0.0074）。

总结：为什么值得试

• 零密钥、零计费：判断力复用你已登录的宿主 CLI，库内没有任何 LLM 客户端；
• 纯 Markdown 即真理：ls、grep、git全都能用，迁移自由；
• 多 Agent 共享一个库：Claude Code 写的，Codex 能读，细节完整；
• 独立 Manage 层：睡眠期按价值整合与遗忘，删除只走提案，无人值守也安全。

如果你的 AI Agent 也在反复"重新认识你"，花十分钟跑一遍上面的快速安装，就能让长期记忆成为它的出厂能力。

【免费下载链接】agent-memoryLong-term memory runtime for AI agents — plain Markdown as the source of truth, local ranked retrieval, and an independent sleep-time Manage layer. Claude Code and Codex share one store. No API key.项目地址: https://gitcode.com/gh_mirrors/age/agent-memory