ComfyUI-ModelResolver：智能解析缺失模型，一键从 Civitai/HF 自动下载

在 ComfyUI 中运行他人分享的工作流时，最头疼的莫过于满屏红色的“Missing Model”提示。内置的缺失模型对话框往往不够智能，无法区分哪些节点真正需要执行，也无法自动从 Civitai 或 Hugging Face 寻找正确的文件。

• GitHub：https://github.com/21omen/ComfyUI-ModelResolver

ComfyUI-ModelResolver能精准检测活动工作流图中实际缺失的模型，忽略静音、绕过和未连接的节点，并通过多源搜索、精确匹配和校验和验证，一键完成模型的下载与部署。

核心亮点：精准、安全、高效

1. 智能图分析，只下需要的

不同于传统工具的全局扫描，ModelResolver 会遍历从输出节点可达的活动路径。

• 忽略无效节点：自动跳过静音（Muted）、绕过（Bypassed）以及没有连接到输出的“死岛”节点。
• 泛化识别：通过节点的 INPUT_TYPES 自动识别模型引用，无论是标准的 Checkpoint Loader 还是自定义节点的加载器，都能准确捕捉。

2. 多源解析与精确匹配

支持从 Civitai 和 Hugging Face 搜索模型。

• 文件名提炼：将复杂的文件名（如 v2_fp16_gguf.safetensors）提炼为核心关键词进行搜索。
• 严格验证：候选结果必须精确匹配文件名（不区分大小写）且类型一致（如 Lora 不会匹配成 Checkpoint），确保下载的文件正是工作流所需的。
• SHA256 去重：如果在不同来源找到哈希值相同的文件，会自动合并显示，避免重复下载。

3. 安全第一：校验和验证

所有下载均在移入目标文件夹前进行 SHA256/MD5 实时计算与验证。

• 断点续传：支持 HTTP Range 请求，意外中断后可从断点继续。
• 坏文件隔离：若校验和不匹配，部分文件会以 .badsha 后缀保留供检查，绝不会让损坏的文件混入你的模型库。

4. 聪明地处理“已存在但重名”的文件

如果你本地已经有了该模型，只是文件名因浏览器重复下载变成了 model (2).safetensors，ModelResolver 能识别出它们其实是同一个文件（通过哈希比对）。它会提示你“Present, just named differently”，你只需在节点下拉菜单中选择已有文件即可，无需再次下载。

快速上手指南

安装

将 ComfyUI-ModelResolver 文件夹复制到 ComfyUI/custom_nodes/ 并重启 ComfyUI。无需额外依赖，它直接使用 ComfyUI 自带的 aiohttp。

配置

首次启动后，扩展文件夹内会生成 config.json。建议填写以下关键信息：

• civitai_api_key：用于加速 Civitai 下载及访问受限内容。
• hf_token：用于访问 Hugging Face 上的私有或受限仓库。
• include_nsfw：设为 true 可搜索 NSFW 模型（默认关闭）。

注意：config.json 包含敏感密钥，切勿提交到公共代码库。修改配置后无需重启，下次请求时自动生效。

使用流程

1. 打开带有缺失模型的工作流。
2. 在侧边栏点击 Model Resolver 标签页。
3. 点击 Search sources，工具会自动搜索并列出高置信度的候选项。
4. 勾选需要的模型，点击 Download selected。
5. 下载完成后，在画布上按 R 键刷新节点列表，然后在对应的加载器节点下拉菜单中选择新下载的文件，红色错误即可消失。

手动添加与故障排除

对于不在主流平台上的模型（如 ModelScope 或私人网盘），可以使用 Add manually 功能：

• 输入直接下载 URL 或本地文件路径。
• 指定目标文件名和文件夹类型。
• 可选填入校验和进行最终验证。

常见问题：

• 下载后节点仍红？ 这是 ComfyUI 的正常行为。请按 R 键刷新节点列表，并手动在下拉菜单中选中新文件。
• 找不到已知模型？ 尝试使用“手动添加”并填入直接 URL。有时文件名过于通用会导致搜索失败。
• HF 下载 403？ 请确保你已在 Hugging Face 网页端接受了该模型的许可协议。