核心用法
该Skill是一份完整的Obsidian知识库操作手册，主要功能包括：
Vault定位与识别
- 解析Obsidian桌面端的vault配置文件（
~/Library/Application Support/obsidian/obsidian.json） - 识别当前活跃vault路径，支持多vault场景（工作/个人、iCloud/本地等）
- 推荐通过
obsidian-cli print-default --path-only或读取配置获取路径，避免硬编码
obsidian-cli工具链
- 设置默认vault、搜索笔记名称/内容、创建带内容的笔记、安全移动/重命名（自动更新wikilinks）、删除笔记
- 强调直接编辑
.md文件与工具调用的场景选择
文件结构认知
- 明确vault本质是普通文件夹，
.md为纯文本，.obsidian/为配置目录，.canvas为JSON格式
显著优点
- 纯文档零风险：无可执行代码，无外部依赖，无网络通信，供应链攻击面为零
- 实用性强：覆盖Obsidian用户高频痛点——vault路径管理、批量笔记操作、链接安全重构
- 安全意识到位：反复强调"避免硬编码路径""读取配置而非猜测"，体现工程化思维
- 工具生态整合：与obsidian-cli形成互补，降低用户命令行学习成本
局限性与潜在缺点
- 依赖外部工具：核心功能（create/move/delete）需obsidian-cli预先安装，Skill本身仅提供指南
- 平台限定：vault路径解析针对macOS（
~/Library/Application Support/），Windows/Linux用户需自行适配 - 无自动化能力：纯静态文档，无法直接执行任何操作，需用户手动复制命令
- URI方案限制：create操作依赖Obsidian已注册URI handler，未安装Obsidian或权限问题会导致失败
适合人群
- Obsidian重度用户，希望用命令行批量管理笔记
- 需要安全重构笔记结构（移动/重命名）避免链接断裂的用户
- 多vault切换频繁的进阶玩家
- 追求"本地优先、文件即数据"理念的Markdown工作流爱好者
常规风险
- 工具链风险：obsidian-cli本身为第三方社区工具（yakitrak/yakitrak/obsidian-cli），需通过官方Homebrew渠道安装，避免下载不明来源二进制
- 误操作风险：move/delete命令会实际修改文件系统，建议在执行前备份vault或启用Git版本控制
- URI注入风险：create命令通过
obsidian://协议触发，理论上若内容未过滤可能存在路径遍历，但obsidian-cli实现中应已处理 - 配置漂移风险：Obsidian版本更新可能改变
obsidian.json结构，建议关注官方文档变更