agricidaniel--claude-obsidian/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

claude-obsidian：面向 Obsidian + Claude Code 的自组织 AI 第二大脑

Claude + Obsidian 知识伴侣与自组织 AI 第二大脑。一个持续运行的 AI 笔记助手，用于构建并维护持久、复利增长的 wiki 知识库。你添加的每个来源都会被整合进来。你提出的每个问题都会从已读内容中检索。知识像利息一样复利增长。

面向 AI 笔记、个人知识管理（PKM）、第二大脑工作流，以及私有 Notion 替代方案的开源 Obsidian AI 插件。15 个 Claude Code 技能、多智能体支持、多写者安全（v1.7+）、一流方法论模式（LYT / PARA / Zettelkasten / Generic，自 v1.8 起），以及 10 原则思维框架（v1.9）。基于 Andrej Karpathy 的 LLM Wiki 模式.

获取该技能的两种方式。 选择适合你工作方式的一种。

• 🌐 公开开源构建（最新：v1.9.2，推荐）：Daniel Agrici 的 GitHub. 上的免费 MIT 许可版本。向所有人开放，无需会员资格。包含全部内容：v1.7 Compound Vault、v1.8 方法论模式，以及 v1.9 思维框架与审计加固。
• ⚡ AI Marketing Hub Pro：相同的 MIT 许可核心，另可最早获得开发中功能（先于公开版落地）、直接协作机会，以及 Pro 社区. Pro 成员从 AI Marketing Hub 组织镜像安装（见下方 Option 2 的替换说明）。

✨ v1.7「Compound Vault」重构：默认采用 Obsidian CLI 作为传输层，混合检索（上下文前缀 + BM25 + 余弦重排序，依据 Anthropic 2024 年 9 月研究), 按文件咨询锁，修复潜在的多写者损坏漏洞，并与 kepano/obsidian-skills. 基座对齐。完整指南：docs/compound-vault-guide.md。可选 DragonScale Memory 扩展（日志折叠、确定性页面地址、语义分块 lint、边界优先 autoresearch）。

---

目录

• 功能概览
• 为何选择 claude-obsidian？
• 快速开始
• 命令
  • /wiki：setup、scaffold、continue
  • /autoresearch：自主研究循环
  • /canvas：可视化层
  • /think：10 原则思维循环
• 方法论模式（v1.8+）
• 知识库用例（v1.0+）
• 跨项目知识库
• 会创建什么
• 架构
• MCP 设置（可选）
• 插件
• CSS 片段
• Banner 插件
• 文件结构
• AutoResearch 配置
• 种子知识库
• 配套工具：claude-canvas
• 常见问题
• 系统要求
• 卸载
• 贡献
• 相关项目
• 社区
• 许可证

---

功能概览

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 轮网络研究并填补缺口	❌	❌
方法论模式	✅ LYT / PARA / Zettelkasten / Generic（一流支持）	❌	❌
思维框架	✅ 10 原则循环，可作为可调用技能	❌	❌
多模型支持	✅ Claude、Gemini、Codex、Cursor、Windsurf	❌ 仅 Claude	✅ 多种
可视化画布	✅ 通过 claude-canvas	❌	❌
多写者安全	✅ 按文件咨询锁（v1.7+）	❌	❌
带引用的查询	✅ 引用具体 wiki 页面	✅ 引用相似笔记	✅ 引用笔记
批量摄入	✅ 多来源并行智能体	❌	❌
开源	✅ MIT	✅ MIT	⚠️ Freemium

📖 深度解读： I Turned Obsidian Into a Self-Organizing AI Brain. 含数据可视化、市场背景与工作流演示的完整拆解。

---

快速开始

ℹ️ 以下命令安装的是来自 AgriciDaniel/claude-obsidian 的公开开源构建（推荐，无需会员资格）。希望最早获得开发中功能的 AI Marketing Hub Pro 成员可将 AgriciDaniel/claude-obsidian 替换为 AI-Marketing-Hub/claude-obsidian（Option 2 也会替换插件 slug；见该选项下的说明）。

方案 1：克隆为库（推荐，2 分钟完成完整配置）

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

在 Obsidian 中打开该文件夹：管理库（Manage Vaults）→ 将文件夹作为库打开（Open folder as vault）→ 选择 claude-obsidian/。

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

