LibTV中实现“一条线跑完再跑下一条”的本质是串行调度:需在设置中切换为串行执行模式,勾选输出节点的“阻塞后续任务”,并通过YAML数组、CLI加--serial参数或API添加X-Execution-Mode: serial头来确保任务严格顺序执行,避免并发导致的分镜错乱与音画不同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在LibTV AI里实现“一条线跑完再跑下一条”,本质是控制工作流的执行顺序与任务调度逻辑,避免多条流水线并发冲突导致分镜错乱、音画不同步或资源抢占崩溃。这一步直接决定批量任务能否稳定产出可用成片,而不是一堆时间轴错位、角色漂移的废片。
确认工作流执行模式为串行
打开 LibTV 主界面 → 点击右上角「设置」→ 在「运行策略」中找到「任务调度模式」→ 将默认的「并发执行」切换为【串行执行】。该选项位于「高级调度」折叠区下方,未展开时不可见。
并发执行会同时启动多条工作流,显存和CPU占用瞬间翻倍,极易触发模型OOM报错或TTS语音截断;串行模式则强制当前任务完全结束(含导出完成、日志写入、缓存清理)后才拉起下一条,是保证单条质量可控的前提。
用节点依赖锁死执行顺序
进入工作流编辑画布 → 选中任意一个输出节点(如「剪辑合成」或「导出MP4」)→ 在右侧属性面板中勾选「阻塞后续任务」。
这一步不是可选项:不勾选时,LibTV 会把每条工作流当作独立进程处理,即使设了串行模式,也可能因中间产物落盘延迟导致下一条提前读取到空帧或旧缓存。勾选后,系统会在该节点完成并校验输出文件MD5值无误后,才向调度器发送「就绪」信号。
批量任务队列配置
方法一:通过YAML配置文件硬编码顺序
在项目根目录下的workflow.yaml中,将tasks列表改为严格数组结构:
tasks:
- name: "口播_001"
script: "script_001.txt"
- name: "口播_002"
script: "script_002.txt"
- name: "口播_003"
script: "script_003.txt"
LibTV 加载时按数组索引顺序逐条解析,跳过任何缺失script文件的任务,但不会打乱执行次序。注意:文件名必须全路径一致,相对路径需以./开头。
方法二:使用CLI命令行参数强制串行
终端中执行:libtv --batch ./batch_list.txt --serial。其中batch_list.txt每行一个脚本路径,--serial参数不可省略,否则即使配置文件写了顺序,CLI仍按默认并发启动。
方法三:API调用时添加同步头
向/api/v1/run发送POST请求时,在Headers中加入:X-Execution-Mode: serial。该头会覆盖服务端全局配置,确保本次请求链路独占调度器资源。
验证串行是否生效
第一步:在工作流中启用「详细日志」→ 运行批量任务。
第二步:打开日志面板,查找连续两段日志的时间戳间隔。若第二条任务的「开始执行」时间晚于第一条的「导出完成」时间至少3秒,则串行成功。
第三步:检查输出目录。串行模式下,文件名后缀应为_001.mp4、_002.mp4……且创建时间严格递增;若出现_002.mp4创建时间早于_001.mp4,说明调度未生效,需回查YAML缩进或CLI参数拼写。











