技能介绍

为什么要把 Obsidian 接到命令行

Obsidian 的 vault 本质上就是一个磁盘上的普通文件夹：笔记是 *.md 文件，附件放在你设置时选的目录里，*.canvas 是 JSON 文件，工作区配置藏在 .obsidian/ 里。这意味着你完全可以用脚本、CI 或 AI Agent 来管理它。但坑在于：vault 路径不是固定的，你可能同时有多个 vault（iCloud 同步的、工作用的、个人用的），把路径写死在脚本里迟早会指错地方。这个技能要解决的问题，就是让外部工具可靠地找到活跃 vault、操作笔记，而不是靠猜。

技能如何工作

它是一个围绕 obsidian-cli 的薄封装。定位 vault 的流程是：读取 Obsidian 桌面端维护的 vault 清单 ~/Library/Application Support/obsidian/obsidian.json，取其中 "open": true 的条目；如果你执行过一次 set-default，就直接用 print-default --path-only 拿路径。路径确定后，所有操作都通过 CLI 完成：

搜索：search 按文件名匹配笔记，search-content 深入笔记正文，返回片段和行号。
创建：create 直接写入内容，加 --open 可通过 obsidian:// URI 唤起 Obsidian 打开新笔记，前提是本机装着 Obsidian 且 URI handler 工作正常。
安全重命名：这是最值得用的能力。move 修改路径的同时，会自动更新整个 vault 里指向它的所有 [[wikilinks]] 和 Markdown 链接——直接 mv 做不到这一点，手动改完所有双链都会变成死链。
删除：delete 移除笔记，效果和在文件管理器里手动删差不多。

适用边界与注意点

这个技能的前提是本机装有 Obsidian 桌面端，CLI 需要依赖它的配置文件和 URI handler。它只管笔记层的管理，不会碰 .obsidian/ 里的 workspace 设置，那些应该留给 Obsidian 自己处理。还有两个容易踩的雷：不要在脚本里硬编码 vault 路径，多 vault 场景下很容易指错；通过 URI 创建笔记时，不要往点开头的隐藏目录（比如 .something/）里写，Obsidian 会拒绝。最后，如果只是修改某条笔记的内容，直接编辑对应的 .md 文件就行，Obsidian 会自动加载，没必要走 CLI。