# ComfyUI_bnb_nf4_fp4_Loaders 插件完全指南 ## 1. 插件简介 **插件地址：** https://github.com/silveroxides/ComfyUI_bnb_nf4_fp4_Loaders 这个插件是个什么宝贝呢？简单来说，它就像是一个专门的"模型压缩包解压器"。平时我们用的AI模型文件都很大，就像一个装满东西的大箱子，不仅占地方，打开的时候还特别慢。 这个插件可以让你加载那些被特殊压缩过的模型（叫做NF4或FP4格式），就像把大箱子里的东西重新整理打包，变成几个小盒子，这样不仅节省空间，打开速度也更快。 **主要好处：** - 让你的电脑显存（就是显卡的内存）用得更少 - 模型加载速度更快 - 特别适合显存不够大的朋友使用 ## 2. 如何安装 ### 方法一：通过ComfyUI管理器（推荐） 1. 打开ComfyUI管理器 2. 确保选择了"Channel:dev"选项 3. 搜索"ComfyUI_bnb_nf4_fp4_Loaders" 4. 点击安装即可 ### 方法二：手动安装 1. 打开ComfyUI文件夹中的`custom_nodes`文件夹 2. 在命令行中输入： ``` git clone https://github.com/silveroxides/ComfyUI_bnb_nf4_fp4_Loaders.git ``` 3. 重启ComfyUI **重要提醒：** 安装完成后，还需要安装一个叫"bitsandbytes"的依赖包，这个就像是解压工具，没有它插件就没法工作。 ## 3. 节点详解 ### 3.1 CheckpointLoaderNF4 节点 - 完整模型加载器 这个节点就像是一个专门的"模型文件管家"，它能够加载那些被压缩过的完整AI模型文件。就好比你有一个压缩后的游戏安装包，这个节点就是专门用来解压和运行这个游戏的工具。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 模型文件名 | ckpt_name | 下拉选择 | 根据需要选择 | 选择你要用的压缩模型文件，就像选择要打开哪个压缩包 | 指定要加载的NF4/FP4格式检查点文件 | 从列表中选择你下载的.safetensors文件 | | 量化类型 | quantization_type | nf4/fp4 | nf4 | 选择压缩方式，nf4压缩得更厉害，fp4质量更好一些 | 选择4位量化的具体算法类型 | 一般选nf4就行，显存紧张时的首选 | | 数据类型 | compute_dtype | float16/bfloat16 | float16 | 选择运算时用的数字精度，就像选择计算器的小数位数 | 计算时使用的浮点数精度类型 | float16适合大多数显卡，bfloat16适合新显卡 | | 双量化 | double_quant | True/False | True | 是否进行二次压缩，就像把压缩包再压缩一次 | 是否对量化参数本身也进行量化 | 开启能进一步节省显存，但可能稍微影响质量 | ### 3.2 UnetLoaderNF4 节点 - 核心模型加载器 这个节点专门负责加载AI绘画的"大脑"部分（叫做UNET），就像是专门负责思考怎么画画的那部分。如果说完整模型是一整套画画工具，那这个就是专门的画笔。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | UNET文件名 | unet_name | 下拉选择 | 根据需要选择 | 选择压缩过的画画大脑文件，就像选择要用哪个画家的技能 | 指定要加载的UNET模型文件 | 选择你下载的压缩版UNET文件 | | 量化类型 | quantization_type | nf4/fp4 | nf4 | 选择压缩方式，nf4更省显存，fp4质量稍好 | 选择4位量化的具体算法类型 | 显存小于8G建议用nf4，显存够大可以试试fp4 | | 数据类型 | compute_dtype | float16/bfloat16 | float16 | 选择运算精度，就像选择用多精确的尺子来测量 | 计算时使用的浮点数精度类型 | float16兼容性最好，bfloat16适合RTX 30系以上显卡 | | 双量化 | double_quant | True/False | True | 是否进行二次压缩，能进一步节省显存 | 是否对量化参数本身也进行量化 | 开启能省更多显存，关闭能稍微提升质量 | ### 3.3 CheckpointLoaderFP4 节点 - 高质量模型加载器 这个节点和CheckpointLoaderNF4很像，但专门用FP4格式，就像是同一个压缩软件的"高质量模式"，压缩比稍低，但画质更好。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 模型文件名 | ckpt_name | 下拉选择 | 根据需要选择 | 选择你要用的FP4格式模型文件 | 指定要加载的FP4格式检查点文件 | 从列表中选择.safetensors文件 | | 数据类型 | compute_dtype | float16/bfloat16 | float16 | 选择运算时的数字精度 | 计算时使用的浮点数精度类型 | float16适合大多数显卡 | | 双量化 | double_quant | True/False | False | 是否进行二次压缩 | 是否对量化参数本身也进行量化 | FP4格式建议关闭，保持更好质量 | ### 3.4 UnetLoaderFP4 节点 - 高质量核心模型加载器 专门加载FP4格式的UNET文件，比NF4版本质量稍好，但占用显存也稍多一些。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | UNET文件名 | unet_name | 下拉选择 | 根据需要选择 | 选择FP4格式的画画大脑文件 | 指定要加载的FP4格式UNET文件 | 选择你下载的FP4版本UNET | | 数据类型 | compute_dtype | float16/bfloat16 | float16 | 选择运算精度 | 计算时使用的浮点数精度类型 | float16兼容性最好 | | 双量化 | double_quant | True/False | False | 是否进行二次压缩 | 是否对量化参数本身也进行量化 | FP4建议关闭以保持质量 | ## 4. 使用技巧和建议 ### 4.1 显存不够怎么办？ - 优先使用NF4格式，显存占用最少 - 开启双量化(double_quant)，能进一步节省显存 - 使用float16数据类型，比bfloat16更省显存 ### 4.2 追求画质怎么设置？ - 选择FP4格式，画质比NF4稍好 - 关闭双量化(double_quant)，保持更好的模型精度 - 如果显卡支持，可以试试bfloat16数据类型 ### 4.3 混合使用技巧 建议把UNET用NF4格式加载，然后配合其他插件把T5XXL用GGUF格式加载，这样能获得最好的速度提升。 ### 4.4 模型文件获取 你可以在Hugging Face上搜索相关的模型仓库，或者在Civitai上搜索"NF4"找到压缩过的模型文件。 ## 5. 常见问题解答 **Q: 为什么我的节点不显示？** A: 确保已经安装了bitsandbytes依赖，并且ComfyUI版本是最新的。 **Q: 使用这个插件会影响画质吗？** A: 会有轻微影响，但对于大多数用途来说几乎看不出差别。如果对画质要求极高，可以选择FP4格式。 **Q: 我的显卡不支持怎么办？** A: 这个插件主要适用于NVIDIA显卡，如果你用的是其他显卡，可能无法正常使用。 **Q: 可以和LoRA一起使用吗？** A: 目前这个插件对LoRA的支持还不完善，使用时可能会遇到问题。 **Q: 加载速度真的会提升吗？** A: 是的，特别是在显存不足的情况下，能避免频繁的内存交换，从而提升整体速度。 ## 6. 进阶使用建议 ### 6.1 工作流程优化 建议的使用顺序： 1. 先用UnetLoaderNF4加载核心模型 2. 配合其他文本编码器（如T5XXL的GGUF版本） 3. 按正常流程连接其他节点 ### 6.2 显存监控 使用这个插件时，建议同时监控显存使用情况，找到最适合你显卡的设置组合。 ### 6.3 备份原始工作流 在使用压缩模型之前，建议先备份你的原始工作流，这样如果遇到问题可以随时切换回去。 这个插件就像是给你的AI绘画工具箱安装了一个"压缩大师"，让你在有限的电脑配置下也能愉快地创作。记住，技术是为了让创作更轻松，不要被复杂的参数吓到，多试试就能找到最适合你的设置！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
