用途：在 Obsidian 知识库（vault）中工作并借助 obsidian-cli 实现自动化。Obsidian 库本质是磁盘上的普通文件夹，笔记为纯文本 Markdown 文件（*.md），可用任意编辑器编辑。
库结构：笔记 *.md；配置 .obsidian/（工作区与插件设置，脚本通常不应改动）；画布 *.canvas（JSON）；附件位于 Obsidian 设置中选定的文件夹（图片、PDF 等）。
定位当前库：Obsidian 桌面版在 ~/Library/Application Support/obsidian/obsidian.json 中记录库信息，这是判断依据；obsidian-cli 也从该文件解析库，库名通常为文件夹名（路径末尾）。已设默认库时可运行 obsidian-cli print-default --path-only；否则读取该 JSON 并选用 "open": true 的条目。常见多库并存（iCloud 与 ~/Documents、工作与个人），不要猜测，应读配置；避免在脚本中硬编码库路径，优先读取配置或使用 print-default。
用法：设定默认库 obsidian-cli set-default "<vault-folder-name>"；查看默认库 obsidian-cli print-default / obsidian-cli print-default --path-only。搜索：obsidian-cli search "query" 查笔记名，obsidian-cli search-content "query" 查笔记内部并显示片段与行。创建：obsidian-cli create "Folder/New note" --content "..." --open，需要 Obsidian URI（obsidian://…）处理程序可用（已安装 Obsidian）；避免通过 URI 在隐藏点文件夹（如 .something/...）下创建笔记，Obsidian 可能拒绝。移动或重命名：obsidian-cli move "old/path/note" "new/path/note"，会在整个库中更新 [[wikilinks]] 和常见 Markdown 链接，这是相比 mv 的主要优势。删除：obsidian-cli delete "path/note"。适当情况下也可直接编辑 .md 文件，Obsidian 会自动拾取变更。
限制：创建依赖已安装 Obsidian 及可用的 URI 处理程序；不要在脚本中改 .obsidian/ 配置；隐藏点文件夹下的创建可能被拒绝。收费、价格与平台支持等信息暂未提供。