Mihon项目中文漫画下载文件冲突问题分析与解决方案

问题背景

在Mihon漫画阅读器的Comick插件（版本1.4.57）中，用户发现了一个关于多版本章节下载管理的技术问题。当同一漫画章节存在多个不同质量的版本时（由同一扫描组发布），系统会出现文件冲突现象，导致用户无法同时保留多个版本。

问题现象

具体表现为：

1. 当用户尝试下载同一漫画章节的多个版本时（例如《Yancha Gal》第2章的不同质量版本）
2. 系统仅保存最先下载的文件
3. 后续下载的同名章节会覆盖已有文件
4. 所有章节入口都指向同一个已下载文件

技术分析

问题的核心在于文件命名机制存在缺陷。当前系统仅使用两个要素构建文件名：

• 扫描组名称（如"Sugoi Gyaru Scans!"）
• 章节名称（如"Vol. 1, Ch. 2: Anjou-san Won't Leave Me Alone"）

当这两个要素完全相同时，系统无法区分不同版本的章节文件，导致文件冲突。

解决方案建议

方案一：向后兼容的渐进式改进

建议采用条件性后缀的命名策略：

1. 对第一个下载的版本保持原文件名不变
2. 对后续版本添加递增后缀（如_a、_b等）
3. 排序依据可以是上传日期或章节URL的字符串比较

示例实现：

Sugoi Gyaru Scans!_Vol. 1, Ch. 2: Anjou-san Won't Leave Me Alone.cbz
Sugoi Gyaru Scans!_Vol. 1, Ch. 2: Anjou-san Won't Leave Me Alone_a.cbz

优点：最大程度保持向后兼容性 缺点：排序逻辑可能不够直观

方案二：彻底解决方案

直接嵌入章节唯一标识符到文件名中：

Sugoi Gyaru Scans!_Vol. 1, Ch. 2: Anjou-san Won't Leave Me Alone [r2ZQ4].cbz
Sugoi Gyaru Scans!_Vol. 1, Ch. 2: Anjou-san Won't Leave Me Alone [w09Y1].cbz

优点：

• 完全避免命名冲突
• 文件名包含更多元信息
• 便于用户识别不同版本

缺点：

• 可能影响现有用户的文件组织结构
• 文件名长度增加

实现建议

推荐采用方案二作为长期解决方案，因为：

1. 从根本上解决问题
2. 提供更好的用户体验
3. 便于扩展维护

同时可以提供过渡期支持：

1. 新版本默认采用新命名方案
2. 保留对旧命名方案的支持
3. 提供文件迁移工具

技术考量

在实现时需要注意：

1. 文件名长度限制（不同文件系统可能不同）
2. 特殊字符处理
3. 多语言支持
4. 性能影响（特别是批量操作时）

总结

Mihon项目的这个文件冲突问题反映了在漫画阅读器中管理多版本内容时的常见挑战。通过改进文件命名策略，不仅可以解决当前问题，还能为未来可能的多版本管理功能奠定良好基础。建议开发团队综合考虑用户体验和技术实现，选择最适合的解决方案。