核心功能
Obsidian CLI 是 Obsidian 1.12+ 官方推出的命令行工具，通过 IPC 与运行中的 Obsidian 实例通信，实现 Vault 的自动化管理。涵盖四大能力域：
1. 笔记与文件操作
支持按名称（维基链接解析）或精确路径读写笔记，提供创建、删除、移动、追加、前置内容等完整生命周期管理，并支持从模板创建笔记。
2. 搜索与任务管理
内置全文搜索（支持上下文匹配、作用域限定、JSON 输出格式），以及强大的任务系统——可提取每日笔记任务、跨 Vault 查询待办事项、切换任务完成状态，并输出详细位置信息。
3. 元数据与图谱分析
提供标签统计、属性读写、双向链接查询、孤儿文件/死胡同文件检测、断链识别及文档大纲提取，助力知识图谱维护。
4. 开发者与多 Vault 支持
支持 JavaScript 代码执行、截图、开发者工具控制、控制台日志及错误捕获；同时原生支持多 Vault 切换（通过 CWD 自动识别或显式指定）。
显著优点
- 官方出品：与 Obsidian 深度集成，API 稳定性有保障
- 功能完备：覆盖日常笔记工作流的 90% 以上场景
- 自动化友好：适合结合 cron、Git Hooks、 Alfred/Raycast 等工具链
- 多平台：支持 macOS、Windows、Linux（需处理 Electron 标志冲突）
局限性与风险
- 必须保持 Obsidian 运行：CLI 依赖 IPC，无法独立工作
- Linux 配置复杂：需处理 Electron 标志注入、systemd 服务的
PrivateTmp等问题 - 权限敏感：可执行任意 JavaScript（
eval命令），存在代码注入风险 - 无远程能力：仅限本地 Vault 操作
适合人群
- 重度 Obsidian 用户寻求自动化工作流
- 开发者构建笔记相关的脚本和工具链
- 需要批量处理笔记元数据的内容管理者
安全提示
obsidian eval 命令可执行任意 JS 代码，避免将用户输入直接传入；建议在受控环境使用，敏感操作前备份 Vault。