ℹ️ setup-vault.sh 会配置 graph.json（筛选 + 颜色）、app.json（排除插件目录）和 appearance.json（启用 CSS）。在首次打开 Obsidian 之前运行一次即可。开箱即用即可获得完整预配置的图谱视图、配色方案和 wiki 结构。

---

方案 2：作为 Claude Code 插件安装

插件安装分两步：先添加市场目录，再从其中安装插件。

ℹ️ 你要安装哪个版本？

• 公开版（推荐，无需会员）： 下方命令会安装来自 AgriciDaniel/claude-obsidian. 的免费 MIT 许可版本。无需注册。
• AI Marketing Hub Pro 会员？ 若要抢先体验开发中功能，将 AgriciDaniel/claude-obsidian 替换为 AI-Marketing-Hub/claude-obsidian，并将插件 slug claude-obsidian@agricidaniel-claude-obsidian 替换为 claude-obsidian@ai-marketing-hub-claude-obsidian。组织镜像需要已通过身份验证的 gh auth login（或 GitHub PAT），且有权访问 AI-Marketing-Hub 组织。若 /plugin marketplace add 返回 404，说明你的账户尚未加入该组织。请在 Skool 社区 私信申请加入。

# Step 1: add the marketplace
claude plugin marketplace add AgriciDaniel/claude-obsidian

# Step 2: install the plugin
claude plugin install claude-obsidian@agricidaniel-claude-obsidian

在任意 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 [file]	读取来源，创建 8-15 个 wiki 页面，更新索引和日志
ingest all of these	批量处理多个来源，然后交叉引用
what do you know about X?	读取索引，深入相关页面，综合生成答案
/save	将当前对话归档为 wiki 笔记
/save [name]	以指定标题保存（跳过命名询问）
/autoresearch [topic]	运行自主研究循环：搜索、抓取、综合、归档
/canvas	打开或创建可视化画布，列出区域和节点
/canvas add image [path]	将图片（URL 或本地路径）添加到画布并自动布局
/canvas add text [content]	向画布添加 Markdown 文本卡片
/canvas add pdf [path]	将 PDF 文档添加为渲染预览节点
/canvas add note [page]	将 wiki 页面固定为画布上的链接卡片
/canvas zone [name]	添加新的带标签区域以组织可视化内容
/canvas from banana	将最近生成的图片捕获到画布上
/think [problem]	对非平凡问题应用十原则思考循环
lint the wiki	健康检查：孤儿页、死链、缺口、建议
update hot cache	用最新上下文摘要刷新 hot.md

✨ 想要更多？ claude-canvas 提供 12 个模板、6 种布局算法、AI 图像生成、演示文稿和完整画布编排。两者一并安装，相互补充。

/wiki：设置、脚手架、继续

首次设置流程：

1. 检查是否已安装 Obsidian
2. 检查 Local REST API 插件（若需要 MCP 传输）
3. 询问「这个库是做什么的？」（一个问题，决定脚手架方向）
4. 根据所选的方法论模式和库用例搭建脚手架
5. 初始化 hot.md、index.md、log.md、wiki/meta/dashboard.base
6. 建议首次摄入

后续运行时，/wiki 会从上次中断处继续。它会检查库健康状态、暴露过时论断，并显示 hot.md 中的近期活动。

/autoresearch：自主研究循环

可配置方案见 skills/autoresearch/references/program.md：

• 最大轮次（默认 3）
• 每会话最大页面数（默认 15）
• 来源偏好规则（学术、官方文档、新闻）
• 置信度评分 + 领域约束

循环流程：

1. 第 1 轮，广泛搜索：分解为 3-5 个角度，每个角度运行 2-3 次查询，每个角度抓取前 2-3 条结果
2. 第 2 轮，补缺：针对矛盾与缺失内容进行定向搜索
3. 第 3 轮，综合检查（可选）：若仍有重大缺口，再跑一轮
4. 归档：综合页 + 来源页 + 实体页 + 概念页，全部交叉引用

按 skills/autoresearch/SKILL.md 中的 ## Web egress hygiene (v1.8.2+) 策略进行 URL 校验与内容净化：拒绝 file:// / javascript: / RFC1918 主机，剥离 <script> 与 wikilink 注入尝试，抓取正文上限 50KB。

