%20(1).png)
ComfyUI-StableProjectorzBridge 插件完全指南
1. 插件简介
ComfyUI-StableProjectorzBridge 是一个专门为 Stable Projectorz 和 ComfyUI 之间搭建桥梁的插件。
插件地址： https://github.com/tianlang0704/ComfyUI-StableProjectorzBridge
这个插件的主要作用就像是一个翻译官，让 Stable Projectorz 软件能够直接和 ComfyUI 对话。简单来说，你可以在 Stable Projectorz 里面点击"生成艺术"按钮，然后它会自动把图片和设置信息传递给 ComfyUI，让 ComfyUI 来处理复杂的图像生成工作，处理完成后再把结果返回给 Stable Projectorz。
这样做的好处是：
- 你可以在 Stable Projectorz 里享受简单易用的界面
- 同时利用 ComfyUI 强大的图像处理能力
- 不需要在两个软件之间来回复制粘贴图片
- 支持控制网络（ControlNet）和图像修补（Inpainting）等高级功能
2. 如何安装
方法一：使用 ComfyUI Manager（推荐）
- 打开 ComfyUI
- 点击 "Manager" 按钮
- 在搜索框中输入 "StableProjectorzBridge"
- 点击安装按钮
- 重启 ComfyUI
方法二：手动安装
- 找到你的 ComfyUI 安装目录
- 进入
custom_nodes文件夹 - 打开命令行窗口，输入：
git clone https://github.com/tianlang0704/ComfyUI-StableProjectorzBridge.git - 重启 ComfyUI
3. 节点详细解析
3.1 Projector Controlnet Input 节点
这个节点就像是一个收信箱，专门用来接收 Stable Projectorz 传过来的控制网络图片和遮罩信息。
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 端口号 | port | 数字 | 8188 | 设置这个节点监听哪个"门牌号"来接收信息 | 设置HTTP服务器监听端口 | 如果你的ComfyUI运行在8188端口，就填8188 |
| 图片格式 | image_format | 选择项 | PNG | 决定接收到的图片用什么格式保存 | 定义图像数据的编码格式 | 选PNG质量最好，选JPEG体积小 |
| 超时时间 | timeout | 数字 | 30 | 等待接收信息的最长时间，超过就放弃 | 网络请求超时时间（秒） | 网络慢的话可以设置60秒 |
3.2 Projectorz Output 节点
这个节点就像是一个发信箱，负责把 ComfyUI 处理完的图片发送回 Stable Projectorz。
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片输入 | image | 图片连接 | 必填 | 连接你要发送回去的图片 | 接收图像张量数据 | 把你的图像生成节点的输出连接到这里 |
| 压缩质量 | quality | 数字 | 95 | 发送图片的清晰度，数字越大越清晰 | JPEG压缩质量百分比 | 95是高质量，70是中等质量，适合快速传输 |
| 回传地址 | callback_url | 文本 | 自动 | 告诉节点把图片发送到哪个地址 | HTTP回调URL地址 | 通常由Stable Projectorz自动提供，不需要手动填写 |
3.3 ProjectorzParameter 节点
这个节点就像是一个设置面板，里面包含了所有 Stable Projectorz 的生成参数。
3.3.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本 | 无 | 描述你想要生成什么图片的文字 | 正向提示词文本 | 写"一只可爱的小猫"就能生成猫的图片 |
| 负面提示词 | negative_prompt | 文本 | 无 | 描述你不想在图片中看到的内容 | 负向提示词文本 | 写"模糊，低质量"来避免生成模糊的图片 |
| 生成步数 | steps | 数字 | 20 | 图片生成的精细程度，越多越精细但越慢 | 扩散模型采样步数 | 20步适合快速预览，50步适合高质量输出 |
| 引导系数 | cfg_scale | 数字 | 7.5 | 控制图片有多符合你的描述，越高越严格 | 分类器引导强度 | 7.5是平衡值，太高会过度拟合，太低会偏离描述 |
| 随机种子 | seed | 数字 | -1 | 控制随机性，相同种子生成相同图片 | 随机数生成器种子 | -1是随机种子，固定数字如123456会生成相同结果 |
| 图片宽度 | width | 数字 | 512 | 生成图片的宽度，单位是像素 | 输出图像宽度像素 | 512适合快速生成，1024适合高分辨率 |
| 图片高度 | height | 数字 | 512 | 生成图片的高度，单位是像素 | 输出图像高度像素 | 512适合快速生成，1024适合高分辨率 |
| 采样器 | sampler | 选择项 | euler_a | 选择图片生成的算法方式 | 扩散模型采样算法 | euler_a速度快，dpm_2m质量好 |
| 调度器 | scheduler | 选择项 | normal | 控制生成过程的时间安排 | 噪声调度策略 | normal是标准模式，karras更平滑 |
3.4 ProjectorzControlnetParameter 节点
这个节点专门用来设置控制网络的参数，让你能精确控制图片的生成过程。
3.4.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 控制网络模型 | controlnet_model | 选择项 | 无 | 选择要使用的控制网络模型类型 | ControlNet模型选择 | 选择canny用于线稿控制，depth用于深度控制 |
| 控制强度 | strength | 数字 | 1.0 | 控制网络影响图片生成的强度 | ControlNet影响权重 | 1.0是完全控制，0.5是中等影响，0.1是轻微影响 |
| 开始控制 | start_percent | 数字 | 0.0 | 从生成过程的百分之几开始应用控制 | 控制开始的采样步数百分比 | 0.0从一开始就控制，0.2从20%的步数开始控制 |
| 结束控制 | end_percent | 数字 | 1.0 | 到生成过程的百分之几停止应用控制 | 控制结束的采样步数百分比 | 1.0控制到最后，0.8控制到80%就停止 |
| 预处理器 | preprocessor | 选择项 | none | 选择对输入图片进行什么预处理 | 图像预处理器类型 | canny用于边缘检测，depth用于深度估计 |
| 阈值A | threshold_a | 数字 | 100 | 预处理器的第一个调节参数 | 预处理器参数A | 用于canny边缘检测的低阈值 |
| 阈值B | threshold_b | 数字 | 200 | 预处理器的第二个调节参数 | 预处理器参数B | 用于canny边缘检测的高阈值 |
3.5 Projectorz Inpaint Input 节点
这个节点专门用来接收图像修补（涂抹填充）的信息，让你能在图片的特定区域进行重新生成。
3.5.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 端口号 | port | 数字 | 8188 | 设置接收修补信息的端口号 | HTTP服务器监听端口 | 与ComfyUI主端口保持一致 |
| 遮罩模式 | mask_mode | 选择项 | inpaint | 选择遮罩的处理方式 | 遮罩处理模式 | inpaint是重新生成被遮罩区域，outpaint是扩展图像 |
| 遮罩反转 | invert_mask | 开关 | false | 是否反转遮罩区域 | 遮罩区域反转标志 | false是处理白色区域，true是处理黑色区域 |
| 填充模式 | fill_mode | 选择项 | original | 选择被遮罩区域的初始填充方式 | 初始填充策略 | original保留原图，color用纯色填充，noise用噪声填充 |
3.6 Projectorz WebUI Bridge 节点
这个节点是一个高级的Web界面桥接器，提供更完整的控制选项。
3.6.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 启用状态 | enabled | 开关 | true | 是否启用这个桥接功能 | 桥接器启用开关 | true启用功能，false禁用节点 |
| 监听地址 | host | 文本 | 0.0.0.0 | 设置监听的网络地址 | 网络监听主机地址 | 0.0.0.0表示监听所有网络接口 |
| 端口号 | port | 数字 | 8188 | 设置Web服务的端口号 | Web服务器端口 | 8188是默认端口，避免与其他服务冲突 |
| 跨域设置 | cors_enabled | 开关 | true | 是否允许跨域访问 | CORS跨域资源共享开关 | true允许不同域名访问，false只允许同域 |
| 日志级别 | log_level | 选择项 | INFO | 设置日志记录的详细程度 | 日志输出级别 | INFO记录常规信息，DEBUG记录详细调试信息 |
| 最大连接数 | max_connections | 数字 | 100 | 同时允许的最大连接数量 | 并发连接数限制 | 100适合个人使用，500适合团队使用 |
| 请求超时 | request_timeout | 数字 | 300 | 单个请求的最长处理时间 | 请求超时时间（秒） | 300秒适合复杂生成任务，60秒适合简单任务 |
4. 使用技巧和建议
4.1 基础使用流程
- 在 ComfyUI 中创建一个基础工作流
- 在输入端放置 "Projector Controlnet Input" 节点
- 在输出端放置 "Projectorz Output" 节点
- 在 Stable Projectorz 中点击 "Gen Art" 按钮
- 等待 ComfyUI 处理完成，结果会自动返回
4.2 控制网络使用技巧
- 使用 Canny 控制网络时，建议阈值A设为100，阈值B设为200
- 深度控制网络适合建筑和风景图片的结构控制
- 控制强度建议从0.8开始调试，根据效果调整
4.3 图像修补技巧
- 遮罩边缘要平滑，避免出现锯齿
- 修补区域不要太大，建议不超过图片面积的30%
- 使用原图填充模式能获得更自然的过渡效果
4.4 性能优化建议
- 端口号统一使用8188，避免冲突
- 大图片处理时适当增加超时时间到60秒
- 批量处理时可以调低图片质量到70%以提高速度
5. 常见问题解答
5.1 连接问题
问题： Stable Projectorz 无法连接到 ComfyUI
解决方案：
- 检查端口号是否一致（都设为8188）
- 确认 ComfyUI 正在运行
- 检查防火墙设置
5.2 图片质量问题
问题： 传输的图片质量很差
解决方案：
- 将压缩质量调高到95%
- 选择PNG格式而不是JPEG
- 检查网络连接是否稳定
5.3 超时问题
问题： 经常出现超时错误
解决方案：
- 将超时时间设置为60秒或更长
- 检查ComfyUI工作流是否过于复杂
- 降低图片分辨率以加快处理速度
5.4 遮罩问题
问题： 图像修补效果不理想
解决方案：
- 检查遮罩是否正确（白色区域会被重新生成）
- 尝试反转遮罩设置
- 使用原图填充模式
6. 进阶应用
6.1 批量处理设置
如果你需要处理大量图片，可以：
- 将最大连接数设置为500
- 使用多个输出节点并行处理
- 调整请求超时时间适应复杂任务
6.2 远程访问配置
如果你想在其他设备上使用：
- 将监听地址设为你的内网IP
- 确保路由器端口转发正确配置
- 启用跨域设置以支持不同设备访问
6.3 自定义预处理流程
你可以在输入节点后添加自己的图像处理节点：
- 添加图像尺寸调整节点
- 插入图像增强节点
- 使用自定义的预处理器
这个插件为 Stable Projectorz 和 ComfyUI 之间搭建了一座完美的桥梁，让你能够享受两个软件的优势。通过合理配置各个节点的参数，你可以获得专业级的图像生成效果，同时保持操作的简单性。记住，参数设置没有标准答案，多实验、多调试，找到最适合你项目需求的配置！