oleksiijko/pmb

这是什么？

核心功能

• 01将决策、经验教训、事实和项目结构保存在本地 SQLite 文件中。
• 02通过 MCP 对接 Claude Code、Cursor、Codex、Windsurf、Zed 和 VS Code。
• 03混合检索，结合 BM25、向量搜索、实体图谱及可选重排序。
• 04在支持的代理上通过生命周期钩子，在模型回答前注入相关记忆。
• 05可索引项目代码、PDF、Markdown 和 ChatGPT 导出记录。
• 06提供本地网页面板浏览记忆，并支持经校验的快照备份与恢复。

适用场景

• 在多次编码会话之间保留架构决策和项目约束。
• 让 Claude Code 或 Cursor 持续了解代码库背景，同时数据不上传云端。
• 在终端中检索个人笔记、PDF 和过往的代理对话记录。

快速上手

1. 1

   从 PyPI 安装软件包

   pip install pmb-ai
2. 2

   将 PMB 接入已检测到的 AI 代理

   pmb setup
3. 3

   预加载嵌入模型，使首次检索更快

   pmb warmup
4. 4

   重启代理，然后运行诊断命令确认配置正确

   pmb doctor

使用前须知

• !默认嵌入模型约 450 MB，首次使用前需要下载。
• !部分功能（如钩子和可选的交叉编码器重排序）仅适用于特定代理或配置。

收录于专题

标签

常见问题

pmb 是什么？

面向 Claude Code、Cursor、Codex 等 AI 编程代理的本地持久记忆，通过 MCP 提供服务，数据存于本地 SQLite。 AI 编程代理在会话之间会忘掉决策、经验教训和项目背景，开发者因此要反复解释同样的约束。PMB 把这些内容以持久记忆的形式存放在本地工作区中：SQLite 作为权威数据源，旁边是可重建的 LanceDB 向量索引。代理通过 prepare(message)、recall(query) 等 MCP 工具读取记忆，检索结合了 BM25、向量搜索、实体图谱和可选的重排序。

pmb 可以免费使用吗？用的什么许可证？

pmb 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

pmb 还在维护吗？

半年内有更新。pmb 最近一次提交是在 2026年9月23日。

pmb 适合用来做什么？

在多次编码会话之间保留架构决策和项目约束。 让 Claude Code 或 Cursor 持续了解代码库背景，同时数据不上传云端。 在终端中检索个人笔记、PDF 和过往的代理对话记录。

pmb 怎么安装和运行？

从 PyPI 安装软件包: pip install pmb-ai 将 PMB 接入已检测到的 AI 代理: pmb setup 预加载嵌入模型，使首次检索更快: pmb warmup 重启代理，然后运行诊断命令确认配置正确: pmb doctor

在哪里获取 pmb？

源代码和安装说明在 GitHub 上：https://github.com/oleksiijko/pmb