Obsidian 仓库探测器

它解决什么问题

脚本里硬编码仓库路径，是 Obsidian 自动化最容易踩的坑。大多数人不止一个 vault：iCloud 同步的、~/Documents 下的、工作与个人分开的。目录一旦变动，写死的路径就失效，批处理脚本跟着一起错。手工复制路径同样不可靠——你记不住此刻打开的是哪个 vault。

技能如何工作

核心是一条原则：不要猜，去读配置。Obsidian 桌面端把 vault 登记在 ~/Library/Application Support/obsidian/obsidian.json，这是唯一事实来源，obsidian-cli 也从这里解析。

• 快速定位：设过默认就用 obsidian-cli print-default --path-only；否则读 json，取 "open": true 的那条记录
• 搜索：search 匹配笔记名，search-content 搜正文并回显片段与行号
• 写入：create 直接落盘，可加 --open 顺手打开
• 重命名：move 会同步更新全仓库的 [[wikilinks]] 与常见 Markdown 链接，这是它相比 mv 的主要价值
• 清理：delete 按路径删除

此外还能把外部文件导入仓库、通过邮件把笔记发给同事（默认取 git config 里的主邮箱，也可指定收件人）。

适用边界与注意点

• vault 名通常就是文件夹名（路径后缀）；多个 vault 同时打开时不要凭感觉挑
• 脚本应从配置动态解析路径，不要写死绝对路径
• create 依赖 obsidian:// URI 处理器可用，即本机装了 Obsidian；通过 URI 往 .something/ 这类隐藏点目录写文件，Obsidian 可能拒绝
• .obsidian/ 下是工作区与插件配置，脚本一般不要碰
• 简单改动直接开 .md 文件编辑即可，Obsidian 会自动拾取