同步问题排查
遇到文件未到齐或同步提示异常时，先保留本机内容，再按下面的顺序检查。多数情况不需要重新建库或删除插件配置。
先做这几项检查
在两台电脑分别打开 设置 → Hongdou for Obsidian → 红豆云Obsidian同步，核对：
- 插件版本：两端使用当前可用版本。出现“此设备的插件版本较旧”时，先更新插件。
- 同步账号：确认是同一账号，而不只是红豆客户端当前显示同一账号。
- 云端笔记库：两端连接同一份云库。各自新建的同名云库是独立数据。
- 同步状态：没有手动暂停，原设备的上传已经完成。
- 同步范围：文件类型已开启，所在文件夹没有被排除。
- 网络与空间：网络可用，账号有剩余空间。
首次同步或附件较多时，请保持相应笔记库打开，等待传输完成。可在活动日志 → 查看中搜索文件名，检查上传、下载或跳过原因。
另一台电脑没有收到文件
先在原设备检查文件是否已上传，再检查接收端。
- 新建的本地副本需要首次在 Obsidian 中打开，并启用插件，才会开始下载。
- 关闭某类附件或排除文件夹后，该范围内的内容不会继续按普通文件同步。
- 只登录账号，不会自动下载账号下的全部云库；请连接需要的已有云库。
- Obsidian 关闭期间不继续同步，重新打开相应库并联网后才会继续。
如果两端已各自新建了独立云库，先备份并核对哪一份内容最完整，再决定合并目标，不要反复新建云库尝试。
网络或授权提示
提示暂时无法连接文件服务
“暂时无法连接红豆云同步文件服务（UNAVAILABLE），请检查网络后重试。”表示插件暂时无法连接云端文件服务，不代表必须打开红豆客户端。
检查当前网络能否正常访问服务；网络恢复后，插件会自动重试。也可以点击立即同步，再观察活动日志。不要为这个提示反复换账号、重建云库或清空本机设置。
提示同步授权暂时无法续期
短暂网络故障时，插件会重试续期；尚未到期的授权可继续使用。确实到期后，同步可能暂时暂停，本机笔记仍可编辑。
网络恢复、回到应用或电脑唤醒后，插件会提前尝试恢复；持续失败时采用逐步延长的重试间隔，最长约 5 分钟。暂时无法联网时，可先继续本机编辑。
自动恢复沿用原账号和云库，不会取消你手动设置的暂停。如果界面明确要求重新授权或重新登录，请按该提示处理；这与普通网络重试不同。
提示另一种同步服务正在使用
如果当前库还启用了 Obsidian 官方 Sync，请先等待原服务同步完成，再到 设置 → 核心插件关闭同步（Sync），然后继续接入。
网盘托管目录也应先按迁入说明处理。避免两套同步工具同时修改同一个工作文件夹。
文件出现冲突
两台设备同时修改同一份笔记，尤其是在离线期间修改相同段落，可能产生冲突。切换设备前等待同步完成，可以减少这种情况。
选择 Markdown 冲突处理方式
在同步设置的冲突处理中选择：
- 自动合并（默认）：尝试合并两端的 Markdown 修改。内容重叠或无法确定时，仍可能需要人工核对。
- 创建冲突文件：保留收到的另一端版本，将本机版本另存为一份普通笔记，方便对照整理。
冲突副本名称类似“笔记名 (Conflicted copy 设备名 年月日时分).md”，它也会继续参与同步。核对并整理内容后，再决定是否删除多余副本。
这个选项按设备分别设置，只适用于 Markdown 笔记，不改变附件、Canvas 和配置文件原有的处理方式。
处理待解决的冲突
文件编辑区出现“此文件存在待处理的同步冲突。”时，点击提示，核对冲突内容并完成处理。选择稍后处理后，仍可再次点击该提示打开。
活动日志可按合并冲突筛选。整理前先保存重要内容副本，不要只根据文件时间判断哪一份需要保留。
主题、快捷键或社区插件没有生效
- 检查两端仓库配置同步是否开启了需要的类别。
- 社区插件的安装、启用和设置分别控制；只开其中一项，不会自动补齐另外两项。
- 有待应用内容时，点击查看并应用，核对差异和采用来源。
- 出现重新加载或应用并重新加载提示时，保存当前工作后按提示操作。
字体文件、插件额外资源或当前未覆盖的设置，需要在本机另行准备。完整范围见同步设置与选择性同步。
提示本机保存未完成
出现“本机保存未完成”或配置保存异常时，先保留本地修改，复制日志和诊断信息。不要直接删除插件数据、重置笔记库或用另一份库覆盖当前文件。
如果问题持续，请连同具体操作和提示联系支持，确认处理方式后再继续合并或恢复。
联系支持前准备什么
- 记下问题发生的大致时间、两端系统和插件版本，以及问题出现前做了什么。
- 在活动日志中保留相关记录；原始日志可能包含文件名，分享前先核对。
- 在同步设置的联系支持中点击复制诊断信息。诊断信息不包含笔记正文、文件路径或登录凭据。
- 说明是一份文件、某类附件，还是整个库无法同步，并附上必要的界面截图。
活动日志只保留本次运行最近的 1000 条，重启前先复制所需记录。无需发送密码、授权令牌或整份笔记库。
