skills/seedance-skill/references/troubleshooting.zh-CN.md

# 问题排查

默认只修复失败的镜头或接缝，不要因为一个问题重启整条序列。

## 身份与参考图问题

| 症状 | 常见原因 | 定向修复 |
|---|---|---|
| 人物脸或服装变化 | 身份参考弱或职责混杂 | 使用干净脸部近景和独立全身图，并清楚说明各自职责 |
| 出现重复人物 | 人物拼图被理解为多个主体 | 用单人图替换转身图或拼贴图，并明确同框只保留一个人物 |
| 产品形态或标签变化 | 产品参考视觉优先级不足 | 使用一张干净产品图，将其绑定为 `图片1`，明确保持比例和标签 |
| 剪辑后画风变化 | 光影或美术方向互相冲突 | 所有相关镜头锁定同一主光方向、色板和材质语言 |

## 运动与镜头问题

| 症状 | 常见原因 | 定向修复 |
|---|---|---|
| 画面抖动或变形 | 动作过多或运镜指令冲突 | 减为一个连续动作和一个主导运镜，或写成一个同步的复合运镜 |
| 脸部近景变形 | 景别太近加大幅旋转 | 换更宽景别、更轻动作，或使用计划好的剪辑 |
| 没有达到目标尾帧 | I2V 没有可用尾帧 | 重做干净尾帧并将其设为 `last_image` |
| R2V 忽略分镜顺序 | 顺序含糊或格子细节太小 | 写明 `镜头1 / 镜头2 / 镜头3`；只简化有歧义的分镜；只有需要逐镜头控制时才切 I2V |

## 接缝与剪辑问题

| 症状 | 常见原因 | 定向修复 |
|---|---|---|
| 连续接龙跳帧或倒退 | 真实尾帧与下一段不够对齐 | 重做收尾动作，重生成边界片段，只在目视检查后裁切 |
| 硬切显得突兀 | 没有视觉或声音关系 | 在剪辑前加入匹配、遮挡、插入镜头或强节奏点 |
| 叠化显得浑浊 | 两个无关构图被强行混合 | 改为硬切、匹配切或遮挡切；叠化只用于真正的时空变化 |
| 输入音频报错 | 提供的参考音频文件或 URL 被拒绝 | 修复或替换 `audio.references`；不要期待脚本静默移除输入音频 |
| 重试后输出音频仍失败 | Seedance 未返回音频流或报告音频生成失败 | 检查请求并让该片段以 `generate_audio:true` 重生成，不要静默降级为无声视频 |
| 原生音频末尾有爆音 | 生成音频被截断 | 先重生成该片段；新结果可接受后再考虑加短淡出 |

## 多素材问题

| 症状 | 常见原因 | 定向修复 |
|---|---|---|
| 素材用错在了某个主体上 | 按组绑定（`图片1到4分别定义四个角色`） | 一个主体一行绑定，各自点明自己的素材 |
| 同一个物体出现两次 | 多视角素材被读成多个物体 | 写明输出数量：`三张图定义同一盏灯；全片只出现一盏` |
| 道具在角色之间转移 | 从未写明归属 | 加 `只属于<主体>` |
| 每份素材都挤进每个镜头 | 没有按场景挑选 | 列出每个场景要用哪些素材 |
| 参考图的背景漏进来 | 素材职责只写了一半 | 补上 `不要用……` 那半 |
| 重复描述的运动与动作参考打架 | 文字在跟参考视频争夺控制 | 只写要继承哪些属性 |

## 分段与时序问题

| 症状 | 常见原因 | 定向修复 |
|---|---|---|
| 段落结束时状态不对 | 没写末态 | 写明这一段结束时什么是可见的 |
| 片子散掉、没有收住 | 最后一段没写末态 | 补上——最常见的遗漏 |
| 模型造出多余的停顿或切换 | 对连续动作用了秒级粒度 | 降到分段，或只写事件顺序 |
| 拍点稳定偏晚 | 该模型的时序漂移 | 查档案；把拍点写早，或降到分段 |
| 某个时间范围里的事件被漏掉 | 一个范围里塞了太多内容 | 拆成更多段 |
| 风格前面守住、后面漂了 | 全局规则被写进了第 1 段里 | 移到全局设定 |
| 向后延长时后段角色提前出现 | 源片首帧没写成末态 | 明确写成末态，并点明什么不许提前出现 |

## 检查顺序

按主体一致性、锁、段落末态、构图、运动、接缝、声音的顺序检查。**第一个失败就停**——后续润色无法弥补错误的身份或落点，继续往下查是浪费这一轮。

同一条锁在某个模型上反复破，那是**档案发现**，不是提示词问题。记进 [model-profile.zh-CN.md](model-profile.zh-CN.md)，不要反复改提示词。

**⚠️ 只看抽帧有盲区。** 静帧能定质感、构图、身份、末态，但说不了动态质量、转场流畅度、节奏与音画同步。绝不要只凭静帧下整体结论——要么看回放，要么明说结论只覆盖哪一半。