用途
Basic Memory 解决的是「AI 对话结束后就忘」的问题。它把知识保存为磁盘上的 Markdown 文件，人和 AI 都能读、写、搜索，从而让 AI 在不同会话之间接续上下文，不必反复解释项目背景。
主要能力
- 本地优先：知识以纯文本 Markdown 存在磁盘上，由用户掌控；无需服务器，只需本地 SQLite 索引。
- 双向读写：人与 AI 写同一批文件，同步保持一致；可在 Obsidian、VS Code 等编辑器中直接编辑。
- 真实知识图谱：每个文件是一个 Entity，包含 Observations（事实）与 Relations（wikilink 关系），可逐链遍历。
- 语义搜索：按含义而非仅关键词查找笔记，采用 FastEmbed 嵌入的混合全文+向量排序，支持 SQLite 或 Postgres；可选交叉编码器重排序以提高向量与混合结果质量。
- MCP 原生：兼容主流 AI 客户端与 IDE；每个工具带行为提示（只读、破坏性、幂等、开放世界），便于智能体按需渐进发现工具。
- 云端可选：跨设备同步、快照备份、团队共享工作区；非必需。
使用方式
有两种路径，使用同一产品与同一批 Markdown：
云端：注册后连接 AI 客户端，可在浏览器、移动端、桌面端使用，内置跨设备同步，托管、备份与快照由服务方处理。官方标价 $15.00/月（终身锁定），另有年付 $12.50/月；提供 7 天免费试用。开源用户使用代码 BMFOSS 可再享 3 个月 20% 折扣（约 $11.40/月）。Beta 期间注册的价格在保持订阅期间不变。团队版 Basic Memory Teams 支持单一共享云工作区，可实时协作编辑与人工/智能体交接，价格相同，按用户增加。
本地：安装后配置 AI 客户端即可运行。免费（AGPL-3.0），数据在本地磁盘，适合隔离环境；需要 Python（通过 uv）。注意：Basic Memory 0.23 依赖 FastMCP 4 预发布版，uv 只有在使用 --prerelease=allow 时才会接受传递依赖的预发布版本，否则会静默安装旧版本；所有 uvx / uv tool 升级命令都需带该标志。
客户端配置：Claude Desktop 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 后重启，笔记默认位于 ~/basic-memory；Codex 添加到 ~/.codex/config.toml，可保留默认 MCP 审批行为，或对符合条件的 Basic Memory 工具预批准（带破坏性注解的写入、编辑、删除仍需审批）；Cursor 添加 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）；ChatGPT 在用户设置（JSON）中添加，Basic Memory 提供 OpenAI 兼容的搜索与获取工具用于 Custom GPT 动作。
官方智能体包：仓库同时是 Basic Memory 的宿主原生智能体包源，核心 Python 包、Claude Code 插件、共享 skills、Hermes 插件、OpenClaw 插件同源发布。Claude Code 插件提供会话开始简报、压缩前检查点、可选的 capture 输出风格以及 /basic-memory:bm-setup、:remember、:share、:status 命令，需先连接 MCP 服务器；安装命令会注册市场并安装插件，可用 --scope project 为团队声明，或 --dry-run 预览。框架无关的 SKILL.md 位于 skills/；Claude 与 ChatGPT 可上传对应 zip。Hermes 插件位于 integrations/hermes，需另将 mcp 包加入 Hermes 虚拟环境；OpenClaw 位于 integrations/openclaw。
Markdown 格式：每个文件是一个 Entity，Observations 用 [方括号] 分类、# 标签、括号内为可选上下文；Relations 为 wiki 风格链接，关系类型为单 token 或加引号的多词。- [[Target]] 与文中 [[Target]] 均索引为 links_to。
MCP 工具（均默认文本输出，可传 output_format="json"）：内容类 write_note、read_note、edit_note、move_note、delete_note、read_content、view_note；搜索与发现 search_notes、recent_activity、list_directory；知识图谱 build_context（导航 memory:// URL）；项目 list_memory_projects、list_workspaces、create_memory_project、delete_project；模式 schema_infer、schema_validate、schema_diff；兼容与诊断 search、fetch、basic_memory_diagnostics。
其他特性：自动更新（uv tool 与 Homebrew 安装每 24 小时检查并静默更新，uvx 跳过；bm update 手动检查+应用，bm update --check 仅检查，可在 ~/.basic-memory/config.json 禁用）；可选的交叉编码器重排序（默认关闭，默认模型 jinaai/jina-reranker-v1-tiny-en，也可通过 LiteLLM 使用托管重排序器，配置无效时快速失败、不会静默回退）；模式系统；按项目云路由（bm project set-cloud）；更智能的编辑（edit_note 的 append/prepend 在笔记缺失时自动创建，write_note 防止意外覆盖）；更丰富的搜索结果包含匹配文本块。
适用场景
- 让 Claude、Codex、Cursor、ChatGPT 等 MCP 客户端在多个会话间记住项目背景。
- 在 Obsidian 等编辑器中维护知识库，同时让 AI 读写同一份文件。
- 团队共享单一知识空间，人与智能体交接工作。
- 需要离线或隔离环境的用户使用本地版。
- 需要对知识库结构做推断、校验与差异分析的用户。
限制与注意事项
云端为付费订阅（$15.00/月，年付 $12.50/月，含 7 天免费试用），团队版价格相同但按用户增加；本地版免费但需 Python 与 uv，且必须使用 --prerelease=allow。重排序默认关闭，本地提供方首次运行需下载模型并增加推理延迟。遥测收集最小化匿名事件（云端推广曝光、登录尝试与结果、推广退出），不收集文件内容、笔记标题、知识库数据、PII、IP 地址或逐命令/逐工具跟踪；事件发送到 Umami Cloud，后台线程不阻塞 CLI，可在配置中禁用。日志使用 Loguru，默认日志文件为 ~/.basic-memory/basic-memory.log（10MB 轮转，保留 10 天）。官方提到 Postgres 部署将语义向量存入 Milvus 时需安装第一方可选 extra。其余安装细节、具体命令行内容与部分配置项在资料中未完整提供。
