先给结论UltralyticsDetectorProvider这个节点搜不到大概率不是你装错了而是你把Impact-Subpack当成一个独立插件来装装完就以为万事大吉。实际上它只是Impact-Pack的“资源包”没有主包你连节点影子都见不着。这篇文章我会从插件机制讲起把安装路径、依赖、模型文件、日志排查全部过一遍照着走基本能解决。1. Impact-Subpack和Impact-Pack到底什么关系1.1 子包和主包的分工Impact-Subpack的全名是ComfyUI_Impact_Subpack英文里Subpack就是“子包”“附属包”的意思。它和Impact-PackComfyUI_Impact_Pack是配套关系主包负责写代码、生成节点子包负责装模型、放辅助文件、跑初始化脚本。很多教程会把Impact-Subpack单独列出来给人感觉它是一个能独立工作的节点插件这是最大的误导。你可以把Impact-Pack想成一台电视机Impact-Subpack是机顶盒。电视没有机顶盒也能看几个频道但想看更多内容必须有机顶盒反过来光有机顶盒没有电视你什么都看不到。节点列表就相当于电视屏幕没装主包屏幕里不可能出现任何Impact系列节点更别想搜到UltralyticsDetectorProvider。我见过不少朋友用ComfyUI-Manager只搜索并安装了Impact_Subpack然后满世界找节点找半天也找不到。这种错误特别常见因为Manager里Subpack的下载量也不小给人造成一种“这是个热门独立插件”的错觉。实际操作中你就算只装了SubpackComfyUI启动时也不会报错因为子包确实有安装脚本和模型文件它能静默加载但没有任何节点暴露出来于是你界面一切正常就是找不到节点。1.2 UltralyticsDetectorProvider节点真实所在再具体一点UltralyticsDetectorProvider这个节点属于Impact-Pack主包里的Detector系列节点。它的作用是配合Ultralytics检测器加载器把YOLOv8等模型变成工作流里可用的检测器常用于人脸检测、物体检测以及抠图、换脸、区域重绘等流程的预处理。所以你在ComfyUI节点列表里能搜到这个名字的前提是Impact-Pack主包已经安装成功并且被ComfyUI正确加载。节点代码在主包模型资源在子包这就是整个问题的核心。另外还要注意UltralyticsDetectorProvider只是一个Provider它本身不执行检测真正执行检测的还需要配合DetectorLoader节点或者使用ImpactPack里的其他检测器节点。在使用上它也分两种加载方式一种是直接用UltralyticsDetectorProvider选择模型文件另一种是通过DetectorLoader加载。先记住这个点后面排查模型文件时会用到。2. 装之前先检查环境别急着复制命令2.1 确认你的ComfyUI版本和安装方式在动手安装之前先搞清楚自己用的是哪种ComfyUI因为目录结构和Python解释器都不一样。如果你用的是官方Windows版也就是ComfyUI_windows_portable目录结构是这样的ComfyUI_windows_portable/ ├─ ComfyUI/ │ ├─ custom_nodes/ │ ├─ models/ │ └─ ... ├─ python_embeded/ │ └─ python.exe └─ run_nvidia_gpu.bat如果你用的是秋叶整合包目录结构基本类似也带一个独立的Python环境通常叫python_embeded或者venv。启动ComfyUI的时候双击的是绘世启动器或者run.bat但底层的ComfyUI目录和custom_nodes位置是相通的。这两种情况安装Impact-Subpack时都不能用系统Python去跑安装脚本也不能用系统的pip去装依赖必须用ComfyUI自带的那套Python环境。很多人卡在这一步命令复制进去提示Python模块不存在其实是因为用了系统Python完全没进到ComfyUI的虚拟环境里。还有一类用户是直接使用桌面版或者说ComfyUI Desktop的这种情况目录位置又会不一样通常在你用户目录下的ComfyUI文件夹里。但安装逻辑一致先找custom_nodes目录再找对应的Python解释器。不确定路径时最简单的办法是打开ComfyUI启动脚本看看它调用的是哪个Python。2.2 检查onnxruntime和ultralytics这两个关键依赖UltralyticsDetectorProvider这个名字里的Ultralytics不是白叫的它底层依赖两个比较重的Python包ultralytics和onnxruntime。ultralytics提供YOLO模型的定义、推理和预处理逻辑。onnxruntime提供ONNX格式模型的推理加速。如果你的Python环境里缺这两个包Impact-Pack主包在加载时虽然不会整个崩溃但在用到Ultralytics相关节点时可能直接报错甚至会显示节点加载失败。有些情况下节点能搜到但拖进画布会报红十有八九就是这里出了问题。所以安装前先检查一下环境。以秋叶整合包为例打开命令行进入到ComfyUI_windows_portable目录然后用下面的命令检查python_embeded\python.exe -m pip list或者直接在命令行里启动Python解释器分别导入测试python_embeded\python.exe -c import ultralytics; import onnxruntime; print(ok)如果报错就安装python_embeded\python.exe -m pip install ultralytics onnxruntime这里一定要强调不要用系统Python的pip去装否则装到哪里去了都不知道ComfyUI根本调不到。2.3 模型文件可以提前准备好Impact-Subpack的安装脚本会帮你下载一些检测模型到ComfyUI的models/ultralytics目录下。但现实是这些模型托管在GitHub或者HuggingFace上国内网络下载速度不稳定经常卡在“正在下载”界面几个小时不动。所以我的建议是先手动确认模型文件再安装子包这样就不用来回纠结网络问题。你需要的检测模型一般放在以下几个目录ComfyUI/models/ultralytics/bbox/ —— 放目标检测模型比如yolov8n.pt、yolov8s-face.ptComfyUI/models/ultralytics/segm/ —— 放分割模型比如yolov8n-seg.ptComfyUI/models/ultralytics/pose/ —— 放姿态模型如果需要的话如果没有这些目录提前创建好再把对应模型文件放进去。用UltralyticsDetectorProvider时它会去这些目录里扫描.pt文件或.onnx文件。如果你已经有现成的YOLO模型放到对应位置即可这是最省事的方式。3. 一步步把Impact-Pack和Subpack装到位3.1 方式一用ComfyUI-Manager一键安装ComfyUI-Manager是目前最主流的插件管理工具秋叶整合包默认自带官方版也可以自行安装。如果你已经有Manager安装步骤很简单第一步先安装主包。在Manager的“Install Custom Nodes”页面搜索框输入Impact Pack找到ComfyUI_Impact_Pack点击Install。等待安装完成后先不要急着装Subpack建议先重启一次ComfyUI确认主包能正常加载。第二步安装子包。同样在Manager里搜索Impact Subpack找到ComfyUI_Impact_Subpack点击Install。安装完成后也不要急着用很多人就是死在“装完直接拖节点”这一步。第三步运行子包的安装脚本。大多数情况下Manager不会自动帮你运行install.py这个脚本负责下载模型和初始化目录。你需要手动去运行它具体命令下一个小节会写。第四步重启ComfyUI。这个流程的问题是Manager安装插件本质上帮你执行git clone但并不会自动帮你处理依赖和运行安装脚本。如果某一步缺失插件虽然下载下来了功能却是不完整的。3.2 方式二手动git clone安装如果你更习惯手动控制或者Manager安装后出现莫名其妙的版本问题可以走git clone这条路。先找到你的custom_nodes目录官方便携版ComfyUI_windows_portable/ComfyUI/custom_nodes秋叶整合包你的安装目录/ComfyUI/custom_nodes然后打开命令行进入这个目录依次执行git clone https://github.com/ltdrdata/ComfyUI-Impact-Pack.git ComfyUI_Impact_Pack git clone https://github.com/ltdrdata/ComfyUI-Impact-Subpack.git ComfyUI_Impact_Subpack注意我在这里把克隆下来的文件夹名明确写了出来分别是ComfyUI_Impact_Pack和ComfyUI_Impact_Subpack目录名不要乱改也不要带多余字符。有些朋友习惯把项目名改成中文或者去掉后缀这容易导致插件加载逻辑找不到对应文件。如果你网络环境不稳定可以换用一些加速镜像或者干脆用浏览器下载zip压缩包再解压到custom_nodes目录。解压后确认文件夹里有pyproject.toml、install.py、modules等文件和目录只要结构完整就行。3.3 运行install.py初始化子包资源这一步是很多教程不会细说的地方。子包下载完成后其实还没完事你必须运行它自带的安装脚本。以官方便携版为例打开命令行切换到ComfyUI_windows_portable目录然后运行python_embeded\python.exe custom_nodes\ComfyUI_Impact_Subpack\install.py如果是秋叶整合包同样的逻辑把python_embeded换成你对应目录下的Python路径即可。这个脚本会做这么几件事检查依赖是否齐全创建models/ultralytics下的bbox、segm、pose等目录尝试下载一些默认的检测模型输出安装结果。如果你在运行过程中报错“No module named ultralytics”或者“No module named onnxruntime”说明依赖还没装好回到2.2节先装依赖。如果你看到类似“Installed”或者目录创建成功的输出说明子包初始化完成。这里还要提醒一句subpack的install.py下载模型时如果网络不好可能会假死。不要傻等直接CtrlC中断然后手动把模型文件放到对应目录效果一样因为脚本最后只是保证“目录存在且有模型”。3.4 验证安装结果重启ComfyUI以后怎么确认装对了一个方法是直接在界面上测试右键打开节点搜索框输入UltralyticsDetectorProvider看能不能搜到。如果搜到了说明主包和子包基本都正常。更稳的方法是看控制台日志。ComfyUI启动时会在命令行窗口打印每个自定义节点的加载情况会显示Import Times也就是花了多少秒加载哪些插件。如果你能看到类似下面的输出说明Impact相关包加载成功了Import times for custom nodes: 0.4 seconds: C:/ComfyUI/custom_nodes/ComfyUI_Impact_Pack 0.1 seconds: C:/ComfyUI/custom_nodes/ComfyUI_Impact_Subpack如果某个插件加载失败控制台会有红色的Traceback或者ERROR信息你要重点关注是不是有依赖缺失。4. 节点找不到的逐条排查清单4.1 搜索方式要正确别在错误分类里翻节点搜索框里输入UltralyticsDetectorProvider时要确保拼写完全正确。它没有空格没有连字符就是UltralyticsDetectorProvider。如果你只搜索Detector也能看到它但你要确认它是否在ImpactPack这个分类下。在ComfyUI右键弹出的菜单里节点分好多个大类。如果没有搜索纯靠手点你要找的位置是ImpactPack节点分类然后往下拉到Detector相关分组。如果你装了Subpack但没装主包这个分类根本不会出现。另外一个常见场景是加载别人分享的工作流。工作流JSON文件里保存的节点类型名是UltralyticsDetectorProvider如果当前ComfyUI没有加载这个节点画布上就会显示一个红色节点或者直接报错。这种情况下即使你能搜到这个节点的名称工作流里的引用依然会因为节点类型不匹配而失败。所以搜索不到不一定是你搜索技术的问题可能是插件没加载成功也可能是工作流本身引用了不同版本的节点名称。我的习惯是先用工作流自带的“缺失节点”提示来判断是什么类型再去处理对应插件。4.2 重启不是关闭浏览器而是结束整个ComfyUI进程“我明明重开了啊还是找不到。”这句话我听了无数次。然后我问怎么重开的十有八九是关闭了浏览器标签页再重新打开localhost:8188实际上ComfyUI后端一直还在运行根本没有重新加载新插件。ComfyUI的自定义节点是在后端启动时加载的不是前端网页加载的。你必须先把运行ComfyUI的那个命令行窗口结束掉也就是按CtrlC停止进程或者直接关掉启动窗口然后重新双击启动脚本等控制台打印出完整的启动信息后再打开浏览器。同时浏览器端也要刷新。就算后端重新加载了旧标签页的缓存里可能还保留着旧节点列表你看到的还是旧状态。建议刷新时用CtrlShiftR强制刷新或者直接开一个无痕窗口测试避免缓存干扰判断。4.3 学会看控制台日志比乱猜高效十倍节点找不到时别急着反复重启先看控制台日志。启动ComfyUI的命令行窗口是这个软件的眼睛它能告诉你每一个自定义节点的加载情况。在启动日志里重点搜索Impact关键词。正常情况下你能看到主包和子包的加载时间。如果只有Subpack看不到Impact_Pack说明主包没有安装或者主包加载时出错了。如果看到某一行报错比如ModuleNotFoundError、AttributeError、TypeError把这些关键信息复制下来。这些报错信息直接指向问题根源。但要注意有些报错不一定会让节点完全“隐藏”只会让部分节点加载失败。比如依赖缺失时ImpactPack分类下有些节点能用有些不能用UltralyticsDetectorProvider可能正好就是那部分不能用的。4.4 模型文件缺失也会伪装成“节点有问题”很多时候节点其实已经加载成功了界面也能搜到但你在使用时报错比如“No model file found”或者“Model not found”这时候问题就变成了模型文件缺失。UltralyticsDetectorProvider节点在拖进工作流后你可以点击它在参数里选择要使用的模型。如果参数下拉框是空的说明models/ultralytics目录下没有可用的模型文件或者目录结构不对。你需要检查ComfyUI主目录下的models文件夹确认是否存在models/ultralytics/bbox这样的路径而不是把模型文件放到了ComfyUI根目录。模型文件格式方面Impact-Pack支持.pt和.onnx但我个人强烈建议优先使用.pt格式因为能避免很多ONNX版本兼容问题尤其在PyTorch版本较老的整合包里。5. 常见报错与踩坑实录5.1 报错“No module named ‘ultralytics’”这个报错经常出现在运行install.py时或者ComfyUI启动时加载ImpactPack的某个依赖时。原因只有一个当前Python环境里没有安装ultralytics包。解决方案参考2.2节用ComfyUI自带的python_embeded来安装。这里再补充一个细节如果你同时装了很多Python版本安装时一定要确认命令里的路径是否指向正确。最笨也最稳的方法是用绝对路径比如D:\ComfyUI_windows_portable\python_embeded\python.exe -m pip install ultralytics onnxruntime安装完成后可以再执行一次导入测试确认没报错。5.2 报错“Impact Pack not found”或者“Please install Impact Pack”这种报错信息通常出现在工作流执行时报错说明当前缺少主包。尤其是某些工作流依赖Subpack里的检测器功能但整个环境里根本没有主包代码。这种情况下只装Subpack是治不好的必须先把ComfyUI_Impact_Pack装上。如果你用Manager装过Subpack而没装主包现在要做的就是回到Manager搜索Impact Pack安装重启基本就解决了。5.3 秋叶整合包特有的路径和版本坑秋叶整合包在国内用户里占比极高但它有一个特点所有插件和依赖都是已经打包好的。如果你在某个旧版本的秋叶包里手动装了新的Impact-Pack主包和Subpack很可能会出现版本冲突因为内置的Python库版本可能不一致。表现就是其他节点都正常唯独Impact相关节点加载失败日志里报一些稀奇古怪的错误。这时候不要硬扛优先看看秋叶整合包自带的插件管理工具提示。有些版本可以在绘世启动器里查看Python环境也可以直接找到python环境目录用它的pip去覆盖安装缺失的依赖。另外秋叶整合包的目录路径里尽量不要有中文和空格。插件用Git工具克隆时路径里有中文可能导致一些莫名其妙的IO错误。如果你的安装路径有中文建议先考虑换目录重装ComfyUI或者至少把custom_nodes里的插件文件夹手动改成纯英文名。还有一个很常见的坑秋叶整合包启动器可能默认使用一个精简版Python环境而不一定是python_embeded。如果你在整合包目录下找不到python_embeded可以用启动器自带的“高级选项”或“环境管理”看看到底用的哪个解释器。实在找不到就打开启动脚本查看里面有没有指向某个exe路径。5.4 模型放好了还是报错“Not supported model type”有些朋友会从网上下载第三方YOLO模型比如Fine-tuning过的模型放到models/ultralytics/bbox目录之后选择模型运行却报错“Not supported model type”。这个问题和插件节点找不到没有直接关系但它是用UltralyticsDetectorProvider时最常见的后续坑。原因通常是模型是ONNX格式但导出的Opset版本过高或者模型中包含了自定义检测头当前Impact-Pack版本无法解析。解决方法是换用Ultralytics官方预训练模型或者重新用ultralytics库导出ONNX时降低Opset版本。如果你是初学用户我建议直接用yolov8n.pt、yolov8s.pt这种官方模型省心很多。5.5 排查速查表我把最常见的六种情况整理成表格方便你对照排查现象可能原因处理方式搜不到UltralyticsDetectorProvider节点没有安装Impact-Pack主包安装ComfyUI_Impact_Pack并重启搜不到节点且Manager里找不到Subpack子包下载不完整或路径错误删除后重新clone确认目录名为ComfyUI_Impact_Subpack运行install.py报错No module named ultralyticsPython依赖缺失用ComfyUI自带python安装ultralytics和onnxruntime节点能搜到拖进画布报红缺少依赖或工作流版本不匹配查看控制台日志检查缺失模块升级Impact-Pack下拉框没有模型可选模型文件缺失或目录不对确保模型在models/ultralytics/bbox、segm、pose目录启动日志里Subpack加载失败子包和主包版本不兼容同时更新主包和子包到最新版重启ComfyUI6. 一些实在话和扩展建议说了这么多其实核心就一句话Impact-Subpack不是独立节点包它只是Impact-Pack的辅助资源包。以后凡是看到类似“Subpack”“Models”这种字样先默认它不是单独的节点插件而是配套资源。遇到问题先确认主包再确认依赖再看模型最后才去怀疑自己“装错了”这个顺序能帮你节约大量时间。另外关于整个ComfyUI生态我个人的建议是能装插件的地方尽量让自定义节点的目录保持干净不要混用多个管理器。有人同时用ComfyUI-Manager和Git命令行安装同一个插件导致版本冲突这是很常见的。选定一个主要方式比如全部用Manager或者全部用git clone不要交错使用。还有一个实际的小技巧插件更新不要太勤也不要长期不更。ComfyUI本身更新节奏较快如果你用的整合包版本很旧插件的更新频率又很高很容易出现新版插件依赖新版ComfyUI的情况这时候你会看到兼容性报错。遇到这类问题优先锁定一套稳定组合ComfyUI版本不动插件也尽量保持在同一时期的版本。最后再给你一个建议碰到任何插件安装问题先打开控制台日志把报错内容复制出来再搜索比在群里问“有没有人遇到同样的问题”要高效得多。日志里的英文报错再长也总有清晰的指向顺着关键字走基本都能解决。经过这一轮排查之后你再回来看UltralyticsDetectorProvider这个节点会发现它其实只是Impact-Pack这个“大礼包”里的一个小功能真正花时间的往往不是安装而是理解组件之间的关系。祝你的工作流早日跑通。
先给结论UltralyticsDetectorProvider这个节点搜不到大概率不是你装错了而是你把Impact-Subpack当成一个独立插件来装装完就以为万事大吉。实际上它只是Impact-Pack的“资源包”没有主包你连节点影子都见不着。这篇文章我会从插件机制讲起把安装路径、依赖、模型文件、日志排查全部过一遍照着走基本能解决。1. Impact-Subpack和Impact-Pack到底什么关系1.1 子包和主包的分工Impact-Subpack的全名是ComfyUI_Impact_Subpack英文里Subpack就是“子包”“附属包”的意思。它和Impact-PackComfyUI_Impact_Pack是配套关系主包负责写代码、生成节点子包负责装模型、放辅助文件、跑初始化脚本。很多教程会把Impact-Subpack单独列出来给人感觉它是一个能独立工作的节点插件这是最大的误导。你可以把Impact-Pack想成一台电视机Impact-Subpack是机顶盒。电视没有机顶盒也能看几个频道但想看更多内容必须有机顶盒反过来光有机顶盒没有电视你什么都看不到。节点列表就相当于电视屏幕没装主包屏幕里不可能出现任何Impact系列节点更别想搜到UltralyticsDetectorProvider。我见过不少朋友用ComfyUI-Manager只搜索并安装了Impact_Subpack然后满世界找节点找半天也找不到。这种错误特别常见因为Manager里Subpack的下载量也不小给人造成一种“这是个热门独立插件”的错觉。实际操作中你就算只装了SubpackComfyUI启动时也不会报错因为子包确实有安装脚本和模型文件它能静默加载但没有任何节点暴露出来于是你界面一切正常就是找不到节点。1.2 UltralyticsDetectorProvider节点真实所在再具体一点UltralyticsDetectorProvider这个节点属于Impact-Pack主包里的Detector系列节点。它的作用是配合Ultralytics检测器加载器把YOLOv8等模型变成工作流里可用的检测器常用于人脸检测、物体检测以及抠图、换脸、区域重绘等流程的预处理。所以你在ComfyUI节点列表里能搜到这个名字的前提是Impact-Pack主包已经安装成功并且被ComfyUI正确加载。节点代码在主包模型资源在子包这就是整个问题的核心。另外还要注意UltralyticsDetectorProvider只是一个Provider它本身不执行检测真正执行检测的还需要配合DetectorLoader节点或者使用ImpactPack里的其他检测器节点。在使用上它也分两种加载方式一种是直接用UltralyticsDetectorProvider选择模型文件另一种是通过DetectorLoader加载。先记住这个点后面排查模型文件时会用到。2. 装之前先检查环境别急着复制命令2.1 确认你的ComfyUI版本和安装方式在动手安装之前先搞清楚自己用的是哪种ComfyUI因为目录结构和Python解释器都不一样。如果你用的是官方Windows版也就是ComfyUI_windows_portable目录结构是这样的ComfyUI_windows_portable/ ├─ ComfyUI/ │ ├─ custom_nodes/ │ ├─ models/ │ └─ ... ├─ python_embeded/ │ └─ python.exe └─ run_nvidia_gpu.bat如果你用的是秋叶整合包目录结构基本类似也带一个独立的Python环境通常叫python_embeded或者venv。启动ComfyUI的时候双击的是绘世启动器或者run.bat但底层的ComfyUI目录和custom_nodes位置是相通的。这两种情况安装Impact-Subpack时都不能用系统Python去跑安装脚本也不能用系统的pip去装依赖必须用ComfyUI自带的那套Python环境。很多人卡在这一步命令复制进去提示Python模块不存在其实是因为用了系统Python完全没进到ComfyUI的虚拟环境里。还有一类用户是直接使用桌面版或者说ComfyUI Desktop的这种情况目录位置又会不一样通常在你用户目录下的ComfyUI文件夹里。但安装逻辑一致先找custom_nodes目录再找对应的Python解释器。不确定路径时最简单的办法是打开ComfyUI启动脚本看看它调用的是哪个Python。2.2 检查onnxruntime和ultralytics这两个关键依赖UltralyticsDetectorProvider这个名字里的Ultralytics不是白叫的它底层依赖两个比较重的Python包ultralytics和onnxruntime。ultralytics提供YOLO模型的定义、推理和预处理逻辑。onnxruntime提供ONNX格式模型的推理加速。如果你的Python环境里缺这两个包Impact-Pack主包在加载时虽然不会整个崩溃但在用到Ultralytics相关节点时可能直接报错甚至会显示节点加载失败。有些情况下节点能搜到但拖进画布会报红十有八九就是这里出了问题。所以安装前先检查一下环境。以秋叶整合包为例打开命令行进入到ComfyUI_windows_portable目录然后用下面的命令检查python_embeded\python.exe -m pip list或者直接在命令行里启动Python解释器分别导入测试python_embeded\python.exe -c import ultralytics; import onnxruntime; print(ok)如果报错就安装python_embeded\python.exe -m pip install ultralytics onnxruntime这里一定要强调不要用系统Python的pip去装否则装到哪里去了都不知道ComfyUI根本调不到。2.3 模型文件可以提前准备好Impact-Subpack的安装脚本会帮你下载一些检测模型到ComfyUI的models/ultralytics目录下。但现实是这些模型托管在GitHub或者HuggingFace上国内网络下载速度不稳定经常卡在“正在下载”界面几个小时不动。所以我的建议是先手动确认模型文件再安装子包这样就不用来回纠结网络问题。你需要的检测模型一般放在以下几个目录ComfyUI/models/ultralytics/bbox/ —— 放目标检测模型比如yolov8n.pt、yolov8s-face.ptComfyUI/models/ultralytics/segm/ —— 放分割模型比如yolov8n-seg.ptComfyUI/models/ultralytics/pose/ —— 放姿态模型如果需要的话如果没有这些目录提前创建好再把对应模型文件放进去。用UltralyticsDetectorProvider时它会去这些目录里扫描.pt文件或.onnx文件。如果你已经有现成的YOLO模型放到对应位置即可这是最省事的方式。3. 一步步把Impact-Pack和Subpack装到位3.1 方式一用ComfyUI-Manager一键安装ComfyUI-Manager是目前最主流的插件管理工具秋叶整合包默认自带官方版也可以自行安装。如果你已经有Manager安装步骤很简单第一步先安装主包。在Manager的“Install Custom Nodes”页面搜索框输入Impact Pack找到ComfyUI_Impact_Pack点击Install。等待安装完成后先不要急着装Subpack建议先重启一次ComfyUI确认主包能正常加载。第二步安装子包。同样在Manager里搜索Impact Subpack找到ComfyUI_Impact_Subpack点击Install。安装完成后也不要急着用很多人就是死在“装完直接拖节点”这一步。第三步运行子包的安装脚本。大多数情况下Manager不会自动帮你运行install.py这个脚本负责下载模型和初始化目录。你需要手动去运行它具体命令下一个小节会写。第四步重启ComfyUI。这个流程的问题是Manager安装插件本质上帮你执行git clone但并不会自动帮你处理依赖和运行安装脚本。如果某一步缺失插件虽然下载下来了功能却是不完整的。3.2 方式二手动git clone安装如果你更习惯手动控制或者Manager安装后出现莫名其妙的版本问题可以走git clone这条路。先找到你的custom_nodes目录官方便携版ComfyUI_windows_portable/ComfyUI/custom_nodes秋叶整合包你的安装目录/ComfyUI/custom_nodes然后打开命令行进入这个目录依次执行git clone https://github.com/ltdrdata/ComfyUI-Impact-Pack.git ComfyUI_Impact_Pack git clone https://github.com/ltdrdata/ComfyUI-Impact-Subpack.git ComfyUI_Impact_Subpack注意我在这里把克隆下来的文件夹名明确写了出来分别是ComfyUI_Impact_Pack和ComfyUI_Impact_Subpack目录名不要乱改也不要带多余字符。有些朋友习惯把项目名改成中文或者去掉后缀这容易导致插件加载逻辑找不到对应文件。如果你网络环境不稳定可以换用一些加速镜像或者干脆用浏览器下载zip压缩包再解压到custom_nodes目录。解压后确认文件夹里有pyproject.toml、install.py、modules等文件和目录只要结构完整就行。3.3 运行install.py初始化子包资源这一步是很多教程不会细说的地方。子包下载完成后其实还没完事你必须运行它自带的安装脚本。以官方便携版为例打开命令行切换到ComfyUI_windows_portable目录然后运行python_embeded\python.exe custom_nodes\ComfyUI_Impact_Subpack\install.py如果是秋叶整合包同样的逻辑把python_embeded换成你对应目录下的Python路径即可。这个脚本会做这么几件事检查依赖是否齐全创建models/ultralytics下的bbox、segm、pose等目录尝试下载一些默认的检测模型输出安装结果。如果你在运行过程中报错“No module named ultralytics”或者“No module named onnxruntime”说明依赖还没装好回到2.2节先装依赖。如果你看到类似“Installed”或者目录创建成功的输出说明子包初始化完成。这里还要提醒一句subpack的install.py下载模型时如果网络不好可能会假死。不要傻等直接CtrlC中断然后手动把模型文件放到对应目录效果一样因为脚本最后只是保证“目录存在且有模型”。3.4 验证安装结果重启ComfyUI以后怎么确认装对了一个方法是直接在界面上测试右键打开节点搜索框输入UltralyticsDetectorProvider看能不能搜到。如果搜到了说明主包和子包基本都正常。更稳的方法是看控制台日志。ComfyUI启动时会在命令行窗口打印每个自定义节点的加载情况会显示Import Times也就是花了多少秒加载哪些插件。如果你能看到类似下面的输出说明Impact相关包加载成功了Import times for custom nodes: 0.4 seconds: C:/ComfyUI/custom_nodes/ComfyUI_Impact_Pack 0.1 seconds: C:/ComfyUI/custom_nodes/ComfyUI_Impact_Subpack如果某个插件加载失败控制台会有红色的Traceback或者ERROR信息你要重点关注是不是有依赖缺失。4. 节点找不到的逐条排查清单4.1 搜索方式要正确别在错误分类里翻节点搜索框里输入UltralyticsDetectorProvider时要确保拼写完全正确。它没有空格没有连字符就是UltralyticsDetectorProvider。如果你只搜索Detector也能看到它但你要确认它是否在ImpactPack这个分类下。在ComfyUI右键弹出的菜单里节点分好多个大类。如果没有搜索纯靠手点你要找的位置是ImpactPack节点分类然后往下拉到Detector相关分组。如果你装了Subpack但没装主包这个分类根本不会出现。另外一个常见场景是加载别人分享的工作流。工作流JSON文件里保存的节点类型名是UltralyticsDetectorProvider如果当前ComfyUI没有加载这个节点画布上就会显示一个红色节点或者直接报错。这种情况下即使你能搜到这个节点的名称工作流里的引用依然会因为节点类型不匹配而失败。所以搜索不到不一定是你搜索技术的问题可能是插件没加载成功也可能是工作流本身引用了不同版本的节点名称。我的习惯是先用工作流自带的“缺失节点”提示来判断是什么类型再去处理对应插件。4.2 重启不是关闭浏览器而是结束整个ComfyUI进程“我明明重开了啊还是找不到。”这句话我听了无数次。然后我问怎么重开的十有八九是关闭了浏览器标签页再重新打开localhost:8188实际上ComfyUI后端一直还在运行根本没有重新加载新插件。ComfyUI的自定义节点是在后端启动时加载的不是前端网页加载的。你必须先把运行ComfyUI的那个命令行窗口结束掉也就是按CtrlC停止进程或者直接关掉启动窗口然后重新双击启动脚本等控制台打印出完整的启动信息后再打开浏览器。同时浏览器端也要刷新。就算后端重新加载了旧标签页的缓存里可能还保留着旧节点列表你看到的还是旧状态。建议刷新时用CtrlShiftR强制刷新或者直接开一个无痕窗口测试避免缓存干扰判断。4.3 学会看控制台日志比乱猜高效十倍节点找不到时别急着反复重启先看控制台日志。启动ComfyUI的命令行窗口是这个软件的眼睛它能告诉你每一个自定义节点的加载情况。在启动日志里重点搜索Impact关键词。正常情况下你能看到主包和子包的加载时间。如果只有Subpack看不到Impact_Pack说明主包没有安装或者主包加载时出错了。如果看到某一行报错比如ModuleNotFoundError、AttributeError、TypeError把这些关键信息复制下来。这些报错信息直接指向问题根源。但要注意有些报错不一定会让节点完全“隐藏”只会让部分节点加载失败。比如依赖缺失时ImpactPack分类下有些节点能用有些不能用UltralyticsDetectorProvider可能正好就是那部分不能用的。4.4 模型文件缺失也会伪装成“节点有问题”很多时候节点其实已经加载成功了界面也能搜到但你在使用时报错比如“No model file found”或者“Model not found”这时候问题就变成了模型文件缺失。UltralyticsDetectorProvider节点在拖进工作流后你可以点击它在参数里选择要使用的模型。如果参数下拉框是空的说明models/ultralytics目录下没有可用的模型文件或者目录结构不对。你需要检查ComfyUI主目录下的models文件夹确认是否存在models/ultralytics/bbox这样的路径而不是把模型文件放到了ComfyUI根目录。模型文件格式方面Impact-Pack支持.pt和.onnx但我个人强烈建议优先使用.pt格式因为能避免很多ONNX版本兼容问题尤其在PyTorch版本较老的整合包里。5. 常见报错与踩坑实录5.1 报错“No module named ‘ultralytics’”这个报错经常出现在运行install.py时或者ComfyUI启动时加载ImpactPack的某个依赖时。原因只有一个当前Python环境里没有安装ultralytics包。解决方案参考2.2节用ComfyUI自带的python_embeded来安装。这里再补充一个细节如果你同时装了很多Python版本安装时一定要确认命令里的路径是否指向正确。最笨也最稳的方法是用绝对路径比如D:\ComfyUI_windows_portable\python_embeded\python.exe -m pip install ultralytics onnxruntime安装完成后可以再执行一次导入测试确认没报错。5.2 报错“Impact Pack not found”或者“Please install Impact Pack”这种报错信息通常出现在工作流执行时报错说明当前缺少主包。尤其是某些工作流依赖Subpack里的检测器功能但整个环境里根本没有主包代码。这种情况下只装Subpack是治不好的必须先把ComfyUI_Impact_Pack装上。如果你用Manager装过Subpack而没装主包现在要做的就是回到Manager搜索Impact Pack安装重启基本就解决了。5.3 秋叶整合包特有的路径和版本坑秋叶整合包在国内用户里占比极高但它有一个特点所有插件和依赖都是已经打包好的。如果你在某个旧版本的秋叶包里手动装了新的Impact-Pack主包和Subpack很可能会出现版本冲突因为内置的Python库版本可能不一致。表现就是其他节点都正常唯独Impact相关节点加载失败日志里报一些稀奇古怪的错误。这时候不要硬扛优先看看秋叶整合包自带的插件管理工具提示。有些版本可以在绘世启动器里查看Python环境也可以直接找到python环境目录用它的pip去覆盖安装缺失的依赖。另外秋叶整合包的目录路径里尽量不要有中文和空格。插件用Git工具克隆时路径里有中文可能导致一些莫名其妙的IO错误。如果你的安装路径有中文建议先考虑换目录重装ComfyUI或者至少把custom_nodes里的插件文件夹手动改成纯英文名。还有一个很常见的坑秋叶整合包启动器可能默认使用一个精简版Python环境而不一定是python_embeded。如果你在整合包目录下找不到python_embeded可以用启动器自带的“高级选项”或“环境管理”看看到底用的哪个解释器。实在找不到就打开启动脚本查看里面有没有指向某个exe路径。5.4 模型放好了还是报错“Not supported model type”有些朋友会从网上下载第三方YOLO模型比如Fine-tuning过的模型放到models/ultralytics/bbox目录之后选择模型运行却报错“Not supported model type”。这个问题和插件节点找不到没有直接关系但它是用UltralyticsDetectorProvider时最常见的后续坑。原因通常是模型是ONNX格式但导出的Opset版本过高或者模型中包含了自定义检测头当前Impact-Pack版本无法解析。解决方法是换用Ultralytics官方预训练模型或者重新用ultralytics库导出ONNX时降低Opset版本。如果你是初学用户我建议直接用yolov8n.pt、yolov8s.pt这种官方模型省心很多。5.5 排查速查表我把最常见的六种情况整理成表格方便你对照排查现象可能原因处理方式搜不到UltralyticsDetectorProvider节点没有安装Impact-Pack主包安装ComfyUI_Impact_Pack并重启搜不到节点且Manager里找不到Subpack子包下载不完整或路径错误删除后重新clone确认目录名为ComfyUI_Impact_Subpack运行install.py报错No module named ultralyticsPython依赖缺失用ComfyUI自带python安装ultralytics和onnxruntime节点能搜到拖进画布报红缺少依赖或工作流版本不匹配查看控制台日志检查缺失模块升级Impact-Pack下拉框没有模型可选模型文件缺失或目录不对确保模型在models/ultralytics/bbox、segm、pose目录启动日志里Subpack加载失败子包和主包版本不兼容同时更新主包和子包到最新版重启ComfyUI6. 一些实在话和扩展建议说了这么多其实核心就一句话Impact-Subpack不是独立节点包它只是Impact-Pack的辅助资源包。以后凡是看到类似“Subpack”“Models”这种字样先默认它不是单独的节点插件而是配套资源。遇到问题先确认主包再确认依赖再看模型最后才去怀疑自己“装错了”这个顺序能帮你节约大量时间。另外关于整个ComfyUI生态我个人的建议是能装插件的地方尽量让自定义节点的目录保持干净不要混用多个管理器。有人同时用ComfyUI-Manager和Git命令行安装同一个插件导致版本冲突这是很常见的。选定一个主要方式比如全部用Manager或者全部用git clone不要交错使用。还有一个实际的小技巧插件更新不要太勤也不要长期不更。ComfyUI本身更新节奏较快如果你用的整合包版本很旧插件的更新频率又很高很容易出现新版插件依赖新版ComfyUI的情况这时候你会看到兼容性报错。遇到这类问题优先锁定一套稳定组合ComfyUI版本不动插件也尽量保持在同一时期的版本。最后再给你一个建议碰到任何插件安装问题先打开控制台日志把报错内容复制出来再搜索比在群里问“有没有人遇到同样的问题”要高效得多。日志里的英文报错再长也总有清晰的指向顺着关键字走基本都能解决。经过这一轮排查之后你再回来看UltralyticsDetectorProvider这个节点会发现它其实只是Impact-Pack这个“大礼包”里的一个小功能真正花时间的往往不是安装而是理解组件之间的关系。祝你的工作流早日跑通。
