Aidoku项目中Komga迁移功能的历史记录保留问题分析

在Aidoku项目的开发过程中，我们发现了一个关于Komga源迁移功能的重要问题：当用户将系列从旧的外部Komga源迁移到新的内部源时，阅读历史记录仅对未添加到库中的标题保留，而库中已有标题的阅读历史会在迁移过程中丢失。

问题背景

Aidoku是一款优秀的漫画阅读应用，支持多种来源的漫画阅读。Komga作为流行的自托管漫画服务器，在Aidoku中得到了良好支持。在项目迭代过程中，开发者实现了从外部Komga源到内部Komga源的迁移功能，旨在提供更好的集成体验。

问题本质

经过技术分析，我们发现问题的根源在于两种源对章节处理方式的差异：

1. 旧的外部Komga源使用章节(chapters)作为阅读进度记录单位
2. 新的内部Komga源则使用卷(volumes)作为记录单位

当前的迁移逻辑仅处理了章节形式的阅读历史，而没有为卷形式的记录提供兼容方案，这导致了部分用户的阅读历史在迁移过程中丢失。

技术解决方案

针对这一问题，我们建议采取以下改进措施：

1. 实现卷记录回退机制：在迁移过程中，当检测到卷形式的阅读记录时，系统应自动将其转换为兼容的章节记录格式，确保历史数据不丢失。

2. 双格式支持：在迁移后的新源中，同时支持章节和卷两种记录格式，为用户提供更灵活的阅读进度管理。

3. 数据验证阶段：在迁移过程中增加数据验证步骤，确保所有形式的阅读记录都能正确转换和保留。

用户体验优化

除了技术层面的修复，我们还建议从用户角度进行以下优化：

1. 迁移前提示：在用户执行迁移操作前，明确告知可能影响阅读历史的特殊情况。

2. 迁移报告：迁移完成后生成详细报告，列出成功保留的阅读记录数量和可能丢失的记录数量。

3. 手动恢复选项：为受影响的用户提供手动恢复阅读历史的简便方法。

总结

阅读历史是用户重要的个人数据，在源迁移过程中必须确保其完整性。通过实现更智能的格式转换机制和增加用户提示，我们可以有效解决当前Komga迁移过程中的历史记录丢失问题，为用户提供更可靠的使用体验。

这一问题的解决不仅提升了Aidoku对Komga源的支持质量，也为处理其他类似源的迁移提供了有价值的参考方案。