Pinchflat项目中日期索引变量的正确使用方法

在Pinchflat视频下载工具的使用过程中，许多用户会遇到文件名模板中日期索引变量显示不正确的问题。本文将详细介绍Pinchflat v0.1.17版本中关于日期索引变量的正确使用方法，帮助用户避免常见的配置错误。

问题背景

Pinchflat作为一款功能强大的视频下载工具，提供了丰富的文件名模板变量。在v0.1.17版本中，新增了索引变量功能，允许用户在文件名中包含视频的索引编号。然而，部分用户在使用{{ upload_date_index }}变量时发现，该变量在生成的文件名中显示为"NA"，而实际上该索引编号确实存在于下载文件的属性中。

变量命名规范解析

Pinchflat采用了明确的变量命名规范，其中关键的一点是使用前缀来区分不同类型的变量：

1. **source_**前缀：表示与源数据相关的变量
2. **media_**前缀：表示与媒体文件相关的变量
3. **target_**前缀：表示与目标输出相关的变量

这种命名方式虽然增加了变量名的长度，但大大提高了变量的可读性和准确性，避免了变量名冲突的情况。

正确使用日期索引变量

针对日期索引变量，Pinchflat提供了以下两种主要形式：

1. {{ media_upload_date_index }}：这是正确的日期索引变量形式，它会返回媒体文件的上传日期索引编号
2. {{ upload_date_index }}：这种简写形式在v0.1.17版本中可能无法正常工作，会返回"NA"

实际应用示例

对于需要与Plex媒体服务器配合使用的场景，特别是使用Absolute Series Scanner和YouTubeSeries Agent时，推荐使用以下文件名模板格式：

/{{ source_custom_name }} [{{ source_collection_id }}]/Season {{ season_from_date }}/{{ source_custom_name }} - {{ upload_yyyy_mm_dd }}{{ media_upload_date_index }} - {{ title }} [youtube2-{{ id }}].{{ ext }}

这种格式能够确保：

• 文件名中包含完整的日期信息(YYYY-MM-DD)
• 日期后紧跟正确的索引编号
• 符合Plex扫描器的识别要求

注意事项

1. 虽然{{ season_episode_index_from_date }}变量能够正常工作，但不建议在Plex环境中使用，因为它生成的格式不符合Plex日期系列文件的识别规范
2. 在配置文件名模板时，建议始终使用带有明确前缀的变量名，以确保兼容性和稳定性
3. 如果遇到变量显示异常，首先检查变量名前缀是否正确

通过正确理解和使用Pinchflat的变量命名规范，用户可以轻松创建符合各种媒体服务器要求的文件命名结构，实现高效的媒体库管理。