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 输入

SamplerCustomAdvanced左边的“引导器”接口才是接线终点。将线从BasicGuider右边青色输出口拖至该接口，这一步只需要一条GUIDER线；正确连接后，两端之间会显示青色连线，采样器的guider接口也不再空着。若目标节点上完全找不到guider接口，当前节点就是普通KSampler或其他采样节点。此时可以改用支持GUIDER的高级自定义采样器，也可以按照原采样器的要求，恢复模型及条件的连接方式。

出现青色线条，只能表明引导器支路已经连接至目标端口。图中的噪波、采样器、西格玛和Latent图像仍为空置状态，不能将这张接线图当作完整出图工作流哦。

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

仍然在SamplerCustomAdvanced左侧完成这一步：先补齐LATENT、SIGMAS、SAMPLER和NOISE几路输入，再把采样输出连到后续解码或保存节点，最后点击顶部“运行”即可，操作就ok。任务成功进入队列并跑完时，采样器和BasicGuider都不会显示红色缺失输入提示。若点击后立即报错，应沿端口从上往下排查是否漏线；若错误指向加载失败或模型不匹配，则返回模型、CLIP加载节点，换用同一工作流体系要求的文件。反复点击运行无法消除配置问题，只会白费劲。

两个常见误区

1. 错误用法：将BasicGuider视作CFG控制器。 基础正向引导才是它适合的用途，因为negative和cfg输入压根不存在；显式CFG需求应交给CFGGuider。
2. 误以为接好GUIDER即可出图。 GUIDER仅是高级采样器的一路输入；噪声、采样方法、sigma、Latent、模型文件及后处理链也必须分别配置正确。

最终核对

1. 左侧只能看到模型与条件两个输入口，而画布中该节点确实名为“基本引导器”。
2. 确认紫色MODEL线来自可用模型节点，橙色CONDITIONING线来自正向条件节点。
3. 支持GUIDER类型的高级采样器应接收青色输出，普通model插槽不是连接目标。
4. 噪声、采样器、sigma及Latent均应补齐，并选定电脑里已有的模型，之后才能正式排队。
5. 后续节点能够正常接到采样输出，且运行时不应报模型加载、类型不匹配或缺失输入错误。
6. 文章中的四张界面截图均可正常打开，并分别对应搜索节点、辨认端口、连接上游和连接下游等步骤。

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