SuperAPI AI 工具集

obsidian-cli

通用与其它

查看项目

更新于 10-16 04:59

技能介绍

用途:该技能用于安装、启用并操作 Obsidian 官方桌面 CLI,从终端对正在运行的 Obsidian 应用执行笔记自动化。官方方向是桌面应用,而非无头同步(无头场景属于 Obsidian Headless)。

主要能力:支持单命令与带自动补全、历史记录的交互式 TUI;可定向库与文件;提供日常命令 daily、daily:append、search、read、create、tags、tasks、diff;通用命令 help、version、reload、restart;开发者命令 devtools、plugin:reload、dev:screenshot、eval,便于插件与主题的自动测试和调试;支持 --copy 复制输出,部分列表命令支持 format=json/tsv/csv/md/paths;并提供 obsidian:// URI 动作 open、new、daily、unique、search、choose-vault。

使用方式:先在 Obsidian 设置 → 通用中启用 Command line interface 并完成注册,再运行本地脚本 bash scripts/install.sh。单命令如 obsidian help;TUI 可直接运行 obsidian 后输入 help。库定向用 vault=<name> 或 vault=<id>,须放在命令前作第一个参数;文件定向用 file=<name>(wikilink 风格)或 path=<path>(从库根算起的精确路径),都不给时常默认活动文件。参数为 name=value,含空格的值加引号,布尔项为裸开关如 open、overwrite,内容中换行用 \n、制表用 \t。URI 示例:obsidian://open?vault=my%20vault&file=my%20note。

适用场景:需要用脚本、别名或外部工具驱动 Obsidian 的场景,以及插件与主题的调试、截图和重载。

限制:CLI 自动化针对桌面应用而非无头同步;daily 需启用 Daily notes 插件,unique 需启用 Unique note creator 插件;应用须在运行,或首个命令会启动它;Linux 可能需要额外的符号链接或 PATH 处理;开发者命令会改变应用或插件状态,应谨慎使用;URI 值须正确编码,path= 会覆盖 vault 和 file,paneType=window 仅限桌面。文档中版本要求按原文:CLI 使用需 Obsidian 1.12 安装器,同时页面也提到升级到最新安装器 1.11.7 与最新抢先版 1.12.x。具体收费与价格资料暂未提供。