核心用法
Obsidian技能通过obsidian-cli工具桥接AI助手与Obsidian知识库，实现纯Markdown笔记的自动化管理。该技能不涉及Obsidian桌面应用本身，而是直接操作存储在磁盘上的标准Markdown文件。
关键能力：
- 智能搜索：按文件名(
search)或全文内容(search-content)检索笔记，返回带上下文的片段 - 安全重构：
move命令移动/重命名笔记时，自动更新全库的[[wikilink]]双向链接和普通Markdown链接，避免链接断裂 - 程序化创建：通过Obsidian URI协议创建笔记，支持指定文件夹路径和初始内容
- 默认库管理：读取Obsidian官方配置(
obsidian.json)识别活动知识库，避免硬编码路径
典型工作流：
1. 配置默认知识库：obsidian-cli set-default "MyVault"
2. 搜索现有笔记：obsidian-cli search-content "关键概念"
3. 安全归档重构：obsidian-cli move "旧分类/笔记" "新分类/笔记"（自动修复链接）
4. 批量创建：obsidian-cli create "项目/2024-Q3/会议记录" --content "..."
显著优点
- 零侵入架构：直接操作标准Markdown文件，不依赖Obsidian插件生态，兼容任何Markdown编辑器
- 链接完整性保障：
move命令的链接修复功能是该技能核心价值，解决了纯文件操作工具无法处理的知识图谱维护难题 - 配置驱动：自动读取Obsidian原生配置文件识别知识库，支持多库切换（iCloud/本地/工作/个人）
- URI协议集成：通过
obsidian://协议创建笔记时自动打开Obsidian桌面应用，兼顾自动化与可视化确认
局限性与风险
功能边界：
- 不支持Canvas文件(
.canvas)的内容操作，仅能通过文件系统层面处理 .obsidian/配置目录的操作需手动完成，工具不介入工作区设置- 依赖Obsidian URI处理器，创建笔记功能在未安装Obsidian桌面端时失效
操作风险：
- 删除操作为永久性（无回收站），建议配合版本控制使用
- 创建笔记时避免使用隐藏文件夹(
.folder/)，Obsidian URI可能拒绝处理 - 全文搜索性能取决于知识库规模，大库可能出现延迟
适用场景限制：
- 专为macOS设计（路径依赖
~/Library/Application Support/） - 多用户协作场景下，链接修复可能产生冲突（需配合Git等版本控制）
适合人群
- 开发者/技术写作者：习惯CLI工具，需要将笔记管理集成到自动化脚本
- Obsidian重度用户：知识库规模较大，频繁重构分类体系，需要维护链接完整性
- Markdown优先主义者：重视文件的可移植性，拒绝被特定应用锁定
安全建议
- 生产环境使用前，在测试库验证
move命令的链接修复行为 - 关键知识库启用Git版本控制，利用
obsidian-cli的批量操作能力前确保可回滚 - 定期检查
obsidian.json配置的准确性，避免默认库指向错误路径