gallery-dl工具使用指南：如何完整下载Inkbunny作品及元数据

概述

gallery-dl是一款强大的命令行工具，专门用于从各种图片网站批量下载作品。本文将以Inkbunny平台为例，详细介绍如何正确使用gallery-dl下载作品及其元数据（包括作品描述等信息）。

基本下载命令

最简单的下载命令格式如下：

gallery-dl.exe -u 用户名 -p 密码 https://inkbunny.net/艺术家ID

执行此命令后，gallery-dl会在当前目录下创建gallery-dl文件夹，并将下载的作品保存在其中的inkbunny子目录中。

下载元数据文件

要同时下载作品的元数据（包括描述、标签等信息），需要使用--write-metadata参数：

gallery-dl.exe --write-metadata -u 用户名 -p 密码 https://inkbunny.net/艺术家ID

元数据会以JSON格式保存，文件名与对应的作品文件相同，扩展名为.json。

常见问题解决方案

1. 文件下载位置问题

默认情况下，gallery-dl会在当前工作目录下创建gallery-dl文件夹存放下载内容。建议在使用前先通过命令行切换到目标目录：

1. 在文件资源管理器中定位到目标文件夹
2. 按住Shift键并右键点击空白处
3. 选择"在此处打开命令窗口"或"在此处打开PowerShell窗口"

或者使用-d参数指定下载目录：

gallery-dl.exe -d "目标路径" --write-metadata -u 用户名 -p 密码 https://inkbunny.net/艺术家ID

2. 重新下载已存在的文件

如果之前已经下载过文件，但需要重新下载或补充元数据文件，可以使用以下方法：

gallery-dl.exe --no-skip --write-metadata -u 用户名 -p 密码 https://inkbunny.net/艺术家ID

--no-skip参数会强制重新下载所有文件，包括已存在的文件。

3. 仅生成元数据文件

如果只需要为已下载文件生成元数据文件而不重新下载作品本身，可以使用：

gallery-dl.exe --write-metadata -O event=file,skip -u 用户名 -p 密码 https://inkbunny.net/艺术家ID

高级技巧

1. 批量下载多个艺术家：可以创建包含多个URL的文本文件，然后使用-i参数指定该文件

2. 使用配置文件：创建配置文件可以避免每次输入用户名和密码

3. 限制下载速度：使用--rate-limit参数防止被封禁

4. 选择性下载：通过--filter参数只下载特定类型的作品

注意事项

1. 确保遵守Inkbunny的服务条款和艺术家设定的使用权限

2. 大量下载时建议设置适当的间隔时间，避免对服务器造成过大压力

3. 元数据文件包含重要信息，建议定期备份

4. 如果遇到特殊字符显示问题，可能是系统区域设置导致的，可以尝试调整系统设置

通过掌握这些技巧，用户可以高效地使用gallery-dl工具完整保存Inkbunny平台上的艺术作品及其相关信息。