# ComfyUI-Q-Align 插件完全使用指南 ## 1. 插件简介 ComfyUI-Q-Align 是一个专门用来给图片打分的插件，就像美食评委给菜品打分一样。这个插件的原地址是：https://github.com/ZHO-ZHO-ZHO/ComfyUI-Q-Align 这个插件基于Q-Align技术，能够像人类评委一样对图片的质量进行评估和打分。想象一下，你有一堆自拍照，不知道哪张最好看，这个插件就像一个专业的摄影师，能告诉你哪张照片质量最高、最符合你的要求。 **这个插件能给你带来什么效果？** - 自动评估图片质量，告诉你哪张图最好 - 根据你的描述文字，判断图片是否符合要求 - 帮你从一堆图片中筛选出最佳的那几张 - 让你不用凭感觉选图，而是有科学依据 **注意：** 这个插件比较"吃配置"，需要16GB以上的显存才能流畅运行，就像玩大型游戏需要好显卡一样。 ## 2. 如何安装 ### 方法一：通过ComfyUI管理器安装（推荐） 1. 打开ComfyUI，点击右下角的"Manager"按钮 2. 在弹出的窗口中选择"Install Custom Nodes" 3. 在搜索框中输入"Q-Align" 4. 找到"ComfyUI-Q-Align"插件，点击"Install"按钮 5. 安装完成后重启ComfyUI ### 方法二：手动安装 1. 打开ComfyUI的安装文件夹 2. 进入`custom_nodes`文件夹 3. 在命令行中输入： ``` git clone https://github.com/ZHO-ZHO-ZHO/ComfyUI-Q-Align.git ``` 4. 重启ComfyUI ## 3. 节点详细解析 ### 3.1 Q-Align Scoring 节点 这个节点就像一个专业的图片评审员，能够根据你给出的文字描述来给图片打分。比如你告诉它"我想要一张清晰的风景照"，它就会评估你的图片有多符合这个要求。 ### 3.2 Q-Align Scoring 节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 输入图像 | image | IMAGE类型 | 必填 | 就像给评委看的照片，你要评分的那张图 | 输入待评估的图像数据 | 连接任何能输出图片的节点，比如"加载图像"节点 | | 文本提示 | text | 文本字符串 | 根据需求 | 告诉评委你想要什么样的图片，比如"美丽的风景" | 用于评估图像质量的文本描述或提示词 | 输入"清晰的人像照片"来评估人像质量 | | 模型路径 | model_path | 文件路径 | 自动检测 | 就像评委大脑里的知识库，决定怎么评分 | Q-Align模型文件的存储位置 | 通常会自动找到下载的模型文件 | | 评分范围 | score_range | 数字范围 | 0-100 | 就像考试分数，0分最差，100分最好 | 输出评分的数值范围设置 | 设置为0-10表示用10分制打分 | | 批量处理 | batch_size | 整数 | 1 | 一次能评几张图，就像一次能看几道菜 | 同时处理的图像数量 | 设置为4表示一次评估4张图片 | ### 3.3 Q-Align Model Loader 节点 这个节点就像是准备评委的"大脑"，需要先加载知识库才能开始评分工作。 ### 3.4 Q-Align Model Loader 节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 模型名称 | model_name | 字符串 | "q-align-v1" | 选择哪个评委来打分，不同评委有不同特长 | 指定要加载的Q-Align模型版本 | 选择"q-align-v1"用于通用图像质量评估 | | 设备类型 | device | 下拉选择 | "auto" | 决定用电脑的哪个部件来工作，显卡更快 | 指定模型运行的硬件设备 | 选择"cuda"使用显卡加速 | | 精度模式 | precision | 下拉选择 | "float16" | 就像画画的精细程度，越精细越慢但越准确 | 模型计算时使用的数值精度 | 选择"float16"平衡速度和准确性 | | 缓存模式 | cache_mode | 布尔值 | True | 决定是否记住之前的结果，像有记忆的评委 | 是否启用模型缓存以提高性能 | 设置为True可以加快重复评估的速度 | ### 3.5 Q-Align Batch Scorer 节点 这个节点就像是能同时评估多张图片的超级评委，一次性给你一堆图片都打上分。 ### 3.6 Q-Align Batch Scorer 节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 图像批次 | images | IMAGE类型 | 必填 | 一次要评分的所有图片，就像一摞照片 | 批量输入的图像数据集合 | 连接能输出多张图片的节点 | | 评估文本 | prompt | 文本字符串 | 必填 | 告诉评委按什么标准打分 | 批量评估时使用的统一文本提示 | 输入"高质量的产品图片"来评估商品图 | | 排序方式 | sort_mode | 下拉选择 | "descending" | 决定分数怎么排列，从高到低还是从低到高 | 评分结果的排序方式 | 选择"descending"把最好的图片排在前面 | | 输出数量 | top_k | 整数 | 5 | 只要前几名，就像选美比赛只看前三名 | 输出评分最高的前K张图像 | 设置为3只输出评分最高的3张图 | | 阈值过滤 | threshold | 浮点数 | 0.5 | 设置及格线，低于这个分数的图片不要 | 过滤掉评分低于此值的图像 | 设置为0.7表示只要评分超过0.7的图片 | ### 3.7 Q-Align Quality Analyzer 节点 这个节点就像是一个图片质量的体检医生，能详细分析图片的各种质量指标。 ### 3.8 Q-Align Quality Analyzer 节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 输入图像 | image | IMAGE类型 | 必填 | 要体检的图片 | 待分析的图像输入 | 连接你想分析的图片 | | 分析维度 | analysis_type | 下拉选择 | "comprehensive" | 选择体检项目，全面检查还是重点检查 | 指定质量分析的维度和类型 | 选择"sharpness"只检查清晰度 | | 详细报告 | detailed_report | 布尔值 | True | 决定要简单结果还是详细报告 | 是否生成详细的质量分析报告 | 设置为True获得完整的质量分析结果 | | 可视化输出 | visualize | 布尔值 | False | 是否要生成图表，像体检报告的图表 | 是否生成质量分析的可视化图表 | 设置为True可以看到质量分析的图形化结果 | ## 4. 使用技巧和建议 ### 4.1 基础使用流程 1. **加载模型**：先用"Q-Align Model Loader"节点加载评分模型 2. **连接图片**：把要评分的图片连接到"Q-Align Scoring"节点 3. **设置标准**：在文本框中输入你的评分标准 4. **获取结果**：运行后就能看到图片的评分结果 ### 4.2 提高评分准确性的小窍门 - **文字描述要具体**：不要只写"好图片"，要写"清晰的人像照片，光线充足，构图居中" - **分批处理**：如果图片太多，建议分批处理，避免内存不够 - **选择合适的模型**：不同模型有不同特长，根据你的图片类型选择 ### 4.3 常见应用场景 - **选择最佳照片**：从多张自拍中选出最好的一张 - **质量筛选**：从大量素材中筛选出高质量的图片 - **风格匹配**：找出最符合特定风格要求的图片 ## 5. 常见问题解答 ### Q1：为什么显示"显存不够"？ **A1：** 这个插件需要16GB以上显存，如果你的显卡显存不够，可以尝试： - 降低批处理数量 - 使用较小的模型 - 关闭其他占用显存的程序 ### Q2：评分结果不准确怎么办？ **A2：** 可能的原因和解决方法： - 检查文字描述是否够具体 - 确认模型是否正确加载 - 尝试不同的评分标准 ### Q3：处理速度太慢怎么办？ **A3：** 可以尝试： - 减少批处理数量 - 使用较低精度模式 - 确保使用显卡加速 ### Q4：如何理解评分结果？ **A4：** 评分通常是0-1之间的数值： - 0.8以上：优秀 - 0.6-0.8：良好 - 0.4-0.6：一般 - 0.4以下：需要改善 ## 6. 进阶使用技巧 ### 6.1 组合使用建议 可以将Q-Align与其他ComfyUI节点组合使用： - 配合图像生成节点，自动筛选最佳生成结果 - 与图像处理节点结合，优化图片质量后再评分 - 结合批处理节点，实现大批量图片的自动化评估 ### 6.2 工作流程优化 建议的工作流程： 1. 模型加载 → 图像输入 → 质量分析 2. 根据分析结果调整参数 3. 批量处理和排序 4. 输出最终结果 ### 6.3 参数调优指南 - **新手**：使用默认参数，重点关注文字描述的准确性 - **进阶**：尝试调整阈值和排序方式，找到最适合的配置 - **专家**：结合多个评估维度，建立个性化的评分体系 这个插件就像是给你配备了一个专业的图片评审团，能够帮助你在海量图片中快速找到最符合要求的那些。记住，好的文字描述是获得准确评分的关键，就像给评委一个清晰的评分标准一样重要。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
