Obsidian Skill

Obsidian Skill 是什么？

Obsidian Skill 用于读取和管理 Obsidian 知识库。Obsidian vault 本质上是一个普通文件夹，笔记通常是 Markdown 文件，画布是 JSON，附件存放位置由用户设置。这个 Skill 可以直接编辑文件，也可以使用 obsidian-cli 搜索、创建、移动和删除笔记。

主要能力

• 查找当前使用的 vault 和默认路径。
• 按笔记名称或正文内容搜索。
• 创建新笔记并按需在 Obsidian 中打开。
• 移动或重命名笔记，同时更新常见内部链接。
• 删除指定笔记，或直接编辑 Markdown 内容。

查找正确的知识库

用户可能同时拥有工作、个人、iCloud 或本地 vault。Skill 要求读取 Obsidian 配置或使用 CLI 获取默认 vault，不应猜测路径，也不应把个人绝对路径硬编码进共享脚本。

移动与直接编辑

普通文字修改可以直接编辑 Markdown 文件，Obsidian 会读取变化。移动和重命名更适合使用 obsidian-cli，因为它可以同步更新 wiki 链接和常见 Markdown 链接。创建笔记时需要确保 Obsidian URI 处理器可用。

风险与限制

删除、批量移动和全文替换可能影响大量链接与笔记。操作前应备份或使用版本控制，并避开 .obsidian 配置目录，除非用户明确要求修改。知识库可能包含私人资料，不应把内容发送给无关服务。

许可证

ClawHub 当前版本没有声明许可证。obsidian-cli、Obsidian 应用和用户笔记分别受各自条款约束。

常见问题 FAQ

1. Obsidian vault 是特殊数据库吗？

主要是普通文件夹，笔记通常保存为 Markdown 文件。

2. 可以不用 CLI 直接修改吗？

可以直接编辑 Markdown，移动和重命名则更适合用 CLI 维护链接。

3. 怎样找到当前 vault？

读取 Obsidian 配置或使用 obsidian-cli 查看默认路径。

4. 可以搜索笔记内容吗？

可以按名称搜索，也可以全文搜索并返回片段与行号。

5. 移动笔记会更新链接吗？

使用 obsidian-cli 移动时会更新常见 wiki 链接和 Markdown 链接。

6. 能修改 .obsidian 配置吗？

技术上可以，但脚本通常应避免碰触该目录，以免破坏工作区和插件设置。

7. 删除笔记可以恢复吗？

取决于备份、回收站和版本控制，执行删除前应确认恢复方案。

8. 支持多个 vault 吗？

支持，但每次操作都要明确目标，不能根据文件夹名称随意猜测。

来源与核验说明

本条目根据 ClawHub 上 steipete 发布的 Obsidian 1.0.0 内容整理，发布前已核对本地文件操作风险。