gallery-dl 文件命名规则配置技巧

在使用 gallery-dl 下载器时，合理的文件命名配置能够有效管理下载内容。本文将详细介绍如何正确配置 gallery-dl 的文件命名规则，特别是针对特定文件类型的命名处理。

常见配置问题分析

许多用户在使用 gallery-dl 时会遇到文件命名规则不生效的情况，尤其是针对特定扩展名文件（如.zip、.rar等）的命名处理。常见问题包括：

1. 条件判断语法错误
2. 规则优先级设置不当
3. 扩展名匹配方式不正确

正确的配置方法

对于需要特殊处理的压缩文件，应采用以下配置结构：

"filename": {
    "extension in ('zip', 'rar')": "[ZIP] {title} {filename}.{extension}",
    "count > 999": "{title}_p{num:>04}.{extension}",
    "count > 99": "{title}_p{num:>03}.{extension}",
    "count > 9": "{title}_p{num:>02}.{extension}",
    "": "{title}_p{num:>02}.{extension}"
}

关键配置要点

1. 特定扩展名优先处理：将压缩文件规则放在最前面，确保优先匹配
2. 正确的条件语法：使用 in 操作符和元组形式指定多个扩展名
3. 完整的回退机制：最后提供默认命名规则

配置原理详解

gallery-dl 的文件名规则匹配遵循以下原则：

1. 顺序匹配：从上到下依次尝试匹配规则
2. 首次匹配：第一个符合条件的规则将被应用
3. 严格语法：条件表达式必须使用正确的比较运算符

对于扩展名匹配，必须注意：

• 扩展名包含点号（如'.zip'）
• 多扩展名使用元组形式('zip', 'rar')
• 使用 in 操作符而非 == 进行多值比较

最佳实践建议

1. 将特殊文件类型的规则置于通用规则之前
2. 为不同类型的文件设计清晰的命名前缀（如[ZIP]、[VIDEO]等）
3. 保留默认命名规则作为最后保障
4. 测试配置时使用少量样本验证效果

通过以上配置方法和原则，用户可以确保 gallery-dl 按照预期的方式命名下载文件，特别是能够正确处理压缩文件等特殊类型的命名需求。