Wink Pings

Obsidian 把 Claude 接进笔记库,五个免费仓库,和一个权限坑

Obsidian CEO kepano 和团队开源了五个让 Claude 读写 vault 的免费仓库。有人用 Karpathy 的 LLM Wiki 思路写了 10 步教程。装之前先看清 token 成本和权限边界。

Obsidian 团队把让 Claude 在笔记库里干活的那套工具开源了。Obsidian CEO kepano 和官方团队放了五个免费仓库:obsidian-skills、defuddle、obsidian-importer、obsidian-help、obsidian-clipper。它们解决同一个问题:Claude 能读写真正的 Obsidian vault 文件,不再只停在聊天窗口里生成一段 Markdown。原推在这里,演示视频也来自原推。

五个仓库分别做什么

  • obsidian-skills:kepano 维护的 Agent Skills 集合,教 agent 写 Obsidian 风格 Markdown、Bases、JSON Canvas,也包 Obsidian CLI 和 defuddle。兼容 Claude Code、Codex、OpenCode。安装可以走两行命令:/plugin marketplace add kepano/obsidian-skills 和 /plugin install obsidian@obsidian-skills。Ryven 在回复里建议先装这个,理由是两行命令,Claude 就能写真正的 vault 文件。
  • defuddle:把网页正文抽成干净 Markdown,去掉评论、侧栏、页脚,少烧 token。CLI 直接跑 npx defuddle parse <url> --markdown。有网友说,光 defuddle 就值了,正文干净,token 少。
  • obsidian-importer:把 Notion、Evernote、Apple Notes、Roam、Bear、OneNote 等历史笔记迁到 Markdown。旧笔记不迁进来,agent 读不到。
  • obsidian-help:官方文档的纯 Markdown 版本,带 AGENTS.md,让 agent 从源头学 Obsidian。
  • obsidian-clipper:官方网页剪藏,把页面直接存进 vault。

第二大脑的关键在循环

Ryven 写了长篇教程,标题大意是用 Claude 和 Obsidian 搭一个越用越聪明的第二大脑。结构来自 Karpathy 在 2026 年 4 月发布的 LLM Wiki 思路:不要让模型每次翻原始笔记,先让它把来源整理成 wiki,之后从 wiki 回答。教程把文件夹分成 raw/、wiki/、output/,再加一个 CLAUDE.md 规则书。raw 只读,wiki 由模型写并保持链接,output 放成品。ingest 一个源,生成摘要和概念页,更新索引;提问只用 wiki/,避免模型拿通用知识填空;每周审查矛盾、无链接页面和无来源断言。第二大脑常见的死法:只进不出,最后变成垃圾场。

两个成本

第一是 token。Claude 能读的文件内容会发给模型。Pro 和 Max 的限额由 Claude 和 Claude Code 共享,第一次灌几百个文件烧得很快。教程建议从五到十个文件开始。机密材料别放进 raw/,除非你的套餐和工作规则允许。

第二是权限。Anthropic 文档说得很直白,CLAUDE.md 是上下文,不是强制配置。写永远不要删除文件只是请求。真要阻止动作,得用 permissions 或 PreToolUse hook。备份好 vault,给定时任务最窄的权限,启用带删除工具的 MCP 前想清楚。教程还列了四个坑:编辑 raw/、CLAUDE.md 太长、提问太开放、不做维护。每个都有对应修法。

今晚怎么开始

装 Obsidian,建一个 vault,里面放 raw、wiki、output 三个文件夹。用 Claude Desktop 的 Code tab 打开这个文件夹,让 Claude 面试你,生成 CLAUDE.md。选一个你真正想留下的源文件丢进 raw/,让它 ingest。然后问一个跨来源的问题,把好答案存回 wiki/。Ryven 的长文有完整 10 步和 30 天计划,链接在下面。别一次灌几百个文件,先跑通一个源的 ingest 和 query。收藏十个教程,不如让 Claude 写出一页真正带链接的笔记。

原文推文:https://x.com/imryven/status/2118704411333501298

长文教程:https://x.com/i/article/2115042274614599680

发布时间: 2026-11-07 10:38