1. 秋叶ComfyUI启动器与model-list.json概述
秋叶ComfyUI启动器是国内开发者"秋葉aaaki"专为中文用户打造的一站式AI绘画解决方案。这个整合包彻底改变了普通用户使用ComfyUI的方式,将原本复杂的安装配置过程简化为"下载即用"的体验。
启动器的核心功能包括:
- 一键安装与更新机制
- 完整的中文本地化支持
- 强大的模型管理系统
- 预置优化工作流模板
- 针对国内网络的加速优化
其中,model-list.json配置文件是模型管理系统的核心数据源。这个JSON文件定义了所有可通过图形界面下载的模型信息,包括名称、描述、下载地址、保存路径等关键数据。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. model-list.json文件结构解析
2.1 基础JSON结构
model-list.json采用标准的JSON格式,其基本结构如下:
json复制{
"models": [
{
"name": "模型显示名称",
"type": "模型类型",
"base": "基础架构",
"save_path": "保存路径",
"description": "详细描述",
"reference": "参考链接",
"filename": "文件名",
"url": "下载地址",
"size": "文件大小"
},
// 更多模型...
]
}
2.2 关键字段详解
name字段
模型在界面中的显示名称,通常包含以下信息:
- 开发者/组织名(如city96)
- 模型名称(如flux1-dev)
- 量化级别(如Q4_0)
- 文件扩展名(如.gguf)
示例:"city96/flux1-dev-Q4_0.gguf"
type字段
最重要的分类字段,决定模型的用途和保存位置。当前支持11种类型:
- diffusion_model(核心图像生成模型)
- lora(轻量级风格调整模型)
- controlnet(条件控制模型)
- clip(文本编码器)
- clip_vision(图像编码器)
- IP-Adapter(图像提示适配器)
- checkpoint(完整打包模型)
- PuLID(身份保持模型)
- MoGe(几何估计模型)
- depth-pro(深度估计模型)
- SegGPT(图像分割模型)
base字段
标识模型的基础架构,常见值包括:
- FLUX.1(最新架构)
- SDXL(Stable Diffusion XL)
- SD1.5(Stable Diffusion 1.5)
- SD3(Stable Diffusion 3)
- LTX-Video(视频生成架构)
save_path字段
模型下载后的保存路径(相对于ComfyUI根目录)。典型目录结构:
code复制models/
├── checkpoints/
├── diffusion_models/
│ ├── FLUX1/
│ ├── SDXL/
│ └── LTXV/
├── loras/
│ ├── HyperSD/
│ └── DMD2/
├── controlnet/
├── clip/
└── ...
3. 模型类型深度解析
3.1 Checkpoint类型
Checkpoint是完整打包的模型文件,包含运行所需的所有组件。配置文件中唯一的checkpoint模型是:
json复制{
"name": "LTX-Video 2B v0.9 Checkpoint",
"type": "checkpoint",
"base": "LTX-Video",
"save_path": "checkpoints/LTXV",
"description": "LTX-Video is the first DiT-based video generation model...",
"reference": "https://huggingface.co/Lightricks/LTX-Video",
"filename": "ltx-video-2b-v0.9.safetensors",
"url": "https://huggingface.co/Lightricks/LTX-Video/resolve/main/ltx-video-2b-v0.9.safetensors",
"size": "9.37GB"
}
技术特点:
- 基于DiT(Diffusion Transformer)架构
- 实时生成能力(24FPS@768x512)
- 适合短视频创作和动画预览
- 最低需求12GB显存(推荐16GB+)
3.2 Diffusion Model类型
FLUX.1 Dev Diffusion Model (scaled fp8)
json复制{
"name": "FLUX.1 [Dev] Diffusion model (scaled fp8)",
"type": "diffusion_model",
"base": "FLUX.1",
"save_path": "diffusion_models/FLUX1",
"description": "FLUX.1 [Dev] Diffusion model (scaled fp8/11.9GB)",
"reference": "https://huggingface.co/Comfy-Org/flux1-dev/tree/main",
"filename": "flux1-dev-fp8.safetensors",
"url": "https://huggingface.co/Comfy-Org/flux1-dev/resolve/main/flux1-dev-fp8.safetensors",
"size": "11.9GB"
}
技术亮点:
- FP8量化技术(8-bit浮点)
- 相比FP16减少50%内存占用
- 质量损失小于3%
- 适合16GB显存显卡(如RTX 4060 Ti)
FLUX.1 GGUF系列
GGUF格式的优势:
- 支持2-bit到16-bit量化
- 高效内存管理
- 跨平台兼容(CPU/GPU)
量化级别对比:
| 量化级别 | 文件大小 | 显存需求 | 质量评分 | 适用场景 |
|---|---|---|---|---|
| Q2_K | 4.03GB | 6-8GB | 60/100 | 快速草图 |
| Q4_0 | 6.79GB | 10-12GB | 85/100 | 推荐标准 |
| Q5_K_S | 8.29GB | 12-14GB | 93/100 | 高质量 |
| Q8_0 | 12.7GB | 16-20GB | 98/100 | 专业作品 |
| F16 | 23.8GB | 24GB+ | 100/100 | 极致质量 |
3.3 LoRA类型
Hyper-SD系列LoRA
加速原理:
- 知识蒸馏技术
- 教师模型(50步)→ 学生模型(4-16步)
- 文件小(60-140MB),可叠加使用
性能对比:
| 模型 | 标准步数 | Hyper-SD步数 | 加速比 | 质量保持 |
|---|---|---|---|---|
| SD1.5 | 20-25 | 4-8 | 3-5x | 90-95% |
| SDXL | 30-40 | 4-8 | 4-8x | 90-95% |
| FLUX.1 | 20-30 | 8-16 | 2-3x | 95-98% |
使用示例:
python复制[Load LoRA]
├─ lora_name: Hyper-SD-8steps
├─ strength: 1.0
└─ 输出 → MODEL
[KSampler]
├─ model: MODEL
├─ steps: 8 # 关键:减少步数
├─ cfg: 1.0 # 关键:降低CFG
└─ sampler_name: euler
3.4 ControlNet类型
jasperai系列ControlNet
包括三种专业控制模型:
- Upscaler(智能放大)
- Depth(深度引导)
- Surface Normals(法线引导)
深度控制工作流示例:
python复制[Load Image] → [Depth Estimator] → 深度图
[Load ControlNet] → flux-depth-controlnet
[Apply ControlNet] → 深度图 + 提示词
[KSampler] → 生成新图像
Shakker-Labs Union ControlNet
创新点:
- 单一模型支持多种控制类型(边缘/深度/法线/姿态等)
- 自动识别输入类型
- 节省存储空间(标准版3.58GB,fp8版1.79GB)
4. 自定义模型添加指南
4.1 编辑model-list.json
- 定位文件:
秋叶启动器目录/model-list.json - 添加新模型条目(保持JSON格式):
json复制{
"name": "我的自定义模型",
"type": "diffusion_model",
"base": "FLUX.1",
"save_path": "diffusion_models/custom",
"description": "我的自定义FLUX.1模型",
"reference": "https://example.com",
"filename": "custom-model.safetensors",
"url": "https://example.com/custom-model.safetensors",
"size": "7.5GB"
}
4.2 添加后的操作流程
- 保存model-list.json文件
- 重启ComfyUI-Manager
- 在模型列表中搜索自定义模型
- 点击下载安装
注意事项:
- 确保URL链接可访问
- 文件大小需准确填写
- 类型和路径需符合规范
- 建议先备份原始文件
5. 模型架构演进趋势
当前主流架构:
- FLUX.1:DiT架构,性能强大
- SD3:MMDiT架构,多模态支持
- LTX-Video:视频生成专用
未来发展方向:
- 更高效的量化技术(如FP4)
- 模块化程度进一步提高
- 多模态融合(文本+图像+视频)
- 实时生成能力增强
- 对消费级硬件更友好
通过深入理解model-list.json配置文件,用户可以更高效地管理AI绘画模型,充分发挥秋叶ComfyUI启动器的强大功能。无论是使用预置模型还是添加自定义模型,合理的配置都能显著提升创作效率和质量。
