附件同步、WebDAV 与备份
红豆中的“文献数据同步”和“附件文件同步”是两套相互配合的机制。题录、分类、标签和笔记已经同步，并不一定代表 PDF、EPUB 等附件也已经上传或下载。红豆 1.0.8 优化了 WebDAV 配置、验证、认证和失败恢复流程，让附件同步的设置更清晰、连接更稳定。
先分清同步内容
- 数据同步：同步文献条目、分类、标签、笔记等数据库内容；
- 附件同步：同步 PDF、EPUB、网页附件及其他文件；
- 下载策略：决定另一台设备何时把云端附件下载到本机；
- 本地备份：保存完整数据目录，用于误删、损坏或迁移时恢复。
附件同步不能替代完整备份，WebDAV 也不是文献数据库的唯一副本。
打开附件同步设置
- 打开“编辑 → 设置”（macOS 中从应用菜单进入“设置”）。
- 选择左侧“同步”。
- 先确认红豆账号的数据同步设置正常。
- 向下找到“文件同步”区域。
- 为“我的文库”选择红豆智能文献管理云存储或 WebDAV。
- 按需要设置个人文库和群组文库的附件下载策略。
附件存储方式
“我的文库”附件可以选择：
- 红豆智能文献管理云存储：使用红豆账号对应的附件存储；
- WebDAV：使用你自己的 WebDAV 服务器保存附件。
群组文库的可用方式和权限取决于当前设置及账号权限。切换附件存储方式前，建议先确认现有附件已经完整保存在本机，并备份数据目录。
配置 WebDAV
- 在“设置 → 同步 → 文件同步”中选择“WebDAV”。
- 点击“配置 WebDAV”。
- 选择协议。远程服务器建议使用 HTTPS。
- 在地址栏填写服务商提供的服务器地址或基础路径。协议与地址分开填写。
- 输入 WebDAV 用户名和密码；如果服务商要求应用专用密码，请使用应用专用密码。
- 点击“验证服务器”并等待完整检查。
- 只有验证成功后，“保存”按钮才可用。
- 保存配置，返回同步设置并执行同步。
地址怎样填写
- 协议在单独的下拉框中选择，地址栏不要重复填写协议；
- 按 WebDAV 服务商说明填写主机名和必要的基础路径；
- 红豆会自动在地址末尾使用独立的
/hongdou/目录，用户不需要手工添加； - 不要把其他应用的专用附件目录直接作为红豆目录；
- 远程服务优先使用 HTTPS，避免用户名、密码和附件内容以不安全方式传输；
- 修改服务器地址后必须重新验证。
例如，服务商要求的基础路径是 dav.example.com/webdav/user/，只需按界面分别选择 HTTPS 并填写该地址，不要再追加 hongdou。
验证过程会检查什么
红豆不会只测试“能否登录”，而是依次确认服务器具备附件同步所需能力：
- 服务器是否支持 WebDAV；
- 目标目录是否可以访问；
- 必要目录是否能够创建；
- 测试文件是否能够写入；
- 写入内容是否能够读取；
- 测试文件是否能够删除。
只有这些检查全部通过，配置才能保存。这样可以提前发现“能登录但没有写入权限”“能上传但不能删除”等问题。
如果验证失败，红豆会恢复到原有有效配置，避免错误地址覆盖可用设置；认证失败时，本次输入的密码会被清空，需要修正后重新填写。
认证优化
红豆 1.0.8 支持常见的 Basic 和 Digest 认证，并改进了认证信息缓存：
- 不同服务器的认证状态相互隔离；
- 同一服务器在有效会话中可减少重复的 401 认证往返；
- 修改地址、用户名或密码后会按新配置重新验证；
- 认证失败不会把本次错误密码保存为有效配置。
这些优化主要改善频繁同步、多附件请求和部分 Digest 服务器下的连接体验，不会绕过服务器权限控制。
附件下载策略
个人文库和群组文库可以分别设置下载方式：
按需下载
条目先同步，需要打开附件时再从服务器下载。
适合：
- 本机磁盘空间有限；
- 文库附件很多；
- 只在当前设备阅读部分文献。
注意：离线前应提前打开或下载需要的附件。
同步时下载
同步时把可用附件下载到当前设备。
适合：
- 希望离线访问文献；
- 新电脑需要完整准备附件；
- 本机空间充足，网络稳定。
首次同步大量附件可能耗时较长，也会占用更多本地空间和网络流量。
多设备使用建议
- 在旧设备确认文献数据和附件已经完成同步。
- 对红豆数据目录做一次完整备份。
- 在新设备登录同一红豆账号。
- 配置相同的附件存储方式和 WebDAV 服务。
- 先完成数据同步，再按下载策略获取附件。
- 随机打开几篇 PDF，确认附件可以正常下载和阅读。
不要在多台设备上同时修改 WebDAV 地址或切换存储服务。切换前先让一台设备完成上传，再逐台调整并验证。
常见问题
验证提示未授权或密码错误
检查用户名、密码和账号权限。启用双重验证的服务通常需要应用专用密码。认证失败后请重新输入密码。
提示服务器不支持 WebDAV
确认使用的是 WebDAV 地址，而不是普通网页、网盘分享页或管理后台地址。向服务商核对正确入口。
能登录但验证写入或删除失败
当前账号可能只有读取权限，或服务端禁止创建目录、覆盖或删除文件。调整服务器权限后重新验证。
地址正确但始终无法连接
检查协议、端口、基础路径、证书和网络代理。远程地址应使用 HTTPS；自签名或过期证书可能导致连接失败。
条目已经出现，但 PDF 没有下载
这是数据同步和附件同步进度不同造成的。检查附件下载策略，确认另一台设备已经上传附件，再执行同步或打开附件触发按需下载。
按需下载时离线打不开 PDF
文件尚未下载到本机。联网后先打开附件或改为同步时下载，完成后再离线使用。
切换 WebDAV 后找不到原附件
切换服务不会自动保证旧服务器上的所有文件已经迁移。先恢复原配置并确认附件完整，再备份本地文件后重新规划切换。
备份建议
同步服务用于多设备保持一致，无法防止所有误删、账号问题、服务器故障或数据库损坏。建议定期备份：
- 完整的红豆数据目录；
- 原始 PDF 和其他重要附件；
- 迁移数据包和关键导出文件；
- WebDAV 服务的重要服务器端数据。
更换电脑、切换账号、修改 WebDAV、迁移数据目录或大批量整理文献前，应先制作一次可恢复的完整备份。
