黑曜石

黑曜石知识库 = 磁盘上的普通文件夹。

知识库结构（典型）

• 笔记：*.md（纯文本 Markdown 格式；可用任何编辑器编辑）
• 配置：.obsidian/（工作区 + 插件设置；通常不从脚本中操作）
• 画布：*.canvas（JSON 格式）
• 附件：在 Obsidian 设置中选择的任何文件夹（图片/PDF 文件等）

查找活动知识库

Obsidian 桌面版在此处跟踪知识库（权威数据源）：

• ~/Library/Application Support/obsidian/obsidian.json

obsidian-cli从该文件解析知识库；知识库名称通常是文件夹名称（路径后缀）。

快速“哪个知识库是活动的 / 笔记在哪里？”

• 如果你已经设置了默认知识库：obsidian-cli print-default --path-only
• 否则，读取~/Library/Application Support/obsidian/obsidian.json并使用带有"open": true的知识库条目。

注意事项

• 多个知识库很常见（iCloud 对比~/Documents、工作/个人等）。不要猜测；请读取配置。
• 避免在脚本中硬编码知识库路径；优先选择读取配置或使用print-default.

obsidian-cli 快速入门

选择一个默认知识库（一次性操作）：

• obsidian-cli set-default "<知识库文件夹名称>"
• obsidian-cli print-default/obsidian-cli print-default --path-only

搜索

• obsidian-cli search "查询"（笔记名称）
• obsidian-cli search-content "查询"（笔记内部；显示片段 + 行号）

创建

• obsidian-cli create "文件夹/新笔记" --content "..." --open
• 需要 Obsidian URI 处理器（obsidian://…）正常工作（已安装 Obsidian）。
• 避免通过 URI 在“隐藏”的点文件夹（例如.something/...）下创建笔记；Obsidian 可能会拒绝。

移动/重命名（安全重构）

• obsidian-cli move "旧路径/笔记" "新路径/笔记"
• 更新整个知识库中的[[维基链接]]和常见 Markdown 链接（这是相比mv命令的主要优势）。

删除

• obsidian-cli delete "路径/笔记"

在合适的情况下，建议直接编辑：打开.md文件并修改；Obsidian 会自动识别。