PhotoCraft 连接 ComfyUI：Bridge、选区蒙版与结果回传
配置桌面 PhotoCraft ComfyUI Bridge，连接 image 与 target 节点，处理选区蒙版，并排查连接或结果位置错误。
ComfyUI PhotoCraft Bridge 把桌面文档连接到 ComfyUI 工作流，再把结果作为新图层返回。 它是一对 ComfyUI 节点，不是上传到本站的插件；能运行的模型和生成工作流需要另外准备。
验证状态——2026 年 10 月 28 日： 我们核查了 Bridge 项目文档 和 PhotoCraft 控制协议，没有实机运行桌面连接、生成或导出结果测试。Bridge README 描述的是项目方截至 10 月 10 日针对 PhotoCraft 的测试，不代表之后每个版本和系统都已兼容。
OpenFill 与 Bridge：正在配置哪一种？
| 选择 | 适合情况 | 操作位置 |
|---|---|---|
| OpenFill | 希望用伴随面板完成填充、消除和扩图 | 桌面 PhotoCraft 旁的 OpenFill 面板 |
| ComfyUI PhotoCraft Bridge | 已经使用节点，希望自己控制生成图 | 在 ComfyUI 操作，用 PhotoCraft 提供文档和选区 |
两者都是本地桌面工作流，不需要为了其中一种而同时安装另一种。AI 总览 对比了这些选择；网页版与桌面版区别 说明为何这些操作不会给本站 Web 编辑器开启 AI。
安装节点并启用桌面控制
- 保存已打开的工作。记录桌面 PhotoCraft 版本、系统和 ComfyUI 安装位置。先在 ComfyUI 中用普通测试图确认目标生成工作流能运行，避免把模型错误当成连接错误。
- 通过 ComfyUI-Manager 搜索 PhotoCraft Bridge，或按仓库说明安装到
custom_nodes。安装后重启 ComfyUI。 - 查看 ComfyUI 控制台。Bridge 会打印使用交换目录的 PhotoCraft 启动命令。采用适合当前设备的命令；不同安装位置和 shell 可能需要不同的可执行文件路径或引号写法。
- 用该命令启动桌面 PhotoCraft，保证控制端口、令牌文件路径和交换目录与 Bridge 配置一致。在这个受控实例里打开一张小测试图。
官方控制协议 说明了本机回环连接、令牌文件和明确允许读写的目录。Bridge 通过共享目录传递图片。把两个自动化根目录限定为交换目录，不要为了绕过路径错误开放整个磁盘。令牌应保密，也不要把控制端口转发到另一台机器。
显示 ComfyUI 的浏览器标签页只是本地界面，不会让远程网站上的 PhotoCraft 编辑器加入这个连接。
先验证连接，再生成
下面是建议你执行的检查，不是本站团队观察到的结果。用一份可丢弃的测试文档，在 ComfyUI 中添加两个 Bridge 节点：
Photocraft Get Image: image → Photocraft Send Image: image
Photocraft Get Image: target → Photocraft Send Image: target
插入生成节点前，先执行这次简单往返。确认新图层出现在目标文档，并与原图对齐。切换可见性对照，再删除测试图层或撤销插入，并记录结果。这个检查失败时，先修连接，不要急于排查模型或提示词。
然后把已经能运行的图像编辑工作流接在 Get Image 和 Send Image 之间。保留来自同一个 Get 节点的 target 连接，它标明目标文档和位置。不要依赖任务完成时碰巧处于活动状态的文档。
传递选区并回传局部重绘图层
- 保留原始文档，在要修改的区域建立一个小选区。首次先用普通选区，方便检查蒙版方向。
- 在 Get Image 打开
crop_to_selection，通过padding留出周边背景。按局部重绘工作流要求，把图像和蒙版接到对应输入。 - 把生成图像接到 Send Image，并保留 target 连接。在工作流中填写简单提示词，提交一次结果。运行期间保持源文档打开。
- 放大到 100% 检查返回图层，确认位置、周边未修改像素和选区边缘。保存前与原图对照。
- 保存可编辑副本，另外导出交付图片。重新打开两者，确认外观和预期图层。保存与导出指南 说明了文件检查流程。
Bridge 也支持快速蒙版，但红色覆盖通常表示未选中的区域。更改 invert_mask 前先检查方向；图层蒙版也不会自动成为文档选区。如果给 Send Image 额外连接 mask，它会覆盖 target 携带的蒙版。这些细节可能导致生成成功却改错区域。
按失败阶段排查
| 问题 | 下一步检查 |
|---|---|
| 找不到 Bridge 节点 | 确认装在实际启动的 ComfyUI 实例中，查看启动错误并重启 |
| 连接或认证失败 | 对照打印的启动命令，检查运行中的 PhotoCraft 实例、端口和令牌路径 |
| 文件传输失败 | 确认交换目录存在，并与两个自动化根目录一致；查看具体路径错误 |
| 连接检查通过，生成失败 | 再用普通输入运行模型工作流，查看缺模型或内存错误 |
| 结果位置不对 | 连接匹配的 target，检查生成工作流内部是否另做裁剪或缩放 |
| 修改了错误区域 | 检查选区方向、快速蒙版设置，以及是否向 Send Image 另传蒙版 |
每次只改一项，使用相同的小输入重试。求助时写清失败阶段和版本，不要把所有错误统称为“PhotoCraft AI 不能用”。
正式使用前需要确认的限制
Bridge 文档明确说明使用 8 位 PNG 传输：返回 16 位文档的编辑图层仍是 8 位。文档也说明按 sRGB 处理，超出该色域的颜色可能丢失。保留高位深原稿，判断结果能否满足当前任务。
连接、生成、画质和成功导出是四项独立检查，安装节点本身不能证明其中任何一项。如果更喜欢由面板管理预设工作流，可以阅读 OpenFill 指南；这两种集成都不是本站提供的托管 AI 服务。