跳转到内容
Sync Vault Docs

快速开始

IMPORTANT

注意：

  1. 使用 Sync Vault 时，请禁用其他同步插件，包括官方的 Obsidian Sync。
  2. 不要将您的仓库放在 iCloud 同步文件夹或百度同步空间等同步目录中，否则可能会发生不可预知的错误。
  3. 建议在云盘同步期间禁用代理，因为代理可能导致云盘访问异常。

安装

Section titled “安装”

从 Obsidian 社区插件市场安装 Sync Vault：点击此处 一键安装，或在 设置 → 第三方插件 → 社区插件市场 中搜索 Sync Vault 安装并启用。

快速设置

Section titled “快速设置”

授权云盘

Section titled “授权云盘”
  1. 打开 设置 → Sync Vault，插件默认停在 开始使用 标签页。
  2. 在 选择云服务 区域选择您的云盘（阿里云盘、百度网盘、夸克网盘、OneDrive 等；带 PRO 徽标的云盘需要专业版）。
  3. 点击 点击授权，按照屏幕提示完成云盘授权（多数云盘会打开浏览器登录）。
TIP

欢迎页面 授权成功后，您将被重定向到 欢迎页面。请按照那里的步骤操作，或参考下方说明。

授权完成后，按钮会变为 撤销授权，点击可随时撤销。

NOTE

免费版与专业版 免费版即可使用阿里云盘、InfiniCloud、坚果云、腾讯 COS 等云盘手动同步。 带 PRO 徽标的云盘（百度网盘、夸克网盘、OneDrive）以及自动同步、实时协作、云盘浏览器等能力需要专业版：在 开始使用 → 获取专业版 中绑定激活码和邮箱即可解锁，详见价格页面。

打开工作台

Section titled “打开工作台”

点击左侧边栏的 ☁️ 图标（移动端：点击底部菜单栏 ☰，在其中找到 ☁️ 图标）打开 Sync Vault 仪表盘。顶部是统一搜索栏，可同时搜索本地与云端文件；下方是 云服务工作台，由一张张卡片组成——刚打开时工作台是空的，点击 同步工作流 等快捷预设，或点击右下角 ➕ 从 Widget 库中添加卡片：

NOTE

工作台速览

  • 顶部：切换云盘，查看同步状态（已就绪 / 待同步 / 同步中 / 离线）与云盘容量。
  • 搜索栏：搜索本地与云端文件；点击文件夹按钮打开 云盘浏览器（专业版）。
  • 卡片区：全宽卡片在上、半宽卡片在下；点击卡片右上角按钮可 上移 / 下移 / 刷新 / 移除；点击右下角 ➕ 打开 添加 Widget，从 Widget 库或快捷预设（同步工作流 / AI 工作流）中挑选想用的卡片。
  • 待同步：同步状态与最近同步记录；自动模式下可 启动/停止同步，另有 空运行 (Dry Run)、重置同步基线 等操作。
  • 速览：云端文件、已节省空间、本地文件、视频标注与云盘容量。
  • AI 数据引擎：内置 MCP Server 的运行状态与开关。
  • Widget 库中还有视频笔记、实时活动、云链接管理、协作、Connector 管理、Agent 会话等卡片。

手动同步与云端浏览

Section titled “手动同步与云端浏览”

工作台里有两种「浏览器」，用途不同：

  • 同步浏览器：受控模式下，在 待同步 卡片中点击 同步浏览器 按钮，手动勾选文件上传到云端或下载到本地，适合需要精确控制同步内容的场景。
  • 云盘浏览器（专业版）：点击搜索栏的 打开云盘浏览器 按钮，像资源管理器一样直接浏览云盘目录；也可以在文件上右键选择 在云端打开，或使用命令 打开云端资源浏览器。

三种同步方式可单独或组合使用，详见 同步：

  • 受控模式：手动选择文件上传或下载，精准控制同步内容。
  • 自动模式：插件按设定周期自动将本地仓库与云端保持同步，无需手动干预（专业版）。
  • 实时同步：基于 WebRTC 的设备间直连，多端毫秒级协作（专业版）。

配置 MCP

Section titled “配置 MCP”

工作台的 AI 数据引擎 卡片可一键启动内置 MCP Server；详细配置步骤请参考 MCP 服务器配置指南（Claude、Cursor、Trae 等）。

DONE

恭喜您，开启 Sync Vault 之旅吧！ 🍻