Mem0 官方插件(@mem0/pi-agent-plugin)

Mem0 官方发布的 Pi 扩展,提供跨会话、分作用域的自动化语义记忆捕获与检索。

安装命令
pi install npm:@mem0/pi-agent-plugin
临时试用 / 替代安装命令
pi -e npm:@mem0/pi-agent-plugin
挂接事件钩子与注册入口
before_agent_start(自动语义召回)agent_end(自动捕获提交)
pi.registerTool()(mem0_memory)pi.registerCommand("/mem0-remember" / "/mem0-forget" / "/mem0-search" / "/mem0-tour" / "/mem0-scope" / "/mem0-status")ctx.ui.confirm()(破坏性遗忘前确认)

1. 是什么

@mem0/pi-agent-plugin 是 Mem0 官方仓库(mem0ai/mem0)维护的 Pi 持久语义记忆扩展。

它由扩展入口(./dist/entry.js)与 6 个配套技能(./skills)组成,支持 project、session 和 global 三级记忆隔离。

2. 解决什么问题

本地文件日志或关键词全文检索难以按“语义相似”找回跨会话积累的偏好、踩坑结论与项目约定;换台电脑或开新子仓库目录时,经验也容易散落。

Mem0 官方插件在每次会话自动提取重要事实并在回答前按语义相关性注回上下文。

3. 作用原理(事件钩子与工具注册层)

在回合前按语义召回项目记忆,在 agent_end 后自动抽取捕获,并向模型注册 mem0_memory 工具和 6 个斜杠命令。

  • 启动时通过 git rev-parse —show-toplevel 自动识别仓库根目录作为 project 作用域的 app_id,确保同一 monorepo 不同子目录共享同一套项目记忆池。
  • 每次 Agent 回复前,扩展使用当前上下文检索 project 作用域下的相关记忆并注入;在 agent_end 结束后(当 autoCapture 开启时),把用户与助手文本提交给 Mem0 做结构化事实抽取。
  • 模型也可主动调用 mem0_memory 工具读写记忆;global 跨项目读取则受策略限制,必须显式设置 /mem0-scope global 或配置 defaultScope: “global”。

4. 怎么装与基本配置

  • 需先在 app.mem0.ai 获取 API Key,设置环境变量 export MEM0_API_KEY=“m0-…”,或写入 ~/.pi/agent/mem0-config.json。
  • 默认 searchThreshold 为 0.3,过低会带入无关记忆,过高会漏召回,可在配置文件中微调。
  • 安装后可用 /mem0-status 检查连通性与身份标识,用 /mem0-tour 浏览已归类记忆。

5. 和同类怎么选

相比纯本地 Markdown 或 SQLite FTS5 方案,@mem0/pi-agent-plugin 的优势是官方托管向量语义检索与跨设备同步,代价是需要外部 API Key 并把会话片段发往 Mem0 服务。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-memory / pi-hermes-memory 纯本地文件(qmd)或本地 SQLite FTS5 存储,无需外发对话内容,也没有外部 API 成本。 代码与上下文不能离开本机时选本地记忆方案;需要跨设备共享语义记忆且可接受 Mem0 云服务时选官方插件。

同方向对比包与顺序阅读

billion-context

跨多编码 Agent 的上下文压缩插件与本地代理,支撑超长单会话并压低多轮 token 消耗。

阅读该包机制详评

context-mode

完全本地运行的上下文省流插件:沙箱执行工具、SQLite FTS5 建索引,只把命中摘要送进上下文。

阅读该包机制详评

04 记忆与上下文经济

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「Mem0 官方插件(@mem0/pi-agent-plugin)」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)