%20(1).png)
1. 插件简介
ComfyQR-scanning-nodes 是一个专门用来检测和验证二维码的 ComfyUI 插件，它的 GitHub 原地址是：https://github.com/coreyryanhanson/ComfyQR-scanning-nodes
想象一下，你用 AI 生成了一个带有二维码的图片，但是你不知道这个二维码到底能不能被手机扫描识别，或者扫描出来的内容是不是你想要的。这个插件就像是一个"二维码检测器"，可以帮你：
- 从图片中读取二维码里面的文字内容（就像用手机扫一扫一样）
- 检查二维码是否能正常扫描
- 验证二维码里的内容是否和你预期的一致
这个插件特别适合配合 ComfyQR 插件使用，ComfyQR 负责生成二维码，而这个插件负责检测二维码质量。
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐） 1. 打开 ComfyUI Manager 2. 搜索 "ComfyQR-scanning-nodes" 3. 点击安装
方法二：手动安装
1. 进入 ComfyUI 的 custom_nodes 文件夹
2. 打开命令行，输入：
git clone https://github.com/coreyryanhanson/ComfyQR-scanning-nodes.git
3. 重启 ComfyUI
重要提醒： 这个插件需要额外安装 zbar 库才能正常工作。根据你的操作系统：
- Windows：需要单独下载安装 zbar
- Mac：使用 brew install zbar
- Linux：使用包管理器安装 zbar
3. 节点逐一解析
3.1 Read QR Code 节点（读取二维码节点）
这个节点就像是一个"二维码阅读器"，它能从图片中识别出二维码，并把二维码里面的文字内容提取出来。就像你用手机扫一扫功能一样，但是这个是在 ComfyUI 里面自动完成的。
输入接口： - image：需要检测的图片（必须包含二维码）
输出接口： - EXTRACTED_TEXT：从二维码中提取出的文字内容
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| library | library | pyzbar | pyzbar | 选择用哪个工具来读取二维码，就像选择用哪个软件打开文件一样 | 指定QR码解析库，目前只支持pyzbar库 | 保持默认的pyzbar就行，暂时没有其他选项 |
3.2 Validate QR Code 节点（验证二维码节点）
这个节点就像是一个"二维码质量检查员"，它会把从图片中读取出来的二维码内容和你预期的内容进行对比，告诉你二维码是否扫描成功，内容是否正确。
输入接口： - image：原始图片 - extracted_text：从 Read QR Code 节点传来的文字内容
输出接口： - IMAGE：原始图片传递输出 - VALIDATION_CODE：验证结果代码（0=完美匹配，1=无法读取，2=内容不匹配）
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| protocol | protocol | Http/Https/None | 根据需要选择 | 在你输入的网址前面自动加上 http:// 或 https://，就像给地址加上门牌号一样 | 为文本内容添加网络协议前缀，便于URL验证 | 如果你的二维码是网址，选择Https；如果不是网址，选择None |
| text | text | 用户输入的文本 | 你期望的二维码内容 | 你预期二维码里应该包含什么文字，用来和实际扫描结果对比 | 预期的QR码内容，用于与提取的文本进行比较验证 | 比如你想二维码包含"https://baidu.com"，就在这里输入"baidu.com" |
| passthrough | passthrough | True/False | False | 决定当二维码检测失败时是否继续运行后面的节点，就像开关一样 | 控制验证失败时是否中断工作流程执行 | 设为False时，二维码扫描失败会停止整个流程；设为True时会继续运行 |
4. 使用技巧和建议
4.1 提高扫描成功率的方法
- 图片质量要好： 确保二维码图片清晰，不模糊
- 二维码尺寸要合适： 太小的二维码难以识别
- 添加边框： 如果扫描失败，可以在 Read QR Code 节点前面加一个 "Pad Image for Outpainting" 节点，给二维码周围加上白色边框
- 对比度要明显： 黑白对比越明显，扫描越容易成功
4.2 工作流程建议
标准检测流程： 1. 图片输入 → Read QR Code 节点 → 提取文字 2. 图片和提取的文字 → Validate QR Code 节点 → 验证结果 3. 根据验证结果决定是否保存图片
批量检测流程： - 将 passthrough 设为 True，这样即使某些二维码扫描失败，也不会中断整个批量处理过程
5. 常见问题解答
Q1: 安装后节点不显示怎么办？
A: 检查是否安装了 zbar 库。这是必须的依赖库，没有它节点无法正常工作。
Q2: 二维码明明很清楚，为什么扫描不出来？
A: 可能是二维码周围的边框太小。试试在 Read QR Code 节点前面加个 "Pad Image for Outpainting" 节点，给二维码加上更大的白色边框。
Q3: VALIDATION_CODE 返回的数字是什么意思？
A: - 0 = 完美匹配，二维码内容和你预期的完全一致 - 1 = 无法读取，二维码扫描失败 - 2 = 内容不匹配，能扫描但内容和预期不符
Q4: 为什么有时候手机能扫描，但这个插件扫描不出来？
A: 不同的二维码解析库有不同的识别能力。pyzbar 库相对比较严格，有时候会出现这种情况。这是正常现象。
Q5: 可以同时检测多个二维码吗？
A: 目前这个插件主要设计用来检测单个二维码。如果图片中有多个二维码，结果可能不准确。
6. 实际应用场景
6.1 AI 生成二维码质量检测
当你用 AI 生成带有二维码的创意图片时，可以用这个插件来检测： - 二维码是否还能正常扫描 - 扫描出来的内容是否正确 - 批量生成时筛选出质量好的图片
6.2 二维码艺术创作验证
在创作二维码艺术作品时，可以用来验证： - 艺术化处理后的二维码是否还能使用 - 不同风格处理对扫描成功率的影响 - 找到艺术性和实用性的平衡点
6.3 批量二维码处理
当需要处理大量二维码图片时，可以用来： - 自动筛选出能正常扫描的二维码 - 统计二维码的扫描成功率 - 对不同质量的二维码进行分类处理
这个插件虽然功能相对简单，但在二维码相关的 AI 创作和处理工作中非常实用。配合其他 ComfyUI 节点使用，可以构建出强大的二维码处理工作流程。