Krita-AI-Diffusion项目中Flux模型的使用指南

Krita-AI-Diffusion项目中Flux模型的使用指南

背景介绍

Krita-AI-Diffusion是一款将AI绘画功能集成到Krita图像编辑软件中的插件项目。该项目通过与ComfyUI等AI绘画后端的集成，为艺术家提供了直接在Krita中使用Stable Diffusion等AI模型的能力。在最新版本中，项目开始支持Flux系列AI模型，这是一种新兴的扩散模型架构。

Flux模型目录结构问题

许多用户在使用过程中遇到了Flux模型无法被正确识别的问题。这主要源于ComfyUI近期对模型目录结构的调整：

1. 原先的"unet"目录已更名为"diffusion_models"
2. 需要正确配置extra_model_paths.yaml文件才能让插件识别多路径下的模型

解决方案详解

目录结构调整

用户需要确保Flux模型存放在正确的目录中。根据ComfyUI的最新规范：

• 纯扩散模型应放置在"diffusion_models"目录下
• 完整检查点(checkpoints)应放置在"checkpoints"目录下

配置文件修改

在ComfyUI的extra_model_paths.yaml文件中，需要正确配置模型路径。以下是推荐的配置示例：

checkpoints: |
     models/checkpoints
     models/diffusion_models

对于同时使用WebUI和ComfyUI的用户，配置可能更为复杂，需要包含多个路径：

checkpoints: |
     /path/to/Stable-diffusion
     /path/to/diffusion_models

模型格式支持

目前插件主要支持以下Flux模型格式：

• flux1-dev-fp8.safetensors
• flux1-schnell-fp8.safetensors
• speedFP8系列模型
• flux1DevHyperNF4等变体模型

需要注意的是，.sft格式的模型可能无法被正确识别，即使修改文件扩展名也无法解决。

常见问题排查

1. 模型不显示：检查目录结构是否正确，配置文件是否修改，并重启ComfyUI服务
2. API错误：某些Flux模型可能引发TypeError，这是ComfyUI的模型检测机制导致的
3. 路径冲突：避免在配置文件中重复引用同一目录

技术建议

1. 对于开发者：建议统一模型目录命名规范，减少因路径变更导致的兼容性问题
2. 对于高级用户：可以尝试建立符号链接(symlink)来管理分散在不同位置的模型文件
3. 对于普通用户：建议将所有模型集中存放在标准目录下，避免复杂的路径配置

通过正确配置目录结构和模型路径，用户可以在Krita-AI-Diffusion中充分利用Flux模型的强大功能，为数字艺术创作提供更多可能性。