名称： obsidian
描述： 使用 Obsidian 知识库（纯 Markdown 笔记）并通过 obsidian-cli 实现自动化。
主页： https://help.obsidian.md
元数据： {"clawdbot":{"emoji":"💎","requires":{"bins":["obsidian-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/obsidian-cli","bins":["obsidian-cli"],"label":"安装 obsidian-cli (brew)"}]}}

Obsidian

Obsidian 知识库 = 磁盘上的普通文件夹。

知识库结构（典型）
- 笔记：*.md（纯文本 Markdown；可用任何编辑器编辑）
- 配置：.obsidian/（工作空间与插件设置；通常无需通过脚本修改）
- 画布：*.canvas（JSON 格式）
- 附件：在 Obsidian 设置中指定的任意文件夹（图片/PDF 等）

查找活动知识库

Obsidian 桌面版在此处跟踪知识库（权威数据源）：
- ~/Library/Application Support/obsidian/obsidian.json

obsidian-cli 会从该文件解析知识库；知识库名称通常是文件夹名称（路径后缀）。

快速定位“哪个知识库是活动的 / 笔记在哪里？”：
- 若已设置默认知识库：obsidian-cli print-default --path-only
- 否则，读取 ~/Library/Application Support/obsidian/obsidian.json 并使用 "open": true 的知识库条目。

注意事项
- 常见多知识库场景（如 iCloud 与 ~/Documents、工作/个人等）。请勿猜测，务必读取配置。
- 避免在脚本中硬编码知识库路径；优先读取配置或使用 print-default。

obsidian-cli 快速入门

设置默认知识库（一次）：
- obsidian-cli set-default "<知识库文件夹名称>"
- obsidian-cli print-default / obsidian-cli print-default --path-only

搜索
- obsidian-cli search "查询"（按笔记名称）
- obsidian-cli search-content "查询"（在笔记内容中；显示片段与行号）

创建
- obsidian-cli create "文件夹/新笔记" --content "..." --open
- 需要 Obsidian URI 处理器（obsidian://…）正常工作（已安装 Obsidian）。
- 避免通过 URI 在“隐藏”的点文件夹（如 .something/...）下创建笔记；Obsidian 可能拒绝。

移动/重命名（安全重构）
- obsidian-cli move "旧路径/笔记" "新路径/笔记"
- 自动更新整个知识库中的 [[wikilinks]] 和常见 Markdown 链接（这是相比 mv 命令的主要优势）。

删除
- obsidian-cli delete "路径/笔记"

在适当时机优先直接编辑：打开 .md 文件并修改；Obsidian 会自动识别。