Model Downloader: Wrong filenames in dropdown when downloading from Civitai

快速结论：该问题出现在 SwarmUI 的 Model Downloader 中粘贴 Civitai 模型链接后，文件下拉框显示的命名与 Civitai 页面“Variants”里看到的名称不一致。核心原因不在 SwarmUI：Civitai API 返回的文件名与网页展示名不同，网页上的“REALISTIC3”、“ART3”等名称根本没有出现在 API 数据中。

适用环境：Issue 中仅确认使用 SwarmUI 的 Model Downloader，并从 Civitai 粘贴模型链接；操作系统、Python、CUDA、PyTorch、显卡等环境未在讨论中说明。

最快修复方案：暂无确认的一步修复方案。按 Issue 结论，这是 Civitai API 数据问题，SwarmUI 侧只能依据 API 返回内容列出文件；维护者表示可以考虑读取文件元数据中的 fp 字段，让文件选择器更容易区分，但讨论中没有确认该改动是否已发布。

注意事项：不要用下拉框名称直接对应网页上的 Variant 名称。需要区分具体文件时，可先悬停 Civitai 下载链接，从 URL 末尾的数字（模型版本或文件相关 ID）对照 SwarmUI 下拉框中的选项；最终文件内容仍应以实际下载结果为准。

问题场景

用户在 SwarmUI 中打开 Model Downloader，把 Civitai 模型链接粘贴到 URL 输入框，然后展开文件下拉框选择要下载的文件。以带多个变体的模型为例（如 https://civitai.com/models/2888019/fasciumkroma?modelVersionId=3406536），用户期望下拉框名称与 Civitai 页面 Download 区域“Variants”中显示的文件名一致，但实际看到的是另一组文件名。浏览器直接下载时，生成的文件名还与两者都不同。

报错原文

Model Downloader: Wrong filenames in dropdown when downloading from Civitai

原因分析

Issue 讨论后确认的根本原因是 Civitai API 返回的数据与 Civitai 网页界面不一致，而不是 SwarmUI 解析错误：

Civitai 网页上展示的“REALISTIC3”、“ART3”等名称在 API 响应中不存在；API 实际返回的版本名包括“ART2”等，文件名形如 fasciumkroma_art2_3238588.safetensors。
SwarmUI 的下拉框依据 API 返回的文件数据生成，因此只能显示 API 提供的名称；当用户预期的版本在 API 中缺失时，下拉框可能选中 API 中第一个实际存在的版本，看起来就像“文件名错位”。
维护者已澄清：“Save As”文件名是 SwarmUI 自动生成，而非直接照搬 Civitai 网页名称，这是有意的设计，但确实容易让用户困惑。
API 返回的文件元数据中包含 fp 字段（例如 bf16、fp8），可作为区分精度版本的辅助信息；讨论中提出读取该字段改善文件选择器显示，但没有确认具体实现和发布日期。

环境排查

确认 SwarmUI 版本；Issue 未记录具体版本，无法据此判断是否包含后续改进。
确认使用的是 Model Downloader 的 URL 粘贴方式，而非手动放置文件。
在 Civitai 页面确认目标模型的版本与文件列表，并注意网页显示名可能与 API 返回名不同。
悬停 Civitai 下载按钮，记录下载 URL 末尾的数字，用于与 SwarmUI 下拉框中的选项对照。
OS、Python、CUDA、PyTorch、显卡等环境在 Issue 中没有证据，暂不作为排查项。

解决步骤

在 Civitai 模型页面找到要下载的文件，将鼠标悬停在下载链接上，查看 URL 末尾的数字（如 models/3351051?fileId=3238588 中的相关 ID）。
回到 SwarmUI Model Downloader 的 URL 字段粘贴模型链接，展开文件下拉框。
用上一步记录的 URL 数字对照下拉框选项，选择对应文件；Issue 中维护者明确建议用这种方式定位文件。
若下拉框名称仍难以区分精度版本，可结合 Civitai API 返回的文件元数据判断；当前界面是否显示 fp 字段取决于 SwarmUI 版本，讨论中仅为改进提议。
不要期望“Save As”自动填入 Civitai 网页上的原始文件名；该字段由 SwarmUI 生成，属于有意行为。

验证方法

选中所选文件并完成下载后，检查实际下载文件的文件名和内容是否与 Civitai 页面上目标变体一致；也可将文件大小、精度信息（如 bf16、fp8）与 Civitai API 数据或页面信息对照。若下拉框仍然缺少网页上看到的某个版本名，说明该版本未出现在 Civitai API 响应中，属于上游数据问题，而非本地 SwarmUI 故障。