obsidian-skills 完整指南：让 AI 操作 Obsidian，跑通笔记自动化的四个环节

郁音允Zoe

872人浏览 · 2026-09-07 22:26:00

郁音允Zoe · 2026-09-07 22:26:00 发布

obsidian-skills 完整指南：让 AI 操作 Obsidian，跑通笔记自动化的四个环节

【免费下载链接】obsidian-skills Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas. 项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills

obsidian-skills 是一个让 AI 操作 Obsidian 的技能包，它把笔记的 Markdown 语法、Bases 数据库、Canvas 画布和 CLI 命令打包成 AI 能直接调用的规则，帮你实现 Obsidian 笔记自动化。它解决的核心问题，是"AI 会写内容、却不会动 Obsidian"这个断层：装好之后，你用一句话描述需求，AI 就能按规范建笔记、净化网页、查动态数据、生成画布，全程不必你手动排版。

一句话看懂 obsidian-skills：5 个内置技能速览

obsidian-skills 遵循 Agent Skills 开放规范，Claude Code、Codex、OpenCode 等主流 AI 编程代理都能直接加载。它本质是一组写给 AI 的操作说明书，覆盖"从把内容收进来，到把结果呈现出去"的完整链路。五个内置技能分工如下：

技能	负责什么	说明文件
obsidian-cli	用命令行读写笔记库、搜索、改属性、开发调试插件	skills/obsidian-cli
obsidian-markdown	双链、嵌入、callout、frontmatter 等 Obsidian 专属语法	skills/obsidian-markdown
obsidian-bases	`.base` 数据库视图：过滤、公式、视图、汇总	skills/obsidian-bases
json-canvas	`.canvas` 画布：节点、连线、分组、布局	skills/json-canvas
defuddle	从网页提取干净正文，输出 Markdown 省 token	skills/defuddle

你可以把这五个技能理解成四个工作流环节的分工：输入靠 CLI，净化靠 Defuddle，查询靠 Bases，呈现靠 Canvas，而 Markdown 技能负责让 AI 写出的每个文件都符合 Obsidian 规范、能正常渲染。

obsidian-skills 安装教程：三种方式 30 秒装好

按你用的 AI 工具选一种即可，装完重启对应工具，技能会被自动发现，无需改动任何配置文件。

⚡ 最省事——Obsidian 插件市场里直接添加：

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

用 npx 一行拉取：npx skills add <仓库地址>
手动放置：Claude Code 用户把仓库内容放进库根目录的 /.claude；Codex 用户把 skills/ 拷到 ~/.codex/skills/；OpenCode 用户要克隆整个仓库到 ~/.opencode/skills/，命令是 git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills。

OpenCode 特别提醒：要克隆完整仓库，目录结构应是 skills/<技能名>/SKILL.md，只拷内层文件夹会被漏发现。

核心能力详解：输入、净化、查询、呈现四步工作流

这四个环节串起来，就是 AI 帮你运转笔记库的完整路径。

输入：让 AI 自动写 Obsidian 笔记

这是最常用的一环。obsidian-cli 让你用命令行直接对一个正在运行的 Obsidian 实例做增删改查：新建笔记、全文搜索、追加日记、批量改属性、查反链和标签统计。AI 建出的笔记会由 obsidian-markdown 技能兜底，自动补上 callout、待办清单和双链，避免写出一堆渲染不出来的半成品。

常用命令	作用
`create`	新建符合规范的笔记
`search`	按关键词全文搜索库
`daily:append`	往当日日记追加内容或任务
`property:set`	指定笔记批量改属性
`backlinks`	查看指向某笔记的反链

对用户的实际好处：增删改查全走命令行，你不用打开编辑器，一句话就能让 AI 把纪要、任务、资料落进库里。三条高频用法如下：

obsidian create name="Q3 排期会" content="# 会议纪要\n- [ ] 周五前交付初稿"
obsidian search query="竞品分析" limit=20
obsidian daily:append content="- [ ] 提交本周数据"

净化：defuddle 一键把网页洗成干净 Markdown

收藏网页的老毛病是导航栏、广告、弹窗一起进来，既乱又费 token。defuddle 技能专门处理这一步：给定一个链接，它只抽出正文，直接输出规整的 Markdown，也能单独取标题、描述等元信息。对资讯页、博客、文档站，它比通用抓取工具更省 token。注意默认输出是 HTML，要 Markdown 必须带上 --md：

defuddle parse https://example.com/report --md -o 行业报告.md
defuddle parse https://example.com/report -p title

-o 指定落盘文件。这样"收藏一篇网页"变成一句自然语言的事，库里不会再堆成一堆带噪音的复制粘贴。

查询：obsidian bases 怎么用

Bases 让笔记库长出一张会算数的表。一个 .base 文件就是一段 YAML，由三块组成：filters 用标签、文件夹、属性或日期圈定范围，支持 and/or/not 嵌套；formulas 定义计算字段；views 配置 table、cards、list、map 四种视图和展示列。你让 AI 按需求生成好文件，Obsidian 里就多出一张实时更新的动态视图，还能用 ![[某库.base]] 直接嵌进笔记正文。对要反复查记录的场景，等于给笔记库装了一个查询引擎。完整函数参考见 FUNCTIONS_REFERENCE。

呈现：AI 生成 obsidian canvas

讨论到一半想把思路摊开，不用再切到白板软件。json-canvas 技能让 AI 直接产出符合公开规范的 .canvas 文件——核心就是 nodes（节点）和 edges（连线）两个数组。节点可以是文本、文件、网页链接或分组容器，颜色、坐标、连线锚点都能指定，AI 还会校验每个 fromNode/toNode 是否指向真实节点。生成的画布打开就是 Obsidian 原生画布，想拖就拖、想连就连。完整节点与布局规范见 json-canvas 技能说明。

进阶玩法：让 AI 调试 Obsidian 插件

如果你自己也写插件或主题，obsidian-cli 还藏了一套开发者命令，能把"改代码 → 重载 → 查报错 → 截图验证"做成闭环。常用动作包括 plugin:reload 重载插件、dev:errors 查报错、dev:screenshot 截图、dev:console 看日志、eval 在应用上下文里跑一行 JavaScript。让 AI 替你走完这套循环，它就从"笔记助手"升级成了"开发助手"。