Files
ai-manju/references/workflow.md
T
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

73 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 七阶段流水线与闸门
核心不是「一键出片」,而是**资产节点化 / 可局部重做 / 阶段确认 / 方法论文件化**。落到文件上:节点 = `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](models.md),台词镜全流程见 [native-av.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](models.md) 的量化档位表核对端点与权重,再决定换端点还是改提示词。
**阶段 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](models.md)。
## 输出契约
`30_shots.json` 一行一镜,每个 `shotId` 对应三样东西:
- `40_prompts/Sxx.i2v.txt` —— 该镜提示词**原文**,一字不改,供复核与回溯(台词镜是 `Sxx.h3v3.txt`,五段式,两者并存不覆盖)
- `work/EPxx/videos/Sxx_<hash8>.mp4` —— 哈希取提示词内容 sha256 前 8 位,改词即换文件,旧版不覆盖
- `50_manifest.json` 中的一条记录:路径、哈希、模型参数、参考版本、状态、重做原因
## 单镜重做
改第 3 镜不动其余镜头:
```bash
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` 整批结束统一调用一次,别每镜卸载模型。