Paperlib项目数据迁移与恢复指南：从CSV文件重建文献库

背景与需求场景

在学术研究过程中，文献管理工具Paperlib的用户可能会遇到需要跨设备迁移数据或恢复丢失元数据的情况。本文针对用户从CSV备份文件恢复文献标签和笔记的特殊需求场景，提供一套完整的技术解决方案。

核心问题分析

当用户从传统存储方式迁移到MongoDB云同步时，容易出现历史标签和笔记数据丢失的情况。虽然Paperlib支持Zotero格式导入，但直接导入CSV备份文件需要特定的处理流程。关键在于理解Paperlib的数据存储结构和迁移机制。

完整解决方案

第一阶段：数据备份

1. CSV文件备份：确保原始导出的CSV文件完好无损
2. PDF库备份：完整备份文献库文件夹中的所有PDF文件

第二阶段：环境准备

1. 创建新的空文件夹作为临时库目录
2. 在Paperlib设置中将库路径指向新文件夹
3. 登录MongoDB账户后执行全量数据清除
4. 登出MongoDB并恢复原始PDF库路径

第三阶段：数据重建

1. 关闭Paperlib应用
2. 删除库目录中的.realm等数据库文件
3. 确保安装0.0.27版本的entry-scrape扩展
4. 暂时卸载metadata-scrape扩展（可选）
5. 通过拖放方式导入CSV文件

第四阶段：云同步

1. 重新登录MongoDB账户
2. 执行本地到云端的数据迁移操作

技术要点说明

1. 数据隔离：通过切换库目录实现新旧数据的物理隔离
2. 扩展控制：特定版本的scrape扩展确保数据解析兼容性
3. 迁移顺序：必须先完成本地数据重建再进行云同步

风险控制建议

1. 操作前务必验证CSV文件完整性
2. 建议在操作前创建系统还原点
3. 分阶段验证数据恢复情况
4. 大文献库恢复时注意预留足够存储空间

典型问题排查

若恢复后发现部分数据异常：

1. 检查CSV文件编码格式应为UTF-8
2. 确认PDF文件哈希值与记录一致
3. 验证扩展版本是否符合要求
4. 检查系统字符集设置

本方案不仅适用于意外数据恢复场景，也可作为常规数据迁移的标准化流程参考。通过系统化的操作步骤，能够最大限度保证文献元数据的完整性和一致性。