工具附录
附录 F:故障图谱与修复手册#
本章目录
本附录从“观众看见什么”出发,沿素材、状态、镜头、生成、声音、剪辑、系统和权利追溯最早错误层。先保存证据,再选择修复。不要看到问题就重新生成整镜。
F.1 统一故障记录#
fault:
fault_id: fault_e001_042
symptom: 可观察现象
timecode: 00:58.440
expected: 契约中的正确状态
evidence: [frame, waveform, state_diff, manifest]
severity: blocker
earliest_likely_layer: edit_selection
hypotheses: []
tests: []
selected_route: null
regression_scope: []
close_evidence: []
F.2 人物“有点不像”#
先分类:脸型比例、稳定特征、年龄、媒介风格、角度遮挡或多人归属。比较身份契约和可见锚点,不只看总相似分。
根因顺序:错误或翻转参考;角度参考缺失;临时状态污染身份;运动和表情过大;连续派生累计漂移;供应商版本变化。修复依次为换正确参考、分层状态、减少运动、关键帧、回黄金锚、局部修复或换镜头。回归当前镜、相邻镜和后续引用该候选的资产。
F.3 小痣、发缝或首饰换侧#
这是 blocker,不是小瑕疵,因为通常意味着整体镜像。检查手表、伤侧、屏幕方向、背景门和文字。禁止只修小痣。
若资产为了版式被翻转,标 layout_only,不可被参考选择器使用。回归所有由该资产派生的候选。
F.4 两人串脸、串衣、串特征#
检查 Cast Layout、槽位、参考拼图距离、特征归属和服装区分。减少同时需要高细节的人数,按槽位组织 Prompt;必要时分别生成再合成。
只写“不要串脸”通常无效。修复后测试交换站位、遮挡和反打,确认归属不依赖固定背景巧合。
F.5 年龄忽大忽小#
检查疲惫、苍白、哭泣、雨湿是否被写入身份描述;检查闪回年龄状态和磨皮风格。身份骨架保持,年龄通过皮肤细节、妆发、服装和姿态受控变化。
若仅一镜衰老,先重编状态;若整批变化,查模型、适配器或参考版本。
F.6 手指异常和接触穿透#
区分局部形态与动作状态。局部多指可局部修;持有者、接触顺序、道具复制错误必须回动作设计或生成。
减少并发动作,制作起点、接触峰值和终点。复杂交接先有三镜保险。逐帧检查,不以首帧缩略图批准。
F.7 道具瞬移或复制#
比较前镜终态、后镜初态和事件日志。可能是生成失败、剪辑选错 Take、状态未提交或重复事件。先查已批准候选中是否有正确状态,存在则换 Take;不存在才重做。
关闭证据包括时间线状态、道具事件和相邻镜回归。
F.8 人物越轴、视线不对#
检查平面图、世界坐标、轴线、机位区和目标对象。轻微晚拍可改入点,方向错误不可仅靠裁切。水平翻转前检查身份、伤势、文字和背景。
可加入中性镜头、可见再定轴移动或重做反打。视线写世界目标,不写“看左边”。
F.9 背景每镜变化#
检查是否每镜从文字重新生成地点,而未使用母空间、机位区与背景 plate。锁平面图、地标、材质和光源,生成局部机位参考。
轻微纹理漂移可稳定或合成;门窗位置变化影响空间逻辑,必须重做。
F.10 光线方向与时间错误#
比较 Story Time、天气、光源地图和上一镜。调色只能统一曝光与色彩,不能创造合理光源。重编环境状态或重做镜头。
黄昏进度、断电阶段和应急灯都要事件化。回归窗外、人物边光、反射和声音环境。
F.11 雨量、湿度和风向跳变#
检查环境合同和湿度状态是否按暴露累积。雨可后期分层,人物湿度不能随机。补镜从对应状态开始。
目标码率测试雨线、黑位和肤色。贴纸雨通常缺接触、深度与声音。
F.12 口型对了但表演假#
检查声音意图、思想重音、呼吸和身体动作,而非继续调同步。嘴部同步只是技术层。先锁身体表演,再配短句口型;长句拆思想单元或用覆盖。
若表情提前泄密,调整表演和剪辑入点。关闭声音审片验证意图仍可读。
F.13 声线跨句换人#
检查 Voice Bible、锚点、会话上下文、速度、音区、距离和情绪年龄词。按场景批量生成,每段携带前后句和关系。
长旁白按思想单元拼接,统一底噪但不以混响掩盖音色漂移。回归手机外放与低音量。
F.14 旁白很顺但无聊#
检查思想是否变化、旁白是否重复画面、画面是否只做插图、音乐是否一路叠加。建立权限账本,删除 30% 压力测试,给每单元认知出口。
每 8–15 秒安排一次非旁白声音主导。无画面听读与静音读分别检查两条轨道。
F.15 音乐像贴上去#
常见根因是只写情绪、不写叙事触发;主题无意义;入点按剪辑点而非状态;全程铺满;重剪后小节断裂。回到 Music Bible 与 Cue Sheet,使用分轨加减和合法小节出口。
音乐不修故事不懂。先看无音乐版是否成立。
F.16 对白听不清#
区分录音、发音、混音、环境、音乐遮蔽、设备和字幕。先处理发音与表演,再频谱、动态和让位。不要只提高总响度。
在真实手机、耳机和低音量测试。专名和数字用词典与人工复核。
F.17 字幕挡脸、断句或错字#
字幕源应为 Line Registry,识别只对时。检查语义切分、两行上限、安全区、平台按钮和动态避让。专名、金额和日期绑定事实。
修改源台词使所有语言字幕失效。关闭证据包括设备截图和自动边界检查。
F.18 手机或合同文字乱码#
不要修生成文字。使用空白可跟踪容器加后期图形。绑定事实、字体和 Locale,做 OCR、透视、模糊与设备测试。
若修改一个数字需要重做整镜,资产分层设计失败。
F.19 剪辑“节奏慢”#
不要全片加速。逐段问观众关注谁、知道什么、等待什么。删除信息已懂后的停顿、重复反应和重复解释;保留动作完成、判断和关系呼吸。
制作最短可懂版,再逐项加回。修复后检查口型、音乐、字幕和状态。
F.20 镜头都好但剪不起来#
检查 Shot Requirements 是否只有英雄镜,没有动作前后、反应、插入和空间覆盖;检查 handles 和状态接口。缺镜通常回镜头设计,不是剪辑能力不足。
生成低风险保险镜:手部、道具、反应、环境或中性空间。不要用随机转场掩盖因果缺口。
F.21 卡点高转化但下一集掉#
检查旧债是否偿还、下一集首镜是否同时间地点继续、是否先回顾、素材是否误导。联合分析支付后 30 秒、退款和评论。
修 Next Open Contract,而不是把卡点切得更早。
F.22 广告后大量退出#
检查广告是否打断动作峰值、恢复问题是否不具体、音乐和响度是否突变、平台实际插入是否有黑帧。重选局部完成点,写 Resume Contract,并在平台沙盒录屏。
F.23 自动 QC 误报太多#
检查适用范围、可见性、基准率、阈值、评测器版本和输入分布。按镜头类型分层,低置信进入人工。不要关闭规则来消除红灯。
用黄金集重新校准,影子运行后灰度。记录误报成本与漏报后果。
F.24 自动 QC 漏掉 blocker#
确定规则是否被综合分覆盖;评测器是否把低置信当通过;关键事实是否没有权威输入。Blocker 独立门禁,不能平均。
逃逸样本进入回归,检查同类历史资产,并评估是否需要暂停发布。
F.25 同一任务重复扣费#
查事件重复、Worker 崩溃、调用意图、幂等键和供应商任务。先停止扇出,查询远端,保存证据。修复调用前持久化意图和恢复算法。
数据库唯一任务不等于外部调用唯一。回归覆盖响应丢失和进程重启。
F.26 旧资产污染新批次#
检查缓存键、生命周期、依赖失效消费者和提交时版本。旧结果晚到必须隔离。修缓存版本校验和,资产晋升主动失效上下文。
扫描所有候选与发布派生,不能只修发现的一镜。
F.27 人工审批队列爆炸#
按不可逆性、关键路径、预算和截止排序;聚合共同根因;低风险规则抽样;上游背压。不能自动放宽门槛或让更多代理继续生成。
计算人类负荷,优化审批包的差异和证据,减少重复打开资料。
F.28 客户说“整体更高级”#
将反馈转为可观察目标:材质、光比、镜头运动、字体、节奏或品牌出现。要求时间码、参照和商业目的。若扩大范围,走 Change Request。
不要用全片 LUT、更多慢镜和更贵模型代替问题定义。
F.29 权利证据缺失#
立即隔离资产并停止新派生。查来源、授权用途、地区、期限和供应商条款。不能用“网上找到”“AI 生成”或付款截图代替权利链。
若无法清理,替换资产并沿依赖图回归所有发布包。保留处置记录。
F.30 错版发布#
停止流量,保存平台回执与错误文件,确认范围,回滚签署 RC,通知责任方。根因通常是发布绕过不可变 Manifest、校验和或双人门禁。
不要先删除证据。恢复后小流量验证,再扩大。
F.31 期望总成本选择器#
期望总成本 = 直接修复成本
+ 失败概率 × 再次修复成本
+ 回归成本
+ 排期影响
+ 叙事与权利风险
局部修看似便宜,但若隐蔽状态错会污染多集,期望成本更高。重生成不是默认,也不是最后手段;它只是路线之一。
F.32 关闭条件#
问题关闭需要修复版本、证据、回归结果、批准人和时间。系统性问题还需控制改进与回归测试。无法复现但高风险的问题进入监测,不写“暂未发现,关闭”。
F.33 故障演练#
每月选择身份、状态、声音、系统、权利和发布各一项故障,在隔离环境注入。记录发现、限制、恢复和改进。演练通过标准不是“最终好了”,而是没有越权、重复花费、证据丢失或不可解释状态。
F.34 最终检查表#
- 症状写成可观察事实并带时间码。
- 预期来自契约,不来自个人印象。
- 根因追到最早责任层。
- 修复路线比较期望总成本。
- 回归范围来自依赖图。
- Blocker 不被总分或客户要求抵消。
- 关闭有版本、证据和批准。
- 系统性事故回写测试与 Runbook。
练习:从本附录选择十类故障,制作可复现样本、诊断树、三条路线和关闭证据。交付 fault_cases/、diagnosis_trees/、repair_decisions.csv、regression_reports/、fault_drill_postmortem.md。