Kavita漫画服务器扫描优化：解决嵌套文件夹更新引发的全量扫描问题

问题背景

在Kavita漫画服务器0.8.1稳定版中，用户报告了一个影响系统性能的扫描行为问题。当用户按照"出版社/系列"的嵌套结构组织漫画文件时（例如/data/Western Comics/出版社A/系列B/），如果只更新了最深层系列文件夹中的单个文件，系统却会触发对整个出版社文件夹的完整扫描。

技术原理分析

这种扫描行为源于Kavita原有的文件监控机制设计。系统默认会监控文件系统中所有被标记为"已修改"的文件夹事件，但在嵌套目录结构中，父文件夹的时间戳会随着子文件夹内容的修改而自动更新。这导致：

1. 文件系统层面：任何子文件夹的修改都会向上传播修改时间
2. 扫描器逻辑：检测到父文件夹变更后，保守地选择重新扫描整个父目录
3. 性能影响：对于组织结构较深的用户，小更新会触发大范围扫描

解决方案实现

开发团队通过以下技术改进解决了这个问题：

1. 路径深度分析：扫描器现在会分析变更事件的路径深度
2. 精准范围界定：只扫描实际发生变更的最低层级目录
3. 事件过滤：忽略由子项变更引起的父目录时间戳更新

实际效果

这项优化显著提升了以下场景的性能：

• 按出版社分类的大型漫画库
• 日常频繁添加新内容的活跃用户
• 使用深度嵌套目录结构的组织方式

用户建议

对于使用Docker(LSIO容器)部署的用户，建议：

1. 等待该优化进入稳定版
2. 关注扫描日志确认优化效果
3. 保持目录结构清晰规范以获得最佳性能

这项改进已进入测试阶段，经过充分验证后将合并到主分支，为Kavita用户带来更高效的文件管理体验。