ComfyUI Mixlab 插件 Whisper.available False 报错修复

1. 代码在初始化时会强制扫描 models/whisper 文件夹。
2. 如果用户尚未创建该目录，os.listdir() 会直接抛出异常导致模块加载失败。

终极解决方案

第一步：手动创建目录兜底

在你的 ComfyUI 的 /models 目录下，手动新建文件夹：whisper。

第二步：修复源码逻辑漏洞

打开 custom_nodes\comfyui-mixlab-nodes\nodes\Whisper.py，在 model_sizes 扫描逻辑前加入自动创建目录的判断。这样即使文件夹为空也只会返回空列表，不会导致加载失败。

# 确保目录存在，防止 os.listdir 报错抛出 WinError 3
if not os.path.exists(whisper_model_path):
    os.makedirs(whisper_model_path)

# 此时再执行扫描逻辑
model_sizes = [
    d for d in os.listdir(whisper_model_path) 
    if os.path.isdir(os.path.join(whisper_model_path, d)) 
    and os.path.isfile(os.path.join(os.path.join(whisper_model_path, d), "config.json"))
]

第三步：正确放置 Faster-Whisper 模型

由于代码检查 config.json，我们需要下载 Faster-Whisper 格式的模型（如 Systran/faster-whisper-tiny）。Mixlab 的这个节点通常支持以下两类模型：

• Faster-Whisper 模型：例如 tiny, base, small, medium, large-v3 的 CTranslate2 格式文件夹。
• OpenAI 原版模型：.pt 格式的文件。

建议优先尝试 Faster-Whisper 格式，因为代码逻辑里有硬性条件：模型文件夹内必须包含 config.json。

如何获取并放置模型？

可以从 Hugging Face 的 Systran 页面下载。常用的模型包括：

• faster-whisper-tiny (体积小，速度极快)
• faster-whisper-base (平衡性好)
• faster-whisper-large-v3 (精度最高，中文识别强)

正确的文件结构应该是：

H:\PythonProjects1\Win_ComfyUI\models\whisper\large-v3\
 ├── config.json
 ├── model.bin
 ├── tokenizer.json
 └── vocabulary.txt

将下载的文件夹解压到 models/whisper 目录下即可。放好之后，你可以在 ComfyUI 中添加 Load Whisper Model ♾️Mixlab 节点，在下拉菜单里就能看到你刚放进去的文件夹名字了。

验证修复

重启 ComfyUI 后查看控制台日志输出以验证修复：

可以看到控制台显示 Whisper.available 后面没有 False（或者显示了 True），就说明模块已经绕过了路径检查，成功加载到了 ComfyUI 中。

经验总结

在开发 ComfyUI 插件或维护 Python 环境时：

1. Debug 优先：修改 __init__.py 打印 traceback 是定位插件加载问题的万能钥匙。
2. 路径防御性编程：使用 os.listdir 前必做 os.path.exists 或 os.makedirs。

更多节点详情可参考：MixLabPro/comfyui-mixlab-nodes