TachiyomiJ2K中EPUB文件元数据解析问题分析与解决方案

问题背景

在TachiyomiJ2K阅读器应用中，用户反馈了一个关于EPUB文件显示异常的问题：当将EPUB文件放入本地文件夹后，文件标题和章节编号无法正确显示，而是显示为空白并停留在章节列表底部。相比之下，标准版Tachiyomi应用能够正常显示这些信息。

问题现象分析

经过深入调查，发现该问题与EPUB文件的元数据处理机制有关。具体表现为：

1. 在TachiyomiJ2K中，EPUB文件虽然可以正常打开阅读，但无法正确显示书籍标题和章节编号
2. 文件在章节列表中显示为空白条目
3. 这些异常条目会被自动排序到章节列表的底部

根本原因

问题的核心在于Tachiyomi/Mihon框架对EPUB元数据的解析方式存在特定限制：

1. 元数据命名冲突：当EPUB文件的标题与JSON文件中的名称完全相同时，系统无法正确识别和显示
2. 数字命名问题：文件名中包含数字时会影响章节识别逻辑，特别是当数字出现在章节编号之前时

解决方案

针对这一问题，我们推荐以下几种解决方法：

方法一：修改元数据命名

1. 改变EPUB标题的大小写形式（如将全大写改为首字母大写）
2. 在标题末尾添加标点符号（如句点）
3. 完全修改JSON文件中的命名内容

方法二：调整文件命名结构

对于包含数字的文件名，特别是章节编号的位置：

1. 避免将数字放在文件名开头
2. 调整章节编号的位置（例如将"Vol.2 Ch.1"改为"Ch.1 Vol.2 Ch.1"）
3. 确保系统能够优先识别到正确的章节编号

技术建议

为了获得最佳兼容性，我们建议：

1. 保持EPUB文件元数据的一致性
2. 避免使用纯数字作为文件名的开头
3. 在JSON配置文件中使用明确的、唯一的标识符
4. 对于系列作品，采用一致的命名规范

总结

TachiyomiJ2K对EPUB文件的处理依赖于正确的元数据结构和文件命名规范。通过理解系统的工作原理并遵循上述建议，用户可以确保他们的本地EPUB文件能够正确显示和排序。这一问题的解决不仅改善了用户体验，也为开发者提供了关于元数据处理的重要见解。