影栈 0.5.0：部分重做、复用旧结果、完整导出
2026-10-14

操作
1. 保持同一导演台节点及缓存文件夹名，开启“滚动生成”。
2. “全部导出”：只勾选要重做的段，明确选“仅一采”或“仅二采”，运行后合成完整时间轴。
   “分段导出”：仅交付这次勾选的段，不要求其他段有已有结果。
3. 整片路径见报告：timeline_first_pass.mp4 / timeline_final.mp4。
   first_pass.mp4 / final.mp4 仍是本轮实际生成片段的合并文件，不要将其误认成整片。
   全部导出时 frame_count 为完整视频帧数；IMAGE/AUDIO/source_images 仍阻断。
4. 无先确认暂停的自动流程可用“按原接线”。如果启用 Refine 的“先确认一采”，
   全部导出要求显式选仅一采或仅二采，以免无法确定本轮需要复用哪个阶段。

已有结果从哪里来
新版本的滚动运行成功后，在同一缓存目录保存 rolling_videos.json。
索引记录每段一采参数身份、视频阶段、文件路径、帧区间、实际画布、音轨及文件 size/mtime。
全选生成、分段输出、部分重做都会更新本轮段记录；未选段记录保留。
一采重做后，该段旧 final 不再作为当前最终结果提供，避免将新一采和旧二采混为一谈。
索引只在导出成功后原子替换；合并失败不覆盖上次索引，已成功生成的本轮视频和 AV 保留。

复用 0.4.x 旧结果（无需重生成其他段）
旧版没有缓存归属/完整参数身份，系统不会按输出时间猜测某个目录属于当前工作流。
选择“全部导出＋滚动生成”，在新增“旧版完整结果 manifest（可选）”输入框填写：
  E:\06_Tools\ComfyUI-aki-v3\ComfyUI\output\minimax_seg_export\实际时间戳\manifest.json
也可输入该目录。路径是 ComfyUI 所在机器的路径，不是浏览器本地文件上传。
必须是 mode=rolling/status=completed，覆盖当前完整段序，且帧率及未选段 seed 对应。
首次导入只填补当前缓存名下缺失的段记录，不覆盖之后重做的较新结果。
0.4.x 缺少完整参数身份时，当前设定被用作后续身份基准；用户必须确认对应的提示词、
素材和段序，manifest 会标注 identity_origin=user_selected_legacy_manifest，报告保留提醒。
只有 AV 缓存、没有已有可用视频，或只有无法覆盖整片的旧 manifest 时，不能直接补齐。
会说明缺失段，不会自动 VAE 解码全部旧 latent，也不会偷偷重新采样。

复用规则
- 严格仅二采仍先验证所有选中段一采 AV，失配停止，不补一采。
- 未选段复用相同阶段：仅一采用 first，最终交付用 final，不用旧一采冒充二采。
- 未选段检查保存的一采身份（包含有效 seed、提示词、时长、画布、素材标识等）、
  音频模式及源文件状态。变更这些设置会报具体段号/字段，需恢复参数或明确重做该段。
- 未选段保留原来最终处理的结果；修改当前 Refine 参数不会自动精修未选段。
- 缺失、被替换、记录异常在采样前检查；采样后合并前再次检查文件状态。
  解码才能发现的损坏会在合并时停止，本轮已生成段保存，不把残片标记为完整成功。
- size/mtime 不是内容哈希；模型身份沿用既有缓存边界，不宣称能识别全部模型/素材变化。
- 不自动清理历史输出目录。索引引用的源视频必须保留；可用完整新 manifest 在新缓存名下
  显式导入整片作为基准，再自行管理旧目录，不要直接删除仍被引用的文件。

内存、编码与连贯
生成仍保留当前段和必要上一段。旧视频复用由 FFmpeg 逐区间读取，不形成完整 Python RGB。
同源连续区间合并为一次读取；按帧号裁切避免时间戳舍入丢帧。不同画布按最大宽高补边。
每个区间重编码为统一视频，最后拼接复制视频流；音频按累计帧数流式写 PCM，再统一 AAC。
合并有磁盘读取、临时压缩视频/PCM 以及 CPU 编码成本，不等于无损字节拼接或零耗时。
全选生成时直接复用本轮整片文件，无需额外对整片重编码。
多次局部替换优先引用各段最初的本轮输出文件，不以每次整片重编码结果层层转码。

全部导出时，未选上一段的画面和裁剪记录保持原样；不会为新段重写旧段长度或接缝。
当前段仍可读取必要上一段 AV 作引导（仅这一段，非整片）；这有一次 VAE 解码成本。
相邻选中段继续执行原 phase 裁剪/接缝处理。未选后段保留生成当时的旧上下文。
更换中间段后需检查两侧接点，不能保证旧后段自动适配新的动作/人物位置。

manifest
segments / merged：本轮实际生成段及阶段视频。
full_export.segments：整片段序、精确 seed、身份来源、新生成/复用标记、源文件/区间及新片帧区间。
full_export.merged：整片文件；full_export.frames：整片帧数。
status=completed 才表示本轮成功；异常或中断为 interrupted。

验证
CPU/真实 FFmpeg 新增 14 项集成回归：单段替换像素及 AV 不变、不连续多轮替换、
仅二采只采选段、缺失/错误阶段/文件替换/身份失配提前停止、0.4.x manifest 显式导入、
合并失败索引保留、未选前段裁剪记录不改、20 段只解码当前生成段、音频区间与时长、
不同画布、采样中源文件消失、旧 manifest 段数错误、外接组范围传递。
浏览器验证全部/分段切换、路径保存、双语范围提示及宽窄面板布局。
GPU 推理和 ComfyUI 宿主仍使用适配测试；实际 GPU 峰值、速度和接缝观感需目标设备验收。
本版本未发布 Comfy Registry。
