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

# Seedance 2.5 Skill 中文工作流

本文件是中文请求的主流程。模型 ID、JSON 字段、命令、媒体占位符和音频符号属于代码，不翻译。

## 1. 先选视频路线

| 需求 | 路线 | 输入 | 结果 |
|---|---|---|---|
| 一个简短、单一的场景 | T2V | 文字提示词 | 一条自洽镜头 |
| 多镜头且每格仍清晰可读 | 整张 Storyboard R2V | 一张完整分镜图 | 一次请求生成连续短片 |
| 需要人物、产品、场景或风格素材控制 | R2V 参考素材 | 少量、分工明确的参考图 | 一条受素材控制的片段 |
| 必须精确控制起止状态 | I2V 首尾帧 | 首帧和尾帧 | 一条可单独重做的镜头 |
| 同一个不中断动作超过平台时长 | 延长或接龙 | 上一段真实尾帧和下一段提示词 | 同一镜头的延续 |
| 一条片子里承载多个事件 | 分段直出 | 文字加可选参考素材 | 一次请求覆盖有序的多个段落，每段落在写明的末态上 |
| 对已有视频做限定范围的改动 | 编辑 | 源视频加目标参考素材 | 只改指定区域或元素的源片 |
| 两条成片之间的桥接 | 无缝转场 | 两条视频 | 生成中间的衔接内容 |
| 从 3D 预览取运动、调度与运镜 | 白模参考 | 粗或精白模视频加外观参考 | 按白模的时序与调度渲出的成片 |

当前默认可执行模型是 Seedance 2.0。只有所选服务已真实提供 Seedance 2.5 及其限制时，才使用 2.5 路线。

后四条路线依赖的能力逐模型、逐服务不同。**提供之前先核实可用性**——2.0 与 2.5 的对照、以及哪些已发布能力属于平台功能而非 API 参数，见 [能力](capabilities.zh-CN.md)。

### 整张 Storyboard 与逐镜头的选择

- 默认把**整张 Storyboard 作为一张参考图进行一次 R2V 请求**，前提是每格仍能看清。不要先切格。
- 只有当需要单独重做某镜头，或必须精确指定开场和收束状态时，才选择 I2V 首尾帧。
- 不要把每个分镜格都当作 R2V 素材图上传。多张 R2V 图只适用于它们分工不同的情况，例如人物、产品、场景、风格、动作参考。

## 2. 按需启用准备模块

### 主体设定

只有会反复出现的人物、产品、道具、手、车辆或场景需要主体设定。保留 3–5 条不变量：轮廓或比例、标志性材质或服装、主色，以及不可改变的标识。一次性氛围镜头可以跳过。

反复出现的人物使用一张干净脸部近景和一张独立全身参考图。不要把正侧背拼图当作人物身份参考，它可能被理解为多人。需要展示物体多个角度时，产品多角度图仍然有用。

### 关键帧

每个 I2V 镜头都需要首帧。只有镜头必须落在特定动作、构图、产品姿态或手部位置时，才加尾帧。每张关键帧只包含一个干净场景。

### Storyboard

已有 Storyboard 默认直接作为 R2V 参考。Seedance 通常能理解格子顺序；不需要预先删掉编号、格线、箭头或备注。只有实测视频把这些元素渲染进最终画面时，才生成清理版。

没有 Storyboard 时，使用 [中文提示词模板](prompt-templates.zh-CN.md) 中的 Seedream 模板生成一张。**必须在宿主界面展示图片，自己检查后再继续 R2V。** 这只是中间状态展示，不需要等待用户确认。

检查格子顺序、关键节奏是否可读、重复主体是否一致，以及该任务真正重要的结构条件，例如人物解剖、产品形态或关键文字。发现明显错误先自行重做；只有创意取舍无法推断时才询问用户。

只有明确改为 I2V 首尾帧路线时才切格。切格前先检查布局；自动切图只能确认位置，不能判断模型是否真的画对了每格内容。

## 3. 连续性与转场

首尾帧只控制**一个镜头**，不代表每个镜头都要继承上一段尾帧。

| 转场类型 | 下一段是否用上一段尾帧作首帧 | 设计原则 |
|---|---:|---|
| 同一动作、同一镜头不中断 | 是 | 按顺序生成并检查接缝 |
| 切换机位、地点、产品或时间 | 否 | 两段独立设计 |
| 匹配剪辑 | 通常否 | 匹配动作方向、形状、颜色或构图 |
| 遮挡或甩镜转场 | 否 | 上一镜头以遮挡结束，下一镜头从遮挡内或之后开始 |
| 插入镜头或空镜 | 否 | 用物体、环境或产品细节做桥接 |

把重要的剪辑、匹配和遮挡写进 Storyboard 和视频提示词。不要用叠化硬修两个无关镜头。

## 4. 写视频提示词

