ComfyUI BasicGuider 基础引导器接线配置教程

咱们折腾自定义采样工作流的时候，明明手里已经有模型和提示词条件了，可SamplerCustomAdvanced偏就只认guider对象，这中间就得靠BasicGuider来牵线搭桥。它的作用超简单：把一份MODEL和一份CONDITIONING打包成GUIDER，特别适合只用正向条件的基础引导支路。不管你用的是Windows、macOS还是Linux，连接方法都一模一样；不过在正式点排队生成之前，得先备好能用的模型，还要把采样器需要的噪声、采样方法、sigma序列和Latent输入都补全才行。

先明确这条支路能够发挥作用的范围

BasicGuider统共就俩输入：model口接扩散模型，conditioning口接提示词编码后的条件。右边只有一个GUIDER输出，不会出图像、Latent或者采样结果。它内部会把传进去的条件存成positive，基础引导强度固定是1.0；节点本身压根就没有negative和cfg这俩参数。要是你需要正负条件加可调CFG的话，得用CFGGuider，别在BasicGuider上瞎找不存在的接口哈。

开始操作前要确认两件事：ComfyUI可以正常打开节点画布；模型目录中已有与工作流匹配的检查点，或相应的独立模型组件。截图中的检查点加载器保留了“请先放入可用的检查点模型”提示，目的正是标注这个前置条件，并不表示照此配置便能直接排队出图。

在画布中加入基本引导器

步骤一：搜索 Basic Guider

先在ComfyUI画布上找一处空白区域，双击后会出现“添加节点”搜索框，在里面输入 Basic Guider。结果正确时，只会列出一个归在“模型 / 采样 / 引导器”分类下的节点，选中“基本引导器”就ok。没有结果可先改搜中文名“基本引导器”；若依旧找不到，应检查前端与后端是否属于同一套当前版本，之后刷新页面重试。

通过搜索结果中的名称与分类即可确认是否选对，注意不要误选带有正负条件及CFG参数的CFGGuider。

步骤二：辨认三个连接端口

节点加入画布后不要立即接线，应先核对端口名称与颜色。左侧紫色“模型”端口属于MODEL类型，橙色“条件”端口属于CONDITIONING类型，右侧青色“引导器”端口属于GUIDER类型。正确节点应有两个输入和一个输出；若接口更多，大概率选成了其他guider节点，删除后从搜索结果重新添加“基本引导器”即可。

核对BasicGuider本身时才需要看这张局部截图：右边的GUIDER口不能插入普通KSampler的model插槽，并且两路输入并非同一种类型。

连接引导器所需的模型与条件

步骤三：连接 MODEL

上游必须是能够输出MODEL的节点。使用一体式检查点时，从“Checkpoint加载器（简易）”的MODEL输出端口连到BasicGuider的“模型”输入端口；使用独立模型加载器时，同样选择MODEL类型端口。连接正确后会显示紫色连线，BasicGuider的模型接口不再空置。若连线无法落到端口，表示上游输出类型不符；不要连接CLIP或VAE端口，应返回加载节点选择真正的MODEL输出端口。

步骤四：连接 CONDITIONING

这路的上游一般是“CLIP文本编码”节点的CONDITIONING输出口。你得先把加载器的CLIP输出接到文本编码节点上，写好正向提示词，再把橙色的CONDITIONING线连到BasicGuider的“条件”输入口。接对的话，紫色和橙色两路线会分别插到对应的接口上。要是文本编码节点没有条件输出，先检查下CLIP接没接好；要是橙色的线插到别的类型接口上自动弹回来了，就重新对准BasicGuider左边的“条件”口插就行。

图中的紫线负责传递模型信号，橙线负责传递正向条件信号。检查点名称处仍是前置条件提示；实际运行时，必须改用电脑中真实存在且与其他节点匹配的模型。

将 GUIDER 连接至高级采样器

步骤五：连接 guider 输入

BasicGuider右边的青色输出口要接向SamplerCustomAdvanced左边的“引导器”接口，本步只需拖出这一条GUIDER线。连接成功的标志是采样器的guider接口不再空置，两个端口之间同时显示青色连线。若目标节点上根本找不到guider接口，当前使用的就是普通KSampler或其他采样节点，此时应换用支持GUIDER的高级自定义采样器，或者按照该采样器原有要求重新连接模型与条件。

图中噪波、采样器、西格玛和Latent图像仍处于空置状态，所以这不是完整的出图工作流；已有的青色连线仅能证明目标端口收到了引导器支路。

步骤六：补齐采样输入后再排队

仍在SamplerCustomAdvanced左侧完成本步：先接齐NOISE、SAMPLER、SIGMAS和LATENT各路输入，再把采样结果送往后续解码或保存节点，最后点击顶部“运行”就ok。若配置正确，任务进入队列后能够正常结束，采样器与BasicGuider也不会显示红色缺失输入提示。点击运行后立即报错时，应沿端口由上至下排查遗漏连线；遇到加载失败或模型不匹配，则返回模型及CLIP加载节点，选用同一工作流体系所需的文件。配置错误无法靠反复点击运行消除，只会白费劲。

两个常见误区

1. 不要用BasicGuider控制CFG。 它并没有negative和cfg输入，只适用于基础正向引导；需要显式CFG时，应改用CFGGuider。
2. 误以为接好GUIDER就能生成图片。 GUIDER只是高级采样器的一路输入；噪声、采样方法、sigma、Latent、模型文件与后处理链也必须分别处于正常状态。

最终核对

1. 确认画布节点名为“基本引导器”，且左侧仅有模型、条件两个输入端口。
2. 紫色MODEL线来自可用模型节点，橙色CONDITIONING线则来自正向条件节点。
3. 不要把它插进普通model插槽；支持该类型的高级采样器才是青色GUIDER输出的连接目标。
4. 噪声、采样器、sigma和Latent全部接齐，并选定电脑中已有的模型后，才能正式排队。
5. 后续节点可以正常接收采样输出，且运行期间不应发生模型加载、类型不匹配或缺失输入错误。
6. 文中四张界面截图均可正常打开，依次对应搜索节点、辨认端口、连接上游线和连接下游线。

当紫色MODEL线、橙色CONDITIONING线与青色GUIDER线全部正确就位，BasicGuider的配置便已完成。之后若错误发生在其他采样输入或模型加载阶段，应沿相应支路排查，无须反复删除已经正确连接的引导器。