- 新增 render_native.py: 台词镜缝合(保留原生音轨+烧h3v3字幕+瑕疵遮盖,不叠TTS) - 新增 fetch_t2i.py: 出图脚本被杀后按pid救回单图 - 修复 queue_h3_native.py --check 将中断/error误判为在队的bug - 文档: render.md/native-av.md/pitfalls.md/SKILL.md/README 补齐双轨缝合与选机实测
6.2 KiB
七阶段流水线与闸门
核心不是「一键出片」,而是资产节点化 / 可局部重做 / 阶段确认 / 方法论文件化。落到文件上:节点 = 30_shots.json 的一行,连线 = refs 与 manifest 依赖,画布 = 目录。
基线资产 assets/ + config/ (跨集只读,被阶段 1–2 引用)
│
① 策划叙事 ─ ② 分镜中枢 ─ ③ 配音先行 ─ ④ 出图/出视频 ─ ⑤ 缝合 ─ ⑥ 审片归档
│ │ │ │ │ │
00_brief 30_shots.json vo_NN.mp3 Sxx_<hash8> renders/ INDEX.md
10_events 40_prompts/ manifest
20_script
└── 贯穿:校验前置 · 提示词哈希 · 单镜重做 · 阶段闸门 · manifest 回溯 ──┘
阶段与闸门
| # | 阶段 | 输入 | 输出 | 闸门(必须停下等确认) |
|---|---|---|---|---|
| 0 | 基线资产 | 角色设定、参考图 | assets/ 角色卡 / 画风模板 / HUD |
锚图定稿后锁为只读 |
| 1 | 策划与叙事 | 选题、原著片段 | 00_brief.md、10_events.md、20_script.md |
禁忌清单过一遍;重编不是缩写 |
| 2 | 分镜中枢 | 阶段 1 + 资产 | 30_shots.json、40_prompts/Sxx.i2v.txt |
manju.py validate 全绿;提示词逐条展示 |
| 3 | 配音先行(仅无音轨镜) | line 字段 |
work/EPxx/audio/vo_NN.mp3 |
实测时长回填 duration,不允许加快语速硬塞。台词镜走音画同出,跳过本阶段 |
| 4 | 出图 / 出视频 | refs + 提示词 |
work/EPxx/{images,videos}/Sxx_<hash8>.*、videos/native/Sxx.mp4 |
展示对象、数量、模型、端点、完整提示词、参数、执行次数,取得明确授权;台词镜用「排队→取回」,导出后清服务端记录与产物 |
| 5 | 缝合 | 已采用片段 | renders/EPxx_成片.mp4 |
只拼「已采用」片段;未采用的另建候选 |
| 6 | 审片与归档 | 成片 | renders/INDEX.md、50_manifest.json |
区分已生成 / 已采用 / 已合成,不把清单完成当状态完成 |
闸门铁律:普通「继续」、沉默、表单失败都不构成新的生成授权;额外重试要先核对授权是否覆盖。生成返回任务 ID / generating 只表示开始,不能宣称完成。
阶段 0 / 4 的模型闸门:出锚图与首帧走内网 H3-Image(tools/submit_t2i.py,权重自动探测)。
出视频分两轨:有台词的镜头 → 30121(64 GB)的 H3 音画同出(queue_h3_native.py);
无声动作镜头 → A14B(30113)。30113(22 GB)只能跑 H3 的 T2V,别把 first_frame 塞给它。
端点、节点图与两台机器的差异见 models.md,台词镜全流程见 native-av.md;
展示授权清单时必须写明模型 + 端点 + 预计耗时——换模型等于换节点图,不能只改 endpoint。
90 分钟级的任务要按「排队 → 落盘 pid → 事后取回」跑,并在排完 5 分钟内做一次 /queue 存在性自检。
阶段 4 出图的自检闸门:submit_t2i.py 每次出图后自动做 PNG 自检(颜色数 / 亮度 / 标准差),输出 [SANITY] 行。
[SANITY] 判失败(纯色图)时必须停下,不要重跑、也不要清理服务端 —— 这说明量化档位或端点选错了
(DCU 禁 int8_convrot,K8s-30113 只能用 int8_convrot),重跑只会再出一张废图。
正确做法:按 models.md §2.0 的量化档位表核对端点与权重,再决定换端点还是改提示词。
阶段 4 的导出后置闸门(必做):/view 拉回本地且文件大于 cleanup.minBytes 才算「已导出」,随后用官方标准接口(/api/history、/api/queue 的 {"delete":[...]},删后必须复核「删前有→删后无」——200 空 body 是幂等响应,不等于删除成功)清掉服务端记录,再清本次生成的 output / temp 文件。官方没有删 output/ 文件的 HTTP 路由,按 cleanup.deleteApi(社区自定义节点的 DELETE)或 cleanup.commands 处理。清理失败要如实报告状态,不能把「已下载」说成「已清理」。只清服务端:本地成片、提示词原文、30_shots.json、50_manifest.json 全部保留,台账默认只去掉 promptId。工具与接口细节见 models.md §3.4。
输出契约
30_shots.json 一行一镜,每个 shotId 对应三样东西:
40_prompts/Sxx.i2v.txt—— 该镜提示词原文,一字不改,供复核与回溯(台词镜是Sxx.h3v3.txt,五段式,两者并存不覆盖)work/EPxx/videos/Sxx_<hash8>.mp4—— 哈希取提示词内容 sha256 前 8 位,改词即换文件,旧版不覆盖50_manifest.json中的一条记录:路径、哈希、模型参数、参考版本、状态、重做原因
单镜重做
改第 3 镜不动其余镜头:
python3 tools/manju.py hash "$(cat projects/EPxx/40_prompts/S03.i2v.txt)" # 新哈希
# 修改 30_shots.json 里 S03 的 promptHash / status=planned
python3 tools/manju.py validate projects/EPxx/30_shots.json
# 只重提 S03:python3 tools/submit_i2v.py projects/EPxx/30_shots.json --only S03 --force
# 再在 50_manifest.json 追加一条 attempt,保留旧记录
依赖影响面按真实引用查:角色外观改 → 所有引用该锚图的镜;台词改 → 该镜时长与配音;空间/动作改 → 相邻交界镜。未被影响的片段继续有效。
不做的事
- 不递归「结构修正 ↔ 抛光」:结构修正只做一轮集中修改,随后单次抛光。
- 不为了「让它连得上」自行补桥接动作、补道具来源、把模糊角色具体化。
- 不把提示词当作已生成的成片,不把文件路径当作「已看过视频」。
- 派生内容是否允许回灌知识库,按项目
policy清单执行,默认不允许。 - 不在「导出后清理」里删本地已采用成片或提示词原文;也不清别人挂在同一个 ComfyUI 上的任务(
--clear全清一律禁用,只按prompt_id精确删)。/free整批结束统一调用一次,别每镜卸载模型。