### 作用域：每条指令放在它管得住的地方

写模块之前，先按**这行字管什么范围**把已知信息分类。放错位置是漂移最常见的原因——写在第 1 拍里的全局规则，到第 4 拍就不管用了。

| 作用域 | 管什么 | 内容 |
|---|---|---|
| 全局 | 整条片子 | 片型、场景、风格、一句话导演命题、运镜原则 |
| 锁 | 任何不许漂的东西 | 身份、参考素材职责、音频源、连续性、负向 |
| 时序 | 某一拍或某一段 | 段落事件与各自末态 |

把两三条最贵的锁在提示词的**物理结尾**复述一次（近因效应有用）。这是放置约定，不是第四个作用域——内容仍属「锁」，并且先在那里出现过。

这与[通用视频提示词 Skill](../../universal-video-prompt-skill/references/workflow.zh-CN.md) 的模型无关 spec 格式一致。同一份需求要跑多个模型时用那个 Skill；本文件用于 Seedance 专属的写法。若此链接不可达，说明安装不完整；继续前先协助用户安装 `universal-video-prompt-skill`，不要自行编造缺失的共享规则。

### 模块

只写会影响镜头的模块：

```text
[主体或参考图绑定]
+ [一个可观察动作]
+ [空间与重要物体关系]
+ [一个主导运镜、同一意图的复合运镜，或剪辑]
+ [必要时的光影和风格]
+ [启用时的声音或台词]
+ [末态，任何必须落在特定位置的段落都要写]
+ [必须保持的约束]
```

### 末态承载多事件的片子

只要片子有一个以上事件，就写明每段结束时**什么是可见的**。这是给多段提示词加的杠杆最大的一项：它把「保持一致」变成模型能瞄准、你也能检查的东西。

```text
弱：  两个人继续弄那束花
强：  末态：花艺师左手持花束；剪刀回到工作台右侧
```

末态必须看得见。`她感到释然` 不是；`她的肩膀落下、皱起的眉松开` 是。完整分段结构见 [long-video.zh-CN.md](long-video.zh-CN.md)。

### 时序粒度：写拍点之前先定

粒度是前置决策。按秒级写完拍点再想降级，等于重写。

| 粒度 | 什么时候用 |
|---|---|
| 不写时序——只给事件顺序 | 单一连续动作、氛围片、单镜头。写了秒数反而把镜头切碎 |
| **分段 + 末态** | 绝大多数叙事片。**默认** |
| 秒级 | 只在有外部硬约束时：音乐、口型、素材交接、必须落在固定时间的拍点 |

能从输入推出来的就推——给了音乐或口播音轨＝秒级，说了氛围片＝不写，有明确固定拍点＝秒级。当需求是**多事件叙事、无外部约束**时，**要问，而且要给建议并说明理由**，不要甩一个空的选择题。

时间戳分配的是时间预算，**不是帧精确的剪辑点**，动作可能落在边界前后。不要要求「一秒内完成三个动作」这类不可能的密度。

- 明确每张参考图的职责，例如 `图片1中的人物`、`图片2中的产品`、`图片3中的厨房场景`。
- 整张 Storyboard R2V 按 `镜头1`、`镜头2`、`镜头3` 写事件顺序；时长交给服务参数，不在文字里强写逐秒时间表。
- 每个镜头优先一个主导运镜。允许复合运镜，但方向、与主体的关系、速度必须共同服务于一个意图。
- 启用原生音频时，`（）` 表示音乐，`<>` 表示音效，`{}` 表示台词，`【】` 表示画面文字。
- 只写代价高的约束，避免冗长负面词。

按任务读对应的参考文件：

| 文件 | 什么时候读 |
|---|---|
| [提示词模板](prompt-templates.zh-CN.md) | 各路线的模板 |
| [提示词组件库](prompt-blocks.zh-CN.md) | 可复用的镜头、声音、约束词块 |
| [长视频](long-video.zh-CN.md) | 分段结构、末态、时间戳规则 |
| [多素材绑定](multi-reference.zh-CN.md) | 素材多而不混淆 |
| [人物](real-person.zh-CN.md) | 可信的人，以及什么时候该省略这些细节 |
| [转场](transitions.zh-CN.md) | 哪些该生成、哪些该交给剪辑 |
| [编辑与延长](editing-and-extension.zh-CN.md) | 改动或续写已有视频 |
| [能力](capabilities.zh-CN.md) | 2.0 与 2.5 的上限；平台功能与 API 参数的分界 |
| [模型档案](model-profile.zh-CN.md) | 实测的逐模型行为与编译注记 |
| [电影语言词库](cinematography.zh-CN.md) | 细化镜头语言 |
| [问题排查](troubleshooting.zh-CN.md) | 按症状查修法 |
| [执行适配器](execution-adapters.zh-CN.md) | 脚本与适配器配置 |

