claude-obsidian Skill:把 Obsidian 变成可复利的 AI 第二大脑
一句话总结
claude-obsidian 是 Claude Code 生态里最热门的「Obsidian AI 第二大脑」Skill 包,它把 Andrej Karpathy 的 LLM Wiki 模式落地为可一键安装的 15 个 Skill 子模块,主打「你扔资料进去,它自动整理成网状知识库并能持续复利增长」。截至 2026-07-28,仓库 GitHub Stars 已突破 10,029、Forks 1,167,平均每天净增 89+ 星,是当下 Claude Code 生态里增速最快的「个人知识管理 + Agent」组合。
核心功能与设计原则
claude-obsidian 不只是一个聊天插件,而是一个会自己整理笔记的 AI 引擎。它围绕「Compounding Vault(复利金库)」这个核心概念构建:你扔进去任意资料(PDF、网页、对话、播客),Claude 自动抽取实体、概念、互相引用,归档到结构化的 Obsidian vault;你提问时,它从最近热缓存、索引和具体页面拉上下文综合回答,并直接引用 wiki 页面而非依赖训练数据。原则是「资料越丢越多,但知识始终能找回」——所有内容以 Markdown 形式存在,用户 100% 拥有数据,不绑定任何云服务。
具体能力上,v1.7 之后的版本默认使用 Obsidian CLI 作为传输层,混合检索策略结合「上下文前缀 + BM25 + 余弦重排序」,对标 Anthropic 2024 年 9 月的 Contextual Retrieval 论文;v1.8 引入 LYT/PARA/Zettelkasten/Generic 四种主流笔记方法论模式;v1.9 新增「10 原则思维框架」并支持多写者并发安全。
认可度与热度数据
- GitHub Stars:10,029(截至 2026-07-28,API 实测)
- Forks:1,167
- 创建时间:2026-04-07(112 天)
- 日均 Star 增速:89.5 stars/day(在 Claude Skills 类目下增速第一梯队)
- 最新 release:v1.9.2(2026-05-28),近 60 天累计 5+ 次重要更新,仍在活跃迭代
- 配套 Pro 社区:AI Marketing Hub Pro(Skool),提供早期内测版本与作者直接协作通道
- 同时登上 GitHub Topics
claude-skills、claude-code-skill、obsidian、second-brain四个主题推荐位
仓库链接
GitHub:https://github.com/AgriciDaniel/claude-obsidian
项目博客:https://agricidaniel.com/blog/claude-obsidian-ai-second-brain
原作者
Daniel Agrici(GitHub: @AgriciDaniel),独立 AI 营销 / 知识工程开发者,现运营 AI Marketing Hub Pro 付费社区。MIT 开源协议,核心代码全免费,仅 Pro 镜像提供「先行内测」特性。
项目介绍
claude-obsidian 起源于 Andrej Karpathy 提出的「LLM Wiki」模式——让 LLM 持续维护一个互相连接、可被检索、可被引用的 Markdown 知识图谱,而不是只回答一次性问题。Daniel 把这套思路实现成了一组 Claude Code 原生 Skill:用户在项目根目录运行 omm setup(或直接调用 /wiki、/autoresearch、/canvas、/think 等命令),Claude 就会自动读取资料、抽取实体、建立交叉引用、维护索引、发现孤立节点、修复死链,并在每次会话结束时更新热缓存。
对比市面上常见的 Obsidian AI 插件(Smart Connections、Copilot 等),它最大的差异是「自动组织而非「聊天问答」:能主动生成实体、概念、交叉引用,能标记矛盾来源([!contradiction] callout),能跑 lint 找到孤儿节点和过时断言。
核心特点
- 15 个 Claude Code Skill 一体化:覆盖
/wiki、/autoresearch、/canvas、/think、/lint、/inbox、/connections等多种工作流 - 混合检索架构:上下文前缀 + BM25 关键词 + 余弦重排序,对标 Anthropic Contextual Retrieval
- 四种方法论模式:LYT(Linking Your Thinking)、PARA、Zettelkasten、Generic,可在 setup 时任选
- 本地优先:所有数据用纯 Markdown 存储,用户完全拥有,可与 kepano/obsidian-skills 互通
- 可选 DragonScale Memory 扩展:log folds、确定性页面地址、语义切片 lint、边界优先自动研究
- 多 AI 编程工具兼容:Claude Code、Codex、Cursor、OpenClaw、Antigravity 一套命令自动注册
使用方法
前置要求: 已安装 Claude Code 或其他兼容 CLI(Cursor / Codex / OpenClaw)。
最简三步上手:
-
全局安装 CLI
bash
npm install -g oh-my-mermaid-style # 实际命令:
# 官方推荐从仓库克隆后通过 /wiki setup 命令初始化 -
在 Claude Code 内执行初始化
/wiki setup
会询问你是 brand(品牌/落地页)还是 product(应用 UI/仪表盘),并写入 PRODUCT.md 与 DESIGN.md。 -
开始往 vault 里扔资料
/wiki ingest ./papers/llm-wiki.pdf
/wiki ingest https://example.com/article
/think synthesize "我这周读过的内容能总结出什么模式?"
完整命令列表与 CLI 集成方式见仓库 README 的「Quick Start」与「Commands」章节。
使用场景与目标人群
典型场景:
- 研究员 / 博士生:长期跟踪某个细分领域,需要自动把每周新论文归档成可引用 wiki
- 独立开发者 / 创业者:把产品想法、市场调研、用户访谈、代码片段统一沉淀进同一个 vault
- 写作者 / 内容创作者:把零散素材、灵感、引用、采访录音全部交给 Claude 整理成结构化笔记
- 知识管理爱好者:替代 Notion、Roam 等闭源 PKM 工具,数据完全自有
目标用户: 已在使用或愿意尝试 Claude Code、对本地优先的 Markdown 知识库有需求、不希望把隐私数据交给云端大厂的进阶用户。
输入与输出案例
案例 1:批量摄取论文并生成结构化笔记
Input(用户指令):
/wiki ingest ./papers/ --methodology PARA --tag "ml-systems"
Claude 依次打开 papers/ 目录下所有 PDF,抽取作者、方法、关键结论、图表数据,按 PARA(Projects / Areas / Resources / Archive)四类目录归入 vault,自动建立论文之间的方法对比引用,并在 _index/PARA-map.md 里生成可视化总览。
Output(生成内容片段):
Areas/ml-systems/papers/flashattention.md:包含原文摘要、关键公式、与已有 12 篇相关论文的对比表_index/PARA-map.md:自动渲染的 Mermaid 主题树!contradictioncallout:标记两篇论文在同一基准上结论相反/wiki/todo:自动产生「需补充复现实验」「需查证第三节引用」等后续行动
案例 2:基于已有 vault 回答问题
Input:
/think answer "我这季度读过的所有 LLM 推理优化论文,KV-cache 压缩的主流路线分几派?"Output:
Claude 不依赖自身训练数据,而是扫描 vault 内最近 30 天的摄取记录,从 FlashAttention、PagedAttention、vLLM、GQA、MLA 等相关笔记中提取共同模式,给出三大派系分类 + 每派代表论文 + 各自优缺点,最后明确写出「本回答引用了以下 7 个 vault 页面」,附可直接点开的 wikilink。
GitHub 仓库: https://github.com/AgriciDaniel/claude-obsidian
作者: Daniel Agrici · 协议: MIT · 最新版本: v1.9.2(2026-05-28)
评论区
登录后可评论。