时间线渲染 · 截图待补
这个节点是做什么的
时间线渲染（Timeline Render）读取上游COMFYTV_TIMELINE JSON，调用所选 timeline workflow 后端，将各 segment 的图片（与可选音轨）拼接/编码为一条 COMFYTV_VIDEO。
与 Director Timeline 的关系：Director Timeline 负责剪辑表编排，Timeline Render（本节点） 负责导出成片。没有文本 prompt——时长、顺序、素材 URL 全部来自时间线 JSON。
适用场景
- Shot Images + Director Timeline 工作流最后一步，导出可分享的 MP4。
- 调整时间线后只 Re-Run 本节点，无需重跑所有分镜出图。
- 验证 BGM 与画面长度是否对齐（Render 前在 Director Timeline 听预览）。
工作原理（为什么 ComfyTV 这样设计）
- Stage + ▶ 运行：只跑 timeline workflow，不触发上游 Shot Images / Storyboard 重跑；进度按 segment 回调（
shot 2/5等）。 - 快照：使用 Director Timeline 当前保存的 timeline 快照；若改了时间线但未 Re-Run Render，成片仍是旧版——需再次 Run 本节点。
- workflow 下拉框：映射 timeline 类 runner。当前内置 Multishot (placeholder) 为演示用占位后端（返回 sample 视频 URL）；正式 multishot 编码 workflow 见 roadmap.md。
类型说明（COMFYTV_* vs ComfyUI 原生）
术语提示：COMFYTV_*是 ComfyTV 保存在项目里的结果引用；ComfyUI 原生的IMAGE/VIDEO/AUDIO是运行时才在内存里的数据，二者不能直接连线，需用 Bridge 转换。
Bridge：bridges.zh.md
界面与参数说明
workflow
- 是什么：时间线渲染后端；启动时从仓库注册的 timeline 类 workflow 加载选项。
- 当前内置：Multishot (placeholder) —— 开发占位，非最终生产编码器。
- 选项从哪来：仓库 runners/ 注册 + 未来
workflows/timeline/工作流文件。 - 需要什么：视具体 workflow；占位 runner 无需本地模型。
- 影响：决定编码方式、是否真拼接 segment 等。
timeline
- 是什么：上游
COMFYTV_TIMELINE连线。 - 填什么：Director Timeline → timeline。
- 误区：空 timeline 或 segments 为空会导致无效/占位输出。
自定义参数（custom_params）（隐藏）
- 侧栏绑定的额外 workflow 参数（随 timeline workflow 演进）。
输出说明
新手一步一步
- 完成 Storyboard → Shot Images → Director Timeline 编排（或等价素材链）。
- 添加 Timeline Render，timeline 接 Director Timeline 输出。
- workflow 选可用项（如 Multishot placeholder）。
- ▶ 运行，观察逐 segment 进度。
- 在节点预览播放成片；满意则接 Video Upscale 或 从资产库 另分支复用。
- 若改时间线：只 Re-Run 本节点（不重跑 Shot Images）。
完整教程（推荐阅读）
本页只说明这一个节点的参数与用法。端到端流程与多节点串联，请见 GitHub 上的 ComfyTV 用户指南：
仓库与工作流
常见问题
Q：输出是示例视频，不是我的画面？A：Multishot (placeholder) 在正式 timeline workflow 上线前会返回演示片段。 Q：Run 没反应？
A：确认 timeline 已连线且 Director Timeline 有非空 segments；查看控制台。 Q：与 Video Stage 有何区别？
A：Video Stage 生成 AI 视频（文/图生视频）。Timeline Render 编码已编排的帧。生成 vs 拼接/导出。 Q：workflow 列表灰色？
A：重启 ComfyUI 重新扫描；timeline runner 在启动时注册。 Q：Load 与 generate 的区别？
A：Load Video 导入文件；本节点从 timeline JSON 编码新成片。Loader 不能替代 Render。
相关节点
- Director Timeline —— 必需上游编排。
- Shot Images —— 常见 segment 素材来源。
- Video Stage —— 单段 AI 视频生成，不同用途。
- Video Clip / Video Upscale —— 成片后处理。
- Load Video from Asset —— 从库复用 Render 结果。