Tdarr项目中的变量使用详解与实战指南

变量基础概念

在Tdarr媒体处理系统中，变量(Variables)是一种强大的功能，它允许用户在不同处理阶段传递和检查自定义数据。变量主要分为两种类型：系统预定义变量和用户自定义变量。系统变量由Tdarr自动生成和维护，而用户变量则完全由用户根据需求创建和使用。

变量配置方法

要在Tdarr中设置变量，用户需要在每个库(Library)的配置界面进行操作。具体步骤为：

1. 进入库设置界面
2. 找到变量配置区域
3. 添加新的变量键值对
4. 保存配置

例如，可以为不同类型的媒体库设置"type"变量，值为"movie"、"tvshow"等，以便后续处理流程中进行区分。

变量检查与使用

在流程(Flow)中使用变量时，需要通过特定的插件"Check Flow Variable"来实现条件判断。该插件提供了三个关键参数：

1. 变量路径：指定要检查的变量位置，格式为args.userVariables.library.变量名
2. 比较运算符：支持等于(==)、不等于(!=)等多种比较方式
3. 预期值：要与变量进行比较的目标值

正确使用变量路径是确保条件判断生效的关键。许多用户容易犯的错误是直接使用变量名进行比较，而忽略了完整的前缀路径。

实际应用场景

一个典型的应用场景是根据不同的媒体类型执行不同的后处理操作。例如：

1. 为电影库设置type: movie
2. 为电视剧库设置type: tvshow
3. 在流程中使用条件分支，针对不同类型执行不同的转码参数或移动操作

这种设计使得用户可以为不同类型的媒体内容定制完全独立的处理流水线，大大提高了工作流的灵活性。

常见问题与解决方案

变量未被识别：最常见的原因是变量路径填写不正确。务必确保使用完整路径args.userVariables.library.变量名而非简单的变量名。

条件判断失效：检查比较运算符和预期值是否匹配，特别注意大小写敏感问题。

变量作用域：记住变量是库级别的，同一个库中的所有文件共享相同的变量设置。

最佳实践建议

1. 为变量使用清晰、有意义的命名
2. 在流程中添加日志输出，调试变量值
3. 充分利用Tdarr的模板系统({{{}}})处理复杂变量
4. 为不同的处理阶段设计不同的变量组
5. 定期审查和优化变量使用方式

通过掌握这些变量使用技巧，用户可以构建出更加智能、高效的媒体处理工作流，充分发挥Tdarr的强大功能。