Sonarr项目中的TVDB标准集数解析优化方案

背景介绍

在Sonarr这一自动化媒体管理工具中，对视频文件名的解析机制一直是核心功能之一。近期社区反馈了一个关于动漫文件命名解析的特殊情况：当文件名中同时包含标准TVDB集数标识（如S01E06）和绝对集数（如06）时，当前解析逻辑会优先采用第一个匹配到的集数标识，而无论其类型如何。这种处理方式在某些特定场景下可能导致不符合预期的结果。

问题分析

在动漫发布领域，存在两种常见的集数标识方式：

1. 标准TVDB格式：采用"S季数E集数"的明确标识（如S01E06）
2. 绝对集数格式：仅使用数字表示集数（如06）

当前Sonarr的解析逻辑简单地按照首次匹配原则处理这两种格式，这在以下典型场景中会产生问题：

• 特殊集处理：当OVA/SP被标记为S00E01但实际剧情位置在正片中间时
• 多季动漫：如《Cardcaptor Sakura》这类TVDB与其他数据库季节划分不一致的作品
• 续作处理：如《小林家的龙女仆S》这类带有明显续作标识的作品

技术解决方案

从技术实现角度，建议对解析逻辑进行以下优化：

1. 优先级调整：当检测到文件名中包含标准TVDB格式时，应优先采用该标识
2. 双重验证：可考虑将两种标识都提取后进行交叉验证
3. 特殊场景处理：针对动漫特有的命名习惯（如OVA、SP等）增加特殊处理逻辑

实现建议

具体到代码层面，可以在GetEpisodes方法中增加对标准TVDB格式的优先检测：

if (parsedEpisodeInfo.SeasonNumber.HasValue && 
    parsedEpisodeInfo.EpisodeNumbers != null && 
    parsedEpisodeInfo.EpisodeNumbers.Count != 0)
{
    return GetEpisodes(parsedEpisodeInfo, series, parsedEpisodeInfo.SeasonNumber.Value, false, searchCriteria);
}

这种修改能够确保：

• 当存在明确季节和集数信息时优先使用
• 保持向后兼容性
• 不影响现有简单命名格式的解析

行业实践参考

在媒体服务器领域，Plex等软件已经实现了类似的优先逻辑。这种处理方式符合以下行业最佳实践：

1. 明确性优先：标准TVDB格式比单纯数字更明确
2. 用户体验：减少因解析错误导致的观看顺序问题
3. 自动化友好：为发布组提供更可靠的自动化支持

预期影响

实施此优化后将带来以下改进：

• 提高解析准确率：特别是对于包含多种集数标识的文件名
• 增强兼容性：更好地支持动漫发布组的命名习惯
• 降低用户困惑：减少因解析问题导致的媒体库管理问题

总结

Sonarr作为专业的媒体管理工具，对文件名的解析精度直接影响用户体验。针对动漫这一特殊内容类型的命名习惯进行优化，将显著提升工具在相关领域的适用性。建议开发团队考虑实现标准TVDB格式的优先解析逻辑，同时保持对传统命名方式的支持，以达到最佳的兼容性和准确性平衡。