breferrari/obsidian-mind

概述

Obsidian Mind 是一个 Obsidian 模板库，可将个人知识库转变为 AI 编码代理（如 Claude Code、Codex CLI 和 Gemini CLI）的长期记忆存储。该库附带一组钩子脚本、命令快捷方式和可选的语义搜索集成（QMD），因此每次启动编码助手会话时，代理都会预先加载 North Star 目标、活跃项目、最近的 git 更改、开放任务和文件列表。在您交谈时，代理会自动创建和更新笔记——会议记录、决策记录、事件时间线、brag-doc 条目——并保持库整洁。

主要功能

功能	作用	重要性
跨会话持久记忆	一个 `SessionStart` 钩子在每次代理对话开始时注入精选上下文（目标、项目状态、最近更改）。	代理不再从空白开始；它记住过去的决策和正在进行的工作。
斜杠命令快捷方式	像 `/om-standup`、`/om-dump`、`/om-incident-capture`、`/om-wrap-up` 这样的命令触发预定义的工作流，在特定文件夹（人员、工作、决策、brag 文档等）中创建或更新笔记。	一行命令将口头更新转化为一组完全链接的 markdown 文件。
自动笔记链接与验证	工具后钩子验证前置元数据、强制反向链接、拆分过大的笔记，并标记错放的文件。	保证一个干净、图形化的知识库，易于浏览和审计。
可选 QMD 语义搜索	安装后，QMD 提供本地嵌入、查询扩展和重排序，使代理能够按含义检索笔记（例如，“我们关于缓存做了什么决定”）。	无需将数据发送到外部 API 即可实现更快、更准确的回忆；可离线工作。
模型上下文协议（MCP）服务器	暴露 `mcp__qmd__*` 工具，这些工具出现在代理的工具菜单中，让子代理以编程方式调用相同的搜索功能。	便于以后添加其他支持 MCP 的工具（如工单、日历）。
跨代理支持	钩子和命令文件与代理无关；同一个库可与 Claude Code、Codex CLI、Gemini CLI、Antigravity 和 Grok 一起使用。	您可以在不重建知识库的情况下切换提供商。
ShardMind 安装程序	`shardmind install` 创建一个新库，运行向导填写 `brain/North Star.md`，初始化 git，并可选地启动 QMD。	一键设置；如果您更喜欢普通模板，也可以直接克隆该库。
令牌高效的上下文处理	开始时仅注入轻量级摘录；完整笔记内容通过 QMD 或显式读取按需获取。	保持对话在 Claude 的令牌限制内并降低成本。

工作原理（高层）

库布局 – 核心文件夹如 brain/（目标、主题）、work/（项目笔记、ADR）、org/people/、perf/Brag Doc.md 和 thinking/session-logs/ 保存持久数据。
钩子 – .claude/scripts/ 中的 Node/TypeScript 脚本（也用于 Codex/Gemini）在定义的生命周期事件（SessionStart、UserPromptSubmit、PostToolUse、PreCompact、Stop）中运行。它们注入上下文、分类消息、验证写入并执行维护。
Claude Code mod – 对于较新的 Claude Code 版本，一个小插件（.claude/skills/obsidian-mind/）在模型内部运行，将注入的上下文作为指令文件传递，并在每轮后显示简洁的“库检查”报告。
语义检索（可选） – 安装 QMD 会创建一个带有嵌入的本地 SQLite 存储。库的 .mcp.json 注册 QMD 查询工具，代理可以直接调用或通过钩子生成的提示调用。
用户交互 – 您在 Obsidian 中打开库，启用 Obsidian CLI，然后启动所选代理（claude、codex 或 gemini）。从那里您只需交谈；斜杠命令触发上述自动化工作流。

典型工作流

# 1️⃣ 安装（推荐）
npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

# 2️⃣ 在 Obsidian 中打开文件夹，启用 CLI（设置 → 通用）
# 3️⃣ 在同一目录中启动编码代理
claude   # 或 codex / gemini

开始会话 → /om-standup → 代理读取 North Star、最近的 git、任务 → 您获得简洁的状态。

会议后 → /om-dump "…" → 笔记、决策记录和 brag-doc 条目会自动创建并链接。

事件 → /om-incident-capture <slack-url> → 生成完整时间线、人员档案、根本原因分析。

一天结束 → wrap up → 库卫生检查、索引更新、亮点发现。

适用人群

软件工程师或技术负责人，已经使用 AI 编码助手，并希望助手记住项目历史、决策和个人目标。
在 Obsidian 中保存会议记录、ADR 和事件报告的团队，希望这些工件能被 AI 自动链接和搜索。
熟悉基于 Node 的 CLI 并愿意运行本地语义搜索引擎（QMD）以获得更丰富召回的人。

限制与注意事项

该库 不是独立的 AI；它依赖外部编码代理（Claude Code、Codex、Gemini 等）。
QMD 是可选的，但对于宣传的“语义搜索”体验是必需的；没有它，系统会回退到简单的 grep，这仍然可用但功能较弱。
钩子脚本以与用户相同的权限运行；在信任该库之前，您应该审查它们（尤其是 Claude Code 模块）。
令牌预算处理针对 Claude Code 的 10k 字符钩子限制进行了调整；其他代理可能有不同的限制，尽管设计保持在合理范围内。

Obsidian Mind 因此提供了一种具体、可重现的方式，让 AI 编码代理拥有持久、可搜索的记忆，这些记忆存在于您常规的 Obsidian 知识库中。它弥合了对话式助手与工程师已经维护的结构化笔记之间的差距。