gallery-dl中Pillowfort站点文件名格式的自定义配置

在gallery-dl这款强大的媒体下载工具中，用户经常需要对不同站点的下载文件命名格式进行自定义配置。本文将以Pillowfort站点为例，深入探讨如何实现智能化的文件名格式设置，特别是针对单图和多图情况下的差异化命名需求。

文件名格式的基本配置

gallery-dl允许用户通过配置文件自定义下载文件的命名格式。对于Pillowfort站点，基础的文件名格式配置如下：

"pillowfort": {
    "filename": "PF {post_id} {num} {hash}{filename:?_//}.{extension}"
}

这种配置会生成类似"PF 1234 1 fd1adc4sbfdb_campfire.png"的文件名，其中包含了帖子ID、图片序号、哈希值和原始文件名（经过处理）等信息。

单图与多图的差异化命名需求

在实际使用中，用户往往希望当帖子中只有一张图片时，文件名中省略序号部分；而当帖子包含多张图片时，则保留序号以便区分。这种需求源于对文件命名简洁性和可区分性的平衡考虑。

条件格式化解决方案

gallery-dl提供了强大的条件格式化功能，可以通过以下方式实现这一需求：

"pillowfort": {
    "filename": "PF {post_id} {num:?/ />02} {hash}{filename:?_//}.{extension}"
}

这种语法中，{num:?/ />02}是一个条件表达式，它的工作原理是：

• 当num存在且有效时，输出/和格式化为两位数的num（如/01）
• 当num不存在或无效时，输出空字符串

技术细节解析

1. num与count的区别：

   • num表示当前图片在帖子中的序号（从1开始）
   • count表示帖子中包含的图片总数
   • 在多图帖子中，num会随每张图片变化，而count保持不变

2. 条件格式化的语法结构：

   • 基本格式为{变量名:?条件为真时的格式/条件为假时的格式}
   • 可以省略假值部分，如上面的例子中只指定了真值部分

3. 格式化选项：

   • >02表示将数字格式化为两位数，不足前面补零
   • _//表示对原始文件名进行处理，替换特殊字符

注意事项

1. 文件冲突风险：在多图帖子中省略序号可能导致文件名冲突，使后续图片因同名文件已存在而被跳过下载。

2. 格式兼容性：不同版本的gallery-dl可能在条件格式化语法上有细微差异，建议查阅对应版本的文档。

3. 测试验证：修改配置后，建议先用少量帖子进行测试，确认命名格式符合预期后再进行大规模下载。

通过合理利用gallery-dl的条件格式化功能，用户可以灵活地定制符合个人偏好的文件名格式，在保持文件组织有序性的同时，也能确保命名的简洁性和可读性。