核心用法
Obsidian CLI 是官方提供的命令行接口，面向 Obsidian 1.12+ 版本，需配合 Catalyst 许可证使用。启用后可通过 obsidian 命令在终端直接操作 Vault，涵盖文件管理、搜索查询、任务处理、模板插入、插件主题管理、同步操作及开发者调试等全功能场景。
典型工作流：
- 快速创建/编辑笔记：
obsidian create name="Idea" content="# Title" - 全文搜索与跳转：
obsidian search query="TODO"+obsidian open file=Note - 任务管理：
obsidian tasks all todo列出未完成任务，obsidian task ref="..." toggle切换状态 - 日常记录：
obsidian daily打开当日笔记并追加内容 - 开发调试：
obsidian devtools、obsidian plugin:reload实时重载插件
交互模式： 纯命令行执行或 TUI 模式（obsidian 进入），支持自动补全和历史记录。
显著优点
1. 官方原生支持：与 Obsidian 深度集成，指令覆盖 95%+ 的 GUI 操作，稳定性优于第三方工具
2. 效率倍增：无需切换应用即可完成笔记创建、搜索、批量修改，适合键盘优先用户
3. 脚本化自动化：可集成到 Shell 脚本、Alfred/Raycast、Git hooks，实现工作流自动化
4. 开发友好：提供插件热重载、DOM 检查、截图、代码执行等调试工具
5. 版本控制：内置文件历史查询与恢复、差异对比功能
潜在缺点与局限性
1. 许可门槛：需 Catalyst 早期访问许可证（付费订阅制），免费用户无法使用
2. 运行依赖：Obsidian 应用必须保持运行，CLI 无法独立工作
3. 平台差异：Windows 支持尚不完善（需 Discord 获取 redirector），macOS/Linux 体验更佳
4. 学习曲线：命令参数较多，TUI 交互逻辑与常规终端工具略有差异
5. 安全风险：obsidian eval 可执行任意 JS 代码，共享脚本时需审查
适合人群
- 重度 Obsidian 用户，追求键盘驱动效率
- 开发者与插件作者，需要调试与自动化工具
- 习惯终端/CLI 工作流的工程师、研究员
- 需要批量操作笔记的数据管理者
常规风险
- 版本锁定：Obsidian 更新可能导致 CLI 行为变化，需关注版本兼容性
- 数据误操作：
delete permanent、move、property:set等命令无二次确认，脚本中需谨慎 - 权限问题：首次启用需修改系统 PATH，企业环境可能受限
- 同步冲突：CLI 修改与 Obsidian Sync 并发操作时可能产生冲突，建议配合
sync:status检查
安全评估
来源为官方团队开发（T1 可信度），但 obsidian eval 执行任意代码能力带来潜在风险，建议生产环境限制使用，敏感操作前备份 Vault。