解决 nunchaku-flux.1-dev 模型在 2025.11 无法被 ComfyUI / LiblibAI 识别的问题（含正确下载与加载方法）

从 nunchaku-tech 发布的旧版 svdq-int4-flux.1-dev 模型目录文件夹，在 2025.11 之后的 ComfyUI / LiblibAI 新版加载器中无法识别，导致：

• 模型不显示

• UNet / Flux backbone 对不上

• T5XXL / 双 CLIP 加载器无法关联

• disable_unet_model_creation=true 失效

• comfy_config.json 参数不兼容

经过测试，问题主要来自两点：

---

❗ 一、根因：nunchaku-tech 旧目录结构不符合 2025.11 新版模型识别规则

旧模型仓库的结构大概是这样：

svdq-int4-flux.1-dev/ ├── svdq-int4-flux.1-dev.safetensors └── comfy_config.json（旧版）

新版 ComfyUI / LiblibAI 的 Flux Loader 要求：

• 文件命名必须包含 svdq-int4_r32-flux.1-dev.safetensors

• comfy_config.json 内必须包含 axes_dim, context_in_dim, vec_in_dim 等新版字段

• 模型目录名最好与主文件名一致，否则不保证自动识别

• 旧版没有 r32 字段 → 默认会加载失败

• 旧版 UNet disable 标记与新版不兼容

因此旧版 svdq-int4-flux.1-dev 在新系统中经常无法被识别。

---

✅ 二、解决方式：切换到新版 svdq-int4_r32-flux.1-dev.safetensors

HuggingFace 官方仓库已经发布最新 r32 版本。

最新文件位置：

https://huggingface.co/nunchaku-tech/nunchaku-flux.1-dev/tree/main

文件：

svdq-int4_r32-flux.1-dev.safetensors

这是目前唯一 完全兼容 2025.11+ 的强制版本。

---

🟦 三、正确下载模型（最稳定的方法）

你可以选择三种方式下载，我给博客读者放最通用的 Linux / WSL 命令。

方法 1：直接 wget（最简单）

cd /your/flux/model/path/ wget https://huggingface.co/nunchaku-tech/nunchaku-flux.1-dev/resolve/main/svdq-int4_r32-flux.1-dev.safetensors

如果链接跳转正常，你会看到类似：

svdq-int4_r32-flux.1-dev.safetensors saved [6.3G]

这说明模型已经成功下载。

---

方法 2：huggingface-cli（适合需要登录的用户）

pip install huggingface_hub --break-system-packages huggingface-cli login huggingface-cli download nunchaku-tech/nunchaku-flux.1-dev \ svdq-int4_r32-flux.1-dev.safetensors \ --local-dir ./flux1dev --local-dir-use-symlinks False

---

🟩 四、正确放置目录结构（必须符合新规范！）

你需要手动创建一个文件夹，例如：

Flux_dev/

把模型文件放进去：

Flux_dev/ └── svdq-int4_r32-flux.1-dev.safetensors

同时确保目录下有最新版 comfy_config.json（官方仓库里有）。

这样 ComfyUI/LiblibAI 能正确识别为 Flux 1.0 模型。

---

🟧 五、加载效果（正确的话会显示为 FLUX 模型）

如果成功，你会在界面看到：

• 模型名：svdq-int4_r32-flux.1-dev

• 使用 Flux Loader 节点时正常显示

• UNet 与 text encoder 不再报错

• 双 CLIP / T5XXL 自动匹配成功

示例输出（命令行）：

Loaded diffusion model: Flux (svdq-int4_r32-flux.1-dev) Config axes_dim = [16,56,56], depth=19, hidden_size=3072

---

🟦 六、为什么旧版不兼容？（简短解释）

新版本 Flux Loader 要求：

项目	旧版	2025.11+ 新版
文件名规则	svdq-int4-flux.1-dev	svdq-int4_r32-flux.1-dev
comfy_config.json 字段	缺失 axes_dim / vec_in_dim	必须包含
UNet 创建逻辑	旧版 Flux	新版强制关闭 UNet 自动创建
r32 优化	无	必须有（结构对不上会无法识别）
目录结构要求	不严格	严格校验目录与文件匹配

简而言之：

旧版结构（没有 r32）和旧版 comfy_config.json 在 2025.11 已经不被 Loader 认为是“有效 Flux 模型”。

---

🎯 七、最终总结（可给读者一句话版本）

如果你遇到：

• Flux 模型不显示

• 加载报错

• T5XXL 不匹配

• comfy_config.json 不生效

只要做这一件事：

删除旧版模型，重新下载最新版 svdq-int4_r32-flux.1-dev.safetensors，并放到独立目录，即可完全解决。