obsidian-official-cli

该技能是Obsidian官方CLI（v1.12+）的完整使用指南，为拥有Catalyst许可证的高级用户提供了从终端全面操控Obsidian笔记库（Vault）的能力。通过详尽的命令参考与示例，用户可掌握文件操作、内容搜索、任务管理、插件控制等核心功能的命令行实现方式，实现知识管理流程的自动化与效率提升。

核心用法涵盖六大功能模块：在文件操作方面，支持通过简单命令创建、读取、移动、追加和删除笔记，同时提供基于Wikilink或精确路径的文件定位机制；搜索功能允许基于关键词全文检索vault内容，支持按路径过滤、大小写敏感匹配及JSON格式输出；任务管理模块可列出、筛选和切换待办事项状态，支持按文件或每日笔记维度管理；插件与主题管理支持启用、禁用、安装、卸载及开发重载；高级功能包括Obsidian Sync同步状态监控、文件历史版本回溯与比较，以及开发者调试工具（截图、DOM操作、控制台访问）。所有命令均支持参数化调用和交互式TUI模式，满足不同场景需求。

显著优点在于将Obsidian的图形界面能力无缝扩展至终端环境，极大提升了批量操作和自动化工作流的效率。对于习惯命令行的开发者而言，可通过脚本实现笔记模板的快速插入、工作空间的保存与切换、以及与外部工具链的集成。与Obsidian官方CLI深度集成的设计确保了操作的原子性和数据一致性，避免了第三方API可能带来的同步延迟或冲突风险。

潜在局限性包括较高的准入门槛：必须拥有Obsidian Catalyst许可证且升级至1.12+版本，同时Obsidian桌面应用必须保持运行状态CLI才能正常工作。作为纯文档型技能，它仅提供命令参考而无法独立执行操作，实际功能依赖于用户本地环境配置。此外，该技能由T3级个人开发者维护，虽内容经过安全审计且准确可靠，但非Obsidian官方直接背书，更新频率和长期维护存在一定不确定性。

该技能特别适合需要构建复杂自动化知识管理流程的高级用户、习惯终端操作的软件开发者，以及希望通过脚本批量处理笔记内容、生成报告或集成CI/CD流程的效率工作者。对于仅使用基础笔记功能的普通用户、未购买Catalyst许可证的用户，或对命令行不熟悉的初学者则不适用，建议先通过Obsidian图形界面掌握基础操作。

使用风险主要集中在操作执行层面：虽然技能本身为纯文档无代码执行风险，但用户在实际执行CLI命令时可能因参数错误导致文件误删（特别是使用permanent永久删除标志）或数据覆盖。开发者命令（如eval和devtools）使用不当可能引发Obsidian应用崩溃或数据异常。建议用户在执行破坏性操作前完整备份vault，仔细核对目标文件路径，避免在生产环境直接测试未知命令，并保持Obsidian客户端为最新版本以获取安全修复。