尧图网站建设 
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-memoryAI 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 中写得非常直白这里挑出对普通用户最重要的几条文件是真理索引是缓存。rm -rf .index/ mem rebuild不会丢失任何知识——这一点由测试强制执行而非文档口头保证。你的记忆始终可 grep、可入 git、可整体迁移写入不靠 Agent 自觉。蒸馏distillation在会话边界自动触发完整对话轨迹会先被归档蒸馏漏掉了绝不等于系统弄丢了独立时钟的 Manage 层。睡眠期整合consolidation按价值遗忘、更新记忆删除永远只以提案形式出现等你确认库内零 LLM 客户端。判断能力借用宿主 Agent 自己的 CLI无需安装任何密钥、没有计费面且每条写入都可见于你的会话记录多宿主共享一个库。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 与 uvREADME 中提及的工具目前从源码安装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 projectagent-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-codesetup 会探测宿主、把mem-hook命令按宿主的钩子方言追加到配置桌面客户端不读 shell PATH 也没问题、安装 agent-memory skill且不动其余设置。生命周期映射非常干净宿主事件动作SessionStart注入有界记忆索引Stop / SessionEnd触发蒸馏边界自动写PreCompact压缩前逐出支持 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-memory 对比agent-memory W2127/240 52.9%—MemCore W286/240 35.8%37/−17p0.009无记忆7/120 5.8%61/−4p0.001没有记忆的 Agent 准确率只有 5.8%——这就是一关会话就失忆的量化代价。跨宿主的一库三宿主测试同样通过Claude Code、Codex CLI、Hermes 之间 9 种写/读配对全部成功净贡献从 2/36 提升到 13/36p0.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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AI Agent一关会话就失忆？agent-memory：免API密钥的纯Markdown长期记忆运行时完全指南
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-memoryAI 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 中写得非常直白这里挑出对普通用户最重要的几条文件是真理索引是缓存。rm -rf .index/ mem rebuild不会丢失任何知识——这一点由测试强制执行而非文档口头保证。你的记忆始终可 grep、可入 git、可整体迁移写入不靠 Agent 自觉。蒸馏distillation在会话边界自动触发完整对话轨迹会先被归档蒸馏漏掉了绝不等于系统弄丢了独立时钟的 Manage 层。睡眠期整合consolidation按价值遗忘、更新记忆删除永远只以提案形式出现等你确认库内零 LLM 客户端。判断能力借用宿主 Agent 自己的 CLI无需安装任何密钥、没有计费面且每条写入都可见于你的会话记录多宿主共享一个库。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 与 uvREADME 中提及的工具目前从源码安装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 projectagent-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-codesetup 会探测宿主、把mem-hook命令按宿主的钩子方言追加到配置桌面客户端不读 shell PATH 也没问题、安装 agent-memory skill且不动其余设置。生命周期映射非常干净宿主事件动作SessionStart注入有界记忆索引Stop / SessionEnd触发蒸馏边界自动写PreCompact压缩前逐出支持 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-memory 对比agent-memory W2127/240 52.9%—MemCore W286/240 35.8%37/−17p0.009无记忆7/120 5.8%61/−4p0.001没有记忆的 Agent 准确率只有 5.8%——这就是一关会话就失忆的量化代价。跨宿主的一库三宿主测试同样通过Claude Code、Codex CLI、Hermes 之间 9 种写/读配对全部成功净贡献从 2/36 提升到 13/36p0.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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考