Obsidian Mind v8.4.0：让 Agent 记住工作，也要管住 vault

Obsidian Mind 是一套可直接打开的 Obsidian vault。Markdown 文件保存人物、项目、会议、决策与成果；hooks 在会话开始和写入时整理上下文；可选 QMD 提供本地混合检索，`om` MCP 则能让其他仓库访问这套记忆。

版本与要求

v8.4.0 发布于 2026-09-02，修复 QMD 搜索重复向量检索和错误 embedder 继承。运行要求是 Obsidian 1.12+、Node 22+ LTS、Git，以及 Claude Code、Codex CLI 或 Gemini CLI；QMD 可选。

先在空 vault 安装

npm install -g shardmind
mkdir my-test-vault && cd my-test-vault
shardmind install github:breferrari/obsidian-mind

ShardMind 会向当前目录写文件，并可初始化 Git、QMD 和个人资料。用 Obsidian 打开后启用 CLI，再从 vault 目录启动 Agent，先试 `om-standup`。已有 vault 不要直接覆盖，先比较目录、hooks 和配置。

记忆怎样流动

SessionStart 注入目标、活跃项目、最近变化和任务；消息分类 hook 提醒该写到哪里；结束时 `om-wrap-up` 校验链接、更新索引并查漏。QMD 在本机运行嵌入、查询扩展和重排模型，首次使用会下载约 2.2 GB；缺少 QMD 时，系统退回 grep 与 Obsidian CLI。

隐私和访问范围

vault 可能集中保存同事、1:1、事故和公司决策，备份和同步都要按敏感资料处理。
用户级 `om` MCP 让其他本地仓库中的 Agent 搜索、读取并回写 vault，授权范围很大。
本地文件不等于内容不会离机；所选 Agent、模型提供方、同步插件和 Git 远端都可能形成传输路径。
仓库提供 Claude Code 完整支持；Codex 与 Gemini 复用同源脚本，但配置映射和功能细节不同。

与 GBrain 对比

GBrain 以数据库、常驻 daemon、实体边和带来源回答为核心；Obsidian Mind 以可读 Markdown vault、Obsidian 浏览和会话 hooks 为核心。需要主动摄取和结构化图查询时看 GBrain；希望直接维护笔记文件和工作流程时，Obsidian Mind 更贴近这种习惯。

验证边界：本轮只核对官方 README、ARCHITECTURE 和 v8.4.0 Release。未安装 ShardMind、Obsidian 或 QMD，未创建 vault、下载模型、注册 MCP，也未读取或写入用户笔记。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

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

采用建议

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

原教程未展开的系统信息

核心功能

工作记忆命令
`om-standup`、`om-dump`、`om-incident-capture` 等命令把晨会、会议、决策、事故与成果写进约定目录和互链笔记。
跨仓库记忆 MCP
用户级 `om` MCP 可以从其他仓库搜索、读取、展开链接并回写 vault，方便多个项目共用决策记录。

技术栈和运行条件

语言

Markdown、TypeScript、shell

框架

Obsidian vault + Agent hooks/commands + 可选 MCP

关键依赖

Obsidian 1.12+
Node 22+ LTS
Git
QMD（可选）

运行环境

本地文件和 Git；QMD 本地 SQLite/模型；ShardMind 或 git clone 安装

常见问题

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 支持还会不同。

官方来源：仓库、v8.4.0、架构文档。