同步失败或冲突 — 逐步解决

第一步：确认连接状态

NoteGen 同步设置中看当前平台显示什么：

• "已连接" → 通道没问题，看下面的冲突处理
• "连接失败" → 通道不通，继续第二步

第二步：连接失败排查

Git 平台

1. Token 权限——GitHub 需要 Contents 读写（自动建仓库还需要 Administration 读写）；Gitee 需要 user_info + projects；GitLab 需要 api scope
2. 仓库名——格式对吗？GitHub 是 owner/repo，Gitee 也是
3. 分支名——分支存在吗？（NoteGen 不会自动创建分支）
4. Token 过期——去服务商控制台查有效期限
5. 网络——国内访问 GitHub 可能需要代理；Gitee 通常直接能通

S3

1. Access Key ID / Secret Access Key——复制正确？
2. Region / Endpoint / Bucket——都对吗？S3 兼容服务的 Endpoint 格式多样，查服务商文档
3. 权限——Bucket 对这个 AK/SK 有读写权限吗？
4. 桶名——存在吗？拼对了吗？

WebDAV

1. 服务器 URL——对吗？能在浏览器打开看看吗？
2. 用户名/密码——有些 WebDAV 服务需要应用专用密码（不是登录密码）
3. HTTPS——建议用 HTTPS，HTTP 可能被服务端拒绝

第三步：同步队列卡住

同步状态显示"待上传"或"失败"：

1. 先等一会——网络波动可能导致临时失败，稍后会重试
2. 手动触发——点同步菜单里的"立即同步"
3. 查看诊断——同步菜单里可能有诊断信息，看具体哪步错了
4. 停止自动同步——如果一直卡着，先关掉自动同步，手动排查清楚再开

第四步：冲突处理

同步时出现"有 N 个冲突待处理"：

1. 先导出本地 ZIP 备份
2. 理解三方修改内容——哪些内容两边都改了
3. 选择处理方式（详见同步分组的冲突处理页面）：

• 合并两边内容（推荐先试这个）
• 拉取远程覆盖本机
• 上传本机覆盖远程

第五步：仍未解决

• GitHub/Gitee/GitLab：在仓库的 Commit 页面看看有没有 NoteGen 提交的记录
• S3：登录控制台看 Bucket 里的文件变化时间
• WebDAV：在支持 WebDAV 的文件管理器（如 Windows 映射网络驱动器）里看看能不能直接访问

确认远程侧状态后，再回到 NoteGen 里选处理方式。