一、插件到底是什么：先建立正确的概念

上一课我们把 ComfyUI 装进了自己的电脑，也提到了 custom_nodes 这个文件夹——注释写着”插件安装目录”。但你可能还没搞明白：插件到底是什么？它和画布上一个个方框（节点）是什么关系？和我们下载的那几个 GB 的大模型又是什么关系？

先把结论放在最前面：插件（Custom Nodes，自定义节点）是一段 Python 扩展代码，装进 ComfyUI 之后会”注册”出一批新的节点；模型则是纯数据文件，不含任何代码。ComfyUI 本体只相当于一个引擎，插件负责给它扩展功能，模型负责提供”绘画功底”。

用一个所有人都熟悉的类比——手机：

• ComfyUI 软件 = 操作系统：提供画布界面、任务调度、显存管理这些基础能力，但它出厂自带的”App”不多（内置节点有限）
• 插件 = App：想要抠图？装一个抠图插件。想用 ControlNet？装对应插件。每个插件都会给系统添一批新功能
• 模型 = 素材资源包：App 再多，没有好素材也做不出东西。模型决定画面风格和质量，但模型自己不会干活，要靠节点去调用

二、插件、节点、模型：三者的关系

2.1 一张表分清三者

2.2 一个具体例子串起来

假设你想给一张照片去除背景。整个链路是这样跑起来的：

1. ComfyUI 本体没有抠图节点 → 这是”能力边界”问题，装内核多少个版本都没用
2. 你去装一个抠图插件（比如 RMBG 类插件）→ 它把抠图节点注册进你的 ComfyUI
3. 你在画布上右键搜索”RMBG”，拖出这个节点，连上加载图片的节点和保存图片的节点 → 这就是用节点搭工作流
4. 插件第一次运行时会自动下载它需要的模型文件（抠图算法的权重），放到 models\rmbg 之类的目录 → 模型到位，才能真正干活

看明白了吗？插件给你节点，节点调用模型，三者缺一不可。很多人卡在这一步，就是因为以为”装了插件就万事大吉”，结果插件需要依赖的模型没下载，或者反过来模型下载了却没有对应插件去调用它。

2.3 术语小卡片

插件 / Custom Nodes

社区开发的 Python 扩展包，为 ComfyUI 注册新节点

节点 Node

画布上有输入输出口的功能方块，工作流的最小积木

Manager

ComfyUI-Manager 插件，插件界的应用商店，装插件的插件

依赖 requirements

插件运行需要的第三方 Python 库，缺了会启动失败

三、插件是怎么被加载的：custom_nodes 机制

3.1 启动那一刻发生了什么

理解加载机制，你会一下子看懂之前遇到过的很多报错。每次双击 run_nvidia_gpu.bat 启动时，ComfyUI 都会做这件事：

1. 扫描：启动时遍历 custom_nodes 下的每一个文件夹
2. 识别：检查文件夹根部有没有 __init__.py，有才算一个合法插件
3. 执行：逐个执行这些 __init__.py，插件在其中完成”节点注册”
4. 呈现：注册成功的新节点，出现在画布右键菜单和双击搜索列表里

这个过程全部记录在控制台日志里。启动时你看到的 Loading: ComfyUI-Manager、Import times: ... 这些行，就是逐个插件的加载记录。如果某个插件加载失败，日志里会出现醒目的 IMPORT FAILED，后面跟着插件名和错误原因。学会看这段日志，插件问题就不再是玄学。

3.2 两个最常见的”假安装”

基于上面的机制，有两个坑几乎人人踩过：

四、ComfyUI-Manager：插件界的”应用商店”

4.1 它是什么

手动去 GitHub 下载插件、解压、装依赖、重启——这套流程能走通，但每次都做会烦死。所以社区发明了 ComfyUI-Manager：它本身也是一个插件（装插件的插件），提供了图形化的插件管理界面，相当于 ComfyUI 的”应用商店 + 应用管家”。

好消息是：我们第 8 课下载的官方便携版已经内置了 Manager，第 8 课启动日志里的 Loading: ComfyUI-Manager 就证明它已经就位。桌面版（Desktop）同样默认内置。也就是说，你什么都不用装，它已经在工作了。

4.2 Manager 能帮你做的五件事

4.3 装插件的标准姿势（预演）

本课先建立概念，第 11 课会带大家实操完整流程。这里先预演一遍正确顺序，混个脸熟：

1. 打开 ComfyUI 界面 → 菜单找到 Manager 按钮
2. 点 Custom Nodes Manager，搜索插件名
3. 点 Install，等待下载（会自动装依赖）
4. 按提示 Restart 重启 ComfyUI
5. 看控制台日志确认没有 IMPORT FAILED
6. 画布右键 / 双击搜索，找到新节点开工

五、导入工作流节点变红：排查决策树

从第三章开始，我们会在课程里分享大量现成工作流。导入工作流时最常遇到的问题就是：画布上出现红色节点，提示 Missing Node。原因很简单——那个工作流用到了你没装的插件。

按这张决策树走，95% 的红节点问题都能解决：

1. 认出红节点的”姓”：红节点名称通常带插件前缀（如 IPAdapter、CR ...、KJNodes），能猜到来自哪个插件
2. 第一招：一键补装：打开 Manager → Install Missing Custom Nodes，列表会列出当前工作流缺失的所有插件，逐个点 Install，装完重启
3. 第二招：手动克隆：Manager 搜不到的小众插件，去 GitHub 找仓库，git clone 或下载 zip 放进 custom_nodes
4. 第三招：补依赖：插件目录里有 requirements.txt 的话，用内置 Python 手动安装依赖
5. 最后检查：目录没有套两层、确实重启过、日志没有红色报错

六、新手必备插件地图：六大类

ComfyUI 社区插件成百上千，全装既拖慢启动又容易冲突。本课程后续 100 多节课只用到其中一小部分，先给大家一张全景地图，心里有数即可，不要现在就全装：

七、常见疑问 FAQ

Q1：插件和模型有什么本质区别？

插件是代码（.py 文件组成的文件夹），决定 ComfyUI 有哪些功能节点；模型是数据（.safetensors 等大文件），是被节点调用的”原料”。插件放 custom_nodes，模型放 models 对应子目录。

Q2：为什么装了插件，节点搜索里还是找不到？

按命中率排序检查：① 没有真正重启 ComfyUI（关控制台窗口再双击 bat）；② 文件夹套了两层；③ 控制台日志里有 IMPORT FAILED（缺依赖）；④ 节点名搜索时大小写或关键词不对——用画布双击空白处的搜索框多换几个关键词试试。

Q3：Manager 里下载插件一直转圈/超时怎么办？

网络问题。临时方案：去插件 GitHub 页面 Code → Download ZIP，解压（注意只留一层文件夹）到 custom_nodes，手动装依赖后重启。长期方案是第 10 课的网络环境配置。

Q4：删除插件直接删文件夹就行吗？

可以，删掉 custom_nodes 下对应文件夹后重启即可。个别插件会在 user 或 models 下留下配置和缓存，介意的话一并清理。删除前建议整个文件夹改名加个 _bak 后缀观察几天，确认无影响再真删——这也是排查”插件冲突”的常用手法。

Q5：插件会让我的电脑中毒吗？

插件是能执行任意代码的 Python 程序，确实存在安全面。把握三条：只用 GitHub 星数高、更新活跃的知名插件；不从来路不明的网盘链接装插件；看到要求输入管理员权限或修改系统目录的插件立即放弃。社区主流插件（本课程用到的）都是安全的。