用途：面向 Obsidian 库（vault）的自动化操作。Obsidian 库就是磁盘上的普通文件夹，笔记为 *.md 纯文本 Markdown，可用任意编辑器修改；配置位于 .obsidian/（工作区与插件设置，脚本通常不应改动）；画布为 *.canvas（JSON）；附件存放在 Obsidian 设置中指定的文件夹。
定位活动库：Obsidian 桌面端在 ~/Library/Application Support/obsidian/obsidian.json 记录库信息，这是权威来源，obsidian-cli 也据此解析库，库名通常为文件夹名（路径后缀）。若已设默认库，可用 obsidian-cli print-default --path-only；否则读取该 JSON，取 "open": true 的条目。多库很常见（iCloud 与 ~/Documents、工作与个人等），不要猜测，应读取配置；避免在脚本中硬编码库路径。
主要能力与用法：设置默认库 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"。
限制与注意：配置目录 .obsidian/ 通常不要由脚本改动；合适时可直接编辑 .md 文件，Obsidian 会自动识别。资料未提供平台支持范围、安装方式、版本要求及收费信息。