SuperAPI AI 工具集

obsidian-cli

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

用途:该技能针对 Obsidian 笔记库操作。用户已安装 obsidian CLI,它通过本地 REST API 与运行中的 Obsidian 桌面实例通信,可搜索、读取、创建、修改和分析笔记,而不直接触碰磁盘文件。核心原则是用 CLI 做发现与元数据操作,用直接文件访问做精细编辑,二者结合形成“先查找、后编辑”的流程。

主要能力:全文搜索与带行上下文搜索(search、search:context);文件、文件夹、大纲、字数、最近文件等读取;创建、追加、前置写入笔记;读写、设置、删除属性(frontmatter)与标签;反向链接、出链、孤立笔记、死端、未解析链接等图谱分析;待办列表、筛选与切换完成状态;日记读取、路径获取、追加与前置;模板列表、读取与插入;书签、历史版本、diff、Bases 数据库查询、插件/主题/片段、库信息与统计;在 Obsidian UI 中打开文件或执行命令。

使用方式:语法为 obsidian <command> [key=value ...] [bare-flags]。file= 按名称解析(类似 wikilink,无需扩展名),path= 为库相对精确路径,含空格的值需加引号,content 中换行用 \n,vault= 指定库,format=json 输出结构化结果,多数命令省略 file=/path= 时默认作用于当前活动文件。

安全与限制:读命令与多数列表命令为安全操作;append、prepend、create、property:set、task 等为修改操作;delete、move、rename、history:restore、插件/主题/片段启停、reload、restart、command 等属破坏性操作,应先与用户确认。使用前 Obsidian 桌面应用必须处于运行状态,否则报连接拒绝;部分命令需显式指定文件避免“无活动文件”;多库环境需用 vault= 指定。完整 80+ 命令及选项参见 references/command-reference.md。