核心用法
Obsidian 技能通过 obsidian-cli 工具桥接 Obsidian 知识库与外部自动化流程。Vault 本质是普通文件夹，笔记为纯 Markdown 文件，可直接读写。技能提供三类核心能力：
1. 库定位与配置
- 从
~/Library/Application Support/obsidian/obsidian.json读取 Obsidian 桌面端管理的 vault 列表 - 使用
obsidian-cli set-default和print-default建立默认工作库，避免脚本中硬编码路径 - 支持多库切换（iCloud/本地、工作/个人等场景）
2. 笔记生命周期管理
- 搜索：
search按文件名查找，search-content全文检索并返回上下文片段 - 创建：
create支持指定文件夹、初始内容和自动打开（依赖 Obsidian URI scheme） - 重构：
move是核心差异化功能——在移动/重命名笔记时自动更新 vault 内的[[wikilinks]]和标准 Markdown 链接，解决 Obsidian 生态中最易出错的手动迁移问题 - 删除：
delete安全移除笔记
3. 混合编辑模式
技能明确区分"CLI 操作"与"直接编辑"场景：批量自动化用 obsidian-cli，单文件快速编辑可直接操作 .md 文件，Obsidian 实时同步。
显著优点
- 零锁定设计：Vault 是普通文件夹，笔记是标准 Markdown，随时可迁移至任何工具
- 链接完整性：
move命令的链接自动修复是独家能力，避免手动重构的遗漏风险 - 生态兼容：保留
.obsidian/配置和.canvas画布文件，不破坏 Obsidian 原生体验 - URI 集成：创建笔记后可自动唤起 Obsidian 客户端，无缝衔接可视化编辑
潜在局限
- 平台限制：
obsidian-cli主要面向 macOS（依赖~/Library/Application Support路径），Windows/Linux 用户需额外配置 - URI 依赖：
--open等功能需 Obsidian 桌面客户端已安装且 URI scheme 注册成功 - 隐藏文件夹限制：通过 URI 创建笔记时，Obsidian 可能拒绝写入
.开头的隐藏目录 - 移动版不支持：Obsidian Mobile 不暴露相同文件路径，无法直接操作
适合人群
- 需要批量处理笔记的知识管理重度用户（日记归档、项目迁移、标签重构）
- 希望用脚本自动化 Obsidian 工作流的开发者、研究员、内容创作者
- 多库并行管理且需要统一入口点的团队用户
常规风险
- 配置漂移：
obsidian.json由 Obsidian 维护，手动修改可能导致 vault 列表不同步 - 链接修复边界：
move的链接更新可能无法覆盖插件自定义语法或代码块内的引用 - 并发写入：直接编辑
.md文件与 Obsidian 实时同步时，若双方同时修改同一文件可能产生冲突 - 权限问题：iCloud Drive 等同步目录可能因文件锁定导致 CLI 操作延迟或失败