Obsidian CLI

核心功能

Obsidian CLI 是官方推出的命令行工具，为 Obsidian 知识库提供程序化控制能力。其核心架构基于 IPC（进程间通信），要求 Obsidian 1.12+ 版本并保持后台运行。

主要能力

笔记生命周期管理：支持创建、读取、更新、删除（CRUD）操作，可通过 wikilink 名称或精确路径定位文件，支持模板创建和批量追加/前置内容。

任务与日程：深度集成 Daily Notes，可提取、过滤（待办/已完成）、切换任务状态，支持跨 vault 的全局任务查询。

知识库导航：提供双向链接追踪（backlinks/outgoing）、孤儿文件检测、死链识别、大纲结构提取等图谱分析功能。

元数据操作：标签统计、属性读写、高级搜索（支持 JSON 输出和上下文匹配）。

开发者工具：JavaScript 代码执行、插件热重载、调试工具（截图、控制台、错误追踪）。

显著优点

• 原生集成：官方出品，IPC 通信稳定可靠，无需第三方 API
• 多 vault 支持：通过参数或工作目录自动识别目标库
• 自动化友好：适合脚本、定时任务和 AI 工作流集成
• Linux 深度适配：提供 Electron 沙盒问题的解决方案

局限性与风险

硬性依赖：必须保持 Obsidian GUI 运行，无法纯后台使用。Arch Linux 用户需额外配置 PrivateTmp=false 解决 IPC 权限问题。

安全边界：eval 命令可执行任意 JavaScript，存在代码注入风险；截图/开发者工具暴露敏感界面内容。

平台差异：wrapper 脚本针对 Arch Linux 设计，其他发行版需自行适配 Electron 参数处理。

适用人群

高级用户、开发者、需要自动化笔记工作流的内容创作者，以及将 Obsidian 作为第二大脑进行量化管理的知识管理实践者。

常规风险提醒

• 删除操作移至系统回收站，非永久删除
• 多 vault 场景下务必显式指定 vault= 参数避免误操作
• 非交互式使用前需确保 Obsidian 进程已启动

核心用法

obsidian-cli 是一个纯文档型 Skill，用于指导用户通过官方 Obsidian CLI（v1.12+）进行笔记库自动化管理。该 Skill 本身不执行任何代码，仅提供完整的命令参考和配置说明。

主要功能覆盖

• 日常笔记：创建、读取、追加/预写每日笔记
• 文件操作：创建、读取、移动、删除笔记，支持模板创建
• 搜索：全文检索、作用域搜索、JSON 格式输出
• 任务管理：跨文件任务聚合、完成状态切换、过滤未完成任务
• 标签与属性：标签统计、属性读写、元数据管理
• 链接分析：反向链接、孤立文件、死链接检测
• 开发者工具：JavaScript 执行、截图、开发者控制台
• 多库支持：基于 CWD 或显式指定目标库

显著优点

1. 功能全面：覆盖 Obsidian CLI 全部官方功能，从基础文件操作到高级开发者工具
2. 实用性强：特别适合构建自动化工作流（如结合 cron 定时生成日报、自动归档任务）
3. IPC 架构安全：CLI 通过本地 IPC 与运行中的 Obsidian 通信，不直接操作文件系统，避免数据损坏风险
4. 参数设计清晰：支持 wikilink 风格文件引用（file=Name）和精确路径（path=）两种模式
5. 多库切换灵活：自动识别当前目录所属库，或显式指定目标库

潜在局限

1. 依赖运行实例：必须保持 Obsidian 桌面端运行，无法纯后台操作
2. 平台限制：官方 CLI 仅支持桌面端（Windows/macOS/Linux），移动端不可用
3. Linux 配置复杂：Arch Linux 等平台需处理 Electron 标志注入、PrivateTmp 等系统级配置
4. T3 来源：作者为个人开发者 adolago，无官方背书
5. 无版本锁定：文档未声明与特定 Obsidian CLI 版本的兼容性追踪

适合人群

• Obsidian 重度用户，希望用脚本自动化笔记工作流
• 开发者需要批量操作笔记库或集成到其他工具链
• 团队使用 Obsidian 作为知识库，需自动化日报/周报生成
• 习惯终端操作、追求效率的极客用户

常规风险

| 风险点 | 说明 | 缓解措施 |

|--------|------|----------|

| eval 命令误读 | 文档中的 `obsidian eval` 是 Obsidian 内部 JS 沙箱，非 shell eval | 理解 CLI 命令作用域 |

| 多库操作误触 | 未指定 `vault=` 时可能操作意外库 | 脚本中始终显式指定 vault |

| IPC 连接失败 | Obsidian 未运行或系统配置问题 | 使用前检查进程状态 |

| 来源可信度 | T3 级别个人项目 | 内容已人工可读，无可执行代码 |

安全评估总结

安全扫描显示该 Skill 为纯 Markdown 文档，无可执行代码、无网络通信、无敏感数据收集。安全等级 S，来源可信度 T3。主要风险已确认为误报（eval 命令示例实为 Obsidian 合法功能）。建议在可控环境中配合人工审查使用。