Obsidian 概览
Obsidian 技能让 AI 助手直接访问本地 Obsidian Vault（Markdown 文件夹）。
支持搜索、创建、移动/重命名笔记，并在重命名时自动更新 [[wikilinks]] 与 Markdown 链接。
工作原理
读取 Obsidian 配置，定位当前可用的 Vault（支持多 Vault）。
使用 obsidian-cli 按名称或内容搜索，并在任意文件夹创建新笔记。
移动或重命名时自动更新全库 [[wikilinks]] 与 Markdown 链接。
直接编辑 .md 文件，Obsidian 会自动同步变更。
核心功能
Vault 发现
自动读取 Obsidian 配置，支持多 Vault。
笔记搜索
按名称或全文搜索，并返回片段与行号。
安全重命名与移动
移动或重命名时自动重构链接。
创建笔记
在任意目录创建笔记，并可自动在 Obsidian 中打开。
直接编辑文件
直接编辑 Markdown 文件，Obsidian 实时同步。
默认 Vault 管理
设置默认 Vault，避免每次传路径。
环境要求
- 无需虚拟机。
- 需要 obsidian-cli（可通过 Homebrew 安装）。
- 需要 Obsidian 桌面应用以支持 URI 自动打开。
使用场景
知识管理
组织、搜索并更新个人知识库。
笔记自动化
自动创建日报、会议纪要或项目记录。
Vault 重构
重组织 Vault 结构并自动更新链接。
内容检索
在大量笔记中快速全文搜索。
安装方式
npx clawhub@latest install obsidian在终端运行命令，或点击页面顶部安装按钮一键完成。
常见问题
必须安装 Obsidian 吗？
自动打开等功能需要 Obsidian；其他操作可直接作用于 Vault 文件。
从哪里读取 Vault？
默认读取 `~/Library/Application Support/obsidian/obsidian.json` 配置。
重命名会更新链接吗？
会，obsidian-cli 会更新全库 [[wikilinks]] 与 Markdown 链接。
如何设置默认 Vault？
使用 `obsidian-cli set-default`，并用 `obsidian-cli print-default` 查看。
可以按内容搜索吗？
可以，使用 `obsidian-cli search-content` 获取匹配结果。
多 Vault 怎么办？
支持多 Vault，可指定或设置默认 Vault。