官方 Obsidian CLI 工具，支持命令行管理笔记、搜索内容、操作任务、管理插件主题及同步，需 Catalyst 许可证和 Obsidian 运行环境。
说明：
## 核心用法
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。
会员专属
