Tdarr项目库交替处理功能的问题分析与修复

问题背景

Tdarr是一款流行的媒体文件转码自动化工具，其核心功能之一是能够对多个媒体库中的文件进行智能处理和转码。在2.24.04版本中，用户报告了一个关于"库交替处理"(Library alternation)功能的异常行为。

问题现象

当用户配置了多个媒体库并启用库交替处理功能时，系统虽然能够正确显示按"最新扫描"(Newest Scanned)排序的队列，但在实际处理过程中却出现了异常。具体表现为：

1. 队列显示排序正常，文件按预期顺序排列
2. 实际处理时，系统仅从单一库中选取文件进行处理
3. 文件处理顺序与队列显示不符，例如将位置7的文件移动到位置1进行处理

技术分析

库交替处理功能的设计初衷是确保系统能够均衡地从各个媒体库中选取文件进行处理，避免长时间集中处理单一库中的文件。这一功能对于拥有多个媒体库且希望保持处理平衡的用户尤为重要。

在正常情况下，该功能应：

• 维护一个全局处理队列
• 根据配置的排序规则(如按最新扫描时间)对所有库中的文件进行统一排序
• 在处理时保持这种排序，同时确保各库文件得到均衡处理

从用户报告的现象来看，排序逻辑在前端显示是正确的，但实际处理时的文件选取逻辑出现了偏差，导致系统仅从单一库中选取文件，破坏了预期的交替处理机制。

问题根源

经过开发团队分析，该问题源于处理引擎中文件选取逻辑的一个缺陷。具体表现为：

1. 队列生成与文件选取逻辑之间存在不一致性
2. 文件选取时未能正确考虑库交替的优先级
3. 排序结果的缓存与实际处理时的决策存在脱节

解决方案

开发团队在2.24.05版本中修复了这一问题，主要改进包括：

1. 统一了队列显示与实际处理的文件选取逻辑
2. 增强了库交替处理的核心算法，确保严格遵循配置的排序规则
3. 优化了处理引擎中的决策机制，保证各库文件得到均衡处理

修复后，系统能够正确实现：

• 按配置的排序规则(如最新扫描时间)处理文件
• 同时保持各媒体库之间的处理平衡
• 确保前端显示与实际处理行为一致

用户建议

对于使用Tdarr多库处理的用户，建议：

1. 及时升级到2.24.05或更高版本以获得修复
2. 定期检查处理日志，确认文件确实来自不同库
3. 根据实际需求调整库交替处理的参数配置
4. 关注处理队列的行为是否与预期一致

该修复确保了Tdarr在多库环境下的稳定性和可靠性，为用户提供了更加一致和可预测的媒体处理体验。