/canvas：可视化层

向 Obsidian 画布添加图片、PDF、笔记和 AI 生成图像。区域管理用于分组。自动布局使节点无重叠定位。

/canvas                       # open or create the canvas
/canvas add image <path>      # add an image with auto-layout
/canvas add pdf <path>        # render PDF as preview node
/canvas add note <wiki-page>  # pin a wiki page as a linked card
/canvas zone <name>           # add a labeled zone
/canvas from banana           # capture recent banana-generated images

符合 JSON Canvas 1.0 规范（skills/canvas/references/canvas-spec.md）。完整编排（12 个模板、6 种布局算法、演示文稿）见配套 claude-canvas.

/think：十原则思考循环

将 OBSERVE-OBSERVE-LISTEN-THINK-CONNECT-CONNECT-FEEL-ACCEPT-CREATE-GROW 框架应用于任何非平凡问题（架构决策、审计、事后复盘、模糊用户需求）。

/think <problem statement>

该框架引导 Claude 历经 10 个阶段，每阶段配有提示。当问题的新颖性与不可逆性值得这套纪律时使用。完整框架见 skills/think/SKILL.md。其他技能均有「How to think」附录，将框架映射到具体工作。v1.8.0 推送前审计 以该框架为方法论主线。

---

方法论模式（v1.8+）

四种组织哲学，通过 bash bin/setup-mode.sh 选择启用。wiki-mode 技能（v1.8+）读取 .vault-meta/mode.json 并据此路由新页面。默认为 generic（v1.7 行为，不施加偏好）。

模式	哲学	归档约定
Generic（默认）	无偏好。保留 v1.7 行为。	wiki/sources/, wiki/entities/, wiki/concepts/, wiki/sessions/
LYT（Linking Your Thinking）	笔记互链，文件夹不参与。MOC 是导航原语。	wiki/mocs/<topic>-moc.md + wiki/notes/<atomic-note>.md
PARA（Tiago Forte）	按可执行性组织（Projects、Areas、Resources、Archives）。	wiki/projects/, wiki/areas/, wiki/resources/, wiki/archives/
Zettelkasten（Luhmann 卡片盒）	原子笔记、唯一 ID、密集双向链接、无文件夹。	wiki/<YYYYMMDDHHMMSSffffff>-<slug>.md（扁平、带时间戳）

切换模式不会自动迁移已有文件。完整指南：docs/methodology-modes-guide.md。

---

库（Vault）使用场景（v1.0+）

这些场景说明你的库用于什么。它们可与方法论模式（Methodology Modes，说明如何组织）组合使用。

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

使用场景可以组合。例如按 PARA 组织的「商业 + 研究」库是有效组合。

---

跨项目知识库

将任意 Claude Code 项目指向此库。在该项目的 CLAUDE.md 中添加：

## Wiki Knowledge Base
Path: ~/path/to/vault

When you need context not already in this project:
1. Read wiki/hot.md first (recent context cache)
2. If not enough, read wiki/index.md
3. If you need domain details, read the relevant domain sub-index
4. Only then drill into specific wiki pages

Do NOT read the wiki for general coding questions or tasks unrelated to [domain].

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

---

会创建什么

典型脚手架会创建：

• 针对所选使用场景 + 方法论模式的文件夹结构
• 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：颜色编码的文件资源管理器
• Vault CLAUDE.md：自动加载的项目指令

---

架构

三张图说明本插件的关键设计取舍。

库流程

来源进入 .raw/。/wiki-ingest 代理读取每个来源，提取实体与概念，按当前方法论模式归档到相应 wiki/ 子文件夹，并更新索引、日志与热缓存。查询按 热缓存 → 索引 → 页面 的顺序读取，以降低 token 成本。

多写入者安全（v1.7+）

若用户批量提交多个来源，并行摄取子代理可能写入同一 wiki 页面。scripts/wiki-lock.sh 提供按文件的 advisory lock（建议锁）：一个写入者获得锁，另一个等待并在下一轮重试。PostToolUse 自动提交钩子在暂存前检查锁列表，写入进行中时推迟提交。

