介绍
# Obsidian
Obsidian vault = 磁盘上的一个普通文件夹。
Vault 结构（典型） - Notes: `*.md` (纯文本 Markdown；可用任意编辑器编辑) - Config: `.obsidian/` (工作区 + 插件设置；通常不从脚本中修改) - Canvases: `*.canvas` (JSON) - Attachments: 你在 Obsidian 设置中选择的任意文件夹（图片/PDF 等）
## 查找当前活动的 vault(s)
Obsidian 桌面端在此处跟踪 vault（单一真实来源）： - `~/Library/Application Support/obsidian/obsidian.json`
`obsidian-cli` 从该文件解析 vault；vault 名称通常是**文件夹名称**（路径后缀）。
快速查看“当前是哪个 vault / 笔记在哪里？” - 如果你已经设置了默认 vault：`obsidian-cli print-default --path-only` - 否则，读取 `~/Library/Application Support/obsidian/obsidian.json` 并使用带有 `"open": true` 的 vault 条目。
Notes - 多个 vault 很常见（iCloud 对比 `~/Documents`，工作/个人等）。不要猜测；读取配置。 - 避免将硬编码的 vault 路径写入脚本；最好读取配置或使用 `print-default`。
## obsidian-cli 快速开始
选择默认 vault（仅需一次）： - `obsidian-cli set-default "<vault-folder-name>"` - `obsidian-cli print-default` / `obsidian-cli print-default --path-only`
Search - `obsidian-cli search "query"` (笔记名称) - `obsidian-cli search-content "query"` (笔记内部；显示片段 + 行号)
Create - `obsidian-cli create "Folder/New note" --content "..." --open` - 需要 Obsidian URI 处理程序 (`obsidian://…`) 正常工作（已安装 Obsidian）。 - 避免通过 URI 在“隐藏”的点文件夹（如 `.something/...`）下创建笔记；Obsidian 可能会拒绝。
Move/rename (安全重构) - `obsidian-cli move "old/path/note" "new/path/note"` - 更新整个 vault 中的 `[[wikilinks]]` 和常见 Markdown 链接（这是相比 `mv` 的主要优势）。
Delete - `obsidian-cli delete "path/note"`
适当时优先直接编辑：打开 `.md` 文件并修改它；Obsidian 会自动检测到变化。