gallery-dl 配置：按帖子/主题分类下载文件的最佳实践

在使用 gallery-dl 进行内容归档时，合理的目录结构配置能极大提升文件管理的效率。本文将详细介绍如何配置 gallery-dl 的配置文件，实现按创作者和帖子/主题分类存储下载内容。

配置原理

gallery-dl 通过 JSON 格式的配置文件控制下载行为，其中 directory 参数决定了文件的存储路径结构。需要注意的是，directory 必须配置为数组形式，而非简单的字符串路径。

常见错误

许多新手用户容易犯的一个错误是直接将 directory 配置为字符串路径，例如：

"directory": "./gallery-dl/fanbox/{creator}/{id}_{title}"

这种配置会导致 DirectoryFormatError 错误，提示 "Single '{' encountered in format string"。这是因为 gallery-dl 期望 directory 是一个路径组件数组，而不是完整的路径字符串。

正确配置方法

Fanbox 平台配置

对于 Fanbox 平台，推荐使用以下配置：

"directory": ["fanbox", "{creatorId}", "{id}_{title}"]

这个配置会创建三层目录结构：

1. 根目录下的 fanbox 文件夹
2. 创作者ID命名的子文件夹
3. 以帖子ID和标题命名的最终文件夹

Fantia 平台配置

对于 Fantia 平台，应采用如下配置：

"directory": ["fantia", "{fanclub_name}", "{post_id}_{post_title}"]

同样形成三层结构：

1. 根目录下的 fantia 文件夹
2. 粉丝俱乐部名称的子文件夹
3. 帖子ID和标题组合的最终文件夹

完整配置示例

以下是一个完整的配置示例，包含了 Fanbox 和 Fantia 两个平台的设置：

{
    "extractor": {
        "fanbox": {
            "cookies": {
                "FANBOXSESSID": "你的会话ID"
            },
            "directory": ["fanbox", "{creatorId}", "{id}_{title}"],
            "filename": "{filename}.{extension}",
            "shorten": false,
            "parent_directory": false
        },
        "fantia": {
            "cookies": {
                "_session_id": "你的会话ID"
            },
            "directory": ["fantia", "{fanclub_name}", "{post_id}_{post_title}"],
            "filename": "{filename}.{extension}",
            "shorten": false,
            "parent_directory": false
        }
    }
}

高级技巧

1. 路径深度控制：可以通过增减数组元素来控制目录结构的深度
2. 变量组合：在最终目录名中可以使用多个变量组合，如 {id}_{date}_{title}
3. 特殊字符处理：当标题包含特殊字符时，建议启用 "restrict-filenames": true 选项

通过以上配置，gallery-dl 将自动为每个帖子/主题创建独立的文件夹，使下载内容保持清晰有序的组织结构，极大方便后续的管理和使用。