WallHaven-Batch-Downloader 是一款专为 WallHaven 壁纸网站设计的批量下载工具，支持自动遍历或指定页数下载壁纸，突破未登录用户的页数限制，提供多种下载控制选项，帮助您高效获取心仪的壁纸。

• ✅ 批量下载 WallHaven 网站壁纸
• ✅ 支持指定页数下载或自动遍历所有页面
• ✅ 支持 Cookie 配置，突破页数限制
• ✅ 支持下载速度和线程数设置
• ✅ 支持暂停/继续、停止下载功能
• ✅ 支持重下失败图片
• ✅ 实时显示下载状态和日志
• ✅ 支持清空日志功能
• ✅ 支持自定义保存路径

首次启动软件时，会自动弹出 Cookie 配置对话框，这是为了突破 WallHaven 对未登录用户的页数限制。

如何获取 Cookie：

1. 打开浏览器，登录 WallHaven 网站

2. 按 F12 打开开发者工具

3. 切换到 Network 标签

4. 刷新页面，选择任意请求

5. 在 Request Headers 中找到 Cookie 字段

6. 复制完整的 Cookie 值到软件输入框中

   

注意：

• 若不填写 Cookie，将只能访问前面几页壁纸
• Cookie 信息仅保存在您的电脑本地，不会上传到任何服务器
• 您可以随时在设置中修改 Cookie

1. 输入下载链接：在"下载链接"输入框中粘贴 WallHaven 网站的搜索链接或分类链接（例如：https://wallhaven.cc/search?q=cat 或 https://wallhaven.cc/toplist）

2. 设置保存路径：

   • 点击"浏览"按钮选择保存文件夹
   • 默认保存路径为桌面的"Wallhaven下载"文件夹

3. 设置下载页数：

   • 在"下载页数"输入框中输入数字
   • 0 表示自动遍历所有页面，直到无图片为止
   • 输入具体数字（如 10）表示只下载前 10 页

1. 点击"开始下载"按钮
2. 观察"下载状态"区域的实时信息
3. 在"运行日志"区域查看详细的下载过程

• 暂停/继续：点击"暂停/继续"按钮可以暂停或恢复下载
• 停止下载：点击"停止下载"按钮可以终止当前下载任务
• 重下失败图片：下载完成后，若有失败图片，"重下失败图片"按钮会变为可用，点击可重新下载失败的图片

• 查看日志："运行日志"区域实时显示下载过程和结果
• 清空日志：点击"清空日志"按钮可以清空当前日志内容

点击"设置"按钮，在弹出的设置对话框中可以配置：

• 在"Cookie信息"标签页中可以查看和修改 Cookie
• 支持复制粘贴完整的 Cookie 字符串
• 保存后立即生效，无需重启软件

• 下载速度限制：设置每秒下载速度（KB/s），防止请求过快被封禁
  • 范围：1-1000000 KB/s（1-1000 MB/s）
  • 默认值：5000 KB/s（5 MB/s）
• 最大线程数：设置同时下载的最大线程数
  • 范围：1-20
  • 默认值：5
  • 建议：根据网络状况调整，一般设置 5-10 较为合适

• 查看软件功能介绍
• 查看开发者信息
• 访问开发者的 Bilibili 空间和个人相册

• 检查网络连接是否稳定
• 尝试降低线程数，过多线程可能导致网络拥堵
• 检查下载速度限制是否设置过低
• 考虑 WallHaven 网站的服务器限制

• 可能是网络波动导致，尝试使用"重下失败图片"功能
• 检查 Cookie 是否过期，若过期请重新获取并设置
• 部分图片可能已被网站删除

• 请检查 Cookie 是否正确设置
• 未登录用户只能访问有限页数，正确设置 Cookie 可以突破限制

• 设置合理的下载速度和线程数
• 确保 Cookie 有效
• 网络不稳定时，尝试降低下载速度
• 定期更新 Cookie

• 就绪：软件已准备就绪，可以开始下载
• 正在初始化下载任务：正在准备下载环境
• 已暂停下载：下载已暂停，点击"暂停/继续"可恢复
• 已继续下载：下载已恢复
• 正在停止下载任务：正在终止当前下载
• 下载任务已完成/停止：下载已完成或被停止

日志中包含以下类型的信息：

• [信息]：常规操作和状态提示
• [结果]：下载完成等重要结果
• [警告]：需要注意的情况
• [错误]：下载失败等错误信息

目前软件不支持快捷键操作，所有功能均通过鼠标点击按钮实现。

• 操作系统：Windows 7/8/10/11
• Python 3.6+
• PyQt5 库
• 稳定的网络连接

1. 请遵守 WallHaven 网站的使用条款，合理使用本工具
2. 不要过度频繁下载，避免给网站服务器造成负担
3. 定期更新 Cookie 以确保下载正常
4. 下载的壁纸仅用于个人用途，请勿用于商业目的
5. 软件会在您的主目录下创建配置文件 .wallhaven_downloader_config.json，用于保存 Cookie 和设置信息

本软件会持续更新，修复问题并添加新功能，建议您关注最新版本。

若您在使用过程中遇到问题，可以通过以下方式获取帮助：

• 查看软件内置的"关于"页面
• 联系开发者：guanggaoniang@google.com

感谢您使用 WallHaven-Batch-Downloader！祝您下载愉快！🎉