claude-obsidian

Claude + Obsidian 知识伴侣。一个持续运行的笔记记录器，构建并维护一个持久、不断累积的 wiki 知识库。你添加的每个来源都会被整合。你提出的每个问题都会从所有已读内容中提取答案。知识像利息一样复利增长。

基于 Andrej Karpathy 的 LLM Wiki 模式。11 项技能。零手动归档。支持多 agent。可选 DragonScale Memory 扩展（日志折叠、确定性页面地址、语义平铺 lint、边界优先自动研究）。

---

它能做什么

Youtube 演示

你放入来源。Claude 读取它们，提取实体和概念，更新交叉引用，并将所有内容归档到结构化的 Obsidian 知识库中。每次摄入，wiki 都会变得更丰富。

你提出问题。Claude 读取热缓存（近期上下文），扫描索引，深入相关页面，并综合出答案。它会引用具体的 wiki 页面，而非训练数据。

你进行 lint 检查。Claude 发现孤立页面、死链接、过时声明和缺失的交叉引用。你的 wiki 无需手动清理也能保持健康。

每次会话结束时，Claude 会更新热缓存。下一次会话从完整的近期上下文开始，无需回顾。

---

为什么选择 claude-obsidian？

大多数 Obsidian AI 插件是聊天界面——它们回答关于你现有笔记的问题。claude-obsidian 是一个知识引擎——它自主创建、组织、维护和发展你的笔记。

能力	claude-obsidian	Smart Connections	Copilot
自动组织笔记	创建实体、概念、交叉引用	否	否
矛盾标记	带来源的 [!contradiction] 标注	否	否
会话记忆	热缓存跨对话持久化	否	否
知识库维护	8 类 lint（孤立页、死链接、缺口等）	否	否
自主研究	3 轮网络研究，自动填补缺口	否	否
多模型支持	Claude、Gemini、Codex、Cursor、Windsurf	仅 Claude	多个
可视化画布	通过 claude-canvas 伴侣实现	否	否
带引用的查询	引用具体 wiki 页面	引用相似笔记	引用笔记
批量摄入	多来源并行 agent	否	否
开源	MIT	MIT	Freemium

深度解析： 我把 Obsidian 变成了一个自组织的 AI 大脑 —— 包含数据可视化、市场背景和工作流演示的完整分析。

---

快速开始

选项 1：克隆为知识库（推荐：2 分钟完成完整设置）

git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh

在 Obsidian 中打开该文件夹：管理知识库 → 将文件夹作为知识库打开 → 选择 claude-obsidian/

在同一文件夹中打开 Claude Code。输入 /wiki。

setup-vault.sh 会配置 graph.json（过滤 + 颜色）、app.json（排除插件目录）和 appearance.json（启用 CSS）。在首次打开 Obsidian 前运行一次。你将直接获得完全预配置的图谱视图、配色方案和 wiki 结构。

---

选项 2：安装为 Claude Code 插件

插件安装是 Claude Code 中的两步过程。首先添加市场目录，然后从中安装插件。

# 步骤 1：添加市场
claude plugin marketplace add AgriciDaniel/claude-obsidian

# 步骤 2：安装插件
claude plugin install claude-obsidian@claude-obsidian-marketplace

在任何 Claude Code 会话中：/wiki。Claude 会引导你完成知识库设置。

检查是否成功：

claude plugin list

---

选项 3：添加到现有知识库

将 WIKI.md 复制到你的知识库根目录。粘贴到 Claude 中：

Read WIKI.md in this project. Then:
1. Check if Obsidian is installed. If not, install it.
2. Check if the Local REST API plugin is running on port 27124.
3. Configure the MCP server.
4. Ask me ONE question: "What is this vault for?"
Then scaffold the full wiki structure.

---

命令

你说	Claude 做
/wiki	设置检查、搭建结构或继续上次进度
ingest [文件]	读取来源，创建 8-15 个 wiki 页面，更新索引和日志
ingest all of these	批量处理多个来源，然后交叉引用
what do you know about X?	读取索引 > 相关页面 > 综合答案
/save	将当前对话归档为 wiki 笔记
/save [名称]	以指定标题保存（跳过命名问题）
/autoresearch [主题]	运行自主研究循环：搜索、获取、综合、归档
/canvas	打开或创建可视化画布，列出区域和节点
/canvas add image [路径]	添加图片（URL 或本地路径）到画布，自动布局
/canvas add text [内容]	添加 markdown 文本卡片到画布
/canvas add pdf [路径]	添加 PDF 文档作为渲染预览节点
/canvas add note [页面]	将 wiki 页面固定为画布上的链接卡片
/canvas zone [名称]	添加新的带标签区域以组织视觉内容
/canvas from banana	捕获最近生成的图片到画布
lint the wiki	健康检查：孤立页、死链接、缺口、建议
update hot cache	用最新上下文摘要刷新 hot.md