混合检索（v1.7+，可选）

/wiki-retrieve 技能提供基于 Anthropic 2024 年 9 月 contextual retrieval 研究. 的三层检索流水线。BM25 为始终启用的稀疏层。上下文前缀层需用户同意（--allow-egress），供希望将页面正文发送至 Anthropic API 生成前缀的用户使用。Cosine rerank 默认使用本地 ollama 模型。v1.7 的 50 次查询基准测试显示，相比 v1.6 基线，top-1 准确率提升 32 个百分点，错误率降低 41%。

ℹ️ 使用 bash bin/setup-retrieve.sh 配置流水线。它会构建 BM25 索引、提示出口同意，并验证 ollama 连接。流水线可优雅降级：任一层不可用时，其余层仍可返回有用结果。

---

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

ℹ️ 两种传输方式均由 scripts/detect-transport.sh 自动检测。结果写入 .vault-meta/transport.json。若要固定手动选择，编辑该文件并设置 "manual_override": true（v1.8.2+ 会遵循该设置）。

---

插件

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

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

预装社区插件（随本库提供）

在 Settings → Community Plugins → enable 中启用：

插件	用途	备注
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 class
ITS-Image-Adjustments	笔记中精细控制图片尺寸：在任何图片嵌入后追加 |100

---

Banner 插件

在任意 wiki 页面 frontmatter 中添加：

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

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

---

文件结构

claude-obsidian/
├── .claude-plugin/
│   ├── plugin.json              # manifest
│   └── marketplace.json         # distribution
├── skills/                       # 15 Claude Code skills (v1.9.2)
│   ├── wiki/                    # orchestrator + references
│   ├── wiki-ingest/             # source ingestion
│   ├── wiki-query/              # answer questions from the vault
│   ├── wiki-lint/               # vault health check
│   ├── wiki-cli/                # Obsidian CLI transport (v1.7+)
│   ├── wiki-retrieve/           # hybrid retrieval (v1.7+, opt-in)
│   ├── wiki-mode/               # methodology modes router (v1.8+)
│   ├── wiki-fold/               # log rollup (DragonScale opt-in)
│   ├── save/                    # /save: file conversations to wiki
│   ├── autoresearch/            # autonomous research loop
│   ├── canvas/                  # visual layer (images, PDFs, notes)
│   ├── defuddle/                # web extraction wrapper
│   ├── obsidian-bases/          # Bases schema reference
│   ├── obsidian-markdown/       # OFM syntax reference
│   └── think/                   # 10-principle thinking framework (v1.9+)
├── agents/
│   ├── verifier.md              # pre-commit audit agent (v1.7.1+)
│   ├── wiki-ingest.md           # parallel batch ingestion agent
│   └── wiki-lint.md             # health check agent
├── commands/                     # slash command entry points
├── hooks/
│   └── hooks.json               # SessionStart + Stop + PostToolUse hooks
├── scripts/                      # 12 helper scripts (transport, locking, retrieval, etc.)
├── tests/                        # 9 hermetic test suites (~1240 assertions, make test)
├── bin/                          # 5 setup scripts (setup-vault, setup-retrieve, setup-mode, etc.)
├── _templates/                   # Obsidian Templater templates
├── wiki/                         # seeded vault content (demo)
│   ├── canvases/                # welcome.canvas + main.canvas
│   ├── concepts/                # seeded: LLM Wiki Pattern, Hot Cache, Compounding Knowledge
│   ├── entities/                # seeded: Andrej Karpathy
│   ├── sources/                 # populated by your first ingest
│   └── meta/
│       ├── dashboard.base       # Bases dashboard (primary)
│       └── dashboard.md         # Legacy Dataview dashboard (optional)
├── docs/                         # guides + audits + release notes
├── .raw/                         # source documents (hidden in Obsidian)
├── .obsidian/snippets/           # vault-colors.css (3-color scheme)
├── WIKI.md                       # full schema reference
├── CLAUDE.md                     # project instructions
└── README.md                     # this file

---

AutoResearch：program.md

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

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

默认程序适用于通用研究。请按你的领域覆盖配置。医学研究者可添加「优先 PubMed」。商业分析师可添加「聚焦市场数据与 filings」。

