basicmachines-co/basic-memory

解决的问题

Basic Memory 为 AI Agent 和人类提供了一个持久化的双向记忆系统。它通过允许 AI 助手在用户磁盘上的纯 Markdown 文件中读取和写入结构化知识，解决了 LLM 对话易失性的问题，从而创建了跨会话和不同 AI 客户端的长期记忆。

工作原理

该系统使用 Model Context Protocol (MCP) 将 AI 客户端（如 Claude、Cursor 或 ChatGPT）连接到本地或云端托管的 Markdown 文件目录。这些文件作为包含观察（事实）和关系（wiki-links）的“Entities”起作用，从而形成知识图谱。AI 可以使用语义向量搜索（通过 FastEmbed）或关键词搜索来搜索这些笔记，并可以实时更新笔记。由于数据以纯文本形式存储，用户可以在 Obsidian 或 VS Code 等编辑器中手动编辑笔记，AI 会看到这些更改。

适用对象

希望其 AI 助手能够维护项目决策、学习心得和个人知识的运行日志，且不想被锁定在专有数据库或复杂的 RAG 基础设施中的开发者和高级用户。

亮点

• 本地优先且双向：知识以纯 Markdown 文件形式存储，人类和 AI 均可读取和写入。
• MCP 原生：兼容任何支持 Model Context Protocol 的 AI 客户端。
• 语义搜索：支持混合全文搜索和向量搜索，并提供可选的 cross-encoder 重排序以实现更高的精度。
• 知识图谱：使用 wikilinks 创建 AI Agent 可以遵循的可遍历信息图谱。
• 跨设备同步：提供可选的云端托管，用于在移动端、网页端和桌面设备之间进行同步。