想要更多？ claude-canvas 增加了 12 个模板、6 种布局算法、AI 图像生成、演示文稿和完整的画布编排。两者都安装——它们相辅相成。

---

跨项目强力用法

将任何 Claude Code 项目指向此知识库。添加到该项目的 CLAUDE.md：

## Wiki 知识库
路径：~/path/to/vault

当需要本项目尚未包含的上下文时：
1. 先读取 wiki/hot.md（近期上下文缓存）
2. 如果不够，读取 wiki/index.md
3. 如果需要领域细节，读取相关领域子索引
4. 然后才深入具体 wiki 页面

不要为一般编码问题或与 [领域] 无关的任务读取 wiki。

你的执行助理、编码项目和内容工作流都从同一个知识库中获取信息。

---

六种 Wiki 模式

模式	使用场景
A：网站	站点地图、内容审计、SEO wiki
B：GitHub	代码库地图、架构 wiki
C：商业	项目 wiki、竞争情报
D：个人	第二大脑、目标、日记综合
E：研究	论文、概念、论文
F：书籍/课程	章节追踪器、课程笔记

模式可以组合使用。

---

创建的内容

典型的搭建会创建：

• 所选模式的文件夹结构
• wiki/index.md：主目录
• wiki/log.md：仅追加的操作日志
• wiki/hot.md：近期上下文缓存
• wiki/overview.md：执行摘要
• wiki/meta/dashboard.base：Bases 仪表板（主要，原生 Obsidian）
• wiki/meta/dashboard.md：旧版 Dataview 仪表板（可选回退）
• _templates/：每种笔记类型的 Obsidian Templater 模板
• .obsidian/snippets/vault-colors.css：彩色编码的文件浏览器
• 知识库 CLAUDE.md：自动加载的项目指令

---

MCP 设置（可选）

MCP 让 Claude 无需复制粘贴即可直接读写知识库笔记。

选项 A（基于 REST API）：

1. 在 Obsidian 中安装 Local REST API 插件
2. 复制你的 API 密钥
3. 运行：

claude mcp add-json obsidian-vault '{
  "type": "stdio",
  "command": "uvx",
  "args": ["mcp-obsidian"],
  "env": {
    "OBSIDIAN_API_KEY": "your-key",
    "OBSIDIAN_HOST": "127.0.0.1",
    "OBSIDIAN_PORT": "27124",
    "NODE_TLS_REJECT_UNAUTHORIZED": "0"
  }
}' --scope user

选项 B（基于文件系统，无需插件）：

claude mcp add-json obsidian-vault '{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
}' --scope user

---

插件

核心插件（Obsidian 内置：无需安装）

插件	用途
Bases	驱动 wiki/meta/dashboard.base：原生数据库视图。自 Obsidian v1.9.10（2025 年 8 月）起可用。取代 Dataview 作为主仪表板。
Properties	可视化 frontmatter 编辑器
Backlinks、Outline、Graph view	标准导航

预装社区插件（随此知识库提供）

在 设置 → 社区插件 → 启用 中启用：

插件	用途	备注
Calendar	右侧边栏日历，带字数统计和任务点	预装
Thino	快速备忘录捕获面板	预装
Excalidraw	自由手绘画布，注释图片	预装*
Banners	通过 banner: frontmatter 实现 Notion 风格页眉图片	预装

* Excalidraw 的 main.js（8MB）由 setup-vault.sh 自动下载。它不在 git 跟踪中。

也从社区插件安装（未预装）

插件	用途
Templater	从 _templates/ 自动填充 frontmatter
Obsidian Git	每 15 分钟自动提交知识库
Dataview （可选/旧版）	仅旧版 wiki/meta/dashboard.md 查询需要。主仪表板现在使用 Bases。

同时安装 Obsidian Web Clipper 浏览器扩展。一键将网页发送到 .raw/。

---

CSS 代码片段（由 setup-vault.sh 自动启用）

三个代码片段随知识库提供并自动启用：

