ComfyUI-GGUF项目加载WAN模型架构类型问题解析

在ComfyUI-GGUF项目使用过程中，用户可能会遇到一个特定的错误提示："Unexpected architecture type in GGUF file, expected one of flux, sd1, sdxl, t5encoder but got 'pig'"。这个问题主要出现在尝试加载某些量化版本的WAN模型(如i2v q4_k_m)时。

问题根源分析

该问题的核心在于GGUF文件中的架构类型标识不匹配。ComfyUI-GGUF项目预期接收的架构类型包括flux、sd1、sdxl或t5encoder，但实际加载的文件却包含了一个意外的'pig'标识。这种情况通常发生在：

1. 使用了非官方渠道获取的模型文件
2. 某些自定义节点修改了原始架构标识
3. 模型转换过程中参数设置不当

解决方案

针对这一问题，开发者提供了几种有效的解决方法：

1. 使用官方模型文件：直接从官方仓库获取正确的GGUF文件，这些文件的架构标识已正确设置为"wan"。

2. 手动修改GGUF元数据：对于已经下载的文件，可以使用llama.cpp提供的GGUF元数据编辑工具，将general.architecture键值修改为wan。

3. 更新ComfyUI-GGUF：最新版本的项目代码已添加了对这类模型的回退处理机制，类似于处理stable diffusion.cpp模型的方式。只要转换代码没有偏离原始键格式，现在应该可以正常加载。

技术背景

GGUF(Generic GPU Unified Format)是一种通用的模型文件格式，它包含了模型的架构信息、参数配置等元数据。当加载器检测到不匹配的架构类型时，会出于安全考虑拒绝加载。这种机制虽然严格，但可以有效防止因模型不兼容导致的各种问题。

最佳实践建议

1. 始终从官方或可信来源获取模型文件
2. 在遇到架构不匹配问题时，优先考虑更新加载器插件
3. 对于自定义转换的模型，确保使用正确的参数设置架构类型
4. 了解不同加载器插件的适用场景，如GGUF Loader与Unet Loader (GGUF)的区别

通过理解这些技术细节和解决方案，用户可以更顺利地使用ComfyUI-GGUF项目加载各种模型，充分发挥其功能。