Error downloading selected_tags.csv

快速结论：该报错发生在 Kohya SS 使用 WD14 captioning 功能时，由于网络连接超时导致 Hugging Face 上的 selected_tags.csv 文件下载失败。优先检查网络代理设置或手动下载文件放置到正确路径。

问题场景

用户在运行 Kohya SS 的 WD14 captioning 功能时，程序尝试从 Hugging Face 下载 selected_tags.csv 文件，但下载过程因网络超时而中断。

报错原文

C:\AI\kob\kohya_ss\venv\lib\site-packages\huggingface_hub\file_download.py:791: FutureWarning: The `force_filename` parameter is deprecated as a new caching system, which keeps the filenames as they are on the Hub, is now in place.
  warnings.warn(
selected_tags.csv:   0%|                                                                     | 0.00/254k [00:00<?, ?B/s]Error while downloading from https://huggingface.co/SmilingWolf/wd-v1-4-convnextv2-tagger-v2/resolve/main/selected_tags.csv: HTTPSConnectionPool(host='huggingface.co', port=443): Read timed out.
Trying to resume download...

原因分析

此问题属于 Hugging Face 下载机制遗留问题。报错中的 force_filename 参数弃用警告以及 Read timed out 表明，旧版下载方式在新的缓存系统下超时。问题已在上游子模块 sd-scripts（PR #2053）中修复。用户当前版本可能尚未包含该修复，或网络环境（如代理、防火墙）导致无法正常连接 Hugging Face。

环境排查

确认 Kohya SS 版本是否为最新 master 分支（已包含 sd-scripts 子模块的修复）。
检查网络：能否直接访问 https://huggingface.co/SmilingWolf/wd-v1-4-convnextv2-tagger-v2/？
确认代理设置：如果有代理，需确保 HTTP_PROXY 或 HTTPS_PROXY 环境变量已正确配置。

解决步骤

更新至最新版本（可优先尝试）：拉取 Kohya SS 当前主分支代码，确保子模块已更新，其中包含 sd-scripts PR #2053 的修复。
手动下载文件：将 selected_tags.csv 手动下载到 Kohya SS 的对应缓存目录下。历史讨论中建议的路径为 kohya_ss\cache\ 或 Hugging Face 的默认缓存目录（例如 C:\Users\用户名\.cache\huggingface\hub）。如果不确定具体位置，可搜索本地已存在的同类 tagger 模型文件的存储路径作为参考。
检查网络连接：尝试直接访问报错中的下载链接，确认是否因网络延迟或封锁导致超时。如果使用代理，可临时关闭代理或配置系统代理环境变量。

验证方法

重新运行 WD14 captioning 功能，观察控制台输出。若不再出现 Error downloading selected_tags.csv 或 Read timed out 信息，并能正常解析 CSV 文件，则问题已解决。

参考来源

bmaltais/kohya_ss #3177

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

Error downloading selected_tags.csv