Obsidian 笔记库 CLI 工作流
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7ca4c668/obsidian-v13。
技能介绍
问题背景
Obsidian 的笔记库本质上就是磁盘上的普通文件夹:*.md 笔记、.obsidian/ 配置、可选的 *.canvas 与附件目录。脚本或 Agent 要读写笔记时,首先要搞清楚当前打开的是哪个 vault、笔记路径怎么写;多库并存(iCloud、工作/个人等)时硬编码路径很容易写错库。另外,用系统 mv 重命名笔记会破坏 vault 内大量的 [[wikilink]] 与 Markdown 链接,后续检索和图谱都会断链。
技能如何工作
本技能以 obsidian-cli / obsidian-agent 为操作面,强调从 Obsidian 桌面端的 obsidian.json(macOS 在 ~/Library/Application Support/obsidian/,Windows 在 %APPDATA%/obsidian/)解析 vault,vault 名通常对应文件夹名。可通过 OA_VAULT 或每次命令的 --vault 指定目标库,也可用 obsidian-cli set-default / print-default 固定默认库。
典型能力包括:
- 检索:
search按笔记名;search-content在正文内查并返回片段与行号 - 创建:
create带路径与内容,需本机 Obsidian URI 可用;避免在带点前缀的「隐藏」目录下通过 URI 建笔记 - 重构:
move在移动/重命名的同时更新 vault 内 wikilink 与常见 Markdown 链接 - 删除:
delete按路径删除笔记
技能文档还规定了分步工作流:先在当前工作区定位本地文件(示例为「邮件摘要」),再执行上述 CLI 操作;流程结束后应配合 file-emailer 技能收尾。能直接改 .md 文件时,优先文件级编辑,Obsidian 会自动感知变更。
边界与注意
- 不要猜测 vault 路径;以配置或
print-default为准 .obsidian/一般不要由脚本随意改动- 创建笔记依赖 Obsidian 已安装且 URI 处理正常
- 与 file-emailer 串联是文档中的完整流程要求,单独用 CLI 时需自行补齐下游步骤
使用场景
- Agent 在工作区找到「邮件摘要」后,用 `search-content` 在指定 vault 里定位相关笔记再改写
- 多 vault 并存时,用 `print-default` 或 `--vault` 确认目标库,避免脚本写到 iCloud 与个人库混用
- 批量整理目录结构时,用 `move` 重命名路径并自动更新全库 `[[双链]]` 与 Markdown 链接
- 收到结构化摘要文本后,用 `create` 在固定文件夹下新建笔记并在 Obsidian 中打开核对
适合人员
- 维护个人/工作双 Obsidian 库、希望 Agent 从 `obsidian.json` 自动识别当前库的知识管理者
- 需要把邮件或工作区摘要写入 vault,并按规定串联 file-emailer 收尾流程的自动化编排者
- 经常调整笔记路径、又不想手动修复 hundreds 条双链的 PKM 重度用户
- 在 macOS/Windows 上用 obsidian-cli 做 vault 内检索与创建、而非只改单个 `.md` 文件的脚本作者