gallery-dl项目中Kemono平台用户名显示问题的解决方案

在gallery-dl下载工具的实际使用过程中，许多用户反馈在下载Kemono平台内容时遇到了用户名显示为数字ID而非实际用户名的问题。本文将深入分析这一现象的成因，并提供完整的解决方案。

问题现象分析

当用户通过gallery-dl下载Kemono平台内容时，默认情况下文件名和路径中会使用数字ID（如37411309）来标识创作者，而不是更直观的用户名（如aduare）。这种现象主要出现在以下场景：

1. 下载文件保存路径的配置中
2. 下载完成后的文件名中

技术背景

这种现象源于gallery-dl的默认元数据提取策略。Kemono平台API返回的数据中同时包含数字ID和用户名两种标识符，但工具默认使用更稳定的数字ID作为主要标识，原因包括：

1. 数字ID具有唯一性和持久性
2. 用户名可能发生变更
3. 数字ID在平台API中作为主要检索键

解决方案

要启用实际用户名显示功能，需要进行以下配置修改：

1. 打开gallery-dl的配置文件
2. 在配置文件中添加或修改以下参数：

{
  "extractor": {
    "kemonoparty": {
      "metadata": true
    }
  }
}

3. 在文件名模板中使用{username}占位符替代原来的数字ID标识

高级配置建议

对于需要更精细控制的用户，还可以考虑以下配置方案：

1. 混合使用ID和用户名：

{
  "filename": "{username}_{id}/[%Y-%m-%d] {title}{extension}"
}

2. 添加备用方案（当用户名为空时回退到ID）：

{
  "filename": "{username:?{id}}/{title}{extension}"
}

注意事项

1. 用户名可能包含特殊字符，建议在配置中启用文件名净化功能
2. 频繁更改用户名可能导致文件组织结构混乱
3. 某些历史存档内容可能无法获取到用户名信息

通过以上配置，用户可以更直观地通过用户名来组织和识别下载内容，显著提升文件管理的便利性。这一解决方案不仅适用于Kemono平台，其原理也可应用于其他类似平台的配置优化。