gallery-dl中DeviantArt子文件夹下载配置指南

背景介绍

gallery-dl作为一款强大的媒体下载工具，近期增加了对DeviantArt网站子文件夹的支持功能。这项功能允许用户按照艺术家设置的文件夹结构来组织下载内容，大大提升了文件管理的便利性。

配置要点

基本配置结构

在配置文件中，DeviantArt相关的设置需要放在"deviantart"字段下。一个完整的配置应包含以下关键元素：

1. 认证信息：包括cookies、client-id、client-secret等
2. 下载选项：如是否下载原图(mature)、是否包含日志(journals)等
3. 路径设置：通过directory参数控制文件保存位置

子文件夹下载配置

要实现子文件夹下载功能，需要特别注意以下几点：

1. flat参数设置：必须将flat参数设为false，这样才能保留原始文件夹结构
2. folder子类别配置：需要单独为folder子类别设置directory路径
3. 路径模板：使用{folder[title]}变量来动态生成子文件夹名称

典型配置示例

"deviantart": {
    "cookies": "cookies.txt",
    "client-id": "your_client_id",
    "client-secret": "your_client_secret",
    "refresh-token": "your_refresh_token",
    "flat": false,
    "directory": ["DeviantArt"],
    "gallery": {
        "directory": ["DeviantArt", "Users", "{author[username]}", "Gallery"],
        "folders": true
    },
    "folder": {
        "directory": ["DeviantArt", "Users", "{author[username]}", "Gallery", "{folder[title]}"],
        "folders": true
    }
}

常见问题解决方案

1. 文件被保存到根目录：检查是否设置了flat参数为false，并确保folder子类别有正确的directory配置

2. 未分类文件被放入"None"文件夹：在路径模板中使用条件表达式"{folder[title]:?//}"，这样当文件不属于任何子文件夹时就不会创建额外目录

3. 多级子文件夹问题：目前gallery-dl仅支持一级子文件夹结构，更深层次的嵌套文件夹会被平级处理

最佳实践建议

1. 使用-E参数查看提取器默认设置，了解可用的变量和选项
2. 对于复杂的文件夹结构，建议先测试小范围下载，确认路径生成符合预期
3. 定期更新gallery-dl以获取最新的功能改进和bug修复

通过合理配置，用户可以轻松实现按照DeviantArt原始文件夹结构下载内容，保持本地文件与在线画廊的组织一致性。