用途:通过 obsidian-cli 操作 Obsidian 仓库(vault),仓库本质是磁盘上的普通文件夹。典型结构:笔记为 .md 纯文本 Markdown,可用任意编辑器编辑;配置在 .obsidian/(工作区与插件设置,脚本通常不要改动);画布为 .canvas(JSON);附件存放于 Obsidian 设置中指定的文件夹。
主要能力:查找当前活动的仓库、搜索笔记名称与笔记内容、创建笔记、移动/重命名笔记、删除笔记。其中移动操作会更新仓库内的 [[wikilinks]] 与常见 Markdown 链接,这是相对直接 mv 的主要优势。
使用方式:查找活动仓库时,可用已设默认值命令 obsidian-cli print-default --path-only;否则读取 ~/Library/Application Support/obsidian/obsidian.json,使用其中 "open": true 的仓库条目。该文件是 Obsidian 桌面记录的仓库来源,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 处理器(obsidian://…)可用且已安装 Obsidian。移动:obsidian-cli move "old/path/note" "new/path/note"。删除:obsidian-cli delete "path/note"。
限制与注意:避免在脚本中硬编码仓库路径,优先读取配置或使用 print-default;不要通过 URI 在隐藏点文件夹(如 .something/…)下创建笔记,Obsidian 可能拒绝;合适的情况下可直接编辑 .md 文件,Obsidian 会自动识别。定价、平台支持范围、安装方式等信息暂未提供。