内置.分拆输出
30-节点与模板 · 引擎 local · 2026-08-28 · 1.1 KB
模板ID:local.split.any
基本信息
- 功能:从上游多个产出(图片/视频/音频/文本均可)按序号取出单个。纯本地程序自主分拆,不经过 ComfyUI,直接取上游产物中的第 index 个。输出类型可由「输出类型」参数明确指定。
- 类别:tool
- 标签:工具、分拆
核心价值
弥补了原节点设计的局限:上游单节点产出多张图/多个文件时,无法分别喂给下游多个同类型端口。分拆输出把每个产出拆成独立单产出,作为独立上游节点,供下游多个输入端口正确分配。
输入端口
- 多产出源(任意,必填):上游输出的多个产出(图片/视频/音频/文本均可,会取其中的第 index 个)
输出端口
- 单个产出(任意,类型由「输出类型」参数或实际文件决定):按序号取出的单个产出
可调参数
- 序号(integer, 默认 0;范围 0~100;分组:主要):取第几个(0 起)。0=第1个、1=第2个……
- 输出类型(select, 默认 auto;分组:主要):输出端声明的类型。
auto:按取出的实际文件推断类型(.png→image、.mp4→video、.mp3→audio、.txt→text)。image/video/audio/text:手动明确输出类型,下游据此正确识别并分配端口(即使未运行也能让连线/端口识别到准确类型)。
用法示例
- 上游「视频.抽首尾帧」输出 2 张图 → 拖 2 个分拆节点:index=0 取首帧、index=1 取尾帧 → 分别接到下游双图编辑的 input1、input2。
- 上游多段视频 → 分拆成单段视频。
- 多音频 → 拆成单个音频。
- 多文本结果 → 拆成单个文本(把「输出类型」设为 text,下游文本端口才能正确识别)。
输出类型适配
- 分拆出的单个产出类型:当「输出类型」参数非 auto 时以参数值为准;auto 时按实际文件自动推断(.png→image、.mp4→video、.mp3→audio、.txt→text)。
- 手动指定输出类型可让下游在运行前就明确识别到准确类型(避免原本 any 类型导致下游按 any 处理、无法被文本/音频等端口识别的问题)。
- 引擎返回的 JobResult.type 已正确标注;模板 outputs 声明为 any(因类型可动态),连接层面 any 兼容一切下游。
来源:E:/workbuddyProj/unlimitCanvas/ai_manual/node_rules/本地-分拆输出.md