Obsidian 命令行

要解决什么问题

自动化脚本、CI 或 AI Agent 往往需要在不手动点界面的情况下读写笔记、切换库或验证插件改动。Obsidian 提供官方 CLI，但参数约定（file= 与 path=、vault= 优先级、多行转义）容易踩坑；插件开发也需要固定的「改代码 → 重载 → 看错误 → 看界面」循环。

技能如何工作

本技能围绕已打开的 Obsidian 实例整理命令用法：

• 定位笔记：file= 按 wikilink 规则解析（可省略路径与扩展名）；path= 从库根目录写完整路径；省略时默认当前活动文件。
• 指定库：默认操作最近聚焦的 vault；需要时用 vault= 作为第一个参数指向目标库。
• 通用习惯：任意命令可加 --copy 把输出进剪贴板；silent 避免自动打开文件；列表类命令用 total 只拿数量。
• 插件开发：改代码后先 Reload 插件，再查错误、截图或 DOM 核对、看控制台；还可跑应用内 JavaScript、查 CSS、切换移动端模拟；完整开发者命令以 obsidian help 为准（含 CDP / 调试）。

语法上：参数带 = 赋值，含空格需引号；标志为无值布尔开关；多行内容用 \n、\t。完整参考见 Obsidian CLI 文档。

适用边界

Obsidian 必须先运行，CLI 才能连上实例；命令列表以本机 obsidian help 为准，比静态摘抄更可靠。