Basic Memory：让 AI 助手读写关联笔记
Basic Memory 是一套本地优先的知识系统，人和 AI 助手都可以读取、写入和搜索其中的 Markdown 文件。它适合保留需要在后续对话中使用的信息，例如项目决策、研究笔记、会议摘要或值得回看的解释。新会话仍然需要检索相关笔记；把信息保存下来，不等于模型已经获得了这些上下文。
文件、观察记录与关系
Basic Memory 把每篇笔记视为一个实体。观察记录是笔记中带有分类的陈述，关系则把它连接到另一篇笔记。这些连接构成知识图谱，让人和助手可以顺着关联继续查找，而不只依靠一次关键词匹配。官方知识格式指南 介绍了具体的 Markdown 语法。
例如，一篇项目笔记可以这样写：
# 回测范围
## 观察记录
- [决策] 将分析保留为命令行脚本。
- [约束] 使用测试数据，不修改生产账户。
- [完成条件] 手续费分摊测试通过后结束。
## 关系
- relates_to [[生产环境隔离]]
这只是一份示例记录，不是工具内置的规则。链接中的标题指向示例知识库里的另一篇笔记。记录真实决策时，应注明批准人、适用时间和来源链接，并区分已接受的决策与提案，让后来的读者能判断究竟确定了什么。
连接一个项目
按官方说明 完成安装和客户端设置后，可以注册一个存放本地笔记的目录。把 ./notes 换成目标目录，把 research 换成自行选择的项目名：
basic-memory project add research ./notes --local
basic-memory project list --local
添加本地项目时会为它建立索引。兼容 MCP 的客户端随后可以使用 write_note、read_note、edit_note 和 search_notes 等工具；build_context 则通过 memory:// 地址沿着笔记之间的连接获取上下文。这些是工具名称，不是 shell 命令。客户端如何调用工具，可参阅 MCP（模型上下文协议）。
一种实用的问法是：请助手在选定项目中找到回测范围笔记，读完后说明哪些决策仍适用于当前请求。搜索支持关键词和语义检索，具体是否可用、如何工作，取决于搜索配置。官方仓库 列出了工具接口。
记忆系统不等于权限系统
Basic Memory 支持双向编辑。它没有规定一个项目只能有一篇笔记，也不禁止启动时检索，更没有把所有写入权限定给人类。团队可以约定修改决策笔记前必须审批，但要通过客户端、权限设置和工作方式落实这项约定。
旧笔记可能有误，也可能已被后续决策替代。它与当前请求或适用规则冲突时，应先确定哪个决策仍然有效，而不是默默把存储的文本当成更高优先级的指令。检索内容也可能包含不可信指令；进入知识图谱并不会让它变得可以安全照做。
本地 Markdown 存储本身不提供跨设备同步、备份，也不保证 AI 处理过程私密。这些取决于部署方式和客户端。Basic Memory 提供可选的云托管与同步服务；即使文件保存在本机，连接的远程 AI 服务仍可能收到你发送给它的笔记。
何时选择其他工具
主要想搜索 Markdown 集合时，可以使用 QMD。需要定位工作区中的代码或文档章节时，可以使用 zvec-grep。智能体记忆与检索 说明这些选择如何与来源核对、任务上下文配合。Python 软件包发布在 PyPI。