basicmachines-co/basic-memory

AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN

解决的问题

Basic Memory 为 AI 助理提供了一个持久化的双向记忆系统。它解决了 LLM 对话转瞬即逝、知识在会话间丢失的问题。与传统的只读 RAG 不同，Basic Memory 允许人类与 AI 代理共同读写共享的 Markdown 知识库，从而建立随时间演进的长期记忆。

运作原理

该系统使用存储在本地或云端的纯 Markdown 文件作为事实来源。它实现了模型上下文协议 (MCP)，使其能够与 Claude、Cursor 和 VS Code 等 AI 客户端集成。

知识被结构化为带有“观察”(事实) 与“关系”(wiki-links) 的“实体”，形成一个可遍历的知识图谱。为了寻找信息，它结合了全文搜索与语义向量搜索 (通过 FastEmbed)，并可选配交叉编码器 (cross-encoder) 重排序以提高精确度。

适用对象

希望 AI 助理能在不同会话与工具 (例如 Obsidian、Claude Desktop、Cursor) 之间记住项目架构、个人学习心得与专业工作流程的开发者与 AI 高级用户。

特色亮点

  • 双向同步：人类与 AI 代理写入相同的 Markdown 文件。
  • MCP 原生：与任何兼容 MCP 的 AI 客户端或 IDE 无缝协作。
  • 本地优先：数据默认以纯文本格式存储在用户的磁盘上。
  • 语义搜索：结合向量与混合搜索，根据意义而非仅仅是关键字来寻找笔记。
  • 知识图谱：使用 wikilinks 让 AI 代理能够导航连接的概念。
  • 渐进式工具探索：工具标记了行为提示 (例如只读、破坏性)，协助代理高效选择正确的工具。

相关

  • 项目
    MemTensor/MemOS

    MemOS 2.0 是一个面向基于 LLM 的 AI 代理的内存操作系统。它提供统一的 API 用于存储、检索、编辑和删除多模态记忆（文本、图像、工具追踪等），以图结构组织。系统可作为托管云服务（API 密钥访问）运行，也可通过 Docker（Neo4j + Qdrant）自托管，或使用本地 SQLite 插件部署。已提供与 OpenClaw、Hermes 和 DeepSeek Harness 的预装插件。基准测试显示其性能优于现有商业记忆产品。采用 Apache 2.0 许可证。

  • 项目
    TencentCloud/TencentDB-Agent-Memory

    TencentDB Agent Memory 是一个用于 LLM 代理的开源记忆中心。它能捕捉对话、提取可重复使用的技能、从文档中建立 Wiki，并将代码索引至 CodeGraph。中央 UI (Memory Hub) 让团队能管理资产、设置细粒度的 ACL，并将特定的记忆片段绑定至个别代理。代理通过统一的代理服务器进行通讯，因此任何框架 (如 Claude Code、DeepSeek Harness、OpenClaw 等) 均可在无需修改代码的情况下使用相同的记忆。基准测试显示角色保留率提升了 59%。存储库提供一键式 Docker 部署、迁移工具，以及关于零配置冷启动与更多整合的路线图。

  • 项目
    EverMind-AI/EverOS

    EverOS 是一个 Python 库，为 AI 代理提供以 Markdown 为基础的本地优先记忆。它将文件同步至 SQLite 和 LanceDB，提供简单的 HTTP API 进行添加、清除与搜索，并仅需单个 OpenRouter 密钥即可进行关键字搜索。可选扩展功能包括基于嵌入的混合搜索、重排序与多模态文件导入。

  • 项目
    rohitg00/agentmemory

    一个为 AI 编码代理设计的持久化记忆层，通过捕捉并压缩会话数据，消除在不同会话和工具间重复解释项目背景的需求。

  • 项目
    mnemon-dev/mnemon

    Mnemon 是一个跨平台 CLI，为 LLM 代理添加持久化、基于图的记忆。宿主 LLM 监督要记住、链接或遗忘的内容，而 Mnemon 负责确定性存储、衰减、去重和可选的向量搜索。它通过一键设置与许多 AI 编程工具（Claude Code、Codex、Cursor 等）集成，只需一个本地二进制文件，且不需要额外的 API 密钥。