basic-memory：使用结构化 Markdown 和 MCP 的持久双向记忆系统

它解决了什么问题

Basic Memory 为 AI 代理和人类提供了持久的、结构化的记忆系统。它解决了会话结束后知识丢失的短暂 LLM 对话问题，并通过允许 AI 和人类对共享的本地优先知识库进行读写，克服了传统 RAG（只读）的限制。

工作原理

该系统使用纯 Markdown 文件作为唯一可信来源。这些文件被组织为包含“观察”（事实）和“关系”（指向其他笔记的链接）的“实体”知识图谱。

AI 代理通过模型上下文协议（MCP）与此记忆交互，能够实时搜索、创建和编辑笔记。人类可以使用任何 Markdown 编辑器（如 Obsidian）编辑这些相同的文件。本地 SQLite 索引和语义向量搜索（使用 FastEmbed）使 AI 能够通过意义而非仅关键词来查找笔记。

适用人群

• AI 高级用户： 使用 Claude、Cursor 或 ChatGPT 的人，希望 AI 能在会话之间记住项目细节、学习内容和偏好。
• 代码导向用户： 使用 VS Code 或 Cursor 等 IDE 的开发者，希望持久记录架构决策和技巧。
• 知识工作者： 使用 Obsidian 或其他基于 Markdown 的笔记应用的用户，希望 AI 助手管理并扩展他们的知识图谱。

亮点

• 双向同步： 人类和 AI 都可以读取和写入相同的 Markdown 文件。
• MCP 原生： 直接集成到 Claude Desktop、Claude Code、Cursor 和 VS Code 等主要 AI 客户端。
• 本地优先： 数据以纯文本形式存储在用户磁盘上，确保没有供应商锁定。
• 语义搜索： 结合全文和向量排序，以意义查找笔记。
• 知识图谱： 使用 wikilinks 和结构化关系，让 AI 能遍历并构建上下文。
• 渐进式工具发现： 工具带有行为提示标签（例如只读、破坏性），帮助代理高效选择合适的工具。