SplitVideo 视频时间码精准切分与多片段剪辑节点

节点核心功能 (What is it?)

SplitVideo 节点允许创作者依据广播级标准时间码（Timecodes）或多格式区间描述，将一个完整的长视频精准切割、切分为多个独立的视频子片段。它底层集成了 AI 驱动的多格式时间码智能解析能力与高精度 FFmpeg 切片管线，在切分各片段的同时完美保持原始素材的高清画质与音画同步。

典型适用场景 (When would I use it?)

在以下情况下使用 SplitVideo 节点：

将冗长的完整录播、访谈或演讲视频自动拆解为便于传播的短片分段；
从长视频中精准抽取特定的精彩高光场景或精彩镜头；
剥离视频的片头（Intro）、主体正文与片尾（Outro）；
为多平台分发（如短视频信息流）准备规整的子视频素材合集；
配合多模态 LLM 识别出的精彩时间戳自动化生成切片工件。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在工作流画布中添加 SplitVideo 节点。
将待切分的长视频连接至 video 输入插槽。
在 timecodes 参数框中输入一个或多个切分区间时间码。
执行工作流，节点将输出切分完成的视频片段列表（split_videos）。

参数输入插槽 (Parameters)

video：待切割的目标长视频流（原生支持 VideoArtifact 与 VideoUrlArtifact）。

timecodes：指导视频切分的时间码参数（必填，required）。支持极具弹性的多种描述语法：

基础 SMPTE 时间码范围（格式：时:分:秒:帧）：
```
00:00:00:00-00:01:00:00
00:01:00:00-00:02:30:00
```

带标题与分段备注的时间码（使用竖线 | 隔开）：

00:00:00:00-00:00:04:07|片段 1: 引言
00:00:04:08-00:00:08:15|片段 2: 核心演示

结构化 JSON 规范格式：

[
  {"start": "00:00:00:00", "end": "00:01:00:00", "title": "Intro"},
  {"start": "00:01:00:00", "end": "00:02:30:00", "title": "Main"}
]

输出引脚 (Outputs)

split_videos：切割分离出的所有独立视频片段列表（list[VideoUrlArtifact]）。
logs：详细的处理与帧提取日志。

典型工作流示例 (Example)

将一段 10 分钟的长视频按章节切分为 3 个独立短片：

将 LoadVideo 的输出连入 SplitVideo 的 video 输入插槽。

在 timecodes 中录入章节切片点：

00:00:00:00-00:02:30:00|第一章：项目背景与架构
00:02:30:00-00:07:30:00|第二章：核心算子实机演示
00:07:30:00-00:10:00:00|第三章：总结与后续规划

运行工作流，节点将自动切片生成 3 个独立的全新视频文件，并作为列表置入 split_videos 输出端，下游可接入 DisplayList 展开分发。

关键技术特性 (Important Notes)

AI 智能时间码语法自适应：原生理解 SMPTE 标准时间码（HH:MM:SS:FF）以及自然语言语义切片；
全主流帧率自适应：自动精准探测母素材帧率（原生覆盖 24fps、25fps、29.97fps、30fps、50fps、59.94fps、60fps）并自动补偿 Drop Frame 丢帧机制；
画质无损切片：采用关键帧精准寻址（Keyframe Seeking）与平滑重编码，确保切片接缝处零黑屏、音画不爆音。

常见问题与排查 (Common Issues)

时间码格式错误：请确保时间码符合 时:分:秒:帧 标准规范，帧数不要超出当前视频 FPS 上限。
起始时间晚于结束时间：检查各分段的起始时间点必须早于结束时间点。