SuperAPI AI 工具集

obsidian

办公与效率

查看项目

更新于 10-16 09:35

技能介绍

用途:操作 Obsidian 库。Obsidian 库是磁盘上的普通文件夹,笔记为 *.md 纯文本 Markdown,可用任意编辑器编辑;配置位于 .obsidian/,通常不应由脚本改动;画布为 *.canvas(JSON);附件目录由 Obsidian 设置决定。

查找活动库:桌面版在 ~/Library/Application Support/obsidian/obsidian.json 中记录库列表,这是事实来源;obsidian-cli 从该文件解析库,库名通常是文件夹名(路径后缀)。若已设默认库,可用 obsidian-cli print-default --path-only 快速查看;否则读取该 JSON 并采用 "open": true 的条目。多库很常见(iCloud 与 ~/Documents、工作与个人等),不要猜测,应读配置;避免在脚本中硬编码库路径,优先读取配置或使用 print-default。

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;避免通过 URI 在隐藏点文件夹(如 .something/...)下创建笔记,Obsidian 可能拒绝。移动/重命名:obsidian-cli move "old/path/note" "new/path/note",会更新全库的 [[wikilinks]] 和常见 Markdown 链接,这是相对 mv 的主要优势。删除:obsidian-cli delete "path/note"。

适用场景:需要批量或脚本化处理 Obsidian 笔记、跨库定位、安全重构链接时。限制:创建依赖 Obsidian URI;隐藏目录创建可能失败;脚本中不宜硬编码路径。直接编辑 .md 文件亦可,Obsidian 会自动拾取。其他细节暂未提供。