把节点打包成 ComfyUI 子图后,父工作流只能连接子图已经暴露的输入和输出槽。创建子图时,ComfyUI 会根据所选节点的输入和输出生成初始接口,但这个边界可以编辑:通过默认空槽添加连接,重命名或删除槽,也可以让槽与内部节点断开。槽位不会绕过数据类型校验,外部连线仍遵循 ComfyUI 的标准类型验证规则。具体操作可参阅官方子图指南。
外部接口由槽位决定
应把子图边界看作一个接口,而不是内部所有端口的透视图。内部节点的某个输入或输出,只有在子图边界上有对应的暴露槽时,父工作流才能通过子图连接它。没有对应槽的端口仍可在子图内部使用,但不能直接从父工作流接线。
自动生成的槽只是初始接口。官方文档没有说明槽位的一一对应规则,也没有保证所选节点的每个端口都会分别暴露为槽。打包后应进入编辑模式,逐项检查输入槽和输出槽,尤其是选中节点包含多组输入输出、或者你想把实现细节留在子图内部时。槽名用于辨认用途,不会改变槽连接的数据类型。
按顺序检查并编辑边界
如果原先可以连接到内部节点的线,在父工作流中找不到合适入口,请按以下顺序检查:
- 双击子图内部的空白区域进入编辑模式,注意避开控件;也可以点击子图的编辑按钮。
- 在编辑模式中分别检查输入槽和输出槽。把父工作流需要的每条连接,映射到实际暴露的槽,而不是内部节点端口。
- 要暴露新的连接,使用标记为
1的默认空槽。输入槽连接目标内部节点输入,输出槽连接目标内部节点输出。官方指南将这个空槽说明为添加输入或输出连接的入口。 - 要修改现有接口,在槽的连接点上右键,可重命名或删除暴露槽。名称应准确说明信号用途,例如
Image或Mask;命名不会改变信号类型。 - 如果槽不应再指向当前内部节点,在该槽上右键并使用文档列出的断开操作。不要仅根据断开动作推断槽仍可用或在父工作流中具有某种固定状态;应返回父工作流检查最终端口,再按需要将槽连接到目标内部端口。
- 使用顶部导航栏或按
Esc返回父工作流。确认子图节点上出现了所需槽,再尝试从外部连接。
槽位操作在子图编辑模式中进行。参数面板里编辑控件的顺序或可见性是另一项功能,不能代替暴露端口。
按现象诊断连线问题
先观察父工作流或子图编辑界面中出现的情况,再采取对应步骤:
| 观察到的情况 | 可能的边界问题 | 下一步检查 |
|---|---|---|
| 父工作流的子图节点没有所需输入端口 | 没有暴露对应内部输入的槽 | 重新进入编辑模式,通过默认空槽添加连接 |
| 槽位存在,但名称看不出用途 | 接口不易辨认,不一定是连接已断开 | 右键槽位,改成能准确描述信号的名称 |
| 槽位可见,但内部目标不对或没有目标 | 槽已断开,或接到了其他内部端口 | 右键检查槽是否连接到预期的原始节点端口 |
| 尝试接线时被拒绝 | 两端可能不符合标准数据类型校验 | 对比源输出与槽连接的内部端口类型;改用兼容端口,不要假定槽能转换类型 |
| 内部输出不能从外部取得 | 没有将其暴露为输出槽 | 通过默认空槽添加输出连接,再检查父工作流中的子图节点 |
例如,假设一个子图里有一个输出 IMAGE 的节点和一个输出 MASK 的节点,而父工作流需要图像,但子图只暴露了遮罩输出。仅把遮罩槽重命名为 Image 并不能让内部图像输出变得可连接。应新增一个输出槽并将它接到图像输出,再检查父工作流中的端口和类型兼容性。这里的节点输出和类型仅为假设示例,不代表某个具体工作流或实测结果。
用端口清单验收接口
完成调整后,对照内部端口与需要暴露的槽。下表是一个假设清单,不是软件测试结果。
| 内部端口 | 是否对外暴露 | 槽名称 | 数据类型 | 外部连接检查 |
|---|---|---|---|---|
| 生成图像的节点输出 | 是 | Preview Image | IMAGE | 在父工作流中实际尝试连接,并确认 ComfyUI 接受连线 |
| 生成遮罩的节点输出 | 否 | 无 | MASK | 确认父工作流不需要取得这个内部结果 |
| 作为子图输入暴露的下游节点图像输入 | 是 | Source Image | IMAGE | 在父工作流中实际尝试连接,并确认 ComfyUI 接受连线 |
这是一个假设工作表,不是官方测试结果。IMAGE、MASK、端口颜色或其他界面线索只能帮助识别候选连接,不能单独证明某条连接一定会被接受。验收标准是在目标父工作流中实际尝试连线,并随后检查预期的内部端口仍保持正确连接。
排查后续步骤与常见问题
如果默认空槽没有形成预期接口,先确认当前确实处于子图编辑模式,并且使用的是正确方向的空槽。再右键现有槽,检查它是否连接到原始节点;必要时断开并重新连接。返回父工作流后,再检查子图暴露出的端口。
官方文档说明该功能需要 ComfyUI 前端版本 1.24.3 或更高版本;如果看不到编辑控制项,应先核对前端版本,并查看官方子图指南中的更新说明。文档也注明示例界面使用 nightly 前端,实际界面可能不同。本指南聚焦边界槽,不涵盖参数面板中的控件排序或发布子图蓝图。
打包时会自动暴露所有内部端口吗?
创建子图时,ComfyUI 会根据所选节点的输入和输出生成初始子图。仍应检查生成的槽位,并按父工作流的实际需要调整接口;只有由槽代表的端口才能从外部连接,不要因为端口在内部存在就假定它已对外开放。
重命名槽位能让不兼容的连线通过吗?
不能。槽位连接遵循标准数据类型校验。重命名只改变槽位标签,不改变数据类型;连线被拒绝时应改用兼容端口。
怎样删除槽,或让槽与内部节点断开?
进入编辑模式后,在槽的连接点上右键。文档列出的操作包括重命名、删除暴露槽,以及断开槽与原始节点的连接。如果接口不再需要该槽就删除。执行断开后不要预设槽的最终状态;返回父工作流检查暴露端口,再决定是否重新连接或删除。
三个后续追问
- 父工作流实际需要哪些内部输入和输出,哪些应继续作为实现细节留在子图内部?
- 重命名、删除或断开槽位后,父工作流是否仍显示预期端口,并接受预期连线?
- 候选连线被拒绝时,是否检查了源输出和槽所连接的内部端口,而不是只依据名称或颜色判断?
来源与下一步
本文依据公开文档解释操作,并使用明确标注的假设验收示例,不是软件实测。控件与可用功能可能变化,请对照所引手册和你的安装版本。
若你在 Imagild 中继续创作,可将输入要求和验收清单带到照片编辑器。上文讨论的外部软件控件属于其各自产品。