Suwayomi/Tachidesk-Server自动下载功能在固定章节数场景下的优化方案

在Suwayomi/Tachidesk-Server的漫画阅读服务中，自动下载功能是用户常用的核心特性之一。近期发现当使用特定扩展源（如Manga Plus）时，该功能会出现异常情况。本文将从技术角度分析问题本质及解决方案。

问题现象分析

当用户配置自动下载功能后，对于采用固定章节数策略的漫画源（如始终保持6个章节），系统无法正确识别新章节发布。这是因为：

1. 常规漫画源的章节列表会随时间线性增长（如第1章→第2章→第3章...）
2. 特殊漫画源采用滑动窗口策略（如始终保持最新3章+最早3章共6章）
3. 服务端的章节检测机制基于总数变化触发下载

技术原理剖析

原检测机制的工作流程：

1. 定期轮询漫画源章节列表
2. 对比本地存储的章节总数
3. 当远程总数 > 本地总数时触发下载

这种设计在常规场景下有效，但无法应对以下特殊情况：

• 章节总数保持不变（如6章）
• 内容实际已更新（如第4章替换第3章）
• 章节ID可能重复使用

解决方案实现

预览版中已采用更智能的检测策略：

1. 章节指纹比对：不仅比较数量，还检查章节元数据（如标题、发布时间）
2. 状态标记追踪：记录每个章节的下载状态（已下载/未下载）
3. 内容哈希校验：对章节内容进行摘要计算，检测实质变更

技术价值

新方案带来以下改进：

• 支持滑动窗口式章节更新策略
• 降低误判率，提高下载准确度
• 兼容更多类型的漫画源实现
• 为后续增量更新功能奠定基础

用户建议

对于使用固定章节数漫画源的用户：

1. 升级到包含此修复的预览版本
2. 无需调整现有配置即可获得改进
3. 可观察日志确认自动下载触发逻辑

该优化体现了Suwayomi/Tachidesk-Server对多样化内容源的良好适配能力，展示了开源项目持续完善用户体验的技术追求。