用途:该技能用于配合 Obsidian 仓库(即磁盘上的普通文件夹)工作,并通过 obsidian-cli 自动完成常见笔记操作。
主要能力:查找当前活动仓库;按笔记名搜索;在笔记内容内搜索并给出片段与行号;创建笔记;安全地移动/重命名笔记,并同步更新仓库内的 [[wikilinks]] 与常见 Markdown 链接(相较直接 mv 的主要优势);删除笔记。
仓库结构与配置:笔记为 *.md 纯文本 Markdown,可用任意编辑器编辑;配置位于 .obsidian/(工作区与插件设置,脚本通常不应改动);画布为 *.canvas(JSON);附件放在 Obsidian 设置中选定的文件夹。桌面版仓库信息记录在 ~/Library/Application Support/obsidian/obsidian.json,obsidian-cli 从该文件解析仓库,仓库名通常为文件夹名(路径后缀)。存在多个仓库属常见情况,应读取配置而非猜测,也不要把硬编码仓库路径写进脚本。
使用方式:先用 obsidian-cli set-default "<vault-folder-name>" 设置默认仓库;用 obsidian-cli print-default 或 print-default --path-only 查看;不设默认时读取 obsidian.json 中 "open": true 的条目。搜索用 search 与 search-content;创建用 create "Folder/New note" --content "..." --open(需 Obsidian 已安装且 obsidian:// URI 处理器可用,避免在隐藏点文件夹下创建);移动用 move;删除用 delete。也可直接编辑 .md 文件,Obsidian 会自动识别。
限制:创建依赖 Obsidian URI 处理器;部分操作受 Obsidian 行为限制;价格、平台与效果等资料暂未提供。