gallery-dl 配置指南：Kemono平台下载文件夹命名优化

问题背景

在使用gallery-dl下载Kemono平台内容时，许多用户会遇到两个常见问题：

1. 下载的文件夹默认使用艺术家ID而非更直观的艺术家名称
2. 文件序列编号默认从1开始而非0开始

解决方案详解

1. 艺术家名称显示配置

要显示艺术家名称而非ID，需要启用metadata选项并正确配置路径格式。以下是关键配置项：

{
    "extractor": {
        "kemonoparty": {
            "metadata": true,
            "directory": ["{category}", "{service}", "{username}", "{title}"]
        }
    }
}

技术细节：

• metadata: true 会触发额外的HTTP请求来获取用户名信息
• {username} 是获取到的艺术家名称变量
• 注意不要使用{user[name]}或{user}等错误格式

2. 文件序列编号调整

要使文件编号从0开始，可以使用以下两种格式之一：

"filename": "{id}{num:A-1/>2}.{extension}"

或

"filename": "\fF {id}{num-1:>2}.{extension}"

格式说明：

• A-1 表示对数值进行减1操作
• >2 表示两位数填充（如01,02）
• \fF 启用f-string格式处理

常见问题排查

1. 配置不生效：

   • 确保配置文件位于正确位置
   • 使用--verbose参数检查配置是否被正确加载
   • 确认gallery-dl版本为最新（1.28.0+）

2. 用户名获取失败：

   • 旧版本(1.27.4)存在相关bug，必须升级到1.28.0+
   • 确保网络连接正常，能够完成额外的元数据请求

3. JSON配置错误：

   • 使用--config-create创建新的配置文件
   • 检查JSON格式是否正确，避免多余的逗号或括号

最佳实践建议

1. 定期更新gallery-dl以获取最新功能和bug修复
2. 使用--verbose参数调试配置问题
3. 备份重要配置文件
4. 对于大量下载，考虑使用--download-archive记录已下载内容

通过以上配置，用户可以更有效地组织下载内容，提高文件管理的便利性。