核心用法
Obsidian CLI 是官方推出的完整命令行界面（v1.12+），提供 115 个命令实现无图形界面操作 Obsidian 核心功能。使用前需满足三重要求：Obsidian 1.12+ 版本、Catalyst 许可证（$25 一次性购买）、以及启用 CLI 设置。命令通过 IPC 与运行中的 Obsidian 实例通信，因此必须保持应用后台运行。
高频场景：obsidian daily 系列管理日记笔记；create/read/append 实现文件 CRUD；search 全文检索；tasks 任务管理；tags 和 properties 元数据操作；backlinks/links 链接分析；sync/publish 云服务管理。开发者可通过 eval 直接执行 JavaScript 访问 Obsidian API，devtools 打开 Electron 开发者工具。
参数语法：name=value 形式传参，空格值需引号包裹；--copy 标志可将输出复制到剪贴板；vault="Vault Name" 指定目标仓库（必须首位）；file=NoteName 使用维基链接解析，path=folder/file.md 使用精确路径。
显著优点
- 官方原生：由 Obsidian 团队直接维护，与桌面端功能深度集成，无第三方同步延迟或兼容风险
- 功能全覆盖：115 个命令涵盖笔记管理、任务、搜索、属性、链接分析、主题插件、工作区、历史版本、同步发布等几乎所有 Obsidian 能力
- 开发者友好：内置 JavaScript 执行、Chrome DevTools Protocol、DOM 查询、截图等调试工具，可直接操作 app 对象
- 跨平台：支持 macOS/Windows/Linux，Snap/Flatpak/AppImage 均有适配方案
局限性与风险
硬性门槛：Catalyst 许可证 $25 一次性费用将大量用户排除在外；必须保持 Obsidian GUI 运行，无法作为纯后台服务使用；IPC 通信意味着远程 SSH 使用时需配合图形转发。
功能边界：仅操作本地 vault，无法直接管理移动设备笔记；命令输出为纯文本，复杂查询（如 search:context）的可读性不如图形界面；依赖 Obsidian 版本同步更新，旧版本可能命令失效。
潜在风险：eval 和 dev:cdp 命令可执行任意代码，共享机器上需防范命令注入；delete/move/sync:restore 等操作不可逆，缺乏交互确认；配置文件权限不当可能导致 vault 路径泄露。
适合人群
- 重度 Obsidian 用户追求键盘效率，愿意付费解锁高级功能
- 开发者构建自动化工作流（配合 Alfred/Raycast/Keyboard Maestro）
- 需要批量处理笔记、生成报告、维护链接健康的进阶用户
- 主题/插件开发者利用 devtools 快速调试
常规风险等级
安全可控（S级）。官方来源、无网络暴露、本地 IPC 通信，主要风险来自用户自身操作失误或恶意 eval 代码。建议配合 vault 定期备份使用。