breferrari/obsidian-mind

这是什么？

核心功能

• 01会话开始时加载目标、进行中项目、待办任务和近期 git 变更。
• 02将决策、事件、成果和会议等内容分类，并归档到相互链接的笔记中。
• 03写入 Markdown 笔记时校验 frontmatter 和 wikilink。
• 04上下文压缩前备份会话记录。
• 05提供站会、收尾、每周汇总和述职简报等斜杠命令。
• 06可选通过 QMD 实现本地语义搜索，并提供 MCP 服务器。

适用场景

• 让 AI 编程代理在数天或数周内持续了解进行中的项目和过往决策。
• 将一对一会议、故障事件和工作成果整理为相互链接的笔记，用于绩效评估。
• 把 Obsidian 作为个人知识库，供编程代理查询和更新。

快速上手

1. 1

   全局安装 ShardMind

   npm install -g shardmind
2. 2

   创建一个空文件夹作为 vault 并进入

   mkdir my-vault && cd my-vault
3. 3

   使用 ShardMind 安装 vault 模板

   shardmind install github:breferrari/obsidian-mind
4. 4

   在 Obsidian 中将该文件夹打开为 vault，然后在该目录中运行你的智能体（例如 Claude Code）

   claude

使用前须知

• !仅 Claude Code 提供完整支持；Codex CLI 和 Gemini CLI 只有钩子和命令，功能较少。
• !Obsidian CLI 集成需要 Obsidian 1.12 或更高版本。
• !可选的 QMD 语义搜索首次使用时会下载约 2.3 GB 的本地模型。

收录于专题

标签

常见问题

obsidian-mind 是什么？

一个 Obsidian 知识库模板，让 Claude Code 等 AI 编程代理跨会话保留记忆。 Obsidian Mind 是一个预先组织好结构的 Obsidian 知识库，AI 编程代理可以把它当作长期记忆来读写。每次会话开始时，代理会加载用户的目标、进行中的项目、待办任务和近期 git 变更，而不是从零开始。笔记按用途分文件夹存放，并与相关的人员、决策和项目互相链接。

obsidian-mind 可以免费使用吗？用的什么许可证？

obsidian-mind 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

obsidian-mind 还在维护吗？

活跃维护中。obsidian-mind 最近一次提交是在 2026年10月17日。

obsidian-mind 适合用来做什么？

让 AI 编程代理在数天或数周内持续了解进行中的项目和过往决策。 将一对一会议、故障事件和工作成果整理为相互链接的笔记，用于绩效评估。 把 Obsidian 作为个人知识库，供编程代理查询和更新。

obsidian-mind 怎么安装和运行？

全局安装 ShardMind: npm install -g shardmind 创建一个空文件夹作为 vault 并进入: mkdir my-vault && cd my-vault 使用 ShardMind 安装 vault 模板: shardmind install github:breferrari/obsidian-mind 在 Obsidian 中将该文件夹打开为 vault，然后在该目录中运行你的智能体（例如 Claude Code）: claude

在哪里获取 obsidian-mind？

源代码和安装说明在 GitHub 上：https://github.com/breferrari/obsidian-mind