Basic Memory：把 Markdown 笔记接入 AI 的本地优先记忆工具

它解决什么问题

Basic Memory 面向希望让 AI 持续记住项目背景、研究记录和工作决策的人。它把知识保存为 Markdown 文件，再通过 Model Context Protocol（MCP）连接 Claude、Codex、Cursor、ChatGPT、VS Code 等客户端。这样，人与 AI 可以围绕同一批可读、可编辑的文件积累上下文，而不是把信息锁在单次聊天里。

项目强调本地优先：本地模式下，数据保存在用户磁盘上；云端同步是可选路径。对于已经使用 Markdown 或 Obsidian 的个人、开发者、研究者和小型团队，这种文件形态更容易纳入现有工作流。仓库也标注了 air-gapped friendly，但这只是项目 README 的定位描述，不等同于对特定隔离环境的兼容性保证。

已知功能

Basic Memory 支持 AI 与人双向写入，并通过同步保持两者看到的内容一致。项目将观察记录和 wikilink 组织成知识图谱，用于形成相互关联的长期上下文；语义搜索则允许按含义查找笔记，而非只依赖关键词。README 还提到可选的交叉编码器重排，用于改善向量和混合检索结果。

它的 MCP 集成覆盖多个常见 AI 客户端和 IDE。仓库同时包含 Claude Code 插件、共享技能以及 Hermes、OpenClaw 等集成目录。不过这些集成的安装步骤、支持范围和依赖并不完全相同，不能仅凭“支持 MCP”推断所有客户端具有相同体验。

截至官方 v0.23.2 release，项目记录了一项 API 修复：解析笔记目录时不区分大小写。该版本信息来自官方 release 页面；采用者仍应根据自己的部署时间核对变更记录。

适合谁

它适合想把 AI 对话沉淀为长期项目资料的人，尤其是已经习惯 Markdown、希望保留本地文件控制权，或需要在多个 MCP 客户端之间复用知识的用户。开发者可将项目日志、架构决策和学习记录放入同一知识库；研究者和知识工作者则可以利用 wikilink 与语义检索组织资料。若团队需要共享工作区，README 另列出 Basic Memory Teams，但这是云端产品路径，不能与本地自托管体验混为一谈。

采用前的限制与部署考虑

首先确认运行环境。README 的徽章标明 Python 3.12+，并说明 Basic Memory 0.23 依赖 FastMCP 4 预发布版本；依赖解析因此可能需要额外关注，不能把普通稳定依赖流程视为已确认兼容。仓库提供 Docker Compose 和 Postgres 相关文件，但现有来源没有充分说明各部署拓扑、资源需求或生产运维边界，因此这些内容应在试点中自行验证。

其次规划文件、同步和备份。云端具备跨设备同步、快照和备份；本地模式则需要用户自行选择 Git、Syncthing 或其他方案。多人同时编辑、冲突处理、移动端访问和离线环境的实际表现，不能仅依据功能列表推断。

最后审查许可证。仓库元数据和 README 均指向 AGPL-3.0。若组织要修改并通过网络提供服务，建议让法务或开源合规人员结合具体架构评估义务。Basic Memory 是开源项目，但云端方案另有定价；本地免费并不意味着部署、维护和备份没有成本。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-09-30