Kavita项目基础架构升级：章节与卷管理重构解析

核心变更概述

Kavita团队近期完成了对漫画阅读系统基础架构的重大升级，重点重构了章节(Chapter)和卷(Volume)的数据模型与管理逻辑。此次改造主要解决了三个核心问题：特殊章节处理混乱、非标准编号支持不足以及排序逻辑复杂等问题。

章节模型深度改造

多维度编号体系

1. 显示编号(ChapterNumberDisplay)：新增字段存储可视化编号表示，支持特殊章节使用符号或标题替代传统数字
2. 数值范围字段：引入MinNumber/MaxNumber浮点型字段，精确记录章节数值范围
3. 智能排序机制：
   • 重构SortOrder字段处理逻辑
   • 支持负数章节编号(如-1)
   • 完善特殊章节排序规则
   • 处理复杂编号情况(如19/19.HU/19.BH/20序列)

技术实现细节

• 将标题生成逻辑迁移至数据库层
• 统一单文件EPUB的特殊章节标识处理
• 开发entity-title组件集中处理展示逻辑
• 封面生成系统适配新排序规则

卷管理系统升级

显示优化

• 新增DisplayTitle字段存储格式化卷名
• 自动转换数值显示(1.0→1)

结构重组

1. 特殊卷分离：

   • 创建独立编号空间处理Special章节
   • 保留原有松散章节(Loose Leaf)处理逻辑
   • 新增年度特刊(Annuals)专用处理通道

2. 测试体系完善：

   • 全面更新SeriesExtensions等核心模块测试用例
   • 验证特殊卷与常规卷的交互逻辑

数据迁移方案

自动化迁移流程

1. 范围数据(Range)向Min/Max数值转换
2. 补全MangaFile的文件名记录
3. 默认章节编号标准化(0→新编号体系)
4. 松散章节卷号重映射

特殊处理项

• 进度数据保留迁移
• 阅读记录(scrobble)重新编码
• 用户需全库强制扫描完成最终同步

客户端适配要求

所有客户端应用(Kavya/Aidoku等)需适配新的编号规则，特别注意：

• 特殊章节的显示逻辑
• 负值卷/章编号处理
• OPDS协议对PDF特殊章节的支持

技术挑战与解决方案

复杂编号处理

通过浮点数+字符串混合排序方案，完美支持：

• 常规数字编号
• 带后缀编号(19.HU)
• 负值编号
• 非数字标识符

兼容性保障

• 设计渐进式迁移路径
• 维护旧版数据自动转换
• 提供明确的用户操作指引(强制刷新)

升级影响说明

本次架构变更涉及核心数据模型修改，建议用户：

1. 提前备份数据库
2. 预留足够的处理时间
3. 更新后执行全库扫描
4. 检查特殊章节的显示准确性

该升级为后续漫画功能扩展奠定了坚实基础，特别是为即将到来的漫画系统重做提供了必要的数据模型支持。