# Nimbus Sync — Obsidian 实时同步插件

专为自托管 **Nimbus Server** 定制的 Obsidian 双向实时同步插件。

## 功能特性
- ⚡ **WebSocket 极速双向同步**：秒级同步笔记的新建、修改、重命名与删除。
- 📦 **二进制与图片附件支持**：完整支持 Markdown 文档及图片等附件文件。
- 🔀 **智能并发冲突保护**：并发编辑时自动生成冲突副本保护笔记不被覆盖。
- 📊 **多 Vault 切换与即时创建**：直接在插件设置面板中选择或新建远程 Vault。
- 💓 **自动重连与心跳保活**：断网自动尝试重连，保持多设备在线状态。

## 安装方法

### 方式一：通过 BRAT 一键安装（推荐 · 支持桌面端与移动端）

1. 在 Obsidian 社区插件市场中搜索并安装 **BRAT** 插件。
2. 打开 BRAT 设置，点击 **Add Beta plugin**。
3. 粘贴仓库地址：`https://github.com/lengedliu/nimbus-vault-sync`，点击确认。
4. BRAT 将自动完成下载安装并启用 **Nimbus Sync**。

### 方式二：手动安装

1. 打开 Obsidian 笔记库，进入 `.obsidian/plugins/` 目录。
2. 新建名为 `nimbus-sync` 的文件夹。
3. 将本目录下的 `manifest.json`、`main.js`、`styles.css` 复制到该文件夹中。
4. 打开 Obsidian -> 设置 -> 第三方插件 -> 刷新已安装列表 -> 开启 **Nimbus Sync**。

## 配置与连接

- **一键导入（推荐）**：在 Nimbus Web 管理控制台点击 **「⚡ Obsidian 连接指引」** ➔ **「下载 data.json」**，保存至 `.obsidian/plugins/nimbus-sync/data.json` 即可免配置启动。
- **手动设置**：在 Obsidian 插件设置中填入 Server URL、Vault ID 及专属 Token 即可开始全双工实时同步。

---