# 核心依赖 - 基于实际使用的模块 # 网络请求 requests>=2.31.0 # 图像处理 Pillow>=9.5.0 numpy>=1.24.0 # 深度学习框架 (LoadImageFromUrlNode需要) torch>=2.0.0 # 云存储 (OSSUploadNode需要) oss2>=2.18.0 # 音频处理 (OSSUploadNode MP3转换需要) pydub>=0.25.0 # 注意：以下模块由ComfyUI环境提供，无需单独安装 # - json (Python内置) # - re (Python内置) # - typing (Python内置) # - os (Python内置) # - io (Python内置) # - urllib (Python内置)
一个功能丰富的ComfyUI自定义节点集合，提供多种实用工具和增强功能。
ComfyUI-ZMG-Nodes是一个专为ComfyUI设计的自定义节点插件包，包含多个实用的节点，旨在提升工作流的效率和功能性。所有节点都经过优化，具有完善的错误处理、类型注解和详细的文档说明。
ZMGNodes/前缀进行分类，便于在ComfyUI中查找和管理所有节点都按照功能分类，在ComfyUI中以ZMGNodes/前缀显示：
ZMGNodes/network – 网络相关节点ZMGNodes/data – 数据处理节点ZMGNodes/image – 图像处理节点ZMGNodes/utils – 工具类节点ZMGNodes/audio – 音频处理节点IMAGE帧序列与可选AUDIO轨道合成为视频文件video/h264-mp4、video/vp9-webm、video/prores-movyuv420p（无透明）、yuva420p/yuva444p10le（支持透明）crf 参数（数值越小质量越高，体积越大）trim_to_audiopingpong乒乓播放以延长时长save_output 控制保存到output或tempAnimateDiff_00001_20251119_103522_123456.mp4VIDEO 输出，兼容 IO.VIDEO 类型节点连接Text To Image 或其它节点得到 IMAGELoad Audio From URL 得到 AUDIOCombine Image+Audio → Video，设置 frame_rate=24、format=video/h264-mp4、crf=19VIDEO，可直接接到后续视频处理/上传节点参数说明
images: 输入帧序列，形状 B x H x W x C，C=3/4frame_rate: 视频帧率，常用 24/25/30filename_prefix: 文件名前缀，系统会自动追加计数与时间戳format: 视频容器与编码，mp4(H.264)、webm(VP9)、mov(ProRes)pix_fmt: 像素格式，yuv420p（无透明）、yuva420p/yuva444p10le（有透明）crf: 质量系数，越小越清晰、体积越大，建议 18–23save_metadata: 写入创建时间等元数据trim_to_audio: 按音频长度裁剪；关闭则为视频补齐静音pingpong: 乒乓播放，延长视频时长save_output: 保存到 output；关闭保存到 tempinput目录waveform、sample_rate），仅解码为PCM，不重新编码audio：多行音频URL输入；支持 http/https、file://、data:audio、/view?；取首个有效URL下载audio：AUDIO字典（waveform、sample_rate）file_path：保存到input目录的完整路径saved：是否保存成功has_audio：是否存在有效音频（True/False）cd ComfyUI/custom_nodes
git clone https://github.com/fq393/ComfyUI-ZMG-Nodes.gitcd ComfyUI-ZMG-Nodes
pip install -r requirements.txt ComfyUI-ZMG-Nodes/
├── __init__.py # 主入口文件
├── README.md # 项目文档
├── requirements.txt # 依赖包列表
├── fonts/ # 字体文件目录
│ └── Songti.ttc # 宋体字体文件
├── nodes/ # 节点实现目录
│ ├── __init__.py # 节点包初始化文件
│ ├── ApiRequestNode.py # API请求节点
│ ├── JsonParserNode.py # JSON解析节点
│ ├── LoadImageFromUrlNode.py # 从URL加载图像节点
│ ├── LoadAudioFromUrlNode.py # 从URL加载音频节点
│ ├── TextToImageNode.py # 文本转图像节点
│ ├── SaveVideoRGBA.py # RGBA视频保存节点
│ ├── CombineImageAudioToVideoNode.py # 图片+音频合成视频节点
│ ├── EmptyImageNode.py # 增强型空图像节点
│ └── config/ # 配置文件目录
│ └── NodeCategory.py # 节点分类配置
└── web/ # Web资源目录
├── text-switch-case.js # 文本大小写切换脚本
├── upload.js # 上传功能脚本
└── utils.js # 工具函数脚本欢迎提交Issue和Pull Request！
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)本项目采用MIT许可证 – 查看 LICENSE 文件了解详情