1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | claude-obsidian | GitHub 仓库名 |
| 项目自述名称 | Claude-Obsidian: AI Second Brain for Obsidian | README 标题 |
| 作者/维护者 | Daniel Agrici（GitHub 账号 AgriciDaniel） | GitHub |
| 来源链接 | https://github.com/AgriciDaniel/claude-obsidian | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars | 9,513 | GitHub API |
| Forks | 1,107 | GitHub API |
| 最新版本 | v1.9.2（“Compound Vault”） | 官方 README |
| 安装方式 | 三种：克隆为独立 Vault / Claude Code 插件市场 / 手动嵌入现有 Vault（见第十章） | 官方 README |
2. 功能介绍与亮点
claude-obsidian 把 Obsidian 笔记库变成一个能自我组织、持续演化的 AI 知识库，而不是简单的问答式笔记助手：
- 自主摄取与归档：丢入任意来源（网页、文件、对话），技能自动读取、抽取实体与概念、建立交叉引用并归档为纯 Markdown
- 15 个 SKILL.md 技能协同工作：涵盖编排调度（wiki）、摄取（wiki-ingest）、问答检索（wiki-query）、健康检查（wiki-lint）、混合检索（wiki-retrieve，融合 BM25、上下文前缀与余弦重排）、自主研究循环（autoresearch）、可视化画布（canvas）、结构化思考框架（think）、对话存档（save）等
- 多种组织方法论可选：LYT、PARA、Zettelkasten 或通用模式，用户可按个人习惯挑选笔记库的自组织方式
- 本地优先、零强制凭据：基础功能完全离线运行，不需要任何 API Key；仅“上下文前缀检索”这一可选增强层需要 Anthropic API Key 且需显式开启
- 联网取证有明确防护：autoresearch 命令默认单次最多抓取 15 个页面、单页限 50KB，过滤
file://、javascript:协议并剥离脚本 - 设计理念可追溯：明确以 Andrej Karpathy 2026 年 4 月公开分享的 “LLM Wiki” 模式为原型，而非凭空自创
3. 适用场景
所属分类：内容创作与知识管理
适合习惯用 Claude Code 工作、长期维护 Obsidian 笔记库的知识工作者、独立研究者与内容创作者——尤其是那些厌倦手工整理笔记、希望资料一进库就自动建立关联和索引的用户。典型场景包括：持续追踪某个研究课题并让新资料自动接入已有知识网络、把日常对话与调研过程沉淀为可检索的长期知识资产、用统一的 Markdown 知识库替代 Notion 等闭源笔记工具。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——本身即以 Claude Code 插件形态设计，
.claude-plugin清单、15 个 SKILL.md 技能、专属 agents（verifier、wiki-ingest、wiki-lint）与 hooks（SessionStart/SessionStop/PostToolUse）一应俱全 - Codex：⚠️ 需适配——仓库根目录含
AGENTS.md（Codex CLI 惯例的智能体说明文件），但官方材料未见明确的 Codex 兼容性承诺，建议使用前自行验证 - OpenClaw：❓ 未验证——已获取的材料中未出现相关说明
- Hermes Agent：❓ 未验证——已获取的材料中未出现相关说明
5. 推荐理由
claude-obsidian 解决的是知识工作者的一个长期痛点：笔记库越攒越多，但很少有时间回头整理、去重、建立关联，最终变成“笔记坟场”。它把归档、去重、关联这些体力活交给 Claude 自动完成，用户只需要专注往里“扔”资料。相比同类工具，它的可信度来自三点：设计模式有名可溯（Karpathy 的 LLM Wiki 模式）、默认零凭据即可跑通核心功能、以及对唯一的联网功能（autoresearch）做了明确的抓取范围与协议白名单限制。对于已经在用 Obsidian、想要一个“会自己维护自己”的第二大脑的用户，这是目前该细分方向里生态最完整（15 个协同技能 + 4 种组织方法论）的开源选择。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 独立仓库（非合集）GitHub Stars 达 9,513；另有 claude-blog.md、youmind.com（两篇独立专题文章）、skillsllm.com、openagentskill.com 等第三方站点收录报道，形成多来源交叉验证 |
| 可用性 | 8 | 提供三种安装路径且均有清晰步骤，README/WIKI.md/SETUP_GUIDE 中英双语齐全；最近一次提交距今约 7 周；但依赖 Obsidian 应用本体与 Python 3.10+ 环境，非纯一条命令即可用 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
- shell 命令执行及权限范围：唯一的自动化钩子是 PostToolUse 触发的本地 git 自动提交，仅作用于
wiki/、.raw/、.vault-meta/三个目录，可按 Vault 或全局关闭；未发现执行任意 shell 命令的路径 - 运行时联网外发：默认完全本地运行；仅当用户主动调用
/autoresearch时才联网检索，且有页数与单页体积上限、协议白名单；可选的“上下文前缀检索”层会把页面正文发给 Anthropic API，但需要用户显式加--allow-egress开启，非默认行为 - API Key/凭据存储：无任何强制凭据；唯一可选的 Anthropic API Key 仅服务于上述可选检索层
- 可疑指令排查：已抓取的 README 与 SECURITY.md 中未发现要求执行可疑操作、访问无关文件或外发数据的指令
- 作者/组织信誉：作者 AgriciDaniel 名下另有公开维护的 Claude Code 技能项目（claude-seo）；本仓库另附完整 SECURITY.md（含单租户威胁模型说明）、CODE_OF_CONDUCT.md、CITATION.cff，并公开漏洞响应时限（5 个工作日确认，高危 7 天、一般 30 天内修复）
- License：MIT，条款清晰，个人与商用均可免费使用
- 最近维护时间：最新提交 2026-05-28，距今约 7 周，在“近 3 个月”安全维护窗口内
综合评分：8.3（三项均值）。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 claude-obsidian 的差异 |
|---|---|---|
| obsidian-second-brain（eugeniughelbur） | 同为“Obsidian + Claude Code”自我改写型知识库，44 个斜杠命令覆盖摄取/调和矛盾/研究工具箱/思维工具，37/44 命令零 API Key 即可跑，支持定时后台代理（晨间日报、夜间调和矛盾） | 两者都溯源同一个“LLM Wiki”设计模式，思路接近；obsidian-second-brain 的差异化在于双时态 frontmatter（同时记录“事实成立时间”与“知识库学到时间”）与无人值守定时任务，claude-obsidian 的差异化在于混合检索算法（BM25+上下文前缀+余弦重排）与可选的方法论预设（LYT/PARA/Zettelkasten） |
| claude-mem（thedotmack） | Claude Code 的跨会话记忆系统，自动压缩并检索注入智能体自身的历史上下文，服务对象是“让 Agent 记住之前做过什么” | 定位完全不同：claude-mem 维护的是 Agent 的工作记忆，claude-obsidian 维护的是用户的知识库；前者让 Claude 不健忘，后者让用户的笔记库自己长大。两者可以同时使用而不冲突 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价或署名测评；已发现的第三方内容（如 claude-blog.md、youmind.com 上的专题文章）均为作者本人或第三方博客的功能介绍性文字，未包含可归属的真实用户证言。
9. 其他补充
- 文档提供中英双语版本（README.md / README_CN.md，CONTRIBUTING.md / CONTRIBUTING_CN.md 等）
- 项目页含正式的 CITATION.cff，便于学术场景引用
- 版本历史显示近期迭代聚焦“上下文前缀检索硬化”“路径处理健壮性”“IPv6 场景修复”等工程细节打磨，而非单纯堆功能
10. 安装使用方式
方式一：克隆为独立 Vault（官方推荐）
git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh用 Obsidian 打开该文件夹，然后在 Claude Code 中输入 /wiki 开始使用。
方式二：作为 Claude Code 插件安装
claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@agricidaniel-claude-obsidian方式三：嵌入现有 Vault：将仓库中的 WIKI.md 复制进现有 Obsidian Vault，并按文件内说明粘贴给 Claude 初始化。
安装后：核心命令包括 /wiki（初始化/续用）、ingest [文件]（摄取来源）、/autoresearch [主题]（自主研究）、/canvas（可视化工作区）、/think [问题]（结构化推理）、“lint the wiki”（健康检查）。首次使用建议先跑一次 lint the wiki 确认环境配置正常。
环境要求：Obsidian v1.9.10+（完整 Bases 支持）或 v1.6+（降级用 Dataview）；Python 3.10+。
11. 注意事项
- 需要预先安装 Obsidian 应用本体，并非纯 Claude Code 内可完全自包含运行的技能
- 官方 SECURITY.md 明确声明威胁模型为“单租户”（一人一库一机），文件锁机制未做跨进程细粒度防护；多人共享同一 Vault 或托管在共享主机上需要额外加固，个人本地使用不受影响
/autoresearch命令的联网检索虽有防护，但仍属主动对外发起请求的功能，对隐私敏感的使用场景建议保持默认关闭上下文前缀检索层- 最近一次代码提交距今约 7 周，暂无更晚近的版本更新可供核验后续维护节奏
- 与官方自称“开源 Notion 替代品”的定位不同，本质仍是 Obsidian 的增强层，需要用户已经或愿意采用 Obsidian 作为笔记宿主