代码片段	效果
vault-colors	在文件浏览器中按类型对 wiki/ 文件夹进行颜色编码（蓝色 = 概念，绿色 = 来源，紫色 = 实体）
ITS-Dataview-Cards	将 Dataview TABLE 查询转换为视觉卡片网格：使用 ```dataviewjs 配合 .cards 类
ITS-Image-Adjustments	笔记中精细的图片尺寸调整：在任何图片嵌入后附加 |100

---

Banner 插件

在任何 wiki 页面的 frontmatter 中添加：

banner: "_attachments/images/your-image.png"
banner_icon: "🧠"

页面会在 Obsidian 中渲染全宽页眉图片。非常适合枢纽页面和概览页面。

---

文件结构

claude-obsidian/
├── .claude-plugin/
│   ├── plugin.json              # 清单
│   └── marketplace.json         # 分发
├── skills/
│   ├── wiki/                    # 编排器 + 参考（7 个参考文件）
│   ├── wiki-ingest/             # INGEST 操作
│   ├── wiki-query/              # QUERY 操作
│   ├── wiki-lint/               # LINT 操作
│   ├── save/                    # /save：将对话归档到 wiki
│   ├── autoresearch/            # /autoresearch：自主研究循环
│   │   └── references/
│   │       └── program.md       # 可配置的研究目标
│   └── canvas/                  # /canvas：可视化层（图片、PDF、笔记）
│       └── references/
│           └── canvas-spec.md   # Obsidian 画布 JSON 格式参考
├── agents/
│   ├── wiki-ingest.md           # 并行摄入 agent
│   └── wiki-lint.md             # 健康检查 agent
├── commands/
│   ├── wiki.md                  # /wiki 引导命令
│   ├── save.md                  # /save 命令
│   ├── autoresearch.md          # /autoresearch 命令
│   └── canvas.md                # /canvas 可视化层命令
├── hooks/
│   └── hooks.json               # SessionStart + Stop 热缓存钩子
├── _templates/                  # Obsidian Templater 模板
├── wiki/
│   ├── Wiki Map.canvas          # 可视化枢纽，中心图谱节点
│   ├── canvases/                # welcome.canvas + main.canvas（可视化演示）
│   ├── getting-started.md       # 入门指南（知识库内部）
│   ├── concepts/                # 已播种：LLM Wiki Pattern、Hot Cache、Compounding Knowledge
│   ├── entities/                # 已播种：Andrej Karpathy
│   ├── sources/                 # 由你的首次摄入填充
│   └── meta/
│       ├── dashboard.base       # Bases 仪表板（主要）
│       └── dashboard.md         # 旧版 Dataview 仪表板（可选）
├── .raw/                        # 源文档（在 Obsidian 中隐藏）
├── .obsidian/snippets/          # vault-colors.css（3 色方案）
├── WIKI.md                      # 完整模式参考
├── CLAUDE.md                    # 项目指令
└── README.md                    # 本文件

---

AutoResearch：program.md

/autoresearch 命令是可配置的。编辑 skills/autoresearch/references/program.md 以控制：

• 偏好哪些来源（学术、官方文档、新闻）
• 置信度评分规则
• 每次会话的最大轮数和最大页面数
• 领域特定约束

默认程序适用于一般研究。根据你的领域覆盖它。医学研究人员会添加“偏好 PubMed”。商业分析师会添加“关注市场数据和文件”。

---

种子知识库

此仓库附带一个已播种的知识库。在 Obsidian 中打开它，你会看到：

• wiki/concepts/：LLM Wiki Pattern、Hot Cache、Compounding Knowledge
• wiki/entities/：Andrej Karpathy
• wiki/sources/：空，直到你首次摄入
• wiki/meta/dashboard.base：Bases 仪表板（在任何 Obsidian v1.9.10+ 中工作）
• wiki/meta/dashboard.md：旧版 Dataview 仪表板（可选回退）

图谱视图将显示一个由 5 个页面组成的连接集群。这就是一次摄入后 wiki 的样子。添加更多来源，它会从此处增长。

---

伴侣：claude-canvas

对于可视化层，claude-canvas 增加了 AI 编排的画布创建——知识图谱、演示文稿、流程图、情绪板，包含 12 个模板和 6 种布局算法。自动检测 claude-obsidian 知识库。

claude plugin install AgriciDaniel/claude-canvas

---

社区

• 博客文章 - 深度解析，包含竞争对手分析、数据图表和工作流演示
• AI Marketing Hub - 2,800+ 成员，免费社区
• YouTube - 教程和演示
• 所有开源工具 - claude-seo、claude-ads、claude-blog 等

---

基于 Andrej Karpathy 的 LLM Wiki 模式。由 Agrici Daniel 构建。