ComfyUI Yedp Action Director：交互式 3D 视口节点，一键批量渲染 ControlNet 动画通道

ComfyUI-Yedp-Action-Director是一款专为ComfyUI设计的自定义3D视口节点，核心作用是为ControlNet工作流提供3D角色动画的导演、实时预览及批量渲染支持，填补了传统静态图像加载器在动画处理上的短板。

GitHub：https://github.com/yedp123/ComfyUI-Yedp-Action-Director

该节点最突出的优势的是，可将完全交互式的3D视口直接集成至ComfyUI工作流中，无需切换第三方软件，即可实现FBX、GLB两种主流格式动画文件的加载与实时预览，同时能批量渲染出OpenPose、深度、Canny、法线四类关键通道图，为ControlNet生成提供精准驱动。

ComfyUI Yedp Action Director：交互式 3D 视口节点，一键批量渲染 ControlNet 动画通道

与常规静态图像加载器不同，Yedp Action Director 基于Three.js技术在客户端（用户浏览器内）完成所有渲染操作，渲染完成后会自动将像素数据回传至ComfyUI，衔接后续处理流程，大幅提升工作流的连贯性和效率。

主要特性

Yedp Action Director 围绕ControlNet 3D角色动画渲染需求设计，核心特性兼顾实用性与便捷性，每一项功能均针对性解决实际使用中的痛点，具体如下：

交互式3D视口：视口支持完全自由调整大小，搭配轨道控制（旋转、平移、缩放）和实时播放功能，用户可直观查看动画效果，随时调整参数，避免盲目设置导致的渲染无效。
多通道批量渲染：无需逐一生成通道图，单次操作即可批量输出4类关键通道，完美匹配ControlNet多场景使用需求，大幅节省渲染时间，具体通道细节如下：
- 🔴 姿态（POSE）：采用无光照纯色设计，骨骼轮廓清晰可辨，专门适配ControlNet OpenPose骨骼控制场景，确保骨骼识别精准度。
- ⚫ 深度（DEPTH）：生成高质量灰度深度图，支持手动调节近（N）、远（F）参数，可根据实际需求设置最大对比度的白/黑点，有效保留3D角色的体积感和层次感。
- ⚪ Canny（CANNY）：通过程序化边缘光技术，实现精准的边缘检测，生成黑色背景搭配白色发光边缘的线稿图，适配ControlNet Canny线稿控制，能精准捕捉角色轮廓与内部细节。
- 🔵 法线（NORMAL）：输出标准RGB格式法线贴图，可精准还原3D角色的几何表面细节，适配ControlNet法线贴图控制，常用于表面纹理优化和光照效果调整。
广泛格式支持：兼容标准.fbx和.glb两种主流动画文件格式，用户无需额外进行格式转换，直接加载即可使用，适配大多数3D动画资源（如Mixamo动画库）。
智能骨骼重定向：具备自动骨骼名称检测与规范化功能，可完美兼容Mixamo等主流动画平台的资源，无需用户手动修改骨骼名称，避免因骨骼不匹配导致的加载失败或动画异常。
无限UI缩放：节点UI支持垂直、水平双向无限缩放，可根据用户浏览器尺寸、工作区大小灵活调整，适配大屏编辑、小屏预览等不同使用场景，提升操作舒适度。

安装步骤

Yedp Action Director 安装流程简洁，无需额外安装复杂的Python依赖，仅需4步即可完成加载，适配ComfyUI标准运行环境，具体步骤如下（全程保留原文命令及路径细节）：

克隆仓库至自定义节点目录：打开终端，输入以下命令，将节点仓库克隆至ComfyUI的custom_nodes目录下（确保终端可正常执行git命令）：

cd ComfyUI/custom_nodes/ 

git clone https://github.com/YourUsername/ComfyUI-Yedp-Action-Director.git

安装依赖：该节点无需额外安装Python依赖，仅需确保ComfyUI本身的标准运行环境正常即可；前端所需的Three.js库会在节点加载时自动动态加载，无需用户手动下载配置。

添加动画文件：为确保节点能正常识别动画资源，需按指定路径放置动画文件，具体操作如下：

在ComfyUI根目录下的input文件夹内，新建一个名为“yedp_anims”的文件夹（文件夹名称不可修改，否则节点无法识别）。
将后缀为.fbx或.glb格式的3D角色动画文件，直接放入新建的yedp_anims文件夹中。
确认文件路径无误：最终动画文件路径为“ComfyUI/input/yedp_anims/”，若路径错误，节点下拉菜单中将无法找到动画文件。

重启ComfyUI：完成上述所有操作后，重启ComfyUI软件，节点将自动加载，重启后即可在节点列表中找到Yedp Action Director，开始使用。

