用途：在 Obsidian 资料库（vault）中处理纯 Markdown 笔记，并通过 obsidian-cli 进行自动化操作。vault 本质上是磁盘上的普通文件夹。
资料库结构（典型）：笔记为 *.md 纯文本 Markdown，可用任意编辑器编辑；配置位于 .obsidian/（工作区与插件设置，通常不要由脚本改动）；画布为 *.canvas（JSON）；附件放在 Obsidian 设置中选定的文件夹。
查找当前资料库：Obsidian 桌面版在此记录资料库（权威来源）：~/Library/Application Support/obsidian/obsidian.json。obsidian-cli 从该文件解析资料库；资料库名称通常就是文件夹名（路径后缀）。若已设置默认库，可用 obsidian-cli print-default --path-only；否则读取该 JSON，取 "open": true 的条目。多个库很常见，不要猜测，应读配置，避免在脚本中硬编码库路径。
obsidian-cli 快速上手：设置默认库 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 handler（obsidian://…）正常工作（即已安装 Obsidian）。避免通过 URI 在隐藏的点文件夹（如 .something/...）中创建笔记，Obsidian 可能拒绝。
移动/重命名（安全重构）：obsidian-cli move "old/path/note" "new/path/note"，会更新整个库中的 [[wikilinks]] 和常见 Markdown 链接，这是其相较 mv 的主要优势。
删除：obsidian-cli delete "path/note"。
其他：适当时可直接编辑 .md 文件，Obsidian 会自动识别。