Agent Skills
返回列表
Obsidian 笔记库 CLI 工作流

Obsidian 笔记库 CLI 工作流

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 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` 文件的脚本作者