核心用法
Obsidian CLI 通过 IPC 与运行中的 Obsidian 实例通信，提供 115 个命令实现知识库全自动化。主要分为六大板块：
内容操作：create/read/append/move 等 18 个文件命令支持 Markdown 全生命周期管理；daily 系列自动化日记工作流；unique 生成带时间戳的会议笔记。
知识组织：search/search:context 支持正则与上下文检索；tasks/task 管理待办状态；tags/properties 实现元数据驱动；links/backlinks/orphans 维护图谱健康。
高级功能：base:* 操作数据库视图；template:* 插入模板；publish:* 需额外订阅（$8/月）用于网站发布；sync:* 管理端到端加密同步历史。
环境与扩展：theme:*/plugin:* 管理外观与功能；workspace:* 保存加载布局；dev:* 提供 DevTools、JS 执行、截图等调试能力。
显著优点
- 官方原生：非第三方工具，与 Obsidian 深度集成，稳定性与兼容性最佳
- 功能完备：覆盖 95% 的 GUI 操作，AI 代理可构建完整自动化工作流
- 多库支持：
vault=<name>参数切换目标库，适合多项目并行 - 输出灵活：多数命令支持
format=json便于程序解析 - 开发者友好：内置 CDP、DOM 查询、移动模拟等专业调试工具
局限与注意事项
- 平台锁定：仅支持 macOS，Windows/Linux 用户无法使用
- 付费门槛：需 Catalyst 许可证（$25 一次性）解锁 CLI；Publish/Sync 功能另需订阅
- 运行依赖：Obsidian 必须保持前台运行，无独立守护进程模式
- 版本要求：1.12+ Early Access 版本，正式版用户需等待更新
- 无远程能力：纯本地 IPC 通信，无法 SSH 远程操控服务器实例
适合人群
- 已购买 Catalyst 的 macOS 重度 Obsidian 用户
- 需自动化日报/周报的职场知识管理者
- 通过 AI 代理构建个人知识管理系统的开发者
- 维护大型多库工作流的内容创作者
常规风险
- 数据安全：
delete permanent绕过回收站，自动化脚本误操作可能导致不可逆丢失 - 同步冲突：多设备同时 CLI 操作可能触发 Sync 版本冲突
- 插件兼容性：
plugin:*命令操作社区插件时，异常插件可能导致 Obsidian 崩溃 - Eval 风险：
dev:eval执行任意 JavaScript，恶意代码可访问完整文件系统 - 订阅陷阱：
publish:*命令在无订阅时静默失败，自动化流程需前置检查