
pi-memory:为 pi 编码代理提供持久记忆的扩展
来源标题:Pi-memory: persistent memory extension for pi
pi-memory 是 pi 官方包目录中收录的热门记忆扩展,可为编码代理提供跨会话的持久记忆。它以纯 markdown 文件形式保存长期事实、每日日志和待办便签,存储在 ~/.pi/agent/memory/ 下,并可通过 qmd 实现关键词、语义和混合搜索。用户可用 pi install npm:pi-memory 安装。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
pi 最受欢迎的记忆扩展——收录于官方 pi 包目录,语义搜索由 qmd 提供支持。 感谢 https://github.com/skyfallsin/pi-mem 带来的灵感。 你的编程 agent 在会话之间会忘掉一切。pi-memory 给了它记忆:持久的事实与决策、持续记录的每日日志,以及一份待办事项便签——全部以纯 markdown 文件形式保存,你可以阅读、编辑和提交。配合可选的 qmd,它还能对记住的一切内容进行关键词、语义和混合搜索。
会话 1
你 ▸ 我在这个仓库里一直用 pnpm,从不用 npm。记住这一点。 pi ▸ 明白——已保存到长期记忆。(写入 MEMORY.md)
……几天后,全新的会话……
你 ▸ 把 prettier 加为开发依赖 pi ▸ pnpm add -D prettier (从记忆中回想起了你的包管理器偏好——无需提醒) 一切内容都以 markdown 形式存放在 ~/.pi/agent/memory/ 下,所以你也可以直接 cat 它: $ cat ~/.pi/agent/memory/MEMORY.md
<!-- 2026-06-07 10:12:03 [a1b2c3d4] -->#preference [[package-manager]] 在这个仓库里一直用 pnpm,从不用 npm。 安装
从 npm 安装(推荐)
pi install npm:pi-memory
……或者从本地检出安装
pi install ./pi-memory 就这样——六个核心工具(memory_write、memory_forget、memory_restore、 memory_read、scratchpad、memory_status)无需其他配置即可立即使用。 搜索功能需另行启用,见下文。 memory_search(以及选择性注入)需要 qmd。两种安装方式均可: npm install -g @tobilu/qmd # 无需 Bun bun install -g https://github.com/tobi/qmd # 确保 ~/.bun/bin 在 PATH 中 当 qmd 存在时,扩展会在下次会话启动时自动创建 pi-memory 集合和路径上下文——无需手动操作。随时运行 memory_status 可确认 qmd、集合和嵌入是否就绪。 语义/深度模式需要向量嵌入;扩展会自动保持其最新 (qmd embed 在会话启动时和写入之后于后台运行)。首次嵌入会下载嵌入模型,因此全新安装后语义搜索 可能需要一分钟才能上线。要手动设置集合: qmd collection add ~/.pi/agent/memory --name pi-memory qmd context add /daily "按日期组织的每日只追加工作日志" -c pi-memory qmd context add / "精选长期记忆:决策、偏好、事实、经验教训" -c pi-memory qmd embed 没有 qmd 时,核心工具仍可完整使用——只有 memory_search 和选择性注入需要它。 工具 描述 memory_write 写入 MEMORY.md(长期)或每日日志 memory_forget 删除匹配条目并创建持久恢复记录 memory_restore 使用 memory_forget 返回的恢复 ID 恢复删除 memory_read 读取任意记忆文件或列出每日日志 scratchpad 添加/完成/撤销/清除/列出清单项 memory_search 搜索所有记忆文件(需要 qmd) memory_status 健康检查:文件位置、qmd/集合/嵌入状态、当前配置 memory_search 模式 模式 速度 方法 最适合 keyword ~30ms BM25 具体术语、日期、名称、#tags、[[links]] semantic ~2s 向量搜索 相关概念、不同措辞 deep ~10s 混合 + 重排序 其他模式找不到时 如果第一次搜索没有找到你需要的内容,试试换个说法或切换模式。 ~/.pi/agent/memory/ MEMORY.md # 精选长期记忆 SCRATCHPAD.md # 待修复/待记住事项清单 daily/ 2026-02-15.md # 每日只追加日志 2026-02-14.md ... recovery/ <recovery-id>.json # memory_forget 删除操作的完整载荷和恢复状态 工作原理 上下文注入 在每个 agent 回合之前,以下内容会按优先级顺序注入系统提示: 本地前缀缓存运行时(llama.cpp、vLLM、MLX)会从第一个出现分歧的 token 起失效。如果注入的记忆块逐回合变化,那么后续每个 user / assistant / tool token 都会被重新处理——实际上每回合都要处理整个对话历史。 为保持前缀字节稳定,扩展会在精心设定的检查点对记忆上下文做快照,并在其间的每个回合输出相同的字节。快照会在以下情况下刷新: 带 target: daily 的 memory_write 和 scratchpad 写入不会标记为脏——它们频率高,且写入内容已通过工具调用参数回显。模型随时可以调用 memory_read / memory_search 获取权威的最新状态。 设置 PI_MEMORY_SNAPSHOT=per-turn 可选择退出并恢复旧的逐回合重建行为,包括自动的逐提示 qmd 搜索注入。 当设置 PI_MEMORY_SNAPSHOT=per-turn 且 qmd 可用时,扩展会在每回合前使用用户提示自动搜索记忆。前 3 条关键词结果会随标准上下文一起注入。这样无需显式调用 memory_search 即可呈现相关的过往决策,代价是每回合都会破坏 KV 缓存(搜索依赖提示,无法缓存)。 搜索有 3 秒超时,且静默失败。在默认的稳定模式下,模型通过按需调用 memory_search 获得相同能力。 在记忆内容中使用 #tags 和 [[wiki-links]] 以提升可搜索性: #decision [[database-choice]] 所有后端服务选用 PostgreSQL。 #preference [[editor]] 用户偏好使用 Neovim 搭配 LazyVim 配置。 #lesson [[api-versioning]] URL 前缀版本控制(/v1/)可避免 CDN 缓存问题。 这些是内容约定,而非强制元数据。qmd 的全文索引使它们免费可搜索。 当上下文窗口压缩时,扩展会自动在当天的每日日志中捕获一条交接条目:
<!-- HANDOFF 2026-02-15 14:30:00 [a1b2c3d4] -->会话交接
未完成的便签事项:
- 修复认证 bug
- 审查 PR #42 近期每日日志上下文: ...今天日志的最后 15 行... 这确保进行中的上下文在压缩后得以保留,并在下一回合可见(通过当天每日日志注入)。 持久性:记忆文件是磁盘上的纯 markdown——可读、可编辑、对 git 友好。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。