obsidian-skills 完整指南:教 AI 直接操作你的笔记库,十分钟开启笔记自动化
2026/9/8 22:09:21 网站建设 项目流程

obsidian-skills 完整指南:教 AI 直接操作你的笔记库,十分钟开启笔记自动化

【免费下载链接】obsidian-skillsAgent 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

如果你想让 AI 真正操作 Obsidian——写会议纪要、清洗网页内容、生成动态表格和思维画布,obsidian-skills 是一个相当直接的开源项目:它把 Obsidian 的用法打包成 AI 可直接加载的 Agent Skills,覆盖 CLI、Markdown 语法、Bases、Canvas 和网页提取五大块。装上之后,AI 就按 Obsidian 的规则写文件,笔记自动化从"AI 帮你生成一段文字"变成"AI 直接操作你的库"。这篇文章按"能力全景 + 任务实战"的顺序,带你完整跑一遍。

一张能力矩阵看懂 obsidian-skills 的 5 个 Obsidian AI 技能

所有技能都放在 skills/ 目录下,每个技能一份独立的SKILL.md说明文件,AI 会根据你的任务自动去读。可以粗分成两大类:

内容录入——把东西写进库

技能管什么典型产物
obsidian-cli通过 CLI 操作运行中的 Obsidian建笔记、搜索、改属性、写日记、管任务
obsidian-markdownObsidian 风味 Markdown 语法.md笔记:双链、嵌入、提示框、属性、公式、Mermaid
defuddleDefuddle CLI从网页抽取干净的 Markdown 正文

知识组织——把库里的东西整理出来

技能管什么典型产物
obsidian-basesBases 数据库视图.base文件:过滤器、公式、表格/卡片/地图视图
json-canvasJSON Canvas 公开规范.canvas画布:节点、连线、分组容器

这套技能本质是写给 AI 的"规则手册":它不替代 Obsidian 本身,而是保证 AI 写出来的.md.base.canvas语法正确,打开就能渲染。

十分钟安装 obsidian-skills:三种 AI 工具加载方式

按你用的 AI 工具挑一种即可,装完自动发现,不需要改任何配置文件:

  • Obsidian 插件市场:先执行/plugin marketplace add kepano/obsidian-skills,再执行/plugin install obsidian@obsidian-skills
  • npx 一行命令npx skills add <仓库地址>
  • 手动放置:Claude Code 用户把仓库内容放进 Vault 根目录的.claude文件夹;Codex 用户把skills/目录拷贝到~/.codex/skills/;OpenCode 用户必须克隆整个仓库~/.opencode/skills/obsidian-skills,只拷内层 skills 文件夹会破坏目录结构:

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills

这些技能遵循 Agent Skills 开放规范,所以 Claude Code、Codex、Open Code 等主流代理都能加载,重启对应工具后就能直接对话使用。

AI 自动会议纪要:一条命令把结构化笔记写进库

问题:开完会你只想说一句"把纪要存进 Obsidian",剩下的格式、标签、双链都由 AI 完成,而不是你手动新建再排版。

obsidian-cli 能直接和运行中的 Obsidian 实例对话。让 AI 执行:

obsidian create name="周会纪要" content="# 结论\n\n> [!important]\n> 下个版本聚焦导入导出能力\n\n## 待办\n- [ ] 周四前出设计方案\n\n相关:[[版本规划]]" obsidian search query="竞品分析" limit=20 obsidian property:set name="status" value="已归档" file="周会纪要"

结果:笔记自动生成,带 callout 强调框、待办清单和双链,阅读视图直接渲染;同一个 CLI 还能全库搜索、批量改属性、往日记追加任务(daily:append)。命令记不全就先跑obsidian help,命令列表永远是最新的。

底层由 obsidian-markdown 技能负责"语法把关":它告诉 AI 双链和 Markdown 链接各自的适用场景、如何嵌入 PDF 页和图片、callout 怎么折叠、LaTeX 公式与 Mermaid 图怎么写,避免产出渲染不出来的半成品。

一条命令清洗网页转 Markdown:defuddle 正文提取

问题:收藏一篇行业报道,全选粘贴进来,导航栏、弹窗、广告位全跟着进库,AI 后续读它还得额外消耗 token。

defuddle 技能让 AI 用 Defuddle CLI 抽正文,一条命令搞定:

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

--md指定 Markdown 输出,-o直接把干净正文落成笔记文件,-p可单独抽取标题、描述等元信息。未安装时先npm install -g defuddle。对资讯页、博客、文档站,它比通用抓取工具输出更规整——"收藏一篇网页"从此是一句自然语言的事。

Obsidian Bases 动态表格与 Canvas 画布:让文件自己组织知识

这两块对应"把散落的笔记组织起来",AI 写的都是纯文本文件,打开即生效。

Bases(.base:文件内容就是一段 YAML。你只需要描述需求,比如"给我一张所有带'选题'标签笔记的表",AI 就会生成 filters 段用 and/or/not 组合圈定范围(按标签、文件夹、属性过滤),在 formulas 段定义计算列,再在 views 段输出表格或卡片视图,每列显示什么用 order 指定。Obsidian 里它会显示成一张随笔记实时更新的动态表格,还能用![[某个库.base]]嵌进任何一篇笔记里。完整的过滤器、公式函数和常见报错对照都在 skills/obsidian-bases/SKILL.md,遇到 YAML 引号问题可以当速查表用。

Canvas(.canvas:遵循 JSON Canvas 公开规范,文件核心就是 nodes 和 edges 两个数组。节点分文本、文件、链接、分组容器四种,各带坐标、尺寸、颜色;连线通过 fromNode/toNode 引用节点 id,可加箭头、标签和颜色。AI 把这份 JSON 存成.canvas,在 Obsidian 里打开就是原生画布,想拖想连都随你。讨论时想把思路当场摊到白板上,这就是最快的一条路。

AI 辅助 Obsidian 插件开发:四步调试闭环

如果你自己写 Obsidian 插件或主题,obsidian-cli 里还有一套开发者命令,AI 可以替你跑通"改代码 → 验证"的闭环:

obsidian plugin:reload id=my-plugin obsidian dev:errors obsidian dev:screenshot path=screenshot.png obsidian eval code="app.vault.getFiles().length"

改完代码一条命令重载插件,出错了直接读日志,页面截图和 DOM 检查走命令行,eval还能在应用上下文里执行 JavaScript 查看运行状态。AI 从此不只是代你记笔记,也能动你的开发环境。

上手前先看:新手必知的 5 个避坑提醒

  • ⚠️ 用 defuddle 抓网页别忘加--md,不加的话默认输出 HTML;
  • CLI 命令不必背,先跑obsidian help,列表始终与当前版本同步;
  • .base公式里含双引号时,用单引号包住整条表达式;日期相减得到的是 Duration,要先取.days再做数值运算;属性可能为空就用if()包一层,公式才不会整体报错;
  • 编辑.canvas时,确认每个 fromNode/toNode 都指向真实存在的节点 id,JSON 引号不要写漏;
  • OpenCode 安装记得克隆整个仓库,只拷skills/内层文件夹会导致技能无法被发现。

【免费下载链接】obsidian-skillsAgent 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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询