LibTV在运行前执行静态拓扑校验,任一节点必填输入未连接或为空即报错并禁用运行按钮,确保工作流DAG完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

节点连了一半时 LibTV 会立即中断执行并报错,因为工作流引擎在运行前会做拓扑校验——只要存在未完成输入连接的节点(比如图生视频节点缺关键帧图像输入、配音节点缺文本输入),整个画布就无法进入「可运行」状态,红色警告图标会直接标在悬空节点右上角,且「运行」按钮始终置灰不可点击。
为什么未连完就报错
LibTV 不是边连边跑的实时执行环境,它把整条链路当作一个有向无环图(DAG)来验证。每个节点都声明了 required_inputs 字段,引擎启动前会逐个扫描:如果某个节点的必填输入端口没有被上游连线接入,或接入的是空数据(比如剧本节点输出为空字符串),就会触发校验失败。这一步发生在点击「运行」之前,属于静态检查,不消耗算力也不调用模型。
你可能会看到错误提示:“节点【图生视频-1】缺少必需输入:image_source”,但注意——这个提示不会告诉你“你只连了一半”,而是精确指出哪个端口缺失、缺什么类型的数据。所以不是“连一半就报错”,而是“只要有一个必填端口空着,就根本不让你跑”。
实操中怎么快速定位断点
方法一:看节点右上角小红点
悬停后显示具体缺失字段,比如「missing: prompt, image_source」,说明该节点两个输入都空;只标一个字段,就只补那一个。
方法二:从终点倒推
选中合成节点→点击「依赖高亮」→所有有效上游连线变绿色,未连接或数据中断的路径自动变灰虚线。这条路径上的第一个灰点,就是真正的断点位置。
【重要前提】必须确保至少有一个节点设为「入口节点」(右键→设为入口),否则即使全连满,引擎也找不到起点,同样报“无有效执行路径”。
连错线会导致报错吗
会,但报错时机不同。连错线(比如把配音文本输出接到图生视频的 seed 输入口)属于类型不匹配,引擎会在运行中报「Data type mismatch: expected int, got str」,此时工作流已开始执行,可能已调用一次模型并扣费。这种错误不会阻止你点击「运行」,但大概率导致下游节点崩溃或输出乱码。
这一步操作起来很简单,直接拖动连线到正确端口即可修正,无需删除重连。但要注意:LibTV 不支持同一输出口分叉连多个输入口,强行拖会自动断开前一条线——这点和 ComfyUI 不同,容易误删已有连接。

