使用方法

Yedp Action Director 操作逻辑清晰，适配ComfyUI常规工作流，从添加节点到连接输出，仅需6步即可完成渲染准备，具体步骤（保留原文所有操作细节，补充逻辑衔接）如下：

添加节点：在ComfyUI工作画布空白处，右键点击弹出菜单，依次选择“Yedp → MoCap → Yedp Action Director”，即可将节点添加至当前工作流中。
选择动画：点击节点界面中的动画下拉菜单，菜单中将显示yedp_anims文件夹内的所有动画文件（.fbx、.glb格式），直接选中目标动画文件即可完成加载。
调整基础设置：根据渲染需求，设置输出图像及动画的基础参数，参数设置直接影响最终渲染效果，具体如下：
- 宽度/高度：设置输出通道图的分辨率，建议与ControlNet预处理器要求的分辨率保持一致（示例：512x512），避免后续缩放导致的细节丢失。
- 帧数：设置需要渲染的动画总帧数，需根据动画本身的时长和需求选择，帧数越多，渲染时间越长，建议按需设置，避免冗余。
- FPS：设置动画的播放帧率，与动画本身的帧率保持一致即可，确保渲染后的动画播放流畅，无卡顿或加速/减速异常。
深度参数调整（可选）：若需优化深度通道图效果，可进行此步骤操作，无需调整深度参数则可跳过，具体如下：
- 勾选节点视口标题中的“Depth”选项，即可在3D视口中实时预览深度通道的效果，便于直观调整参数。
- 调节节点界面中的“N”（近）和“F”（远）参数，通过调整两者数值，设置深度图的最大对比度，使近景、远景层次分明，提升ControlNet深度控制的精准度。
烘焙渲染：所有参数设置完成后，点击节点标题栏中的“BAKE”按钮，节点将自动开始播放动画，并同步批量渲染4类通道图，渲染完成后，所有通道的像素数据将自动发送至节点输出端，等待后续连接使用。
连接输出：将节点的4个输出端（POSE_BATCH、DEPTH_BATCH、CANNY_BATCH、NORMAL_BATCH），分别对应连接至ControlNet预处理器的对应输入端，或连接至图像预览节点查看渲染效果，完成整个工作流的搭建。

输出详解

为帮助用户清晰区分4类输出通道的用途，精准匹配ControlNet使用场景，以下结合输出特性、具体描述及最佳用途，进行详细拆解（保留原文所有信息，优化排版可读性）：

输出	描述	最佳用途
POSE_BATCH	代表身体部位的平坦、无光照纯色图，骨骼轮廓清晰，无多余光影干扰，能精准呈现角色骨骼姿态。	ControlNet OpenPose 控制，或基于自定义颜色的骨骼控制场景，确保骨骼识别精准。
DEPTH_BATCH	灰度距离图，严格遵循“白=近、黑=远”的显示规则，层次分明，能清晰呈现角色的体积感和空间关系。	ControlNet 深度控制，可高效保留3D角色体积形状，适配需要突出空间层次的生成场景。
CANNY_BATCH	黑色背景搭配白色发光边缘，边缘检测精准，既能捕捉角色整体轮廓，也能保留内部细微结构。	ControlNet Canny/线稿控制，适配轮廓驱动生成场景，如角色线稿渲染、细节优化等。
NORMAL_BATCH	相对于相机视角的RGB法线贴图，可精准还原3D角色的几何表面细节，呈现表面凹凸纹理特征。	ControlNet 法线贴图控制，适用于表面细节与光照效果生成，提升角色纹理质感。

故障排除

针对用户使用过程中可能遇到的常见问题，结合节点特性及原文排查方案，以下详细说明问题原因及解决方案，帮助用户快速解决故障，确保节点正常运行：

问题：加载节点后，3D视口不可见
- 原因：受浏览器缩放比例影响，节点3D视口初始尺寸可能被设置为0，导致无法正常显示，属于常见的界面适配问题，非节点故障。
- 解决方案：无需重启节点或ComfyUI，仅需轻微拖动节点右下角的缩放按钮，调整节点整体尺寸，视口将自动对齐并正常显示，调整后可根据需求固定节点大小。
问题：动画下拉菜单中未找到目标动画文件
- 原因：主要分为两种情况，一是动画文件放置路径错误，未放入指定的yedp_anims文件夹；二是文件刚添加完成，浏览器未及时刷新，节点未识别到新文件。
- 解决方案：首先确认动画文件已放入“ComfyUI/input/yedp_anims/”路径下，且文件格式为.fbx或.glb；若文件刚添加完成，刷新当前浏览器页面，节点将重新识别文件夹内的动画文件，刷新后即可在下拉菜单中找到目标文件。