Files
ssw d25c9304e1 feat: 原生音画同出闭环 + 队列自检修复 (v1.2.0)
- 新增 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 补齐双轨缝合与选机实测
2026-11-19 10:18:38 +08:00

6.2 KiB
Raw Permalink Blame History

七阶段流水线与闸门

核心不是「一键出片」,而是资产节点化 / 可局部重做 / 阶段确认 / 方法论文件化。落到文件上:节点 = 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 整批结束统一调用一次,别每镜卸载模型。