CLI 命令（Obsidian CLI）

Sync Vault 在 Obsidian CLI 中注册了 sync-vault: 命名空间下的自定义命令。AI Agent、自动化脚本和高级用户可以通过终端直接操作云盘，无需打开浏览器或插件界面。

前置条件

Obsidian CLI — 在 Obsidian 中启用：设置 → 通用 → 命令行界面（需要 Obsidian 1.12+ 安装包）。
Obsidian 保持运行 — CLI 命令需要 Obsidian 应用正在运行才能执行。

可用命令

命令	用途	主要参数
`sync-vault:help`	显示 CLI 帮助	`help=true`
`sync-vault:doctor`	诊断插件健康状态	`cloud`
`sync-vault:info`	获取账户和存储信息	`cloud`
`sync-vault:list`	列出云盘目录文件	`path` `cloud` `limit` `offset` `type` `minSize` `modifiedAfter` `recursive`
`sync-vault:search`	搜索云盘文件	`query` `cloud` `limit` `offset` `path` `type`
`sync-vault:read`	读取云盘文件内容	`path` `cloud` `maxLength`
`sync-vault:config`	查看或修改配置	—
`sync-vault:device`	管理设备	—

使用方法

在终端中使用 obsidian 前缀运行命令：

obsidian sync-vault:list path=/ cloud=aliyun
obsidian sync-vault:search query="会议记录" cloud=baidu
obsidian sync-vault:read path=/笔记.md cloud=quark maxLength=8192
obsidian sync-vault:info cloud=onedrive
obsidian sync-vault:doctor cloud=aliyun

所有子命令支持 help=true 查看详细用法：

obsidian sync-vault:list help=true

示例

列出阿里云盘中的 PDF 文件：

obsidian sync-vault:list path=/Documents cloud=aliyun type=pdf

在夸克网盘中搜索 Markdown 文件：

obsidian sync-vault:search query=obsidian cloud=quark type=markdown

从百度网盘读取文件内容：

obsidian sync-vault:read path=/Notes/Welcome.md cloud=baidu maxLength=4096

用于 AI Agent

这些命令专为 AI Agent 工作流设计。Agent 可以直接运行 CLI 命令来探索和读取云盘文件，无需浏览器或插件 UI。配合 MCP 服务器可实现更深入的功能集成。