## 5. 生成、检查、收尾

1. 需要生成 Storyboard 时，先只生成静帧，在对话中展示，检查后才发起视频请求。
2. 用户提供 Storyboard 时，若对话中还不可见则展示它，然后检查是否适合所选路线。
3. 分镜通过后直接生成一条代表性视频，不等待用户确认；不通过则先优化分镜。
4. 按主体一致性、锁、段落末态、构图、运动、接缝、音频的顺序检查，**第一个失败就停**——身份或落点错了，后面全白查。只重做出错镜头或片段。
5. 接龙必须按顺序生成，因为下一段要用真实尾帧。剪辑型视频则独立生成各镜头，再在时间线中处理预先设计的转场。

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

脚本只负责生成草稿和拼接，不负责专业调色或配乐混音。

## 6. Atlas 执行路线

创作路线与提交方式相互独立。默认使用 Seedream 5.0 Pro 生图、Seedance 2.0 生视频；改模型前先核实其支持所需路线。

在智能体对话中，默认由 **Atlas Cloud Skill 直接执行生成**。它可以查模型、上传本地素材、提交图片或视频任务、轮询并取回结果。只有它实际提交了任务，才报告 `Execution: atlas-skill`。

只有用户明确选择 MCP 且当前客户端暴露了生成工具时，才用 `atlas-mcp`。只有用户明确选择终端、脚本、CI 或批量执行时，才用 `atlas-cli`。若 Atlas Cloud Skill 缺失，先协助安装 `AtlasCloudAI/atlas-cloud-skills`，再选择替代路径。

报告“缺少 Atlas Cloud API Key”之前，必须检查**实际选中的执行进程**。REST 脚本先检查 `ATLASCLOUD_API_KEY`，再兼容检查 `ATLAS_CLOUD_API_KEY`。不要根据另一个服务商、插件或进程的状态推断凭据是否存在；不同执行通道可能拥有相互独立的凭据作用域。

如果两个变量都不存在，引导用户前往 `https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=awesome-seedance-2.5-prompts-skills` 获取 Key。不要让用户把 Key 粘贴到对话中；应指导其在真正提交任务的进程或宿主安全环境设置中配置 `ATLASCLOUD_API_KEY`，必要时刷新或重启执行会话。如果 Key 已存在于宿主或父进程配置，但提交进程读不到，应报告“环境作用域不一致”，不能说用户没有 Key。

### 计费任务状态机

所有图片和视频生成都必须遵守：

1. 提交后立即记录预测 ID 和对应创作阶段。
2. `starting`、`queued`、`pending`、`processing` 都是进行中状态；必须每 2 秒查询同一 ID，禁止为同一阶段再提交任务。
3. `completed`、`succeeded` 是成功终态；必须下载并检查输出，才能开始依赖它的下一阶段。
4. `failed`、`timeout`、`canceled` 是失败终态；新任务必须经过明确重试决定，并先报告原任务 ID 和可能增加的费用。
5. 推理时间为 0 或缺失、输出延迟、本地轮询超时、对话中断、临时查询失败，都不能证明任务失败；必须保留 ID 并恢复轮询。
6. 用户说“继续”只表示恢复原任务，不代表允许重试。Storyboard 仍在生成时，禁止提交依赖它的视频任务。

本工作流的 2 秒查询周期适用于所有 Atlas 执行路线。`atlas-skill` 每 2 秒用同一 ID 重复执行查询预测结果的步骤；`atlas-mcp` 每 2 秒用同一 ID 调用一次 `atlas_get_prediction`。MCP 服务端每次工具调用只查询一次状态，循环由智能体负责。内置 REST 和 CLI 适配器则在代码中实现 2 秒轮询。查询状态是只读操作，任何情况下都不能用新的生成调用代替。

脚本恢复任务时，把原 ID 写入 `execution.resumePredictionIds.<阶段>`。阶段键包括 `grid`、`ref1`、`ref2`、`seg1`、`shot1`、`clip1` 等。不能因为上一轮轮询进程结束就创建替代任务。

`scripts/generate.mjs` 不能调用智能体 Skill 或 MCP；它是单独的批处理工具。未设置时默认 `atlas-rest`，只有显式设置 `execution.adapter: "atlas-cli"` 才会使用 CLI，绝不因为本机安装了 CLI 就自动切换。

```bash
GRID_ONLY=1 node scripts/generate.mjs scripts/myjob.json
CLIPS_MAX=1 node scripts/generate.mjs scripts/myjob.json
SEGS_MAX=1 node scripts/generate.mjs scripts/myjob.json
```

脚本输出 `[storyboard-preview]` 绝对路径时，必须把该图展示给用户并自行检查，再继续视频任务。详细执行规则见 [中文执行适配层](execution-adapters.zh-CN.md)。