---

Seed Vault

本仓库附带预置 vault。在 Obsidian 中打开后，你将看到：

• wiki/concepts/：LLM Wiki Pattern、Hot Cache、Compounding Knowledge
• wiki/entities/：Andrej Karpathy
• wiki/sources/：首次 ingest 前为空
• wiki/meta/dashboard.base：Bases 仪表盘（适用于任意 Obsidian v1.9.10+）
• wiki/meta/dashboard.md：旧版 Dataview 仪表盘（可选回退方案）

图谱视图会显示 5 个页面组成的连通簇。这就是一次 ingest 后 wiki 的样子。添加更多来源后，它会继续增长。

---

配套工具：claude-canvas

对于可视化层，claude-canvas 提供 AI 编排的画布创建：知识图谱、演示文稿、流程图、情绪板，含 12 个模板与 6 种布局算法。可自动检测 claude-obsidian vault。

claude plugin install AgriciDaniel/claude-canvas

---

常见问题（FAQ）

最好的 AI 第二大脑应用是什么？ 最好的 AI 第二大脑应让你的数据始终属于你。claude-obsidian 将所有内容存为你拥有的纯 Markdown 文件（无数据库、无锁定、无订阅），并让 Claude 读取、链接并整理为一张连通的知识图谱。它免费且开源（MIT）。

如何用 AI 构建第二大脑？ 将任意来源放入 vault。Claude 会读取它，提取实体与概念，链接到你已有的内容，并归档到结构化的 Obsidian vault 中。你提问，它会基于已读内容作答并引用页面。知识库会在每次会话中变得更丰富、更连通。

如何将 Claude 连接到 Obsidian 作为第二大脑？ 两行命令：git clone https://github.com/AgriciDaniel/claude-obsidian，然后 cd claude-obsidian && bash bin/setup-vault.sh。将该文件夹作为 Obsidian vault 打开，在同一文件夹中打开 Claude Code，并输入 /wiki。完整步骤见 Quick Start。

有没有适合私有、AI 驱动知识库的良好 Notion 替代方案？ 有。claude-obsidian 是开源、本地优先（local-first）的替代方案：笔记是你磁盘上的纯 Markdown，而非托管数据库，并由 AI 为你整理。无厂商锁定，也无月费。

它会自动跨设备同步吗？ 不会自行同步。vault 只是一个纯 Markdown 文件夹。可搭配 Obsidian Sync、Obsidian Git 或任意文件同步工具（Syncthing、iCloud、Dropbox）实现跨设备同步。

多人能否安全地编辑同一 vault？ 可以（v1.7+）。通过 scripts/wiki-lock.sh 实现的按文件咨询锁（advisory locking）可防止并发写入损坏页面。并行 ingest 子代理在写入前会获取锁。过期锁会在 60 秒后自动清理。

hot.md 与 index.md 有何区别？ hot.md 是近期上下文缓存（约 500 词，每会话刷新）。index.md 是 vault 中每一页的主目录。Claude 先读 hot.md，再读 index.md，然后深入具体页面。双层设计可降低重复查询的 token 成本。

能否在不使用 Claude Code 的情况下使用？ 这些 skills 兼容 Agent Skills（对 OpenAI Codex CLI、Cursor、Windsurf、Gemini CLI、Goose 提供实验性支持）。目前生产验证仅在 Claude Code 上完成。跨宿主安装路径遵循各宿主约定，但 skill 发现方式可能不同。

如何从 Dataview 迁移到 Bases？ 两者并排提供。wiki/meta/dashboard.base 为主；wiki/meta/dashboard.md 为旧版 Dataview 回退。在 Obsidian 中选其一即可，另一个无害。Bases 需要 Obsidian v1.9.10+（2025 年 8 月）。

方法论模式（Methodology Modes，LYT/PARA/Zettelkasten）与 Vault 用例（Vault Use Cases，Website/GitHub/Business）有何区别？ 方法论模式（v1.8+）控制页面如何组织：文件夹结构 + 文件命名约定。Vault 用例（v1.0+）描述 vault 用于什么：内容类型。二者可组合。使用 PARA 方法论的「Business」vault 是有效配置。

