Paperlib云同步功能使用注意事项与数据恢复指南

云同步机制解析

Paperlib作为一款学术论文管理工具，其云同步功能基于MongoDB Atlas实现metadata的云端存储。系统采用本地与云端双备份机制：

1. 本地数据核心存储于用户指定的库文件夹中
2. 云端仅同步论文元数据（metadata）
3. PDF文件始终保留在本地原始位置

典型问题场景

当用户开启云同步后执行"合并本地云端数据库"操作时，可能出现论文列表清空现象。这通常源于以下原因：

1. 云同步配置未正确完成
2. MongoDB Atlas连接参数设置错误
3. 本地库文件夹路径变更

数据恢复方案

本地数据恢复步骤

1. 立即登出云同步功能
2. 检查库文件夹设置是否指向原始论文存储路径
3. 重启Paperlib应用

预防性措施

1. 定期备份库文件夹内的realm数据库文件（扩展名为.realm）
2. 重要论文的PDF建议单独备份
3. 执行云同步前验证MongoDB连接状态

云同步配置要点

1. 确保MongoDB Atlas集群已正确配置IP白名单
2. 检查连接字符串中的用户名/密码有效性
3. 在Atlas控制台查看实时日志排查连接问题
4. 首次同步建议在小规模测试库上进行验证

技术建议

对于科研用户，建议：

1. 保持本地存储为主，云同步为辅的策略
2. 重要项目论文采用本地+云端+外部存储三重备份
3. 定期检查数据库同步状态
4. 云同步失败时优先检查网络连接和Atlas服务状态

通过理解这些技术原理和操作规范，用户可以安全高效地使用Paperlib的云同步功能，避免数据丢失风险。