obsidian-mind 是什么?

Obsidian Mind 是一套可直接作为 Obsidian vault 使用的 Agent 持久记忆模板。它用 Markdown、链接、索引、生命周期 hooks 和一组 `om-*` 命令保存目标、项目、人物、会议、决策和工作记录,完整支持 Claude Code,并为 Codex CLI 与 Gemini CLI 提供同源 hooks。

⭐ 2,944 Stars 🍴 367 Forks TypeScript — 作者: breferrari
来源:github.com/breferrari/obsidian-mind/blob/main/README.md 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v8.4.0 把项目从简单 vault 模板推进到可选 QMD 混合检索、跨仓库 `om` MCP 和受预算约束的会话上下文。

来源:github.com/breferrari/obsidian-mind/releases/tag/v8.4.0;https://githu…

核心功能

会话生命周期

SessionStart 注入目标、活跃工作、最近变化与任务;消息分类 hook 给出归档提示;wrap-up 校验链接、更新索引并补记成果。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md
工作记忆命令

`om-standup`、`om-dump`、`om-incident-capture` 等命令把晨会、会议、决策、事故与成果写进约定目录和互链笔记。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md
可选 QMD 混合检索

QMD 在本地提供 BM25、向量检索和重排;未安装时退回 grep 与 Obsidian CLI,MCP 项会跳过。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md
跨仓库记忆 MCP

用户级 `om` MCP 可以从其他仓库搜索、读取、展开链接并回写 vault,方便多个项目共用决策记录。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md

技术架构

持久数据位于 git 可追踪的 `brain/` 等 Markdown 目录;Obsidian 负责浏览与链接,Node 22+ 运行 TypeScript hooks,Agent 负责内容判断。可选 QMD 为每个 vault 建独立 SQLite 索引并在本机运行三个模型;`om` MCP 通过 Node 脚本跨仓库暴露 search、expand、recall、record 等操作。用户级注册能让任意仓库访问该 vault,因此权限范围大于在 vault 目录内单次运行 Agent。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md;https://githu…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Obsidian 1.12+ Node 22+ LTS Git QMD(可选) 会话生命周期 工作记忆命令 可选 QMD 混合检索 跨仓库记忆 MCP obsidian-mind 项目本体 核心功能 关键依赖

技术栈

语言Markdown、TypeScript、shell框架Obsidian vault + Agent hooks/commands + 可选 MCP
Obsidian 1.12+Node 22+ LTSGitQMD(可选)
本地文件和 Git;QMD 本地 SQLite/模型;ShardMind 或 git clone 安装
来源:github.com/breferrari/obsidian-mind/blob/main/README.md

快速上手

准备空目录后运行 `npm install -g shardmind`,进入该目录执行 `shardmind install github:breferrari/obsidian-mind`。用 Obsidian 1.12+ 打开 vault,在设置中启用 CLI,再从 vault 目录启动 Claude Code、Codex 或 Gemini,并先运行 `om-standup`。安装向导会写当前目录并可初始化 Git、QMD 和个人信息;先在测试 vault 查看差异,再导入真实工作记录。
来源:github.com/breferrari/obsidian-mind/blob/main/README.md;https://githu…

使用场景

适合个人或小团队保存跨会话的项目背景、设计决策、1:1、事故复盘和成果记录。涉及同事资料、Slack 记录或多仓库访问时,应先确定数据保留与授权范围;不适合作为无需治理的公司级知识库。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md

优势与局限

优势

  • 持久记忆是可读可迁移的 Markdown
  • hooks、命令和索引职责分明
  • QMD 可选且缺失时有词法回退
  • 同一 vault 支持三个主流编码 Agent

局限

  • 会集中保存人物、会议和项目敏感信息
  • 用户级 MCP 可让任意本地仓库访问 vault
  • QMD 首次下载约 2.2 GB 模型并占用本机算力
  • 非 Claude Agent 的 hook 与命令支持存在差异
来源:github.com/breferrari/obsidian-mind/blob/main/README.md

最新版本

v8.4.0 发布于 2026-09-02,修复 QMD 搜索路径重复向量检索和错误 embedder 继承问题。Release 的快速开始仍要求 Obsidian、Node 22+ 与受支持 Agent。

来源:github.com/breferrari/obsidian-mind/releases/tag/v8.4.0

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、ARCHITECTURE、v8.4.0 Release 与安装要求  |  limitations: 未安装 ShardMind、Obsidian 或 QMD,未创建 vault,未下载模型,未注册 MCP,未读取或写入任何用户笔记  |  observed_output: 当前版为 v8.4.0(2026-09-02);要求 Obsidian 1.12+、Node 22+、Git 和一个支持的 Agent,QMD 为可选依赖

来源:github.com/breferrari/obsidian-mind/releases/tag/v8.4.0;https://githu…

同类项目对比

相比 GBrain 的数据库、常驻 daemon、实体边与带来源回答,Obsidian Mind 把 Markdown vault、Obsidian 浏览体验和会话 hooks 放在中心;前者更偏主动摄取与结构化图查询,后者更适合愿意直接维护笔记文件和工作流程的人。两者都在本机保存核心数据,但都要单独审计 Agent 与外部模型的访问。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md;https://githu…

总结评价

它适合愿意用 Markdown 管理个人工作记忆、并需要跨会话上下文的用户。先用空 vault 验证 hooks、索引和 MCP 范围,再加入真实资料;人物、会议和公司决策进入 vault 前应先确定授权、同步与删除规则。

来源:github.com/breferrari/obsidian-mind/blob/main/README.md

常见问题

Obsidian Mind v8.4.0 必须安装 QMD 吗?

不必须。没有 QMD 时会退回 grep 和 Obsidian CLI,MCP 配置会跳过;安装 QMD 后才有本地向量检索与重排。

Obsidian Mind 会把 vault 上传到云端吗?

仓库设计把 vault 和 QMD 索引留在本机,但实际 Agent、模型提供方、同步插件和 Git 远端可能读取或传输内容,需要按自己的配置逐项核对。

注册用户级 om MCP 有什么权限影响?

它让其他仓库中的 Agent 搜索、读取并回写这个 vault。应只给可信 Agent 使用,并把人物、会议和凭据类内容放入明确的访问与备份策略。

Obsidian Mind 对 Codex 和 Gemini 的支持与 Claude Code 一样吗?

不是完全一样。三者共用 Markdown、TypeScript hooks 和命令内容;README 把 Claude Code 标为完整支持,Codex 与 Gemini 使用各自配置映射,其他 Agent 的 hook 支持还会不同。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件