影栈 0.5.0：滚动生成（当前段＋上一段）
2026-10-14

0.5.0 导出范围
全部导出＋滚动：只生成选中段，复用未选段已有视频合并完整时间轴。
分段导出＋滚动：只交付本轮选中段。完整用法、旧版 manifest 迁移和失配规则见 rolling-full-export.txt。
以下 first_pass.mp4 / final.mp4 为本轮执行片段，全部导出的整片请使用 timeline_first_pass.mp4 / timeline_final.mp4。

开启
输出设置勾选“滚动生成（当前段＋上一段）”。界面会关闭旧“低内存落盘”选择；关闭两者可恢复普通导出。
字段是 timeline_data.output.rollingGeneration=true，默认关闭。不增加位置型控件，不改节点 ID。
外接 Group、FL2V、导演包和旧工作流继续使用原来的分段标识与 seed。
本版本不包含分线管理。

工作方式
当前段生成期间保留上一段的画面、第一/最终 AV、必要音频和交接记录。
下一段完成钉帧、phase-align 尾帧修剪和原接缝处理后，前段才送入持续视频编码器，然后释放其完整画面。
最后一段在本轮完成时提交。若下一段不在本轮运行范围内，当前段可直接提交；全部导出仅从已有视频补齐，不采样未选段。
延迟导出重新读取的分段文件音频在导出完成/失败后释放；公共共享音频保持原语义。
“当前＋上一段”指片段工作范围，并非只有两个张量；一采对比、最终画面、模型、VAE 和参考素材仍各有占用。

减少的磁盘与编码操作
- 不写 seg_XXXX.mp4、_pre、_pN 等逐段/中间轮次视频。
- 中间 N 采不为导出额外执行 VAE 解码，仅保留必要的一采对比和最终解码。
- 不写完整 RGB 的 raw/FFV1 缓存，不把旧段全量读回 Python。
- 一采 AV 成功后先保存，再解码；最终 AV 在该段成功后保存一次。裁剪只更新小型 handoff/PCM，不重写整个 AV。
- 固定画布下，每个实际输出阶段使用一个连续 H.264 编码器；结束时仅复制视频流并封装音频，不再次编码视频。
- 没有 Refine/脸修且一采与最终相同时，复用一次视频编码。
- 画布变化会关闭当前编码片段，再按新画布继续；结束时需要额外统一画布并合并。该情况无法保持“全程单次编码”。
- 跨采样阶段的模型加载仍由 ComfyUI 与现有显存清理设置控制；滚动模式不会额外强制卸载未使用分段 LoRA 的共享模型。

输出
路径仍是 ComfyUI/output/minimax_seg_export/时间戳/，具体绝对路径见 Director report。
first_pass.mp4：本轮全部选中段的一采。
final.mp4：本轮全部选中段均有最终阶段时的结果。
face_pre.mp4：选择“输出修脸前”且存在对应阶段时的结果。
某阶段仅覆盖部分段时命名为 *.partial.mp4，manifest 的 complete=false，并记录实际覆盖段和帧区间；不把未二采的段伪装为二采。
manifest.json 的 mode=rolling、status=completed 才表示本轮已完整结束。精确 seed 以十进制字符串保存。
IMAGE/AUDIO/source_images 等完整媒体接口阻断；fps、frame_count、report 仍输出。
0.6.7 在原 8 口后追加 first_pass_video / final_video（文件 VIDEO），可直接连接官方 SaveVideo。
导演台内提供按需预览、下载和服务器路径；详情见 rolling-video-delivery.txt。
视频分批写入编码器不意味着每段都会产生可直接预览的独立 MP4；最终 MP4 在结束封装后生成。

缓存与仅二采
保留每段 .pre.av.pt 和一采参数指纹，支持 0、uint64 上限及空白继承全局 seed。
仅二采仍在任何采样/清理前逐段校验，失配、缺失或损坏会停止并说明原因，不补跑一采。
第一轮已确定的 phase 裁剪保存在交接记录，滚动仅二采复用该长度，避免把已裁掉的尾帧重新带回。
完整 RGB 缓存不再保留；该段被滚动重做后，同槽旧 RGB 会清理，避免新 AV 配旧画面。
部分运行需要上一段时，只从缓存 AV 恢复所需上一段的画面，不恢复整条时间轴。必要的一次 VAE 解码有时间成本。
切回普通“全部导出”后，不存在完整 RGB 的未选段不能靠旧像素缓存补齐；请使用已保存视频，或明确选段用匹配 AV 执行仅二采。

中断与限制
异常或正常的用户取消会关闭编码进程并标记 interrupted；已成功的一采 AV、已保存最终 AV 以及尚存的 *.video.mkv/*.audio.wav 片段保留。
硬杀进程或容器 OOM 无法保证 WAV 头/视频尾部已封装完整；一采缓存仍按已完成的原子写入保存。
不承诺中断后一键无损续接正在编码的 MP4，不会自动重采。可检查缓存后明确选择需要的段/仅二采。
编码器仍需磁盘空间，音频需要 PCM 暂存；本模式减少重复处理，不是完全不落盘。
RSS 不保证每段立即回落；模型常驻、分配器与系统文件缓存另计。单段太大仍可能 OOM。

验证范围
CPU 测试使用真实缓存与 FFmpeg，覆盖 20 段弱引用/一个编码器、22 帧连贯和裁剪、旧拼接像素对照、
仅二采裁剪长度、独立 seed、选段恢复上一段、缺失音轨与重采样、画布改变、部分阶段及编码失败清理。
GPU 采样与宿主适配使用测试桩。实际模型画质、音视频同步、服务器 RSS 和耗时仍需目标设备验收。
