安装和开始使用同步
本页介绍如何让当前 Obsidian 笔记库开始同步，以及如何在另一台电脑继续使用同一套笔记。
准备工作
- 使用 Obsidian 1.11.4 或更高版本，并在需要同步的笔记库中安装、启用 Hongdou for Obsidian。
- 准备好红豆账号，并确认账号的同步服务和空间可用。
- 如果笔记库已有重要内容，先复制一份独立备份。
- 如果正在使用官方 Sync 或网盘同步，先按迁入说明完成切换准备。
安装和启用插件
可在红豆客户端的设置 → 插件与集成 → Obsidian 连接中管理 Obsidian 端插件。先在 Obsidian 中打开一次目标笔记库，便于客户端识别；安装或替换文件前，按安装页提示完全退出 Obsidian。
安装后重新打开目标库，在设置 → 第三方插件中启用 Hongdou for Obsidian。插件按本地笔记库安装，一份库安装成功，不代表其他库也已启用。具体安装方法见原插件使用说明。
也可以不安装红豆客户端，直接下载插件，并安装到Obsidian客户端安装说明。
登录同步账号
- 打开 Obsidian 设置 → Hongdou for Obsidian → 红豆云Obsidian同步。
- 点击登录同步账号。
- 按提示完成账号登录和同步授权。
在“红豆云Obsidian同步”中登录同步账号；上方的客户端联动授权另行管理。
红豆客户端已运行并登录时，可以快捷授权；也可以使用插件打开的网页登录窗口。授权完成后，同步可独立运行，红豆客户端无需保持打开。
登录前，设置页只提供账号入口；连接云库后，才可使用相应的同步状态、空间及文件恢复功能。
为当前笔记库开始同步
还没有云端笔记库
- 在选库窗口中点击新建云端笔记库。
- 填写容易辨认的名称，通常可沿用当前本地库名称。
- 如需先排除部分内容，打开窗口中的同步内容调整范围。
- 点击创建并同步。
正常连接后会直接开始同步，无需再经过一次“开始同步”确认。
账号已有云端笔记库
在选择云端笔记库窗口中，找到要使用的云库，点击连接并同步。
已有笔记请选择对应云库；图中的库名仅为示例。也可先通过“同步内容”调整范围。
主动登录后，若账号只有一份可连接云库，且与当前本地库同名，插件会直接使用它，省去选库步骤。已经确认过连接的库按原目标继续；手动暂停的库不会因重新登录而自行恢复。
本机已有笔记时，会出现合并确认。核对目标后点击合并并同步；插件会先保存本机备份，再合并两端内容。同路径文件可能产生冲突，处理方式见同步问题排查。
已有内容时先核对合并目标；点击“合并并同步”后开始备份和同步。
取消选库或合并确认后，账号可以保持登录，稍后再点击选择云端笔记库继续。
在另一台电脑连接同一套笔记
- 在另一台电脑安装并启用插件，登录同一同步账号。
- 打开云端笔记库 → 管理，选择已有云库并点击连接。
- 根据本机情况，选择连接同名空库、与已有库合并，或另建本机笔记库。
- 核对连接方案。需要新建本地副本时，选择存放文件夹，再点击确认连接。
- 新副本创建后，在 Obsidian 仓库切换器中选择“打开本地仓库”，打开所提示的文件夹，并按提示信任、启用插件。
新建副本首次在 Obsidian 中打开后，才会开始下载。需要同时连接多份云库时，使用连接多个笔记库，详见账号与笔记库管理。
如果已经打开一份本地库，也可直接在该库连接对应云库；空库会接收云端内容，有内容的库会先确认合并。
确认同步已经生效
等待设置中的同步状态显示本次同步完成，再切换到另一台电脑检查。可以先新建一条简短笔记，确认另一端收到后，再继续整理大量文件。
“本次同步已完成”表示当前待处理内容已经完成，插件仍在等待后续修改；右侧保留暂停同步按钮属于正常状态。
接下来可阅读同步设置与选择性同步，决定这台电脑需要同步的附件、主题和插件。
