用途：面向 Obsidian vault（即磁盘上的普通文件夹）进行笔记与知识库管理，并通过 obsidian-cli 实现自动化。适用场景包括笔记检索、vault 管理、PKM 与知识库维护。
主要能力：搜索笔记名（obsidian-cli search "query"）与笔记内容（obsidian-cli search-content "query"，返回片段与行号）；创建笔记（obsidian-cli create "Folder/New note" --content "..." --open）；移动或重命名并自动更新 [[wikilinks]] 与常见 Markdown 链接（obsidian-cli move "old/path/note" "new/path/note"）；删除（obsidian-cli delete "path/note"）。
典型结构：笔记为 *.md 纯文本 Markdown，可用任意编辑器修改；配置在 .obsidian/（工作区与插件设置，脚本通常不改动）；画布为 *.canvas（JSON）；附件位于 Obsidian 设置中指定的文件夹。
使用方式：Obsidian 桌面端在 ~/Library/Application Support/obsidian/obsidian.json 记录 vault，obsidian-cli 从该文件解析；vault 名通常为文件夹名。可用 obsidian-cli print-default --path-only 查看默认路径，否则读取该 JSON 并使用 "open": true 的条目。设置默认库：obsidian-cli set-default "<vault-folder-name>"。建议避免在脚本中硬编码 vault 路径，多 vault 场景（如 iCloud 与 ~/Documents、工作与个人）应读取配置而非猜测。
限制：创建笔记依赖 Obsidian URI 处理器（obsidian://…）正常工作且已安装 Obsidian；通过 URI 在隐藏点文件夹（如 .something/…）下创建笔记可能被 Obsidian 拒绝。适当情况下也可直接编辑 .md 文件，Obsidian 会自动识别。