Tdarr项目中实现流变量多值校验的技术方案

背景介绍

Tdarr作为一款媒体文件处理工具，其流程控制功能对于自动化处理至关重要。在实际使用中，用户经常需要对流程变量进行条件判断，而现有的"Check Flow Variable"功能仅支持单一值比对，这在处理多条件场景时显得不够灵活。

问题分析

在Tdarr的流程控制中，当需要检查某个变量是否等于多个可能值时，传统做法有两种：

1. 串联多个"Check Flow Variable"模块，每个模块检查一个值
2. 使用自定义变量实现复杂逻辑

这两种方法都存在明显缺陷：第一种方法会导致流程冗长复杂，第二种方法则增加了使用门槛。

技术实现方案

多值校验功能设计

新功能允许在"Check Flow Variable"模块的value字段中输入逗号分隔的多个值，当使用"=="操作符时，只要变量值匹配任意一个输入值，条件即视为成立。这种设计既保持了向后兼容性，又显著提升了使用便利性。

实现原理

1. 输入解析：系统首先将逗号分隔的字符串拆分为值数组
2. 条件匹配：对于"=="操作，执行数组包含性检查
3. 结果处理：任一匹配即返回真值，否则返回假值
4. 操作符限制：该功能仅适用于"=="操作，其他比较操作保持原样

应用场景

这一改进特别适用于以下场景：

• 媒体库ID的多选过滤
• 文件类型的批量识别
• 处理状态的复合判断
• 多路径来源的合并处理

技术优势

1. 简化流程设计：减少模块数量，提高可读性
2. 提升执行效率：单次判断替代多次判断
3. 降低维护成本：集中管理条件值，便于后续修改
4. 保持兼容性：不影响现有流程的正常运行

最佳实践建议

1. 对于简单条件，仍建议使用单一值判断
2. 当条件值超过3个时，采用多值校验更为高效
3. 复杂逻辑可结合自定义变量使用
4. 定期检查条件值列表，避免包含过期值

这一改进体现了Tdarr对用户体验的持续优化，通过简化常见操作流程，让用户能够更专注于媒体处理逻辑本身，而非繁琐的条件判断设置。