快速结论：这个报错通常出现在 Kohya SS 的 WD14 Captioning（tagger）首次或重新下载 Hugging Face 上模型标签文件 selected_tags.csv 时，由于网络读取超时导致下载中断、恢复失败。优先排查到 huggingface.co 的网络连通性与代理设置，而不是本地配置写错。
适用环境：Issue 中确认的环境为 Windows 下运行的 Kohya SS（路径 C:\AI\kob\kohya_ss\，使用 venv 虚拟环境），触发场景为 WD14 Captioning，涉及 Hugging Face 模型 SmilingWolf/wd-v1-4-convnextv2-tagger-v2。Issue 未提供 Python、CUDA、显卡或 PyTorch 版本信息。
最快修复方案：暂无确认的一步修复方案。该问题在上游 sd-scripts#2053 中已修复，按 Issue 官方结论应更新到包含该修复的当前 submodule / master 版本后重试；若下载仍失败需附完整日志重开 Issue。
注意事项：Issue 中用户提到的“手动下载 selected_tags.csv 再放到某处”这一思路，在讨论链中并未给出确认的放置路径，因此不要凭猜测放置文件。报错里的 force_filename 只是弃用警告（FutureWarning），并非导致失败的直接原因；真正的失败是 HTTPSConnectionPool Read timed out。更新代码前请确认 sd-scripts submodule 已同步到包含修复的提交。
问题场景
用户在 Kohya SS 中使用 WD14 Captioning 为图像生成标注（tagging），tagger 需要从 Hugging Face 下载模型文件 SmilingWolf/wd-v1-4-convnextv2-tagger-v2 中的 selected_tags.csv。下载过程中连接 huggingface.co 读取超时，进度条停在 0%，反复尝试恢复下载仍无法完成，导致 WD14 Captioning 无法继续。
报错原文
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...原因分析
最可能的原因是本机到 huggingface.co 的网络连接不稳定或被阻断，导致 HTTPS 读取超时，selected_tags.csv 下载失败。Issue 讨论给出的官方处置是：该下载逻辑与已弃用的 force_filename 参数属于同一批 Hugging Face 下载实现，已由上游 sd-scripts#2053 修复，属于上游问题而非用户操作错误。日志中的 FutureWarning 只是弃用提示，不是报错根因。
环境排查
- 确认 Kohya SS 是否为包含 sd-scripts#2053 修复的版本（重点检查 sd-scripts submodule 是否为当前 master）。
- 确认能否稳定访问 huggingface.co（必要时检查代理 / 镜像设置），这是超时类报错的首要排查点。
- 确认运行方式为 Windows 下的 venv 环境，路径与 Issue 一致与否仅作参考。
- Issue 未提供 Python、CUDA、PyTorch、显卡驱动版本，这些不是本次报错的已确认相关项。
解决步骤
- 先确认网络：测试是否能正常连通 huggingface.co，排除代理、防火墙或区域网络导致的读取超时。
- 将 Kohya SS 更新到当前 master，并确保 sd-scripts submodule 同步到包含 sd-scripts#2053 的提交（该修复即针对此处下载逻辑）。
- 更新后重新运行 WD14 Captioning，观察 selected_tags.csv 是否能完整下载并继续进入标注流程。
- 若仍失败，按 Issue 官方说明，用当前 master 复现并保留完整日志，再回到 Issue 反馈重开。
验证方法
重新执行 WD14 Captioning 后，selected_tags.csv 下载进度能到达 100% 且不再出现 “Read timed out” 与 “Trying to resume download…”，并能正常进入后续标注步骤，即表示问题已解决。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
这个方案解决了吗？
可以继续搜索完整报错，或查看同一工具的其他排查指南。