这会把我的笔记发送给 Anthropic 吗？ 默认不会。可选的 /wiki-retrieve skill 的 API 出站（egress，contextual-prefix.py）受 --allow-egress 同意标志门控。无该标志时，检索完全在本地（BM25 + 可选 ollama rerank）。/autoresearch 中的 Web 出站遵循相同的 opt-in 原则。

公开构建版与 AI Marketing Hub Pro 有何区别？ 二者共享相同的 MIT 许可核心，位于 AgriciDaniel/claude-obsidian,，这是推荐给所有人的安装方式。AI Marketing Hub Pro 成员可最早获得开发中功能，早于其在此发布，并可直接协作与参与社区。核心中没有仅付费功能。

什么是 DragonScale Memory？ 可选的 opt-in 扩展（bash bin/setup-dragonscale.sh），新增四种记忆机制：log folds（过往条目的汇总）、确定性页面地址（基于计数器的唯一 ID）、语义分块 lint（semantic tiling lint，通过 ollama 进行块边界校验）、边界优先 autoresearch（优先研究 vault 的「前沿」）。正常使用不必需。完整指南：docs/dragonscale-guide.md。

---

系统要求

组件	最低版本	说明
Claude Code	latest	https://claude.com/claude-code
Obsidian	v1.9.10+（用于 Bases）	https://obsidian.md. v1.6+ 可使用 Dataview 回退。
Python	3.10+	用于可选检索流水线与测试套件
Bash	4.0+（或 zsh）	用于安装脚本
Git	any	用于通过 Obsidian Git 插件自动提交 vault

可选：

• ollama（用于 /wiki-retrieve 中的本地 rerank）
• defuddle-cli（用于 /defuddle 中的干净 Web 提取）
• Anthropic API key（用于 /wiki-retrieve 上下文前缀层，通过 --allow-egress opt-in）
• Local REST API plugin（用于 REST-API MCP 传输）

---

卸载

插件安装：

claude plugin uninstall claude-obsidian@agricidaniel-claude-obsidian
claude plugin marketplace remove AgriciDaniel/claude-obsidian

克隆安装（删除文件夹）：

rm -rf /path/to/claude-obsidian

你的 vault 内容（位于 wiki/ 下）是纯 Markdown，卸载后仍会保留。若要在不卸载的情况下清除运行时状态，请在仓库根目录运行 make clean-test-state。

---

贡献

欢迎 PR。请先阅读：

• CONTRIBUTING.md：工作流、六切自检清单、提交约定、封闭测试要求
• CODE_OF_CONDUCT.md：Contributor Covenant v2.1
• SECURITY.md：负责任的安全披露政策
• CHANGELOG.md：版本历史（最新：v1.9.2）

Issue 与 PR 模板位于 .github/。CI 在每个 PR 上运行 make test + SKILL.md frontmatter 校验 + 插件 manifest JSON 有效性检查。位于 agents/verifier.md 的 pre-commit verifier agent 对暂存 diff 应用六切 + agent kernel。

---

相关项目

• 🎨 claude-canvas: 可视化画布编排（12 个模板、6 种布局算法、AI 图像生成）。本插件的配套工具。
• 📊 claude-ads: 多平台付费广告审计（覆盖 Google、Meta、LinkedIn、TikTok、Microsoft、Apple、Amazon Ads 的 250+ 项检查）。
• 🔍 claude-seo: 技术 SEO + GEO 审计套件。
• 🧠 best-practices: 可组合工程内核。six-cut + agent 内核的源码来源，由 agents/verifier.md 强制执行。

---

社区

• 📝 Blog post: 深度解读，含竞品分析、数据图表与工作流演示
• 💬 AI Marketing Hub: 2,800+ 成员，免费社区
• ⚡ AI Marketing Hub Pro: 抢先体验开发中功能，并可直接协作
• 🎬 YouTube: 教程与演示
• 🔧 All open-source tools: claude-seo、claude-ads、claude-blog 等

---

许可证

MIT License. 完整文本见 LICENSE。个人与商业使用均可免费。欢迎注明出处，但非必需。

---

Star 历史

---

基于 Andrej Karpathy 的 LLM Wiki 模式. 由 Agrici Daniel. 构建。复利式积累知识，是思考者能养成的最高杠杆习惯。