Kometa项目中TV节目重复项分割操作异常分析

在Kometa媒体管理工具的2.1.0版本中，用户报告了一个关于TV节目库操作的有趣现象。当启用split_duplicates参数时，系统错误地将两个明显不同的电视剧《绿箭侠》和《神盾局特工》识别为重复项并进行分割操作，最终导致脚本执行失败。

问题现象

在SeriesTest库配置中，当设置split_duplicates: true时，系统会将两个完全不同的TV节目：

• 《绿箭侠》(TMDB ID: 1412)
• 《神盾局特工》(TMDB ID: 1403)

错误地识别为重复项并尝试分割。这一错误操作随后引发了一系列Plex API 404错误，导致脚本执行中断。

深入分析

经过技术团队复现测试，发现以下关键点：

1. 正常情况处理：当库中确实存在重复剧集时，分割操作能正确执行。测试中故意添加重复剧集后，系统能准确识别并分割。

2. 隐藏的重复项：进一步调查发现，用户环境中实际上存在个别剧集的重复文件，这些不易察觉的重复项可能是导致系统误判的根源。

3. Plex界面差异：值得注意的是，Plex界面中"分割"选项的可见性存在特殊行为：

   • 在库视图下不显示"分割"选项
   • 需要进入具体节目详情页才能看到该操作选项

解决方案与最佳实践

对于遇到类似问题的用户，建议采取以下步骤：

1. 彻底检查重复项：

   • 使用Plex的"重复项"筛选功能
   • 检查每个节目的所有剧集文件

2. 操作验证流程：

   • 先在Plex界面手动确认能否看到"分割"选项
   • 确认无误后再通过Kometa执行批量操作

3. 文件系统检查：

   • 避免使用硬链接等特殊文件处理方式
   • 确保每个媒体文件都有独立存储空间

技术启示

这一案例揭示了媒体管理中的几个重要技术点：

1. 重复项检测机制：系统不仅比较节目元数据，还会分析实际媒体文件。

2. 错误处理优化：当API返回404错误时，应有更完善的错误处理机制。

3. 用户界面一致性：Plex不同视图下的功能可见性差异可能导致用户困惑。

通过这个案例，我们更深入地理解了Kometa与Plex交互时可能遇到的边缘情况，为未来版本改进提供了宝贵参考。用户在遇到类似问题时，应首先从基础检查入手，逐步排查可能的原因。