NunchakuFluxDiTLoader does not exist

快速结论：这个报错发生在 Krita AI Diffusion 插件通过 ComfyUI 后端调用 Flux 模型时，ComfyUI 未识别到 NunchakuFluxDiTLoader 节点。优先排查是否完整安装了 ComfyUI-nunchaku 节点包及 nunchaku 后端，确保版本兼容。

问题场景

用户在 Krita AI Diffusion 插件（v1.45.0 及部分早期版本）中使用 Flux 模型，尤其是通过插件默认安装的 ComfyUI 后端、自定义 ComfyUI 服务器或 Linux Docker 环境时触发此报错。部分用户在重新安装插件后问题仍未解决。

报错原文

Server error: {'type': 'invalid_prompt', 'message': 'Cannot execute because node NunchakuFluxDiTLoader does not exist.', 'details': "Node ID '#1'", 'extra_info': {}}

原因分析

根本原因是 ComfyUI 无法加载 NunchakuFluxDiTLoader 节点。可能原因包括：

缺失 ComfyUI-nunchaku 节点包（插件所需节点来源：github.com/nunchaku-tech/ComfyUI-nunchaku）。
安装了不兼容的 nunchaku 后端版本。服务器日志显示 ComfyUI-nunchaku 1.0.1 is not compatible with nunchaku 1.0.1. Please update nunchaku to a supported version in ['v1.0.0']，表明版本号存在点号（.）匹配问题。
Linux 环境下 CUDA 版本不兼容，如缺少 libcudart.so.13，导致 nunchaku 后端加载失败。
安装了“面部（Face）”控制模型后意外破坏 nunchaku 节点加载（社区报告的可能原因）。

环境排查

确认 ComfyUI 版本（如 Windows 便携版 v3.70）。
确认 Python 版本（如 3.13.9）。
确认 PyTorch 版本（如 2.9.0+cu130）。
确认 CUDA 版本（Linux 下需检查兼容性）。
确认 ComfyUI-nunchaku 节点包版本（GitHub 仓库中的 comfyui-nunchaku）。
确认 nunchaku 后端版本（通过 pip 或 install wheel 安装的 nunchaku 库，如 nunchaku-1.0.2+torch2.9）。
检查 ComfyUI 服务器日志查看具体错误信息（如版本不兼容或缺失动态库）。
如果是自定义服务器，确认 ComfyUI-nunchaku 节点是否已加载（检查 custom_nodes/ 目录）。

解决步骤

确认节点安装：前往 ComfyUI 的浏览器界面（http://127.0.0.1:8188/），下载 Krita 工作流，观察是否有节点显示为红色（表示缺失或加载失败）。
安装 ComfyUI-nunchaku 节点：通过 ComfyUI Manager 的“Check Missing”功能自动安装，或手动从 github.com/nunchaku-tech/ComfyUI-nunchaku 克隆到 ComfyUI/custom_nodes/ 目录。
安装 nunchaku 后端：如未安装，请按官方安装指南安装对应版本的 nunchaku 库。注意：这一步不是所有 ComfyUI 节点常见的操作，但这里是必需的。
检查服务器日志：重启 ComfyUI 后查看 server.log，重点搜索 “nunchaku” 相关错误。常见问题：版本不兼容提示、缺失 libcudart.so.13。
版本兼容性修复：如果日志显示“ComfyUI-nunchaku 1.0.1 与 nunchaku 1.0.1 不兼容”，请尝试将 nunchaku 后端降级到 v1.0.0（通过 pip install）。或确保两者使用完全一致的主次版本号。
Linux CUDA 问题处理：如果遇到缺失 libcudart.so.13，尝试安装 CUDA Toolkit v13（可从 NVIDIA 开发者网站下载）。
彻底重装（备选）：如果以上均无效，且确认非 Linux/CUDA 问题，可尝试完全卸载 Krita AI Diffusion 插件及 ComfyUI，然后从插件安装器重新安装（注意：重装后仍需手动安装 comfyui-nunchaku 节点和 nunchaku 后端）。
自定义服务器用户：如果是自定义 ComfyUI 后端，检查节点是否被防火墙或路径问题阻止加载。确保 ComfyUI-nunchaku 仓库的 __init__.py 能被正常导入。

验证方法

重启 ComfyUI 与 Krita 后，在 Krita AI Diffusion 插件中选择 Flux 工作流并运行一次任务。若不再弹出 NunchakuFluxDiTLoader does not exist 报错，且节点列表中出现 NunchakuFluxDiTLoader，则问题已解决。也可以在 ComfyUI 浏览器界面中直接加载包含 Flux 的工作流，检查节点是否正常显示。