AIO Aux Preprocessor（全功能辅助预处理器）是由 comfyui_controlnet_aux 插件提供的通用辅助预处理节点，它可将输入图像转换为适用于 ControlNet 模型的控制图（如线稿、深度图、人体姿态图等），是进行图像驱动生成的关键组件。

你可以把它理解为一个“图像感知器”——它能把一张图“转译”为 AI 模型能读懂的控制线索，比如：轮廓、边缘、深度、姿势、语义区域等。

常见使用流程示例：

Load Image         │         ▼  AIO Aux Preprocessor         │         ▼   Apply ControlNet

📌 端口与参数

📌 输入端口

🔵 image

图像

通常来自 Load Image 节点，也可接其他图像处理节点的 IMAGE 输出。

📌 参数

preprocessor

预处理器

选择图像预处理方法。

预处理器名称,功能简述AnimeFace_SemSegPreprocessor,动漫人脸语义分割AnyLineArtPreprocessor_aux,任意线稿辅助预处理器BinaryPreprocessor,图像二值化CannyEdgePreprocessor,Canny 边缘检测ColorPreprocessor,基于颜色区域提取DensePosePreprocessor,人体密集姿态估计（DensePose）DepthAnythingPreprocessor,Depth Anything 深度图（旧版）Zoe_DepthAnythingPreprocessor,Zoe + Depth Anything 混合深度图DepthAnythingV2Preprocessor,Depth Anything V2 深度图（推荐）DSINE-NormalMapPreprocessor,DSINE 法线图生成器DWPreprocessor,人体姿势关键点生成器AnimalPosePreprocessor,动物姿势估计HEDPreprocessor,HED 边缘检测FakeScribblePreprocessor,伪草图预处理器（仿手绘）LeReS-DepthMapPreprocessor,LeReS 深度图生成器LineArtPreprocessor,标准线稿提取AnimeLineArtPreprocessor,动漫专用线稿提取LineartStandardPreprocessor,标准化线稿Manga2Anime_LineArt_Preprocessor,漫画转动漫线稿MediaPipe-FaceMeshPreprocessor,MediaPipe 人脸网格检测MeshGraphormer-DepthMapPreprocessor,MeshGraphormer 深度图Metric3D-DepthMapPreprocessor,Metric3D 深度图Metric3D-NormalMapPreprocessor,Metric3D 法线图MiDaS-NormalMapPreprocessor,MiDaS 法线图MiDaS-DepthMapPreprocessor,MiDaS 深度图M-LSDPreprocessor,M-LSD 线条检测BAE-NormalMapPreprocessor,BAE 法线图OneFormer-COCO-SemSegPreprocessor,OneFormer（COCO 语义分割）OneFormer-ADE20K-SemSegPreprocessor,OneFormer（ADE20K 语义分割）OpenposePreprocessor,OpenPose 骨架检测PiDiNetPreprocessor,PiDiNet 边缘检测PyraCannyPreprocessor,Pyramid Canny 边缘检测ImageLuminanceDetector,图像亮度检测ImageIntensityDetector,图像强度（明暗对比）检测ScribblePreprocessor,草图提取（常规）Scribble_XDoG_Preprocessor,草图提取（XDoG 算法）Scribble_PiDiNet_Preprocessor,草图提取（PiDiNet 变种）SAMPreprocessor,SAM（Segment Anything）分割ShufflePreprocessor,打乱图像纹理输入TEEDPreprocessor,TEED 关键点检测TilePreprocessor,图像瓦片预处理TTPlanet_TileGF_Preprocessor,TTPlanet 瓷砖风格（GF版）TTPlanet_TileSimple_Preprocessor,TTPlanet 瓷砖风格（精简版）UniFormer-SemSegPreprocessor,UniFormer 模型语义分割SemSegPreprocessor,语义分割预处理（通用）Zoe-DepthMapPreprocessor,Zoe 深度图

提示：

初次使用某个图像预处理器时，可能需要一些时间下载对应的模型。

这些模型将被置于自定义节点插件的文件夹中。

ComfyUI\custom_nodes\comfyui_controlnet_aux

说明：

我们在使用 AIO Aux Preprocessor 节点时，每一个预处理器的选择都应尽量与所用的 ControlNet 模型类型相匹配，否则可能出现效果不佳、图像结构错乱，甚至完全无法引导生成的情况。

如果你不确定该选哪个预处理器，优先匹配你加载的 ControlNet 模型名称中的关键词（如包含 “scribble”、“depth”、“pose” 等）。

resolution

分辨率

预处理图像的目标分辨率，只需要输入短边尺寸，以像素为单位。

说明：

使用 AIO Aux Preprocessor 节点时，可尝试不同分辨率对比生成结果，通常与最终图像尺寸接近的分辨率效果最好。

📌 输出端口

🔵 IMAGE

图像

输出处理后的图像。可连接到 Apply ControlNet 节点的 image 输入端口。或者，接入 Preview Image 节点进行预览。

💡 使用建议与说明

1、用途广泛

可配合不同的 ControlNet 模型实现多种图像控制目标，如姿态迁移、深度补全、线稿上色等。

2、图像适配建议

使用前请确保输入图像大小、方向和比例与生成目标图一致。

resolution 参数是预处理后图像大小（短边）。

3、与 ControlNet 搭配

AIO Aux Preprocessor 输出的是图像，而非 ControlNet 模型本身，需配合 Load ControlNet Model + Apply ControlNet 节点使用。

快速测试推荐组合：

人像骨架控制：OpenposePreprocessor + control_sd15_openpose线稿重绘：LineArtPreprocessor + control_sd15_lineart深度生成：DepthAnythingV2Preprocessor + control_sd15_depth

“点赞行美意，赞赏是鼓励”