从Calibre迁移到Citadel：完整数据转移教程与注意事项

从Calibre迁移到Citadel：完整数据转移教程与注意事项

【免费下载链接】citadelManage your ebook library without frustrations. Calibre compatible.项目地址: https://gitcode.com/gh_mirrors/ci/citadel

Citadel是一款专为电子书爱好者设计的高效图书馆管理工具，完全兼容Calibre数据库格式。本教程将指导您如何安全、快速地将现有Calibre图书馆迁移到Citadel，享受更现代的界面和更流畅的管理体验。

📋 迁移前准备工作

在开始迁移前，请确保您已完成以下准备工作：

1. 备份Calibre数据：在进行任何迁移操作前，务必备份您的Calibre图书馆。默认情况下，Calibre数据存储在~/Calibre Library目录下。您可以通过复制整个目录来创建备份。

2. 安装Citadel：从仓库克隆并安装最新版本的Citadel：

   git clone https://gitcode.com/gh_mirrors/ci/citadel cd citadel # 按照项目README中的安装说明进行安装

3. 检查系统要求：确保您的系统满足Citadel的运行要求，包括适当版本的Node.js和Rust环境。

🔄 迁移步骤详解

1. 确认Calibre数据库结构

Citadel使用与Calibre兼容的数据库结构，但为了确保迁移顺利，建议先了解数据库中的关键表结构。Calibre的核心数据表包括：

• books- 存储书籍基本信息
• books_authors_link- 书籍与作者的关联
• books_tags_link- 书籍与标签的关联
• books_series_link- 书籍与系列的关联

Citadel已实现这些表的完整CRUD操作，确保数据迁移后所有关系都能正确保留。

2. 执行数据迁移

Citadel提供了专门的迁移工具，可以直接导入Calibre的数据库文件。按照以下步骤操作：

1. 打开Citadel应用程序
2. 在欢迎界面选择"导入Calibre图书馆"选项
3. 浏览并选择您的Calibre数据库文件（通常位于Calibre Library/metadata.db）
4. 点击"开始导入"按钮，系统将自动处理数据迁移

Citadel架构概览：展示了数据迁移过程中的数据流向

3. 验证迁移结果

迁移完成后，建议进行以下检查以确保数据完整性：

1. 检查书籍总数是否与Calibre中一致
2. 随机选择几本书，验证元数据（标题、作者、标签等）是否完整
3. 确认书籍文件已正确关联
4. 测试基本操作（搜索、分类、添加注释等）

⚠️ 注意事项与常见问题

数据完整性保障

Citadel实现了与Calibre兼容的数据库触发器，确保数据完整性：

• 自动生成字段：系统会自动生成UUID和排序字段，无需手动干预
• 级联删除：删除书籍时会自动清理相关记录，避免孤儿数据
• 外键约束：防止删除仍被引用的作者、标签等实体

这些触发器在src-tauri/libcalibre/src/persistence.rs中实现，确保数据库操作符合Calibre的数据规范。

处理特殊情况

1. 大型图书馆迁移：对于包含数千本书的大型图书馆，建议分批次迁移，或在非高峰时段进行迁移。

2. 自定义字段：如果您在Calibre中使用了自定义字段，可能需要手动映射这些字段到Citadel的相应属性。

3. 插件数据：Calibre插件生成的特殊数据可能无法完全迁移，建议在迁移前记录这些数据。

🔍 故障排除

如果在迁移过程中遇到问题，可以尝试以下解决方法：

1. 数据库锁定错误：确保迁移时Calibre应用程序已关闭，避免数据库文件被锁定。

2. 数据不完整：检查迁移日志文件，位于~/.citadel/migration.log，查找可能的错误信息。

3. 性能问题：对于大型图书馆，考虑增加系统内存或使用SSD存储来提高迁移速度。

📚 迁移后优化

成功迁移后，您可以通过以下方式优化您的Citadel图书馆：

1. 更新元数据：利用Citadel的批量编辑功能更新书籍元数据
2. 整理标签系统：使用Citadel的标签管理工具优化您的分类系统
3. 设置自动备份：配置Citadel的自动备份功能，确保数据安全

Citadel的存储架构在src/stores/books.ts中实现，提供了高效的缓存机制和状态管理，比传统的Calibre架构更具性能优势。

🎯 总结

通过本教程，您已成功将Calibre图书馆迁移到Citadel。Citadel不仅保留了Calibre的核心功能，还提供了更现代的用户界面和更高效的性能。随着Citadel的不断发展，您将获得更多高级功能和更好的用户体验。

如果您在迁移过程中遇到任何问题，欢迎查阅官方文档或提交issue寻求帮助。祝您使用Citadel管理电子书库愉快！

【免费下载链接】citadelManage your ebook library without frustrations. Calibre compatible.项目地址: https://gitcode.com/gh_mirrors/ci/citadel