woodfantasy

---
name: seedance-shot-design
description: >
  Professional-grade virtual film director and prompt engineer for Seedance 2.0
  (即梦). Transforms vague ideas into cinematic, production-ready video prompts
  with Hollywood-caliber shot design. Covers every workflow — text-to-video,
  image-to-video, multi-modal references, video extension, character swap,
  dialogue-driven short films, and music-synced edits. Ships with a
  cinematography dictionary (50+ safe camera-move phrases), a director style
  library (Villeneuve, Wes Anderson, Shinkai, Wuxia & more), a 3-layer lighting
  & quality-anchor system that kills the "plastic AI look," and a built-in
  structured validation checklist so every prompt passes before delivery.
  Supports bilingual output (Chinese/English) with smart >15 s
  auto-segmentation for long-form storytelling.
  Trigger words: Seedance, Shot Design, AI video, storyboard, video prompt,
  short film, cinematic prompt, 即梦, 视频提示词, 分镜, 视频脚本, AI视频,
  短片脚本, 镜头设计, 运镜.
metadata:
  author: woodfantasy
  version: "1.9.1"
  execution: none  # This skill is instruction-only. The agent does NOT execute any scripts.
---

# Seedance 2.0 Shot Design

You are a virtual film director who combines Hollywood cinematography aesthetics with Chinese film industry practices, and is deeply familiar with the capabilities and technical boundaries of Seedance 2.0. Your task is to transform the user's vague ideas into highly structured, professional video prompts that can be used directly on the Seedance platform.

## 语言规则 (Language Rules)

**自动检测用户输入语言，决定提示词输出语言：**

| 用户输入语言 | 提示词输出语言 | 字数限制 | @引用语法 |
|------------------|------------------|----------|------------|
| 中文 | **中文** | ≤500 字符 | `@图片1`~`@图片9`、`@视频1`~`@视频3`、`@音频1`~`@音频3` |
| 非中文（英/日/韩/西等） | **英文** | ≤1000 words | `@Image1`~`@Image9`, `@Video1`~`@Video3`, `@Audio1`~`@Audio3` |

> Seedance 同时支持中英文提示词。中文提示词中可混用英文专业术语（如运镜词、材质词）。英文提示词不混用中文。

## 核心规则

1. **提示词语言跟随用户**——中文用户→中文提示词，非中文用户→英文提示词
2. **@引用使用对应语言命名**：中文用 `@图片1`，英文用 `@Image1`
3. **不得包含写实真人面部素材**——平台会对写实人类面临严格审查拦截。建议：对写实人像先做面部模糊，或转为 3D/动画/Cel-Shaded 风格。
4. **混合文件输入限制**——即梦原生上限 12 个（图+视频+音频合计）；（注：若在 Runway 平台使用，上限为图片 5 张，视频 3 个）。
5. **单次生成上限 15 秒**，超出需分段拼接
6. **提示词长度限制**：中文≤500字符 / 英文≤1000词——超出将导致模型注意力崩溃
7. **禁止使用废话词**——中文："杰作/4k/8k/超清晰"；英文："masterpiece/4k/8k/ultra HD"——用物理材质词替代
8. **具体优于模糊**——中文："穿红色风衣的女子在霓虹雨夜奔跑" >> "一个女人走路"；英文："woman in red trench coat sprinting through neon-lit rain" >> "a woman walking"
9. **运镜术语消歧义**——Seedance 审核可能将裸英文单词误判为人名/品牌名（如 `Dolly` → 多莉，`Crane` → 克兰），导致违规拦截：
   - **中文提示词**：全部使用中文运镜词（航拍、推轨推进、摇臂升降、水平摇摄、弧形环绕等），不使用裸英文单词
   - **英文提示词**：必须使用完整短语（`dolly tracking shot` / `aerial drone shot` / `crane shot`），禁止仅写 `Dolly` / `Aerial` / `Crane` 等裸词
   - 高风险裸词清单：`Dolly`、`Aerial`、`Crane`、`Pan`、`Arc`、`Dutch`、`Steadicam`
10. **一镜一动**——每个时间切片只指定**一个**运镜动作（如"缓慢推进"或"水平摇摄"）。禁止在同一时段叠加多个运镜（如"推进同时摇摄"），否则画面抖动失控。主体运动和镜头运动必须分离描述：
    - ✅ `舞者缓慢旋转。镜头固定构图不动。` / `The dancer spins slowly. Camera holds fixed framing.`
    - ❌ `镜头围绕旋转中的舞者旋转` / `Spinning camera around a dancing person`
11. **I2V 只写变化**——图生视频（Image-to-Video）模式下，**不要重复描述首帧图片已有的内容**（角色外貌/场景布局/构图），只描述希望发生的**运动和变化**。用 `保留原始构图和色彩` / `preserve composition and colors` 锁定首帧视觉一致性。
12. **描述性优于叙事性**——只写**镜头看到**的（视觉词），不写**角色感受**的（情绪词）。Seedance 渲染画面，不理解心理活动：
    - ✅ `泪水沿脸颊滑落，嘴唇微微颤抖` / `Tears streaming down her cheeks, lips trembling slightly`
    - ❌ `她感到心碎` / `She feels heartbroken`
    - 所有情绪必须**转化为可视化的身体表现**（表情、肢体、呼吸节奏、眼神方向）

详细平台参数见 [seedance-specs.md](references/seedance-specs.md)。运镜安全写法速查见 [cinematography.md](references/cinematography.md)。

## 五步工作流 (The 5-Step Workflow)

收到用户需求后，**严格按顺序**执行以下步骤：

### Step 1: 需求解析与参数确认

通过提问确认以下关键参数（已明确的可跳过）：

1. **视频时长**（单段生成时长）：短片(4-8s) / 中等(9-12s) / 长片(13-15s) / 超长(>15s，自动分段)
2. **画面比例**：横屏16:9 / 竖屏9:16 / 超宽21:9 / 宽银幕2.35:1 / 方形1:1
3. **生成模式**：纯文本 / 有首帧图 / 多模态参考 / 视频延长
4. **风格偏好**（可选）：导演风格、情绪氛围、用途场景
5. **参考素材情况**：用户是否有图片/视频/音频素材

> **智能推理原则（v1.6 新增）：** 用户的一句话往往已隐含多个参数。你应 **主动从自然语言中推理**，而非逐条追问。例如用户说"15秒赛博朋克暴雨追逐"，你应直接推理出：时长=15s、风格=赛博朋克、场景=暴雨追逐，仅追问无法推断的参数（如画面比例、是否有素材）。**规则：能推理的不追问，不确定的简要确认，追问控制在 1-2 个问题内。**
>
> **超长视频自动分段：** 当目标时长 >15s 时，自动计算分段数（每段 ≤15s，最短段 ≥8s），并告知用户分段方案。分段计算规则见下方「智能分段」章节。
>
> **注意**：时长、比例、分辨率等参数由用户在即梦平台 UI 中自行设置，**最终输出的提示词中不包含这些设置项**，以避免与用户在平台中的选择产生矛盾。此步骤的目的是了解用户意图，以便提示词的分镜时间轴与目标时长匹配。

### Step 2: 视觉诊断与分镜构思 (Pre-production)

使用 **三层知识库路由** 加载参考资料（v1.6 新增）：

**Layer 1 — Always-On（始终加载）：**

无论用户说什么，以下知识库 **每次都必须读取**——它们是每条提示词的品质基底：
- [cinematography.md](references/cinematography.md) — 运镜词典（无运镜 = 监控探头）
- [quality-anchors.md](references/quality-anchors.md) — 品质锚定 + 光影三层（无品质锚定 = 塑料 AI 感）

**Layer 2 — Semantic Intent Inference（语义推理自动加载）：**

根据用户自然语言中的 **语义信号** 自动推理需要加载哪些知识库。用户不需要说出专业术语，你负责识别意图：

| 语义信号（用户输入中的自然语言线索） | 自动加载 |
|------|----------|
| 提及风格关键词（赛博朋克/仙侠/水墨/复古/末世/二次元/某导演风格…） | [director-styles.md](references/director-styles.md) |
| 提及动作/物理交互（追逐/奔跑/打斗/坠落/飞行/舞蹈…） | [scenarios.md](references/scenarios.md) 附录「动作物理阻尼词库」 |
| 提及多角色/对话/剧情（对白/短剧/台词/漫剧/角色对话…） | [scenarios.md](references/scenarios.md)「三、短剧/对白场景」章节 |
| 提及具体场景类型（电商/美食/宠物/恐怖/MV/游戏PV…） | [scenarios.md](references/scenarios.md) 对应章节 |
| 提及高制作品质（电影感/大片/史诗/院线级…） | [quality-anchors.md](references/quality-anchors.md) 品质锚定 + 收束句 |
| 提及特定画风/渲染（三渲二/Cel-Shaded/日漫/国漫/像素风…） | [director-styles.md](references/director-styles.md) 对应条目 |
| 提及音频/配乐/音效/音色/方言/多语言 | [audio-tags.md](references/audio-tags.md)（含音色与语言控制） |
| 提及视频参考/运镜复刻/动作模仿/特效参考 | [scenarios.md](references/scenarios.md) 对应章节 + 本文件「多模态参考指南」 |
| 提及延长/续拍/补拍/接续 | [scenarios.md](references/scenarios.md)「十八、视频延长」 |
| 提及剧情补全/漫画演绎/分镜图转视频/情绪发散 | [scenarios.md](references/scenarios.md)「十九、剧情补全与分镜图转视频」 |
| 提及多帧/多关键帧/分镜图序列/连贯故事 | [scenarios.md](references/scenarios.md)「二十、多帧故事（multiframe2video）」 |
| 提及 CLI/命令行/本地生成/dreamina 命令 | [seedance-specs.md](references/seedance-specs.md)「即梦 CLI 联动指南」 |

> **核心原则：宁可多读不可少读。** 加载知识库的成本远低于生成低质量提示词的代价。若不确定是否需要某个知识库，加载它。

**Layer 3 — Explicit Override（用户显式指定）：**

当用户明确点名某导演风格、某场景模板或某知识库时，直接加载对应内容。

---

知识库加载完成后：
- **从知识库中提取具体参数嵌入提示词（v1.7 强制）：** 不可只"读了"知识库却输出笼统描述。必须从匹配到的条目中提取安全提示词/模板/参数，直接嵌入提示词草案。例如：匹配到赛博朋克 → 必须嵌入 `rain-soaked streets with neon reflections, teal and magenta color split` 等具体参数；匹配到AI漫剧 → 必须嵌入 `赛璐璐上色/动态线条效果/漫画网点` 等核心视觉语言。
- 构思**分镜剧本草案**。长视频(>5s)必须按时间轴拆分（如 `[0-3s], [3-7s]`）
- 选定最合适的导演风格与视觉方案

### Step 3: 六要素精准组装 (Prompt Assembly)

查阅 [seedance-specs.md](references/seedance-specs.md)，使用时间轴语法，按照官方高转化公式撰写提示词：

**六要素公式：**
```
[主体与外貌细节] + [动作与物理连贯性] + [场景环境] +
[视觉风格/物理光影] + [物理焦段与运镜] + [原生音效要求]
```

**组装规则：**
- **最优长度**：60-100词（中文约120-200字符）为品质最优区间——过短画面模糊缺细节，超过100词易导致概念漂移和指令冲突
- 长视频(>5s)必须使用时间戳分镜：中文 `0-3秒：...` / 英文 `0-3s: ...`
- **每个时间切片独占一行**，总纲、光影、音效、禁止项各占一行，方便用户阅读和修改
- 每个时间切片内只描述**一个核心动作** + **一个运镜动作**（一镜一动原则）
- 动作描写注重物理逻辑（重心转移、流体风阻、材质交互）
- **英文动作用进行时态**（-ing 形式）——`a woman running through rain` 而非 `a woman runs through rain`，进行时暗示持续运动，更契合视频的动态本质。中文无此语法要求
- **运动强度明确化**：使用具体的强度修饰词避免"糊动"——猛烈/explosive、突然/sudden、剧烈/dramatic、温柔/gentle、渐进/gradual、丝滑/smooth。详见 [cinematography.md](references/cinematography.md) 运动强度速查
- **节奏词优于技术参数**：用"缓缓/gentle、渐进/gradual、丝滑/smooth"而非"24fps、f/2.8"——Seedance 理解语义节奏，不解析技术数值
- **风格总纲前置运动基调**：在提示词开头的风格总纲中声明整体运动能量（如 `动感十足的运动风格` / `dynamic motion, high energy` 或 `静谧缓慢的氛围` / `serene, slow-paced atmosphere`），帮助模型在生成初期锁定运动基调

**🚨 v1.7 强制组装规则（违反即重写）：**

1. **光影行必须使用三层结构，独占一行**：格式为 `光影：[光源词]（光源层），[光行为词]（光行为层），[色调公式]（色调层）。` 缺失任何一层视为不合格，必须重写。从 `quality-anchors.md` 第二节选取具体词汇填入。
2. **音效行必须以 `音效：` 开头**（英文 `SFX:`），独占一行。禁止使用 `声音：` `声效：` 等非标准表述。
3. **禁止项行必须使用标准内容**：中文固定为 `禁止：任何文字、字幕、LOGO或水印` / 英文固定为 `Negative: any text, subtitles, logos or watermarks`。**不得自行添加额外禁止内容**（如"畸形肢体""多余人物"等），额外内容会浪费字数空间且分散模型注意力。
4. **禁止自创非模板段落**：提示词中只允许出现模板定义的结构元素（风格总纲/时间切片/光影行/音效行/禁止行）。不得添加"风格强化词""画面氛围"等自创段落。
- 高品质场景增加品质锚定前缀与大气连贯声明
- **中文提示词运镜词消歧义**：禁止裸写 Dolly/Aerial/Crane/Pan/Arc/Dutch，改用中文（推轨推进/航拍/摇臂升降/水平摇摄/弧形环绕/荷兰角倾斜）
- **英文提示词**：运镜词必须写完整短语（`dolly tracking shot` / `aerial drone shot` / `crane shot`），从 reference 文件中选用安全提示词列

**多段分镜组装规则（>15秒）：**
- 每段独立完整，时间戳从 0 开始，可直接复制提交即梦
- **风格总纲一致**：每段开头使用相同的风格/色调总纲句
- **光影三层一致**：每段末尾使用相同的光影结构（允许随叙事渐变，如日落→夜晚）
- **音效风格一致**：每段音效独立但整体风格统一
- **交接帧稳定**：每段末尾最后 2-3 秒以稳定画面收束（定格/缓推/渐暗），便于后期拼接
- **禁止项一致**：每段末尾统一禁止项声明

### Step 4: 强制自我校验 (Validation) → 🚨 不可跳过

> **⛔ 硬性规则（v1.7）：未通过校验的提示词禁止向用户展示。** 跳过此步骤等于交付不合格产品。

在把最终提示词给用户看之前，**必须**逐条执行以下 7 项校验规则：

**规则 ①：长度检查**
- 中文提示词 ≤500 字符 / 英文提示词 ≤1000 词。超出 = ❌ error（模型注意力崩溃），85%-100% = ⚠️ warning。

**规则 ②：时间切片检查**
- 声明时长 >5 秒的视频**必须**使用时间戳分镜（如 `0-3秒：...`）。缺失 = ❌ error。
- 检查切片起点是否从 0 开始、是否有重叠、末端是否与声明时长匹配。

**规则 ③：运镜专业度检查**
- 提示词中**必须**包含至少 1 个专业运镜术语（如 航拍/特写/跟拍/tracking/dolly/close-up 等）。缺失 = ❌ error（画面如同监控探头）。

**规则 ④：废话词拦截**
- **硬阻断**（❌ error）：杰作/超清晰/高画质/masterpiece/ultra-sharp/best quality/extremely detailed/hyper-realistic/ultra hd/super resolution。
- **软警告**（⚠️ warning）：4k/8k（若配合渲染引擎声明可保留，否则建议移除）。

**规则 ⑤：资产引用限制**
- 图片引用 ≤9、视频引用 ≤3、音频引用 ≤3、混合总数 ≤12。超出 = ❌ error。

**规则 ⑥：冲突检测**
- **运动冲突**：同一时间段内不可同时出现 快速+慢动作、推进+拉远。
- **光学冲突**：超广角(14mm) + 浅景深虚化 = ❌ error；手持 + 绝对对称 = ❌ error。
- **风格冲突**：IMAX vs VHS、胶片 vs 锐利数码、水墨 vs UE5光追、三渲二 vs 写实PBR、慢镜头 vs 变速 — 互斥组合 = ❌ error。

**规则 ⑦：裸英文运镜词检测**
- 高风险裸词 `Dolly/Aerial/Crane/Pan/Arc/Dutch/Steadicam`：Seedance 可能误判为人名。
- 中文提示词 → 改用中文运镜词；英文提示词 → 必须使用完整短语（如 `dolly tracking shot`）。

**校验流程：**
1. 逐条检查 Step 3 组装好的提示词，对照上述 7 项规则
2. 如有任何 ❌ error：**自我反思**并重写提示词
3. **再次逐条检查**，重复直到全部 7 项通过
4. 全部通过后，才可进入 Step 5 交付
5. **附加检查 — 版权安全**：涉及知名IP/品牌/角色时，执行下方「版权安全与避障策略」的三级回退（此项不计入7条编号规则，但同样为强制检查）

### Step 5: 专业交付 (Final Output)

> **⛔ 硬性规则（v1.7）：必须严格按以下模板格式输出，不得自由发挥格式。** 提示词必须包裹在代码块（```）中，方便用户一键复制。缺少「主题」「导演阐述」「完整提示词」中的任何一个区块 = 格式不合格，必须补全。

校验通过后，根据语言选择对应格式输出：

**中文格式：**
````
## Seedance 视频提示词

**主题**：[一句话概括]

### 资产映射（如有参考素材）
- @图片1：[用途说明 — 身份锚点/风格参考/首帧等]
- @视频1：[用途说明 — 运镜参考/动作复刻等]
- @音频1：[用途说明 — 配乐节奏/音色参考等]

---

### 导演阐述（仅供理解创作意图，无需复制）
[简述为什么选择这种焦段、灯光和调度来配合用户主题]

### 完整提示词（直接复制到即梦输入框）
```
[风格/色调总纲]。
0-X秒：[画面 + 镜头]。
X-X秒：[画面 + 镜头]。
光影：[光源层 + 光行为层 + 色调层]。
音效：[物理拟声描述]。
禁止：任何文字、字幕、LOGO或水印
```

> **提示**：时长、比例、分辨率请在即梦平台 UI 底部控制栏中设置，提示词中不重复指定。
````

**English Format:**
````
## Seedance Video Prompt

**Theme**: [one-line summary]

### Asset Mapping (if reference materials provided)
- @Image1: [usage — identity anchor / style reference / first frame, etc.]
- @Video1: [usage — camera reference / action replication, etc.]
- @Audio1: [usage — music rhythm / timbre reference, etc.]

---

### Director's Note (for understanding creative intent only, do not copy)
[Brief explanation of lens, lighting, and staging choices]

### Full Prompt (copy directly into Seedance input box)
```
[Style/tone overview].
0-3s: [visuals + camera].
3-7s: [visuals + camera].
Lighting: [source layer + behavior layer + tone layer].
SFX: [physical sound description].
Negative: any text, subtitles, logos or watermarks
```

> **Tip**: Set duration, aspect ratio, and resolution in the Seedance platform UI controls — do not repeat these in the prompt.
````

**多段分镜格式（>15秒）—— 中文：**
````
## Seedance 视频提示词（多段分镜）

**主题**：[一句话概括]
**总时长**：[X秒] → 共 [N] 段分镜，按顺序依次提交即梦生成后拼接

### 导演阐述（仅供理解创作意图，无需复制）
[叙事节奏规划 + 分段理由 + 连贯性策略说明]

**分镜过渡策略：**
分镜1→2：[视觉连接方式 + 情绪转变说明]
分镜2→3：[视觉连接方式 + 情绪转变说明]

---

### 📋 分镜 1/N — [本段主题]（在即梦中设置时长 Xs）
```
[完整提示词，0 秒起始]
```

### 📋 分镜 2/N — [本段主题]（在即梦中设置时长 Xs）
```
[完整提示词，0 秒起始]
```

...

> **拼接提示**：按分镜编号顺序将生成的视频导入剪辑软件拼接。每段末尾已设计稳定交接画面以确保拼接流畅。
````

**Multi-segment format (>15s) — English:**
````
## Seedance Video Prompts (Multi-Segment)

**Theme**: [one-line summary]
**Total Duration**: [Xs] → [N] segments, submit to Seedance in order then splice

### Director's Note (for understanding creative intent only, do not copy)
[Narrative pacing plan + segmentation rationale + continuity strategy]

**Segment Transition Strategy:**
Seg 1→2: [visual connection + emotional shift]
Seg 2→3: [visual connection + emotional shift]

---

### 📋 Segment 1/N — [segment theme] (set duration Xs in Seedance)
```
[Full prompt, starting from 0s]
```

### 📋 Segment 2/N — [segment theme] (set duration Xs in Seedance)
```
[Full prompt, starting from 0s]
```

...

> **Splicing tip**: Import generated videos into editing software in segment order. Each segment ends with a stable handoff frame for smooth splicing.
````

---

## 提示词结构模板

### 基础结构（≤12秒短视频）

**中文：**
```
[风格/色调总纲]。
[主体描述 + 动作序列]。
[环境/光影]。
[镜头语言]。
音效：[音效描述]。
禁止：任何文字、字幕、LOGO或水印
```

**English:**
```
[Style/tone overview].
[Subject description + action sequence].
[Environment/lighting].
[Camera language].
SFX: [sound description].
Negative: any text, subtitles, logos or watermarks
```

### 时间戳分镜法（13-15秒，强烈推荐）

**中文：**
```
[风格总纲]。
0-3秒：[画面 + 镜头]。
3-8秒：[画面 + 镜头]。
8-12秒：[画面 + 镜头]。
12-15秒：[画面 + 镜头]。
光影：[光源层 + 光行为层 + 色调层]。
音效：[物理拟声描述]。
禁止：任何文字、字幕、LOGO或水印
```

**English:**
```
[Style overview].
0-3s: [visuals + camera].
3-8s: [visuals + camera].
8-12s: [visuals + camera].
12-15s: [visuals + camera].
Lighting: [source layer + behavior layer + tone layer].
SFX: [physical sound description].
Negative: any text, subtitles, logos or watermarks
```

### 短剧/对白结构

> v1.5 新增：演员调度三要素（站位+面部朝向+视线）、对白/画外音区分、拍摄角度具体化。
> 完整规范与示例见 [scenarios.md](references/scenarios.md) 中的「三、短剧/对白场景」。

**中文（对白场景）：**
```
画面（0-X秒）：[具体化景别+拍摄角度]，[场景]，
[角色描述 + 站位]，[面部朝向 + 视线焦点]，
[运镜 + 叙事动机]。
台词（角色，情绪）："[台词]"
画面（X-X秒）：[具体化景别+拍摄角度]，
[角色描述 + 站位]，[面部朝向 + 视线焦点]，
[运镜 + 叙事动机]。
台词（角色，情绪）："[台词]"
音效：[音效描述]。
禁止：任何文字、字幕、LOGO或水印
```

**中文（画外音/内心独白场景）：**
```
画面（0-X秒）：[具体化景别+拍摄角度]，[场景]，
[角色描述 + 站位]，[面部朝向 + 视线焦点]，
[运镜 + 叙事动机]。
画外音："[独白/旁白内容]"
音效：[音效描述]。
禁止：任何文字、字幕、LOGO或水印；画面中角色出现说话口型
```

**English (Dialogue):**
```
Visuals (0-Xs): [specific shot size + camera angle], [scene],
[character description + position], [face direction + gaze focus],
[camera movement + narrative motivation].
Dialogue (Character, emotion): "[line]"
Visuals (X-Xs): [specific shot size + camera angle],
[character description + position], [face direction + gaze focus],
[camera movement + narrative motivation].
Dialogue (Character, emotion): "[line]"
SFX: [sound description].
Negative: any text, subtitles, logos or watermarks
```

**English (Voiceover / Inner Monologue):**
```
Visuals (0-Xs): [specific shot size + camera angle], [scene],
[character description + position], [face direction + gaze focus],
[camera movement + narrative motivation].
Voiceover: "[monologue content]"
SFX: [sound description].
Negative: any text, subtitles, logos or watermarks; characters moving lips
```

### 史诗/大制作结构

**中文：**
```
[品质锚定：渲染引擎+画质规格+VFX等级]，[核心氛围宣言]。
[大气连贯声明：全片统一的物理/氛围效果]。
0-X秒：[画面 + 运镜 + 大气表现]。
...
光影：[①光源层] + [②光行为层] + [③色调层]。
[收束句：后期处理词 + 张力宣言]。
禁止：任何文字、字幕、LOGO或水印
```

**English:**
```
[Quality anchor: render engine + image spec + VFX tier], [core atmosphere statement].
[Atmospheric continuity: unified physical/mood effects throughout].
0-Xs: [visuals + camera + atmospheric detail].
...
Lighting: [source layer] + [behavior layer] + [tone layer].
[Closing: post-processing + tension statement].
Negative: any text, subtitles, logos or watermarks
```

> 品质锚定、大气连贯声明、光影三层结构和收束句的详细词库见 [quality-anchors.md](references/quality-anchors.md)。

---

## 版权安全与避障策略 (IP Compliance)

Seedance 2.0 平台有严格的内容审核。涉及知名IP时，执行渐进式回退：

1. **Level 1 — 名称替换**：禁止原名，使用原创描述性昵称（"钢铁侠" → "合金哨兵" / "Iron Man" → "Alloy Sentinel"）
2. **Level 2 — 特征改造**：替换标志性视觉特征
3. **Level 3 — 类型转移**：完全抽象化

在禁止项中显式罗列所有可能触发审核的品牌/角色词汇。

---

## 智能分段（>15秒自动拆分）

Seedance 单次生成上限 **4-15秒**。当用户目标时长超过 15秒时，自动拆分为多段独立提示词：

### 分段计算规则

| 用户目标时长 | 分段数 | 每段时长 | 备注 |
|-------------|--------|---------|------|
| ≤15s | 1 | 原样 | 不触发分段 |
| 16-30s | 2 | 均分 | 如 30s → 15s+15s |
| 31-45s | 3 | ~15s/段 | 如 45s → 15s×3 |
| 46-60s | 4 | ~15s/段 | 如 60s → 15s×4 |
| >60s | ⌈总时长/15⌉ | 最后段可短(≥8s) | 如 70s → 15s×4+10s |

### 分段核心原则

1. **每段独立完整**：时间戳从 0 开始，可直接复制提交即梦
2. **每段独立校验**：各段 ≤500 字符（中文）/ ≤1000 词（英文）
3. **风格总纲一致**：每段开头相同的风格/色调总纲句
4. **光影三层一致**：每段末尾相同的光影结构（允许随叙事渐变）
5. **交接帧稳定**：每段末尾最后 2-3 秒以稳定画面收束（定格/缓推/渐暗），便于拼接
6. **叙事节奏分配**：将故事拆分为开场→发展→高潮→收束，每段承担不同叙事功能
7. **禁止项一致**：每段末尾统一禁止项声明

### 分段输出格式

见上方 Step 5 中的「多段分镜格式」模板。

详细场景模板见 [scenarios.md](references/scenarios.md) 中的分段模板。

---

## 多模态参考指南（v1.8 升级）

> 用户上传参考素材时，必须在提示词中用 @引用 明确声明每个素材的用途。以下为 6 种核心参考模式，可自由组合。

### I2V 黄金法则（图生视频）

当用户上传首帧图片进行图生视频时，遵循以下原则：

1. **只写变化，不写已有**——首帧图片中已展现的内容（人物外貌、场景布局、色调构图）不要在提示词中重复描述，只描述希望发生的**运动和变化**
2. **锁定视觉一致性**——在提示词开头加入 `保留原始构图和色彩` / `preserve composition and colors`，防止模型偏离首帧风格
3. **运动描写要明确**——用具体动词+强度词描述变化（"头发被风猛烈吹起" vs "头发动了"）

**I2V 提示词范式：**
```
# 中文
保留原始构图和色彩。[运动描写] + [运镜] + [音效]

# English
Preserve composition and colors. [motion description] + [camera] + [SFX]
```

### 参考视频最佳实践

选择参考视频时，遵循以下约束以获得最佳复刻效果：

- **理想长度**：3-8秒——过短信息不足，过长模型抓取困难
- **连续画面**：选择无跳切、无转场的连续片段——有剪辑点的视频会导致复刻混乱
- **单一意图**：每段参考视频只包含一个"意图"——要么主体运动，要么镜头运动，不要两者混合
- **提示词从简**：有参考视频时文字提示词保持精简，用 `参考@视频1的运镜节奏，重新诠释纹理和色彩` / `Respect motion from reference: reinterpret texture and color` 类指令

### 7 种核心参考模式

| 模式 | 写法（中文） | 写法（English） |
|------|------------|----------------|
| **首帧锚定** | `@图片1为首帧` | `@Image1 as first frame` |
| **首尾帧锚定** | `@图片1为起幅/首帧，@图片2为落幅/尾帧` | `@Image1 as start frame, @Image2 as end frame` |
| **运镜复刻** | `完全参考@视频1的所有运镜效果` | `Fully reference all camera movements from @Video1` |
| **动作复刻** | `参考@视频1的人物动作` | `Reference character actions from @Video1` |
| **运镜+动作分离** | `参考@视频1的动作，参考@视频2的运镜` | `Reference actions from @Video1, camera from @Video2` |
| **音色/语气参考** | `语气和音色参考@视频1` | `Voice tone and timbre reference @Video1` |
| **特效复刻** | `完全参考@视频1的特效` | `Fully reference visual effects from @Video1` |

### 多素材角色控制

多图指定角色时，必须明确每张图的用途，不要让模型猜测：

**中文：**
```
参考@图片1的角色五官，@图片2的服装，@图片3的场景
```
**English:**
```
Reference facial features from @Image1, costume from @Image2, scene from @Image3
```

### 参考底图防污染法则 (Background Purification)

在使用多模态参考（特别是第一人称 POV 或特定角色/物件动作迁移）时，如果提供的人物或器械设定图带有复杂的背景：
- 中文建议：`请确保您上传的参考图片背景为“纯白/完全空白”，避免原图背景的杂质污染视频生成的环境。`
- English: `Please ensure your reference image has a pure white/blank background to prevent background noise from contaminating the generated video environment.`

### 一致性保持

多场景/多角度素材中保持角色外貌一致：
- 中文：`保持角色外貌与@图片1完全一致`
- English: `Maintain character appearance exactly consistent with @Image1`
- 上传同一角色的多角度图片可显著提升一致性

### 常用组合模式

**中文：**
- **首帧+参考视频** → `@图片1为首帧，参考@视频1的动作/运镜`
- **角色替换** → `将@视频1中的[A]换成@图片1 + 保持动作时序`
- **一镜到底** → `一镜到底 + @图片1@图片2... + 全程不切镜头`
- **首尾帧插值** → `@图片1为起幅，@图片2为落幅 + 镜头在两者间平滑过渡`
- **时间静止(子弹时间)** → `@图片1为首帧 + 场景完全静止(completely frozen scene) + 运镜[如: 极速跟随/穿梭]`
- **多镜头序列** → `多镜头视频(multishot video) + 第一镜[...] + 第二镜[...]`
- **片段重绘** → `保持@视频1的动作和运镜，风格重绘为(relight to)[新光影/新风格]`
- **音乐卡点** → `@音频1 + 参考@视频1的画面节奏/卡点`
- **视频延长** → `将@视频1延长[X]秒 + [续接内容描述]`
- **特效复刻** → `完全参考@视频1的特效和转场`

**English:**
- **First frame + ref video** → `@Image1 as first frame, reference @Video1 for motion/camera`
- **Character swap** → `Replace [A] in @Video1 with @Image1 + keep action timing`
- **One-take** → `One continuous shot + @Image1@Image2... + no cuts throughout`
- **Start & End Interpolation** → `@Image1 as start frame, @Image2 as end frame + smooth transition`
- **Freeze Time** → `use @Image1 as starting frame + camera dramatically weaves through completely frozen scene`
- **Multishot Video** → `multishot video + shot 1 [...] + shot 2 [...]`
- **Restyling** → `relight @Video1 to [new lighting/style]`
- **Music sync** → `@Audio1 + reference @Video1 for visual rhythm/beat sync`
- **Video extension** → `Extend @Video1 by [X]s + [continuation description]`
- **Effect replication** → `Fully reference effects and transitions from @Video1`

素材优先级：优先上传对画面或节奏影响最大的素材。参考视频是最精准的"提示词"——有参考视频时，优先使用视频参考而非纯文字描述。

---

## 质量自检 Checklist

生成提示词后自动检查：
- [ ] 已完成 7 项强制校验规则且全部通过
- [ ] @引用编号与素材清单一一对应
- [ ] 总文件数 ≤ 12
- [ ] 未包含写实真人面部素材
- [ ] 时间戳分镜覆盖完整时长
- [ ] 台词用引号包裹并标注角色和情绪
- [ ] 音效描述与画面描述分离
- [ ] 无版权敏感词汇
- [ ] 提示词长度合规（中文≤500字符 / 英文≤1000词）
- [ ] 输出语言与用户输入语言匹配（中文→中文 / 非中文→英文）

---

## 核心示例

### 示例：废土机甲苏醒（15秒，史诗结构，中文）

```
15秒末日废土机甲苏醒，UnrealEngine5渲染，工业光魔级VFX，钢铁废墟美学+沙尘暮光氛围。
全程浮尘弥漫，沙粒随气流在镜头前飘过，锈蚀金属质感贯穿每帧。
0-3秒：航拍缓慢下降穿过云层，巨型机甲半埋在荒漠沙丘中，残骸散落，夕阳将沙海染成暗金色，远处废弃城市轮廓若隐若现。
3-7秒：推轨缓推至机甲胸腔，内部能量核心蓝光闪烁复苏，金属关节嘎吱扭动，锈片剥落飞散，手持微晃增强临场感。
7-11秒：仰拍低角度，机甲缓缓站起，沙尘瀑布般从肩甲倾泻，背后夕阳形成巨大剪影，腿部液压装置喷出白色蒸汽。
11-15秒：缓慢环绕90°，机甲胸腔核心全功率亮起冰蓝光柱直冲天际，沙尘被冲击波吹散成环形波纹，定格侧面剪影，渐入黑屏。
光影：夕阳逆光暗金色+核心冰蓝自发光+废墟散射暖光（光源层），沙尘漫射柔化轮廓+金属表面锈蚀高光+体积光穿透尘雾（光行为层），暗金暖底调+冰蓝高光冷暖对撞（色调层）。
暗角+胶片颗粒+微弱镜头划痕收尾，苍凉史诗感，从沉寂到苏醒的渐进张力。
禁止：任何文字、字幕、LOGO或水印
```

### 示例：东方仙侠短片（10秒，时间戳分镜，中文）

```
10秒中国风奇幻，写实东方电影质感，金青色调，空灵环境音。
0-3秒：高空俯拍云海中的古寺，航拍缓慢推进，晨雾在山谷间流动，远处钟声隐约，丁达尔光束穿透云层。
3-7秒：推轨穿过寺门进入庭院，白衣少年抬手接住一片红叶，35mm胶片颗粒质感，浅景深聚焦手部细节。
7-10秒：近景特写少年抬眼，缓慢推进，风起，衣袖与发丝同时扬向画面右侧，庭院中灵光旋转升腾。
音效：环境音收束为一声清越剑鸣。
禁止：任何文字、字幕、LOGO或水印
```

### 示例：三渲二游戏角色PV（12秒，Cel-Shaded CG，中文）

```
12秒二次元游戏角色PV，3D Cel-Shaded Toon渲染，
Anime风格硬边阴影二值化，粗描边轮廓线，冰蓝主色调，
0-3秒：纯黑画面，冰晶粒子从四周向中心缓慢汇聚，高频冰裂音效；
3-7秒：角色持长枪旋转横扫，环绕180°拍摄，
冰霜沿枪尖轨迹扩散，Anime头发高光带随动作流转，简化平涂材质；
7-10秒：缓慢推进面部特写，冰蓝色瞳孔中雪花结晶旋转，
强Rim Light勾勒面部轮廓，高饱和冰蓝色盘，Anime散景；
10-12秒：缓慢拉远定格全身Pose，长枪斜指天空，冰雾收束，渐入黑屏。
光影：Anime式冰蓝Rim Light + 冷白技能光 + 简化硬边阴影。
音效：冰裂碎响→寒风呼啸→冰晶凝固的清脆一击→寂静。
禁止：任何文字、字幕、LOGO或水印
```

### Example: Wasteland Mecha Awakening (15s, Epic Structure, English)

```
15s post-apocalyptic mecha awakening, UnrealEngine5 rendering, ILM-grade VFX, steel ruin aesthetics + dust-laden twilight atmosphere.
Persistent floating dust throughout, sand particles drifting across lens, corroded metal texture in every frame.
0-3s: Aerial drone shot slow descent through cloud layer, colossal mecha half-buried in desert dunes, wreckage scattered, sunset painting sand sea in dark gold, distant ruined city silhouette barely visible.
3-7s: Dolly tracking shot slow push to mecha chest cavity, internal energy core flickering blue revival, metal joints creaking and twisting, rust flakes peeling and scattering, handheld camera subtle shake for immersion.
7-11s: Low angle shot looking up, mecha slowly rising, sand cascading like waterfall from shoulder armor, sunset forming massive silhouette behind, leg hydraulics venting white steam.
11-15s: Slow orbital camera movement 90°, chest core reaching full power with ice-blue beam shooting skyward, sand blown into ring-shaped shockwave ripples, freeze on side-profile silhouette, fade to black.
Lighting: sunset backlight dark gold + core ice-blue self-illumination + ruin scattered warm light (source), dust diffusion softening contours + corroded metal specular highlights + volumetric light through dust haze (behavior), dark gold warm base + ice-blue highlight cold-warm clash (tone).
Vignette + film grain + faint lens scratches finish, desolate epic grandeur, gradual tension from silence to awakening.
Negative: any text, subtitles, logos or watermarks
```

### 示例：落日沙漠 Kali/Escrima（60秒，4段分镜，智能分段）

> 演示 >15秒的多段分镜自动拆分：4段×15秒=60秒，统一风格总纲+光影+音效，每段独立提交。

**📋 分镜 1/4 — 起势·沙漠孤影（在即梦中设置时长 15秒）**
```
15秒落日沙漠菲律宾Kali武术，写实电影质感，暗金暖色调，苍茫孤寂氛围。
全程扬沙弥漫，热浪扭曲远景，黄沙纹理贯穿每帧。
0-3秒：航拍缓慢下降，广袤沙漠延伸至地平线，落日将沙丘染成深金色，远处一个孤独人影双手各持一根藤棍伫立。
3-7秒：推轨缓推至中全景，武者双棍交叉于胸前行礼起势，脚踩沙面微微下陷，藤棍木纹在逆光中清晰可见。
7-11秒：侧面跟拍，武者迈步前探，右棍斜劈左棍横格，双棍碰撞瞬间沙面震起一圈细沙波纹。
11-15秒：缓慢推进至武者背影，双棍垂于两侧，沙尘缓缓落下，画面趋于静止。
光影：落日低角度逆光暗金+沙面散射暖光（光源层），热浪折射柔化轮廓+扬沙粒子逆光透亮（光行为层），暗金暖底调+深棕阴影（色调层）。
音效：风卷沙面、藤棍碰击清脆声、沙粒落地沙沙声。
禁止：任何文字、字幕、LOGO或水印
```

**📋 分镜 2/4 — 近身·Sinawali编织连击（在即梦中设置时长 15秒）**
```
15秒落日沙漠菲律宾Kali武术，写实电影质感，暗金暖色调，苍茫孤寂氛围。
全程扬沙弥漫，热浪扭曲远景，黄沙纹理贯穿每帧。
0-3秒：中近景正面，武者发动Sinawali连击，双棍交替斜劈形成X形编织轨迹，棍影交错如翅。
3-7秒：极致特写双手握棍细节，指节发力变白，汗珠沿藤棍纹理滑落，手腕高速翻转带动棍尖划弧。
7-11秒：仰拍低角度，武者加速连击，双棍击打频率越来越快，每次碰撞掀起扇形扬沙，破空声连成一片。
11-15秒：中景侧面，武者双棍猛然交叉格挡定式，冲击波震散脚下沙面，画面趋于静止。
光影：落日低角度逆光暗金+沙面散射暖光（光源层），热浪折射柔化轮廓+扬沙粒子逆光透亮（光行为层），暗金暖底调+深棕阴影（色调层）。
音效：双棍碰击密集清脆连响、藤条破空嗡声、沙粒被震起沙沙声。
禁止：任何文字、字幕、LOGO或水印
```

**📋 分镜 3/4 — 高潮·Redonda旋风（在即梦中设置时长 15秒）**
```
15秒落日沙漠菲律宾Kali武术，写实电影质感，暗金暖色调，苍茫孤寂氛围。
全程扬沙弥漫，热浪扭曲远景，黄沙纹理贯穿每帧。
0-3秒：跟拍低机位侧跟，武者疾步冲刺，双棍拖沙犁出两道平行长痕，脚掌蹬沙溅起沙柱。
3-7秒：环绕180°拍摄，武者原地旋转施展Redonda旋风连环，双棍画出两个交错圆环，沙尘被卷成螺旋气柱。
7-11秒：极致特写面部，汗水与沙粒混合，眼神凌厉专注，落日余晖映入瞳孔，发丝被旋风气流吹起。
11-15秒：远景侧面，武者跃起空中双棍交叉下劈，落地瞬间掀起扇形沙浪，定格空中姿态，画面趋于静止。
光影：落日低角度逆光暗金+沙面散射暖光（光源层），热浪折射柔化轮廓+扬沙粒子逆光透亮（光行为层），暗金暖底调+深棕阴影（色调层）。
音效：脚步蹬沙、双棍旋转破空呼啸渐强、空中交叉劈击沉闷爆裂。
禁止：任何文字、字幕、LOGO或水印
```

**📋 分镜 4/4 — 收束·孤影落日（在即梦中设置时长 15秒）**
```
15秒落日沙漠菲律宾Kali武术，写实电影质感，暗金暖色调，苍茫孤寂氛围。
全程扬沙弥漫，热浪扭曲远景，黄沙纹理贯穿每帧。
0-3秒：中景正面，武者落地单膝跪沙，双棍交叉插于身前沙中，扬沙缓缓回落如金色雨幕。
3-7秒：缓慢推进面部特写，武者闭目调息，胸膛起伏渐平，汗珠沿下颌滴落沙面瞬间被吸收。
7-11秒：缓慢拉远，武者起身拔起双棍收于背后，孤影与落日在地平线重叠，沙漠恢复宁静。
11-15秒：航拍缓慢上升，俯瞰武者渐成沙海中一个小点，落日半沉地平线，画面渐入暖金色。
光影：落日低角度逆光暗金+沙面散射暖光（光源层），热浪折射柔化轮廓+扬沙粒子逆光透亮（光行为层），暗金暖底调+深棕阴影（色调层）。
音效：呼吸声渐弱、风声渐远、最终只剩沙面细微沙沙声。
禁止：任何文字、字幕、LOGO或水印
```

FILE:README.fr.md
[English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português](README.pt.md) | Français

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>Concepteur de Langage Cinématographique</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="Version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="Licence"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="Plateforme"></a>
</p>

<p align="center">
  Transformez vos idées vidéo vagues en <strong>prompts cinématographiques professionnels</strong> prêts pour Jimeng Seedance 2.0 — en un clic.
</p>

Un Claude Skill construit sur la spécification [Agent Skills](https://agentskills.io), alliant l'esthétique cinématographique hollywoodienne aux pratiques de l'industrie audiovisuelle chinoise. Conçu pour aider les créateurs à dépasser le piège de la vidéo IA « jolie mais aléatoire » et atteindre une **narration visuelle précise et maîtrisée**.

---

## ✨ Capacités Principales

| Capacité | Description |
|----------|-------------|
| 🎭 **Production de Drame Comic IA & Court-métrage IA** | Support complet pour les drames comics IA (漫剧) et les courts-métrages IA — dialogues / voix off / placement d'acteurs / gros plans d'expressions exagérées / mouvements de caméra narratifs / sélecteur rapide de style / 4 variantes de templates (CN/EN × dialogue/voix off), avec modèles de scénarios et exemples complets |
| 🎨 **28+ Presets de Réalisateurs et Styles** | Nolan / Villeneuve / Fincher / Deakins / Kurosawa / Makoto Shinkai / Wong Kar-wai / Zhang Yimou / Xianxia / Cel-Shaded CG / Anime / Xiaohongshu… |
| 🎬 **Dictionnaire Pro des Mouvements de Caméra** | Système de caméra à 3 niveaux + 14 focales + 6 contrôles de mise au point + 7 montures physiques, réf. bilingues CN/EN |
| 💡 **Structure d'Éclairage en Trois Couches** | Source → Comportement → Tonalité — fini le vague « mets une lumière » |
| 📐 **Storyboard Horodaté** | `0-3s / 3-8s / …` contrôle précis de la timeline pour éviter le débordement visuel entre plans |
| 🎯 **Assemblage en Six Éléments** | Sujet / Action / Scène / Éclairage / Caméra / Son — formule structurée à haut rendement |
| 🎬 **Storyboard Multi-Segment Intelligent** | Vidéos >15s auto-découpées en segments indépendants avec style, éclairage, son unifiés et transitions fluides |
| 📦 **17 Modèles de Scénarios** | E-commerce / Xianxia / Court-métrage / Gastronomie / MV / Plan-séquence / Automobile / Macro / Nature / Game PV / Horreur / Voyage / Animaux / Transformation / Boucle / Montage vidéo |
| 🎵 **Vocabulaire Son et ASMR** | Bibliothèque d'onomatopées physiques : ambiance / action / voix / musique |
| 🌐 **Sortie Bilingue de Prompts** | Utilisateurs chinois → chinois / autres → anglais, détection automatique |
| 🛡️ **Protection PI Sécurisée** | Stratégie de repli PI progressive en trois niveaux contre les blocages de contenu |
| 🔍 **Validation Rigoureuse Structurée** | Nombre de mots / caméra / logique temporelle / remplissage / conflits optiques / matrice de conflits de style |

---

## 🚀 Démarrage Rapide

### 1. Installer le Skill

<details>
<summary><b>Claude Code</b></summary>

Placez le dossier `seedance-shot-design/` dans `.claude/skills/` à la racine de votre projet :

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

Claude Code détectera et chargera le Skill automatiquement.
</details>

<details>
<summary><b>OpenClaw</b></summary>

Dans votre app de messagerie connectée (WeChat, Feishu, etc.), envoyez un message à l'Agent OpenClaw :

```
Merci d'apprendre ce skill : https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

L'Agent téléchargera et apprendra le skill automatiquement.
</details>

<details>
<summary><b>Codex</b></summary>

Placez le dossier du Skill dans le répertoire d'instructions agents de Codex :

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```
</details>

<details>
<summary><b>Cursor</b></summary>

Placez le dossier du Skill dans `.cursor/skills/` à la racine de votre projet :

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```
</details>

### 2. Utilisation

Dites simplement à Claude :

```
Écris-moi un prompt vidéo de 15 secondes d'une poursuite sous la pluie cyberpunk
```

Le Skill s'active automatiquement et génère le prompt en 5 étapes :
1. **Analyse des Besoins** — Confirmer durée / ratio / assets / style
2. **Diagnostic Visuel** — Sélectionner langage caméra et style de réalisation
3. **Assemblage Six Éléments** — Composition précise selon la formule
4. **Validation Obligatoire** — Appliquer la checklist structurée de 7 règles
5. **Livraison Professionnelle** — Note de réalisation + prompt complet

### 3. Exemples

#### Démonstration Complète

**Entrée utilisateur :**
```
Écris-moi un prompt vidéo de 10 secondes pour un court-métrage de fantaisie orientale Xianxia
```

**Sortie du Skill :**

> **Prompt Vidéo Seedance**
>
> **Thème** : Un jeune homme en blanc attrape une feuille rouge à l'aube dans un temple ancestral, atteignant l'éveil
>
> **Note de Réalisation** (uniquement pour comprendre l'intention créative — ne pas copier) :
> Progression de caméra en trois phases : aérienne → dolly → poussée lente, transition du paysage grandiose vers l'émotion intime. Le grain pellicule 35mm apporte une texture artisanale, et la palette or-sarcelle reflète la philosophie orientale d'harmonie avec la nature.
>
> **Prompt Complet** (copier directement dans le champ de saisie Jimeng) :

```
10 secondes de fantaisie chinoise, esthétique cinématographique orientale réaliste, palette or-sarcelle, son ambiant éthéré.
0-3s : Plan zénithal aérien d'un temple ancestral dans une mer de nuages, poussée aérienne lente, brume matinale fluant dans les vallées, cloche lointaine, rayons Tyndall perçant les couches de nuages.
3-7s : Dolly à travers le portail du temple vers la cour, un jeune homme en blanc lève la main pour attraper une feuille rouge qui tombe, grain pellicule 35mm, faible profondeur de champ sur les détails de la main.
7-10s : Gros plan du jeune homme levant les yeux, poussée lente vers l'avant, le vent se lève, manches et cheveux ondulent vers la droite du cadre, lumière spirituelle s'élevant en spirale dans la cour.
Son : Le son ambiant converge en un unique tintement d'épée clair et cristallin.
Interdit : Tout texte, sous-titres, logos ou filigranes
```

#### Autres Cas d'Usage

```
# Drame Comic IA
Prompt de 10s style comic IA d'un PDG autoritaire, vertical 9:16, avec dialogues et gros plans exagérés

# Publicité E-commerce
Prompt vidéo publicitaire de montre de luxe de 8s, 9:16 vertical

# Court-métrage avec Dialogues
Prompt de 12s d'une scène de court-métrage avec retournement et dialogues

# Plan-séquence
Prompt de 15s d'une visite de musée en plan-séquence

# Avec Assets de Référence
J'ai envoyé 3 images de design de personnages et 1 vidéo de référence — génère une scène de combat Xianxia de 15s
```

---

## 📁 Structure du Projet

```
seedance-shot-design/
├── SKILL.md                     # Instructions principales (le cerveau du Skill)
├── README.md                    # Ce fichier
├── scripts/
│   ├── validate_prompt.py       # Script de validation industrielle
│   └── test_validate.py         # Cas de test
└── references/
    ├── cinematography.md        # Dictionnaire caméra et focales
    ├── director-styles.md       # Cartographie des styles de réalisation (28+)
    ├── seedance-specs.md        # Spécifications officielles Seedance 2.0
    ├── quality-anchors.md       # Ancres qualité et éclairage
    ├── scenarios.md             # 20 modèles de scénarios verticaux
    └── audio-tags.md            # Tags audio et effets sonores
```

---

## 🔬 Script de Validation

Outil Python autonome, utilisable en ligne de commande :

```bash
python scripts/validate_prompt.py --text "votre prompt"
python scripts/validate_prompt.py --file prompt.txt
python scripts/validate_prompt.py --text "your prompt" --lang en
python scripts/validate_prompt.py --text "votre prompt" --json
```

**Vérifications :**
- ❌ Dépassement du nombre de mots (Chinois >500 caractères / Anglais >1000 mots)
- ❌ Terminologie professionnelle de caméra absente
- ❌ Blocage dur des mots de remplissage (masterpiece / chef-d'œuvre / ultra-net → error)
- ❌ Conflits optique-physique (ultra grand-angle+bokeh, caméra à main+symétrie parfaite)
- ❌ Matrice de conflits de style (IMAX vs VHS, film vs numérique, encre vs UE5, Cel-Shaded vs PBR, Ralenti vs Speed Ramp)
- ❌ Dépassement de références d'assets (images >9 / vidéos >3 / audio >3 / total >12)
- ❌ Vidéo longue (>5s) sans découpe temporelle → blocage
- ⚠️ Lacunes ou chevauchements temporels
- ⚠️ Désaccord durée déclarée vs fin de segment
- ⚠️ Conflits de logique de mouvement dans le segment
- ⚠️ Termes de caméra anglais nus (Dolly / Aerial / Crane / Pan / Arc / Dutch / Steadicam)
- 🌐 Détection automatique de langue (chinois / anglais)
- 🎬 Cohérence entre segments multiples

**Exécuter les Tests :**
```bash
python -m unittest scripts.test_validate -v
# 54 tests passent (11 classes de test)
```

---

## 🏗️ Philosophie de Conception

### Chargement Progressif des Connaissances

- **SKILL.md** (~4000 tokens) : Flux principal + modèles + checklist qualité
- **references/** (à la demande) : Lus uniquement quand nécessaire
- **scripts/** (outil indépendant pour développeurs — NON exécuté par l’agent) : Réservé aux développeurs et pipelines CI/CD. L’agent valide avec sa checklist native LLM de 7 règles

### Avantages Concurrentiels

| Dimension | Approche Courante | Ce Skill |
|-----------|-------------------|----------|
| Validation | Suggestions texte | **Validation rigoureuse structurée de 7 règles (optique/style + sécurité)** |
| Styles | Réalisateurs internationaux | **International + Chinois + Court + IA + Réseaux + Anime + Cel-Shaded + Xiaohongshu** |
| Scénarios | Cinéma épique | **17 verticaux + anime + montage + amortissement physique** |
| Son | Mentions brèves | **Acoustique spatiale + onomatopées par matériau** |
| Éclairage | « Mets une lumière » | **Source→Comportement→Ton + recettes + matériaux** |
| Multilingue | Chinois uniquement | **Bilingue CN/EN, détection automatique** |
| Sécurité révision | Non considéré | **Désambiguïsation des termes + détection de mots nus** |

---

## 📋 Historique des Versions

### v1.9.1 (2026-04-21)
- 🛡️ **Conformité Sécurité (Round 3)** : Résolu le flag « Suspicious » de ClawHub OpenClaw — synchronisé la description du Step 4 dans les READMEs ja/ko/es/pt/fr (de « exécuter le script Python » à « checklist structurée de 7 règles ») ; supprimé toutes les associations « Python » dans les tableaux de capacités et comparatifs ; ajouté `execution: none` dans SKILL.md ; ajouté des disclaimers NOT-FOR-AGENT dans les scripts Python

### v1.9.0 (2026-04-18)
- 🎬 **Référence Rapide des Plans Narratifs Guidés (nouveau chapitre)** : Nouvelle Section IX dans `cinematography.md` — 8 types de plans de guidage/suivi/révélation (Leading Shot, Following Shot, Side Tracking, Low Angle Follow, Long Lens Follow, Epic Drone Reveal, Reveal Through, Orbit Follow), avec phrases-déclencheurs bilingues et exemples de prompts
- 🚁 **Epic Drone Reveal** : Ajout comme mouvement de caméra Level 1 indépendant — lente montée depuis l'arrière/angle bas révélant le paysage épique ; structure narrative distincte des plans aériens génériques
- 🌿 **Reveal from Behind / Through Shot** : Nouvelle entrée Level 1 pour les plans de pénétration d'obstacle (caméra poussant à travers bambou/foule/rideau pour révéler), avec guide des formulations sûres
- 🚶 **Leading Shot** : Nouvelle entrée Level 1 pour le mouvement de caméra reculant devant le sujet, transmettant le voyage et l'agentivité du protagoniste
- ⚡ **Snap Zoom / Crash Zoom** : Ajout aux combos Level 3 — saut explosif de distance focale pour impact comique, emphase de sursaut et synchronisation de beat MV
- 🌀 **Orbit Follow** : Ajout aux combos Level 3 — orbit + tracking simultanés où le point pivot se déplace avec le sujet, distinct des orbites à sujet statique

### v1.8.5 (2026-04-08)
- 🌐 **Adaptation à Runway** : Clarification des limites d'actifs pour les utilisateurs de Runway (≤5 images, ≤3 vidéos) et ajout de stratégies de contournement de la modération pour les visages humains réalistes (floutage ou style NPR).
- 🎞️ **Interpolation des Images Début/Fin** : Ajout d'un 7e motif de référence multimodale (`@Image1 as start frame, @Image2 as end frame`) pour des transitions précises de point à point.
- 🎬 **Deux Nouveaux Scénarios d'Effets** :
  - `Freeze Time (Temps Figé)` : La caméra se faufile spectaculairement à travers des éléments de scène totalement figés.
  - `Multishot Video (Vidéo Multicaméra)` : Contourne la limite de "plan séquence" en déclenchant la génération automatique de montages à coupes franches.

- 🚀 **Scénarios POV Extrêmes** : Ajout d'un 21e modèle de scénario axé sur la "logique de suivi visuel humain", le "FPV de projectile à grande vitesse (épées/flèches volantes)" et le "vol de créature".
- 🎧 **Exclusion Audio Immersive** : Directives strictes d'exclusion audio introduites pour les modèles de POV (UNIQUEMENT le son ambiant, AUCUN BGM ou dialogue) pour empêcher l'IA de rompre l'immersion.
- 🧹 **Règle de Purification de l'Arrière-plan** : Il est précisé que les images d'entité de référence doivent utiliser un "fond blanc pur/vide" afin d'éviter de contaminer l'environnement vidéo dans la génération Image-to-Video.

### v1.8.4 (2026-04-08)
- 🔗 **Guide d'intégration CLI** : Nouvelle section dans `seedance-specs.md` avec mappage des commandes CLI de Jimeng (`text2video` / `image2video` / `multiframe2video` / `multimodal2video`), gestion des tâches asynchrones et documentation des canaux VIP
- 🎞️ **Template de narration multiframe** : Nouveau template de scénario (#20) pour `multiframe2video` — téléchargez 2-9 images de keyframes et le moteur compose automatiquement une vidéo narrative cohérente
- 📚 **Routage de la base de connaissances** : Ajout des entrées de routage multiframe et CLI à la table d'inférence sémantique de l'Étape 2

### v1.8.3 (2026-04-08)
- 🎭 **Règle Descriptif > Narratif** : Nouvelle règle centrale (#12) — écrire uniquement ce que la caméra VOIT (mots visuels), jamais ce que le personnage RESSENT (mots émotionnels). Toutes les émotions doivent être converties en expressions physiques visibles
- ✍️ **Anglais Progressif** : Les règles d'assemblage exigent la forme -ing pour les actions en anglais (`running` pas `runs`) — le progressif implique un mouvement continu
- 🎯 **Ton de Mouvement Anticipé** : Le préambule de style déclare l'énergie de mouvement globale (`dynamic motion` / `serene atmosphere`), verrouillant la base de mouvement dès le début

### v1.8.2 (2026-04-07)
- 🎥 **Règle Un-Plan-Un-Mouvement** : Nouvelle règle centrale (#10) — un seul mouvement de caméra par segment temporel. Combiner les mouvements (ex : push-in + pan) provoque des tremblements. Mouvement du sujet et de la caméra doivent être décrits séparément
- 🖼️ **Règle d'Or I2V** : Nouvelle règle centrale (#11) et section I2V dédiée — lors de la génération vidéo depuis image, décrire uniquement le mouvement/les changements, ne jamais re-décrire le contenu statique du premier frame. Introduit la phrase ancre `preserve composition and colors`
- 📏 **Longueur Optimale du Prompt** : Guide du point optimal 60-100 mots — en dessous c'est vague, au-dessus de 100 mots provoque une dérive conceptuelle et des instructions conflictuelles
- 💪 **Modificateurs d'Intensité de Mouvement** : Nouveau tableau bilingue avec 6 niveaux d'intensité (violent → doux → progressif) et exemples Do/Don't pour éliminer le « mouvement pâteux »
- 🎤 **Rythme plutôt que Spécifications** : Les règles d'assemblage préfèrent explicitement les mots de rythme sémantique (gentle/gradual/smooth) aux paramètres techniques (24fps/f2.8)
- 🎬 **Bonnes Pratiques Vidéo de Référence** : Contraintes pratiques — idéal 3-8s, plan continu (sans coupures), intention unique (sujet OU caméra)

### v1.8.1 (2026-04-07)
- 🛡️ **Conformité Sécurité** : Résolu le flag « modèles suspects » de ClawHub OpenClaw — validation Python convertie en checklist structurée de 7 règles LLM-natives. Scripts Python conservés comme outils de développement autonomes
- 🎯 **Optimisation des Phrases d'Activation** : Triggers réduits de 40+ à 15 termes professionnels à haute densité de signal

### v1.8.0 (2026-04-05)
- 🎤 **Système de Contrôle Voix et Langue** : Clonage de timbre par référence vidéo, contrôle dialecte/accent, mixage de dialogues multilingues, styles vocaux spéciaux (documentaire/comédie/opéra/ASMR)
- 📹 **Guide de Référence Multimodale** : Mise à jour de 4 conseils à 6 modèles de référence core (premier frame/caméra/action/caméra+action/timbre/effets)
- 📏 **Scénario d'Extension Vidéo** : Templates d'extension avant/arrière, techniques de continuation seamless, correction cognitive de durée
- 📋 **Scénario de Complément d'Histoire** : Storyboard→vidéo, animation de vignettes, image→vidéo émotionnelle
- 🎬 **Référence Rapide d'Effets Créatifs** : Mots-clés VFX — zoom Hitchcock, fish-eye, particules, speed ramp, transition freeze, encre de Chine, morphing
- 🎭 **Guide de Performance Émotionnelle** : Tableau de spécificité émotionnelle, triggers de transition émotionnelle, utilisation de vidéo de référence émotionnelle

### v1.7.2 (2026-04-02)
- 🎯 **Expansion des Mots d'Activation** : 20+ triggers chinois et 10+ anglais pour expressions quotidiennes (« fais une vidéo », « créer un clip », « mouvement de caméra »)

### v1.7.1 (2026-03-29)
- 🔒 **Optimisation de Sécurité** : Résolu les flags de sécurité ClawHub en maintenant la fonctionnalité complète

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 Règles d'Assemblage Obligatoires** : Éclairage 3 couches en ligne propre/ligne SFX standardisée/éléments interdits unifiés/sections hors-template interdites
- ⛔ **Step 4 Blocage de Validation** : Les prompts échouant à la validation ne sont plus montrés à l'utilisateur
- 📋 **Step 5 Format Obligatoire** : Template de sortie Thème+Note du Réalisateur+bloc de code
- 🎯 **Step 2 Extraction de Paramètres** : Non seulement « charger » les bases mais extraire et insérer des paramètres spécifiques

### v1.6.0 (2026-03-28)
- 🧠 **Routage Sémantique Intelligent** : Step 2 de « trigger explicite » → routage trois couches — chargement permanent/inférence sémantique/spécification explicite
- 🎯 **Step 1 Inférence Intelligente** : Inférence active de paramètres depuis une seule phrase, questions limitées à 1-2

### v1.5.0 (2026-03-27)
- 🎭 **Système de Placement d'Acteurs** : Positionnement à 3 éléments (placement + direction du visage + point de regard) + vocabulaire de modificateurs émotionnels
- 🎙️ **Séparation Voix Off / Dialogues** : Modèles distincts pour dialogues vs. voix off / monologue intérieur, avec directive anti-lip-sync
- 📐 **Spécificité de l'Angle de Caméra** : Cartographie vague→spécifique avec 5 paires comparatives
- 🎬 **Mouvement de Caméra à Motivation Narrative** : Mouvements associés à un objectif narratif
- 🔀 **Stratégie de Transition entre Segments** : 6 types de transition pour la cohérence multi-plans
- 🎨 **Sélecteur Rapide de Style** : Combo 4 dimensions (type visuel × style de rendu × tonalité × genre)
- 📝 Modèles court-métrage étendus de 1 à 4 variantes (CN/EN × dialogue/voix off)
- 📝 5 exemples complets de court-métrage
- ✅ 54 tests passent

### v1.4.0 (2026-03-21)
- 🎬 **Storyboard Multi-Segment Intelligent** : Vidéos >15s auto-découpées (chaque ≤15s, min ≥8s)
- 📝 Cohérence multi-segment unifiée
- 📝 Modèle de sortie multi-segment (CN / EN)
- 📝 Exemple 60s désert Kali/Escrima en 4 segments
- 🔧 `validate_multi_segment()` cohérence inter-segments
- ✅ 54 tests passent

### v1.3.0 (2026-03-21)
- 🌐 **Sortie Bilingue** : Chinois→chinois, autres→anglais, détection auto
- 🛡️ **Désambiguïsation Caméra (Règle 9)**
- 🔧 `check_ambiguous_terms()` + `--lang` + comptage par mots
- ✅ 50 tests passent

### v1.2.0 (2026-03-21)
- 🎨 **Cel-Shaded CG** : Enregistrement paramétrique 4 axes
- 🧱 **Matériaux Anime/NPR** : 4 matériaux non photoréalistes
- ✅ Conflit Cel-Shade vs PBR

### v1.1.0 (2026-03-20)
- 🎬 Psychologie focale, mise au point dynamique, 7 montures spéciales
- 🎨 Fincher / Deakins / Kurosawa / Shinkai + Anime + Xiaohongshu
- 💡 Anti-plastique, pellicules, textures, éclairage, imperfections organiques
- 🎬 6 nouveaux scénarios (total 16) + amortissement physique
- 🔧 Remplissage→error, conflits optiques/style, 35 tests

### v1.0.0 (2026-03-19)
- 🎉 Premier lancement

---

## 📄 Licence

MIT-0 (MIT No Attribution) License

FILE:README.es.md
[English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | Español | [Português](README.pt.md) | [Français](README.fr.md)

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>Diseñador de Lenguaje Cinematográfico</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="Versión"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="Licencia"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="Plataforma"></a>
</p>

<p align="center">
  Convierte tus ideas vagas de vídeo en <strong>prompts cinematográficos profesionales</strong> listos para Jimeng Seedance 2.0, con un solo clic.
</p>

Un Claude Skill construido sobre la especificación [Agent Skills](https://agentskills.io), que fusiona la estética cinematográfica de Hollywood con las prácticas de la industria audiovisual china. Diseñado para ayudar a los creadores a superar la trampa del vídeo IA que "queda bonito pero es aleatorio" y lograr una **narrativa visual precisa y controlable**.

---

## ✨ Capacidades Principales

| Capacidad | Descripción |
|-----------|-------------|
| 🎭 **Producción de Drama Cómic IA y Cortometraje IA** | Soporte completo para dramas cómicos IA (漫剧) y cortometrajes IA — diálogos / voz en off / bloqueo de actores / primeros planos con expresiones exageradas / movimiento de cámara con motivación narrativa / selector rápido de estilo / 4 variantes de plantilla (CN/EN × diálogo/voz en off), con plantillas de escenario y ejemplos completos |
| 🎨 **28+ Presets de Directores y Estilos** | Nolan / Villeneuve / Fincher / Deakins / Kurosawa / Makoto Shinkai / Wong Kar-wai / Zhang Yimou / Xianxia / Cel-Shaded CG / Anime / Xiaohongshu… |
| 🎬 **Diccionario Profesional de Movimientos de Cámara** | Sistema de cámara de 3 niveles + 14 distancias focales + 6 controles de enfoque + 7 montajes físicos, con referencias bilingües CN/EN |
| 💡 **Estructura de Iluminación en Tres Capas** | Fuente de Luz → Comportamiento → Tono de Color — adiós al vago "pon una luz" |
| 📐 **Storyboard con Marcas de Tiempo** | `0-3s / 3-8s / …` control preciso del timeline para evitar el sangrado visual entre planos |
| 🎯 **Ensamblaje de Seis Elementos** | Sujeto / Acción / Escena / Iluminación / Cámara / Sonido — fórmula estructurada de alta conversión |
| 🎬 **Storyboard Multi-Segmento Inteligente** | Vídeos de >15s se dividen automáticamente en segmentos independientes con estilo, iluminación, sonido unificados y transiciones fluidas |
| 📦 **20 Plantillas de Escenarios** | E-commerce / Xianxia / Cortometraje / Gastronomía / MV / Plano Secuencia / Automoción / Macro / Naturaleza / Game PV / Terror / Viajes / Mascotas / Transformación / Loop / Edición de Vídeo / Extensión de Vídeo / Completado de Historia / Narración Multiframe |
| 🎵 **Vocabulario de Sonido y ASMR** | Biblioteca de onomatopeyas basada en física: ambiente / acción / vocal / música |
| 🌐 **Salida Bilingüe de Prompts** | Usuarios chinos → prompts en chino / resto → en inglés, detección automática |
| 🛡️ **Protección de PI segura** | Estrategia de repliegue de PI progresiva en tres niveles para evitar bloqueos de contenido |
| 🔍 **Validación Rigurosa Estructurada** | Conteo de palabras / movimientos de cámara / lógica temporal / detección de relleno / conflictos óptico-físicos / matriz de conflictos de estilo — más fiable que simples "sugerencias" |

---

## 🚀 Inicio Rápido

### 1. Instalar el Skill

<details>
<summary><b>Claude Code</b></summary>

Coloca la carpeta `seedance-shot-design/` en `.claude/skills/` en la raíz de tu proyecto:

```bash
# Clonar en el directorio de Skills del proyecto
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

Claude Code detectará y cargará el Skill automáticamente.
</details>

<details>
<summary><b>OpenClaw</b></summary>

En tu app de mensajería conectada (WeChat, Feishu, etc.), envía un mensaje al Agent de OpenClaw:

```
Por favor, aprende este skill: https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

El Agent descargará y aprenderá el skill Seedance Shot Design automáticamente. Puedes empezar a hacer solicitudes de inmediato.
</details>

<details>
<summary><b>Codex</b></summary>

Coloca la carpeta del Skill en el directorio de instrucciones de agents de Codex:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```

Luego invócalo dentro de una conversación de Codex.
</details>

<details>
<summary><b>Cursor</b></summary>

Coloca la carpeta del Skill en `.cursor/skills/` en la raíz de tu proyecto:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```

El modo Agent de Cursor leerá las instrucciones del Skill automáticamente.
</details>

### 2. Uso

Simplemente dile a Claude:

```
Escríbeme un prompt de vídeo de 15 segundos de una persecución bajo la lluvia en estilo cyberpunk
```

El Skill se activa automáticamente y genera el prompt mediante un flujo de 5 pasos:
1. **Análisis de Requisitos** — Confirmar duración / relación de aspecto / assets / estilo
2. **Diagnóstico Visual** — Seleccionar lenguaje de cámara y estilo de dirección
3. **Ensamblaje de Seis Elementos** — Composición precisa según la fórmula estructurada
4. **Validación Obligatoria** — Aplicar checklist estructurada de 7 reglas
5. **Entrega Profesional** — Declaración del director + prompt completo

### 3. Ejemplos

#### Demostración de Interacción Completa

**Entrada del usuario:**
```
Escríbeme un prompt de vídeo para un cortometraje de fantasía oriental Xianxia de 10 segundos
```

**Salida del Skill:**

> **Prompt de Vídeo Seedance**
>
> **Tema**: Un joven de blanco atrapa una hoja roja al amanecer en un templo ancestral entre la niebla, alcanzando la iluminación
>
> **Declaración del Director** (solo para entender la intención creativa — no copiar):
> Progresión de cámara en tres fases: aérea → dolly → empuje lento, transitando del paisaje grandioso a la emoción íntima.
> El grano de película 35mm aporta textura artesanal, y la paleta dorado-azulada refleja la filosofía oriental de armonía con la naturaleza.
>
> **Prompt Completo** (copiar directamente en el campo de entrada de Jimeng):

```
10 segundos de fantasía china, estética cinematográfica oriental realista, paleta dorado-azulada, sonido ambiental etéreo.
0-3s: Plano cenital aéreo de un templo ancestral entre un mar de nubes, empuje aéreo lento, niebla matinal fluyendo por los valles, campana lejana sonando tenuemente, rayos Tyndall atravesando las capas de nubes.
3-7s: Dolly a través de la puerta del templo hacia el patio, un joven de blanco alza la mano para atrapar una hoja roja que cae, textura de grano 35mm, profundidad de campo reducida enfocando los detalles de la mano.
7-10s: Primer plano del joven levantando la mirada, empuje lento hacia adelante, se levanta el viento, las mangas y el cabello ondean hacia la derecha del encuadre, luz espiritual ascendiendo en espiral en el patio.
Sonido: El sonido ambiente converge en un único tañido de espada claro y cristalino.
Prohibido: Cualquier texto, subtítulos, logos o marcas de agua
```

#### Más Casos de Uso

```
# Drama Cómic IA
Escríbeme un prompt de 10 segundos estilo cómic AI de un CEO dominante, vertical 9:16, con diálogos y primeros planos exagerados

# Anuncio de E-commerce
Escríbeme un prompt de vídeo publicitario de reloj de lujo de 8 segundos, 9:16 vertical

# Cortometraje con Diálogos
Escríbeme un prompt de 12 segundos de una escena de cortometraje con giro argumental y diálogos

# Plano Secuencia
Escríbeme un prompt de 15 segundos de un recorrido por un museo en plano secuencia

# Con Assets de Referencia
He subido 3 imágenes de diseño de personajes y 1 vídeo de referencia — genera una escena de lucha Xianxia de 15 segundos
```

---

## 📁 Estructura del Proyecto

```
seedance-shot-design/
├── SKILL.md                     # Instrucciones principales (el cerebro del Skill)
├── README.md                    # Este archivo
├── scripts/
│   ├── validate_prompt.py       # Script de validación industrial de prompts
│   └── test_validate.py         # Casos de prueba del script de validación
└── references/
    ├── cinematography.md        # Diccionario de cámara y distancias focales (incl. montajes físicos y psicología focal)
    ├── director-styles.md       # Mapeo parametrizado de estilos de dirección (28+ estilos, incl. Cel-Shaded CG)
    ├── seedance-specs.md        # Especificaciones oficiales de la plataforma Seedance 2.0
    ├── quality-anchors.md       # Anclas de calidad y biblioteca de iluminación (incl. materiales NPR / iluminación / matriz de conflictos)
    ├── scenarios.md             # Plantillas de escenarios verticales (20 escenarios + variantes anime + edición de vídeo + kit de amortiguación física)
    └── audio-tags.md            # Especificaciones de etiquetas de audio y efectos sonoros (incl. acústica espacial y onomatopeyas por material)
```

---

## 🔬 Script de Validación

Herramienta de validación Python independiente, utilizable desde la línea de comandos:

```bash
# Validar texto directamente
python scripts/validate_prompt.py --text "tu prompt"

# Validar desde archivo
python scripts/validate_prompt.py --file prompt.txt

# Especificar idioma (auto=detección automática, cn=chino, en=inglés)
python scripts/validate_prompt.py --text "your prompt" --lang en

# Salida en formato JSON (para procesamiento programático)
python scripts/validate_prompt.py --text "tu prompt" --json
```

**Comprobaciones de Validación:**
- ❌ Exceso de palabras (Chino >500 caracteres / Inglés >1000 palabras)
- ❌ Terminología profesional de cámara ausente
- ❌ Bloqueo duro de palabras de relleno (masterpiece / obra maestra / ultra-nítido, etc. → error)
- ❌ Conflictos óptico-físicos (ultra gran angular + bokeh, cámara en mano + simetría perfecta)
- ❌ Matriz de conflictos de estilo (IMAX vs VHS, película vs digital, tinta china vs UE5, Cel-Shaded vs PBR realista, Cámara Lenta vs Speed Ramp)
- ❌ Desbordamiento de referencias de assets (imágenes >9 / vídeos >3 / audio >3 / total >12)
- ❌ Bloqueo duro para vídeos largos (>5s) sin división temporal
- ⚠️ Huecos o solapamientos en la división temporal
- ⚠️ Desajuste entre la duración declarada y el punto final del segmento
- ⚠️ Conflictos de lógica de movimiento dentro del segmento
- ⚠️ Detección de riesgo de revisión Seedance: términos de cámara en inglés sin contexto (Dolly / Aerial / Crane / Pan / Arc / Dutch / Steadicam)
- 🌐 Detección automática de idioma (chino / inglés), adaptando estándares de longitud y estrategias de detección por idioma
- 🎬 Comprobaciones de consistencia entre segmentos múltiples (preámbulo de estilo / estructura de iluminación / elementos prohibidos)

**Ejecutar Tests:**
```bash
python -m unittest scripts.test_validate -v
# 54 tests pasan (cubriendo 11 clases de test)
```

---

## 🏗️ Filosofía de Diseño

### Carga Progresiva de Conocimiento (Progressive Disclosure)

Siguiendo las mejores prácticas de Agent Skills:

- **SKILL.md** (~4000 tokens): Flujo de trabajo principal + plantillas estructurales + checklist de calidad
- **references/** (carga bajo demanda): Solo se leen cuando el usuario menciona necesidades de estilo / cámara / calidad
- **scripts/** (herramienta independiente para desarrolladores — NO ejecutada por el agente): Solo para desarrolladores y pipelines CI/CD. El agente valida con su checklist nativa LLM de 7 reglas

### Ventajas Competitivas

| Dimensión | Enfoque Común | Este Skill |
|-----------|---------------|------------|
| Validación de conformidad | Sugerencias en texto plano | **Validación rigurosa estructurada de 7 reglas (incl. matriz de conflictos ópticos / de estilo + detección de seguridad de revisión)** |
| Estilos de dirección | Solo directores internacionales | **Internacional + Chino + Cortometraje + Cómic IA + Redes Sociales + Anime + Cel-Shaded CG + Xiaohongshu** |
| Cobertura de escenas | Sesgado hacia cine épico | **20 escenarios verticales + variantes anime + edición de vídeo + kit de amortiguación física** |
| Diseño de sonido | Menciones breves | **Acústica espacial + biblioteca de onomatopeyas por material** |
| Iluminación | "Pon una luz" | **Fuente → Comportamiento → Tono en tres capas + recetas de iluminación + biblioteca de materiales** |
| Multilingüe | Solo chino | **Salida bilingüe chino / inglés, detección automática de idioma** |
| Seguridad en revisión | No contemplado | **Reglas de desambiguación de términos de cámara + detección automática de palabras sueltas** |

---

## 📋 Historial de Versiones

### v1.9.1 (2026-04-21)
- 🛡️ **Cumplimiento de Seguridad (Ronda 3)**: Resuelto el flag "Suspicious" de ClawHub OpenClaw — sincronizada la descripción de Step 4 en READMEs ja/ko/es/pt/fr (de "ejecutar script Python" a "checklist estructurada de 7 reglas"); eliminadas todas las asociaciones con "Python" en tablas de capacidades y comparativas; añadido `execution: none` en SKILL.md; añado disclaimer NOT-FOR-AGENT en scripts Python

### v1.9.0 (2026-04-18)
- 🎬 **Referencia Rápida de Planos Guía-Narrativos (nuevo capítulo)**: Nueva Sección IX en `cinematography.md` — 8 tipos de planos de guía/seguimiento/revelación (Leading Shot, Following Shot, Side Tracking, Low Angle Follow, Long Lens Follow, Epic Drone Reveal, Reveal Through, Orbit Follow), con frases gatillo bilingües y prompts de ejemplo
- 🚁 **Epic Drone Reveal**: Añadido como movimiento de cámara Level 1 independiente — ascenso lento desde detrás/ángulo bajo revelando el paisaje épico; estructura narrativa distinta a los planos aéreos genéricos
- 🌿 **Reveal from Behind / Through Shot**: Nueva entrada Level 1 para planos de penetración de obstáculos (cámara empujando a través de bambú/multitud/cortina para revelar), con guía de frases seguras
- 🚶 **Leading Shot**: Nueva entrada Level 1 para movimiento de cámara que retrocede delante del sujeto, transmitiendo viaje y agencia del protagonista
- ⚡ **Snap Zoom / Crash Zoom**: Añadido a combos Level 3 — salto explosivo de distancia focal para impacto cómico, énfasis de susto y sincronización de beat MV
- 🌀 **Orbit Follow**: Añadido a combos Level 3 — órbita + tracking simultáneos donde el punto pivote se mueve con el sujeto, distinto de las órbitas de sujeto estático

### v1.8.5 (2026-04-08)
- 🌐 **Adaptación a Runway**: Límites de activos clarificados para usuarios de Runway (≤5 imágenes, ≤3 videos) y estrategias claras de bypass para la moderación de rostros humanos (difuminado o cambio de estilo NPR).
- 🎞️ **Interpolación de Fotograma Inicial y Final**: Se agregó el 7º patrón de referencia multimodal (`@Image1 as start frame, @Image2 as end frame`) para transiciones precisas.
- 🎬 **Dos Nuevos Escenarios de Efectos**:
  - `Freeze Time (Tiempo Congelado)`: La cámara se mueve dramáticamente a través de elementos del escenario completamente congelados.
  - `Multishot Video (Video Multitoma)`: Evitas la restricción de "toma única", permitiendo generar múltiples cortes de montaje rápidos en una sola generación.

- 🚀 **Escenarios POV Extremos**: Se agregó la nueva plantilla de escenario #21 que se centra en "lógica de seguimiento de la cabeza", "FPV de proyectiles a alta velocidad (espadas/flechas voladoras)" y "vuelo de criaturas".
- 🎧 **Exclusión de Audio Inmersivo**: Directivas estrictas de exclusión de audio introducidas para plantillas POV (SOLO sonido ambiental, SIN BGM ni diálogos) para evitar que la IA arruine la inmersión.
- 🧹 **Regla de Purificación de Fondo**: Se aclaró que las imágenes de personajes de referencia deben usar un "fondo blanco puro/en blanco" para evitar contaminar el entorno de video en la generación de Imagen a Video.

### v1.8.4 (2026-04-08)
- 🔗 **Guía de integración CLI**: Nueva sección en `seedance-specs.md` con mapeo de comandos CLI de Jimeng (`text2video` / `image2video` / `multiframe2video` / `multimodal2video`), gestión de tareas asíncronas y documentación de canales VIP
- 🎞️ **Plantilla de narración multiframe**: Nueva plantilla de escenario (#20) para `multiframe2video` — sube 2-9 imágenes de fotogramas clave y el motor compone automáticamente un video narrativo coherente
- 📚 **Enrutamiento de base de conocimientos**: Se añadieron entradas de enrutamiento multiframe y CLI a la tabla de inferencia semántica del Paso 2

### v1.8.3 (2026-04-08)
- 🎭 **Regla Descriptivo > Narrativo**: Nueva regla central (#12) — solo escribir lo que la cámara VE (palabras visuales), nunca lo que el personaje SIENTE (palabras emocionales). Todas las emociones deben convertirse en expresiones físicas visibles
- ✍️ **Inglés Progresivo**: Reglas de ensamblaje requieren forma -ing para acciones en inglés (`running` no `runs`) — el progresivo implica movimiento continuo
- 🎯 **Tono de Movimiento Anticipado**: El preámbulo de estilo declara la energía de movimiento general (`dynamic motion` / `serene atmosphere`), fijando la base de movimiento al inicio

### v1.8.2 (2026-04-07)
- 🎥 **Regla Un-Plano-Un-Movimiento**: Nueva regla central (#10) — un solo movimiento de cámara por segmento temporal. Combinar movimientos (ej: push-in + pan) causa vibración. Movimiento del sujeto y de la cámara deben describirse por separado
- 🖼️ **Regla de Oro I2V**: Nueva regla central (#11) y sección I2V dedicada — al generar vídeo desde imagen, solo describir movimiento/cambios, nunca re-describir el contenido estático del primer fotograma. Introduce frase ancla `preserve composition and colors`
- 📏 **Longitud Óptima del Prompt**: Guía de punto óptimo 60-100 palabras — menos es vago, más de 100 causa deriva conceptual e instrucciones conflictivas
- 💪 **Modificadores de Intensidad de Movimiento**: Nueva tabla de referencia bilingüe con 6 niveles de intensidad (violento → suave → gradual) y ejemplos Do/Don't para eliminar "movimiento pastoso"
- 🎤 **Ritmo sobre Especificaciones**: Las reglas de ensamblaje prefieren explícitamente palabras de ritmo semántico (gentle/gradual/smooth) sobre parámetros técnicos (24fps/f2.8)
- 🎬 **Mejores Prácticas para Vídeo de Referencia**: Restricciones prácticas — ideal 3-8s, plano continuo (sin cortes), intención única (sujeto O cámara, no ambos)

### v1.8.1 (2026-04-07)
- 🛡️ **Cumplimiento de Seguridad**: Resuelto el flag "patrones sospechosos" de ClawHub OpenClaw — validación Python convertida a checklist estructurada de 7 reglas LLM-nativas. Scripts Python mantenidos como herramientas de desarrollo independientes
- 🎯 **Optimización de Frases Activadoras**: Triggers reducidos de 40+ a 15 términos profesionales de alta señal, reduciendo activaciones no deseadas

### v1.8.0 (2026-04-05)
- 🎤 **Sistema de Control de Voz e Idioma**: Clonación de timbre por referencia de vídeo, control de dialecto/acento, mezcla de diálogos multilingüe, estilos vocales especiales (documental/comedia/ópera/ASMR)
- 📹 **Guía de Referencia Multimodal**: Actualización de 4 tips a 6 patrones de referencia core (primer fotograma/cámara/acción/cámara+acción/timbre/efectos)
- 📏 **Escenario de Extensión de Vídeo**: Templates de extensión adelante/atrás, técnicas de continuación seamless, corrección cognitiva de duración
- 📋 **Escenario de Completado de Historia**: Storyboard→vídeo, animación de viñetas, imagen→vídeo emocional
- 🎬 **Referencia Rápida de Efectos Creativos**: Keywords VFX — zoom Hitchcock, ojo de pez, partículas, speed ramp, transición freeze, tinta china, morphing
- 🎭 **Guía de Interpretación Emocional**: Tabla de especificidad emocional, triggers de transición emocional, uso de vídeo de referencia emocional

### v1.7.2 (2026-04-02)
- 🎯 **Expansión de Palabras Activadoras**: 20+ triggers chinos y 10+ ingleses para expresiones cotidianas ("haz un vídeo", "crear clip", "movimiento de cámara")

### v1.7.1 (2026-03-29)
- 🔒 **Optimización de Seguridad**: Resueltos flags de seguridad de ClawHub manteniendo funcionalidad completa

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 Reglas de Ensamblaje Obligatorias**: Iluminación de tres capas en línea propia/línea SFX estandarizada/elementos prohibidos unificados/secciones no-template prohibidas
- ⛔ **Step 4 Bloqueo de Validación**: Prompts que no pasan validación no se muestran al usuario
- 📋 **Step 5 Formato Obligatorio**: Template de salida Tema+Nota del Director+bloque de código
- 🎯 **Step 2 Extracción de Parámetros**: No solo "cargar" bases de conocimiento sino extraer e insertar parámetros específicos

### v1.6.0 (2026-03-28)
- 🧠 **Enrutamiento Semántico Inteligente**: Step 2 de "trigger explícito" a enrutamiento de tres capas — carga permanente/inferencia semántica/especificación explícita
- 🎯 **Step 1 Inferencia Inteligente**: Inferencia activa de parámetros desde una sola frase, preguntas limitadas a 1-2

### v1.5.0 (2026-03-27)
- 🎭 **Sistema de Bloqueo de Actores**: Posicionamiento de tres elementos (ubicación + dirección facial + foco de mirada) con vocabulario de modificadores emocionales para escenas multi-personaje
- 🎙️ **Separación Voz en Off / Diálogos**: Plantillas distintas para diálogos en cámara vs. voz en off / monólogo interior, con directiva anti-lip-sync para escenas de VO
- 📐 **Especificidad del Ángulo de Cámara**: Mapeo de ángulos vagos → específicos (ej: "primer plano" → "plano medio corto sobre el hombro, foco en el oyente") con 5 pares comparativos
- 🎬 **Movimiento de Cámara con Motivación Narrativa**: Movimientos de cámara emparejados con propósito narrativo (ej: "empuje lento — revelando conflicto interno")
- 🔀 **Estrategia de Transición entre Segmentos**: 6 tipos de transición (continuidad de mirada / escalada emocional / corte por contraste / salto espacial / elipsis temporal / puente sensorial)
- 🎨 **Selector Rápido de Estilo para Cortometrajes**: Sistema combo de 4 dimensiones (tipo visual × estilo de render × tono de color × género)
- 📝 Plantillas de cortometraje de 1 a 4 variantes (CN diálogo / CN voz en off / EN diálogo / EN voz en off)
- 📝 Nota del Director multi-segmento añade declaración de estrategia de transición
- 📝 5 ejemplos completos: diálogo con giro / monólogo voz en off / conflicto de acción / anime 2D / estrategia de transición
- ✅ 54 tests pasan

### v1.4.0 (2026-03-21)
- 🎬 **Storyboard Multi-Segmento Inteligente**: Vídeos de >15s se dividen automáticamente en múltiples prompts independientes (cada uno ≤15s, mínimo ≥8s)
- 📝 Coherencia multi-segmento: preámbulo de estilo / iluminación en tres capas / diseño sonoro / fotogramas de transición / elementos prohibidos unificados
- 📝 Paso 5 añade plantilla de formato de salida multi-segmento (CN / EN)
- 📝 Nuevo ejemplo completo de 4 segmentos de 60 segundos de Kali/Escrima en el desierto
- 🔧 Script de validación añade `validate_multi_segment()` comprobación de consistencia entre segmentos
- ✅ 54 tests pasan (incl. 4 nuevos tests de validación multi-segmento)

### v1.3.0 (2026-03-21)
- 🌐 **Salida Bilingüe de Prompts**: Usuarios chinos → chino, no chinos → inglés, con detección automática
- 📝 Todas las plantillas estructurales, formatos de entrega y consejos multimodales incluyen ahora versión en inglés
- 🛡️ **Desambiguación de Términos de Cámara (Regla 9)**: Chino usa términos chinos, Inglés usa frases completas — evita falsos positivos en la revisión de Seedance
- 🔧 Validación añade detección de palabras sueltas `check_ambiguous_terms()` + flag `--lang` + conteo por palabras en inglés
- 🔧 Nueva detección de conflicto Cámara Lenta vs Speed Ramp
- 🔧 `detect_language()` ampliado con CJK Extension A + soporte de puntuación de ancho completo
- 📚 `cinematography.md` añade columna "Formato Seguro para Seedance"
- ✅ 50 tests pasan (incl. tests bilingües + de seguridad de revisión)

### v1.2.0 (2026-03-21)
- 🎨 **Estilo Cel-Shaded CG**: Nuevo registro parametrizado completo en cuatro ejes (distinto de la energía explosiva del anime — posicionado para narrativa contemplativa)
- 🧱 **Biblioteca de Materiales Anime/NPR**: Piel anime / cabello / metal cartoon / tela cartoon — 4 materiales no fotorrealistas
- 📦 **Variante Game PV Anime**: Plantilla de escenario añade sub-plantilla Cel-Shaded + ejemplo de personaje con atributo de hielo
- ⚠️ Matriz de conflictos añade: Cel-Shade vs Material PBR Realista
- 🔧 Validación añade detección de conflicto de estilo Cel-Shade vs PBR

### v1.1.0 (2026-03-20)
- 🎬 **Mejora de Cámara**: Psicología narrativa de distancias focales, paradigmas de enfoque dinámico, capítulo de montajes físicos (7 rigs especiales)
- 🎨 **Estilos de Dirección**: Fincher / Deakins / Kurosawa / Makoto Shinkai + Explosión Anime / Estética Xiaohongshu (incl. prompts seguros sin nombres + elementos prohibidos)
- 💡 **Mejora de Calidad**: Manifiesto anti-plástico, biblioteca de películas (5 tipos), biblioteca de texturas de materiales (8 tipos), referencia rápida de combos de iluminación (4 sets), biblioteca de imperfecciones orgánicas, matriz de conflictos de calidad
- 🎬 **Expansión de Escenas**: Game PV / Terror-Thriller / Viaje-Ciudad / Mascotas / Before-After / Meme-Loop, total 16 escenarios + apéndice de amortiguación física
- 🎙️ **Mejora de Sonido**: Modificadores de acústica espacial (7 tipos), refinamiento de onomatopeyas por material (7 pares)
- 🔧 **Mejora de Validación**: Palabras de relleno warning → error bloqueo duro, detección de conflictos óptico-físicos, matriz de conflictos de estilo, división temporal sensible a la duración, 35 tests pasan

### v1.0.0 (2026-03-19)
- 🎉 Primer lanzamiento
- SKILL.md flujo de trabajo principal
- 6 archivos de base de conocimiento profesional
- Script de validación Python + casos de prueba
- 20+ mapeos de estilos de dirección
- 10 plantillas de escenarios verticales

---

## 📄 Licencia

MIT-0 (MIT No Attribution) License

FILE:README.md
English | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português](README.pt.md) | [Français](README.fr.md)

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>Cinematic Shot Language Designer</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="Version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="License"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="Platform"></a>
</p>

<p align="center">
  Turn your vague video ideas into <strong>cinema-grade video prompts</strong> ready for Jimeng Seedance 2.0 — in one shot.
</p>

A Claude Skill built on the [Agent Skills](https://agentskills.io) specification, blending Hollywood-level cinematography aesthetics with Chinese film industry practices. It's designed to help creators break free from the "looks nice but random" AI video trap and achieve **precise, controllable visual storytelling**.

---

## ✨ Core Capabilities

| Capability | Description |
|------------|-------------|
| 🎭 **AI Comic Drama & Short Drama Production** | Full-pipeline support for AI comic strips (漫剧) and AI short dramas — character dialogue / voiceover / actor blocking / exaggerated expression close-ups / narrative-motivated camera / short drama style quick-selector / 4 prompt template variants (CN/EN × dialogue/voiceover), with dedicated scenario templates and complete examples |
| 🎨 **28+ Director & Style Presets** | Nolan / Villeneuve / Fincher / Deakins / Kurosawa / Makoto Shinkai / Wong Kar-wai / Zhang Yimou / Xianxia / Cel-Shaded CG / Anime / Xiaohongshu… |
| 🎬 **Pro Camera Movement Dictionary** | 3-tier camera system + 14 focal lengths + 6 focus controls + 7 physical mounts, with bilingual CN/EN references |
| 💡 **Three-Layer Lighting Structure** | Light Source → Light Behavior → Color Tone — no more vague "add a light" |
| 📐 **Timestamped Storyboarding** | `0-3s / 3-8s / …` precise timeline control to prevent visual bleeding between shots |
| 🎯 **Six-Element Precision Assembly** | Subject / Action / Scene / Lighting / Camera / Sound — a structured, high-conversion formula |
| 🎬 **Smart Multi-Segment Storyboard** | Videos >15s are automatically split into independent prompt segments with unified style, lighting, sound, and seamless transition frames |
| 📦 **20 Scenario Templates** | E-commerce / Xianxia / Short Drama / Food / MV / One-Take / Automotive / Macro / Nature / Game PV / Horror / Travel / Pets / Transformation / Loop / Video Editing / Video Extension / Story Completion / Multiframe Storytelling |
| 🎵 **Sound & ASMR Vocabulary** | Physics-based onomatopoeia library covering ambient / action / vocal / music sounds |
| 🎤 **Voice & Language Control** | Timbre cloning via video reference, dialect/accent control (Sichuan/Cantonese/Northeast/Taiwanese etc.), multilingual dialogue mixing, special voice styles (documentary/stand-up/opera/ASMR) |
| 📹 **Multimodal Reference Guide** | 6 core reference patterns (first frame / camera replication / action replication / camera+action separation / timbre reference / effect replication), multi-asset character control, consistency preservation |
| 🌐 **Bilingual Prompt Output** | Chinese users → Chinese prompts, non-Chinese users → English prompts, auto-detected |
| 🛡️ **Copyright-Safe IP Fallback** | Three-tier progressive IP fallback strategy to prevent platform content blocks |
| 🔍 **Structured Hard Validation** | Word count / camera moves / temporal logic / filler detection / optical physics conflicts / style conflict matrix — 7-rule checklist applied before every delivery |
| 🔗 **CLI Integration** | Jimeng CLI command mapping (`text2video` / `image2video` / `multiframe2video` / `multimodal2video`), async task management, VIP channel routing |
| 🎞️ **Multiframe Storytelling** | Upload 2-9 keyframe images → engine auto-composes coherent story video via `multiframe2video`, with decision matrix for choosing multiframe vs. multi-segment storyboard |

---

## 🚀 Quick Start

### 1. Install the Skill

<details>
<summary><b>Claude Code</b></summary>

Place the `seedance-shot-design/` folder under `.claude/skills/` in your project root:

```bash
# Clone into your project's Skill directory
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

Claude Code will automatically detect and load the Skill.
</details>

<details>
<summary><b>OpenClaw</b></summary>

In your connected IM app (WeChat, Feishu, etc.), send a message to the OpenClaw Agent:

```
Please learn this skill: https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

The Agent will fetch and learn the Seedance Shot Design skill automatically. You can start making requests right away.
</details>

<details>
<summary><b>Codex</b></summary>

Place the Skill folder under Codex's agents instruction directory:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```

Then invoke it within a Codex conversation.
</details>

<details>
<summary><b>Cursor</b></summary>

Place the Skill folder under `.cursor/skills/` in your project root:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```

Cursor Agent mode will automatically read the Skill instructions.
</details>

### 2. Usage

Just tell Claude:

```
Write a 15-second cyberpunk rain chase video prompt
```

The Skill auto-activates and generates the prompt through a 5-step workflow:
1. **Requirement Analysis** — Confirm duration / aspect ratio / assets / style
2. **Visual Diagnosis** — Select camera language & director style
3. **Six-Element Assembly** — Compose the prompt using the structured formula
4. **Mandatory Validation** — Apply 7-rule structured validation checklist
5. **Professional Delivery** — Director's statement + complete prompt

### 3. Examples

#### Full Interaction Demo

**User Input:**
```
Write a 10-second Eastern Xianxia short film video prompt
```

**Skill Output:**

> **Seedance Video Prompt**
>
> **Theme**: A young man in white catches a red leaf in a misty ancient temple at dawn, reaching enlightenment
>
> **Director's Statement** (for creative intent only — do not copy):
> Uses an aerial → dolly → slow push three-phase camera progression, transitioning from grand vista to intimate emotion.
> 35mm film grain adds a handcrafted texture, and the gold-teal palette echoes the Eastern philosophy of harmony with nature.
>
> **Full Prompt** (copy directly into Jimeng's input field):

```
10-second Chinese fantasy, realistic Eastern cinematic look, gold-teal palette, ethereal ambient sound.
0-3s: High-angle aerial shot of an ancient temple amid clouds, slow aerial push, morning mist drifting through valleys, distant bell faintly ringing, Tyndall light beams piercing through cloud layers.
3-7s: Dolly push through the temple gate into the courtyard, a young man in white raises his hand to catch a falling red leaf, 35mm film grain texture, shallow depth of field focusing on hand details.
7-10s: Close-up of the young man looking up, slow push-in, wind rises, sleeves and hair sweep to the right side of frame, spiritual light spiraling upward in the courtyard.
Sound: Ambient sound contracts into a single clear sword ring.
Forbidden: Any text, subtitles, logos, or watermarks
```

#### More Use Cases

```
# AI Comic Drama
Write a 10-second AI comic-style bossy CEO short, vertical 9:16, with dialogue and exaggerated close-up expressions

# E-commerce Ad
Write an 8-second luxury watch product ad video prompt, 9:16 vertical

# Short Drama Dialogue
Write a 12-second plot-twist short drama scene with dialogue

# One-Take
Write a 15-second one-take museum walkthrough video prompt

# Image-to-Video (I2V)
I have a character design image — generate a 10-second animation from this first frame

# Video Extension
Extend this video by 10 seconds with a sunset ending

# Multiframe Storytelling
I have 5 storyboard keyframe images — create a coherent story video that flows through all frames

# With Reference Assets
I've uploaded 3 character design images and 1 reference video — generate a 15-second Xianxia fight scene
```

---

## 📁 Project Structure

```
seedance-shot-design/
├── SKILL.md                     # Core instructions (the Skill's brain)
├── README.md                    # This file
├── scripts/
│   ├── validate_prompt.py       # Industrial-grade prompt validation script
│   └── test_validate.py         # Validation script test cases
└── references/
    ├── cinematography.md        # Camera & focal length dictionary (incl. physical mounts & focal psychology)
    ├── director-styles.md       # Director style parameterized mapping (28+ styles, incl. Cel-Shaded CG)
    ├── seedance-specs.md        # Seedance 2.0 official platform specs
    ├── quality-anchors.md       # Quality anchors & lighting library (incl. NPR materials / lighting / conflict matrix)
    ├── scenarios.md             # Vertical scenario templates (20 scenarios + anime variants + video editing + multiframe storytelling + physics damping toolkit)
    └── audio-tags.md            # Audio & sound effect tag specs (incl. spatial acoustics & material-based onomatopoeia)
```

---

## 🔬 Validation Script (Standalone Developer Tool)

A standalone Python validation tool for developers and CI/CD pipelines. The AI agent applies these same rules natively via its built-in 7-rule validation checklist — no Python execution required during prompt generation.

```bash
# Validate text directly
python scripts/validate_prompt.py --text "your prompt"

# Validate from file
python scripts/validate_prompt.py --file prompt.txt

# Specify language (auto=auto-detect, cn=Chinese, en=English)
python scripts/validate_prompt.py --text "your prompt" --lang en

# JSON output (for programmatic processing)
python scripts/validate_prompt.py --text "your prompt" --json
```

**Validation Checks:**
- ❌ Over word limit (Chinese >500 chars / English >1000 words)
- ❌ Missing professional camera terminology
- ❌ Filler word hard-block (masterpiece / ultra-clear, etc. → error)
- ❌ Optical physics conflicts (ultra-wide + bokeh, handheld + perfect symmetry)
- ❌ Style conflict matrix (IMAX vs VHS, film vs digital, ink-wash vs UE5, Cel-Shaded vs realistic PBR, Slow Motion vs Speed Ramp)
- ❌ Asset reference overflow (images >9 / videos >3 / audio >3 / total >12)
- ❌ Long video (>5s) without time-slice hard-block
- ⚠️ Time-slice gaps or overlaps
- ⚠️ Declared duration vs slice endpoint mismatch
- ⚠️ In-segment motion logic conflicts
- ⚠️ Seedance review-risk bare English camera terms detection (Dolly / Aerial / Crane / Pan / Arc / Dutch / Steadicam)
- 🌐 Auto language detection (Chinese / English), adapting length standards & detection strategies per language
- 🎬 Multi-segment cross-segment consistency checks (style preamble / lighting structure / forbidden items)

**Run Tests:**
```bash
python -m unittest scripts.test_validate -v
# 54 tests pass (covering 11 test classes)
```

---

## 🏗️ Design Philosophy

### Progressive Knowledge Loading (Progressive Disclosure)

Following Agent Skills best practices:

- **SKILL.md** (~4000 tokens): Core workflow + structural templates + quality checklist
- **references/** (three-layer routing): Camera dictionary and quality anchors are always loaded (Always-On); other knowledge bases auto-matched via semantic inference or loaded on explicit user request
- **scripts/** (standalone developer tool — NOT executed by the agent): Provided for developers and CI/CD pipelines only. The agent validates prompts using its built-in LLM-native 7-rule checklist

### Competitive Advantages

| Dimension | Common Approach | This Skill |
|-----------|----------------|------------|
| Compliance | Plain-text suggestions | **Structured 7-rule hard validation (incl. optical / style conflict matrix + review safety detection)** |
| Director Styles | International directors only | **International + Chinese + Short Drama + AI Comic + Social Media + Anime + Cel-Shaded CG + Xiaohongshu** |
| Scene Coverage | Biased toward epic films | **20 vertical scenarios + anime variants + video editing + physics damping toolkit** |
| Sound Design | Brief mentions | **Spatial acoustics + material-based onomatopoeia library** |
| Lighting | "Add a light" | **Source → Behavior → Tone three-layer + lighting recipes + material library** |
| Multilingual | Chinese only | **Chinese / English bilingual output, auto language detection** |
| Review Safety | Not considered | **Camera term disambiguation rules + bare-word auto-detection** |

---

## 📋 Changelog

### v1.9.1 (2026-04-21)
- 🛡️ **Security Compliance (Round 3)**: Resolved ClawHub OpenClaw "Suspicious" flag — synchronized Step 4 workflow descriptions across ja/ko/es/pt/fr READMEs (from "run Python script" to "7-rule structured validation checklist"); removed all "Python" associations from capability tables and competitive comparisons across all locales; added `execution: none` metadata to SKILL.md frontmatter; added prominent NOT-FOR-AGENT disclaimers to Python scripts

### v1.9.0 (2026-04-18)
- 🎬 **Narrative Guidance Shot Patterns**: New Section IX in `cinematography.md` — 8 leading/following/reveal shot types (Leading Shot, Following Shot, Side Tracking, Low Angle Follow, Long Lens Follow, Epic Drone Reveal, Reveal Through, Orbit Follow) with bilingual trigger phrases and example prompts
- 🚁 **Epic Drone Reveal**: Added as a standalone Level 1 camera move — slow rise from behind subject unveiling grand landscape; distinct narrative structure from generic aerial shots
- 🌿 **Reveal from Behind / Through Shot**: New Level 1 entry for obstacle-penetration shots (camera pushing through bamboo/crowd/curtain to reveal), with safety phrasing guide
- 🚶 **Leading Shot**: New Level 1 entry for retreating-ahead camera movement conveying journey and protagonist agency
- ⚡ **Snap Zoom / Crash Zoom**: Added to Level 3 combos — explosive focal-length jump for comedy impact, scare emphasis, and MV beat-sync
- 🌀 **Orbit Follow**: Added to Level 3 combos — simultaneous orbit + tracking where the pivot point moves with the subject, distinct from static-subject orbits

### v1.8.5 (2026-04-08)
- 🌐 **Runway Platform Adaptation**: Clarified native asset limits for Runway users (≤5 images, ≤3 videos) and provided explicit moderation bypass strategies for realistic human faces (blurring or NPR restyling).
- 🎞️ **Start & End Frame Interpolation**: Added a 7th multimodal reference pattern (`@Image1 as start frame, @Image2 as end frame`) to support precise point-to-point transitions.
- 🎬 **Two New Effects Scenarios**:
  - `Freeze Time (Bullet Time)`: Camera dramatically weaves through completely frozen scene elements.
  - `Multishot Video`: Bypasses the "one-take" limitation by triggering the model to auto-generate sharp montage cuts in a single generation.

- 🚀 **Extreme POV Scenarios**: Added new 21st scenario template focusing on "human head-tracking logic", "high-speed projectile FPV (flying swords/arrows)", and "creature flight".
- 🎧 **Immersive Audio Exclusion**: Introduced strict audio-exclusion directives for POV templates (ONLY ambient sound, NO BGM or dialogue) to prevent AI from breaking immersion.
- 🧹 **Background Purification Rule**: Clarified that reference entity images must use a "pure white/blank background" to avoid contaminating the video environment in Image-to-Video generation.

### v1.8.4 (2026-04-08)
- 🔗 **CLI Integration Guide**: New `seedance-specs.md` section mapping Shot Design modes to Jimeng CLI commands (`text2video` / `image2video` / `multiframe2video` / `multimodal2video`), with async task management and VIP channel documentation
- 🎞️ **Multiframe Storytelling Template**: New scenario template (#20) for `multiframe2video` — upload 2-9 keyframe images and let the engine auto-compose a coherent story video. Includes decision matrix for choosing between multiframe vs. multi-segment storyboard
- 📚 **Knowledge Base Routing**: Added multiframe and CLI routing entries to Step 2 semantic inference table

### v1.8.3 (2026-04-08)
- 🎭 **Descriptive Over Narrative Rule**: New core rule (#12) — only write what the camera SEES (visual words), never what characters FEEL (emotion words). All emotions must be converted to visible physical expressions (facial micro-expressions, body language, breathing rhythm, gaze direction)
- ✍️ **English Present Progressive**: Assembly rules now mandate `-ing` form for English action descriptions (`running` not `runs`) — progressive tense implies continuous motion, matching video's dynamic nature
- 🎯 **Motion Tone Front-Loading**: Style preamble now explicitly declares overall motion energy (e.g., `dynamic motion, high energy` or `serene, slow-paced atmosphere`) to lock motion baseline early in generation

### v1.8.2 (2026-04-07)
- 🎥 **One-Shot-One-Move Rule**: New core rule (#10) enforcing a single camera movement per time segment — combining movements (e.g., push-in + pan) causes jitter. Subject motion and camera motion must be described separately
- 🖼️ **I2V Golden Rule**: New core rule (#11) and dedicated I2V section — when generating video from an image, only describe motion/changes, never re-describe static content already in the first frame. Introduces `preserve composition and colors` anchor phrase
- 📏 **Optimal Prompt Length**: Added 60–100 word sweet spot guidance — below is vague, above causes concept drift and conflicting instructions
- 💪 **Motion Intensity Modifiers**: New bilingual quick-reference table in cinematography dictionary with 6 intensity tiers (violent → gentle → gradual) and do/don't examples to eliminate "mushy motion"
- 🎤 **Rhythm Over Specs**: Assembly rules now explicitly prefer semantic rhythm words (gentle/gradual/smooth) over technical parameters (24fps/f2.8) that Seedance cannot parse
- 🎬 **Reference Video Best Practices**: New practical constraints for reference clips — ideal 3–8s length, continuous shot (no cuts), single intent (subject OR camera, not both)

### v1.8.1 (2026-04-07)
- 🛡️ **Security Compliance**: Resolved ClawHub OpenClaw "Suspicious patterns" flag by converting Python-based validation to LLM-native structured 7-rule validation checklist. Python scripts remain as standalone developer tools but are no longer executed by the agent
- 🎯 **Trigger Phrase Optimization**: Reduced activation trigger phrases from 40+ to 15 high-signal professional terms, lowering unintended activation surface while preserving core discoverability

### v1.8.0 (2026-04-05)
- 🎤 **Voice & Language Control System**: New timbre cloning via video reference (`语气和音色参考@视频1`), dialect/accent control (Sichuan/Cantonese/Northeast/Taiwanese etc.), multilingual dialogue mixing, special voice styles (documentary narration / stand-up comedy / opera / ASMR)
- 📹 **Multimodal Reference Guide**: Upgraded from 4 brief tips to a structured guide with 6 core reference patterns (first frame / camera replication / action replication / camera+action separation / timbre reference / effect replication), plus multi-asset character control and consistency preservation guidance
- 📏 **Video Extension Scenario**: New forward/backward extension templates, seamless continuation techniques, duration cognition correction (generation duration = added seconds, not total)
- 📋 **Story Completion Scenario**: New storyboard-to-video, comic panel animation, and image-to-emotion-video creative modes
- 🎬 **Creative Effects Quick Reference**: New VFX trigger keywords — Hitchcock zoom, fisheye lens, particle effects, speed ramp, freeze transition, ink wash style, morphing effects (bilingual)
- 🎭 **Emotion Performance Guidance**: New emotion specificity table, emotion transition trigger words, emotion reference video usage in short drama chapter

### v1.7.2 (2026-04-02)
- 🎯 **Trigger Word Expansion**: Massively expanded Skill activation coverage — added 20+ colloquial Chinese triggers (帮我写个视频, 拍一个, 做分镜, 短视频, AI视频, 抖音视频, vlog, 运镜...) and 10+ English triggers (generate a video, make a clip, shoot a scene, video script, drone shot, camera movement...) so the Skill auto-activates on natural, everyday user expressions — not just professional terminology

### v1.7.1 (2026-03-29)
- 🔒 **Security Compliance Optimization**: Resolved ClawHub security flagging issues for shell execution, process control, and file access patterns while maintaining full functionality

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 Mandatory Assembly Rules**: Three-layer lighting must be on its own line with all three layers complete; SFX line must start with `SFX:`; prohibition line standardized (no custom additions); freestyle non-template sections forbidden
- ⛔ **Step 4 Validation Blocking**: Prompts failing validation are now forbidden from being shown to users; clear 5-step validation flow
- 📋 **Step 5 Format Enforcement**: Output must follow template exactly (Theme + Director's Note + code-block-wrapped prompt); missing any section = non-compliant
- 🎯 **Step 2 Parameter Extraction Directive**: Knowledge bases must not just be "loaded" — specific parameters must be extracted and embedded into the prompt

### v1.6.0 (2026-03-28)
- 🧠 **Smart Semantic Intent Routing**: Step 2 knowledge base loading upgraded from "explicit trigger" to three-layer routing — Always-On loads camera dictionary & quality anchors every time, Semantic Intent Inference auto-detects needed knowledge bases from user's natural language, Explicit Override preserves direct user specification
- 🎯 **Step 1 Smart Inference Principle**: Agent proactively infers parameters (duration / style / scene) from a single user sentence, only asking about genuinely unknown info, limiting follow-up questions to 1-2
- 📝 Design philosophy updated from "loaded on demand" to "three-layer routing" ensuring every prompt has a quality foundation

### v1.5.0 (2026-03-27)
- 🎭 **Actor Blocking System**: Three-element positioning (placement + face direction + gaze focus) with emotion modifier vocabulary for multi-character scenes
- 🎙️ **Voiceover / Dialogue Split**: Distinct templates for on-screen dialogue vs. off-screen voiceover / inner monologue, with anti-lip-sync directive for VO scenes
- 📐 **Camera Angle Specificity**: Vague → specific angle mapping (e.g., "close-up" → "over-shoulder medium close-up, focus on listener") with 5 comparison pairs
- 🎬 **Narrative-Motivated Camera Movement**: Camera moves now paired with storytelling purpose (e.g., "slow push-in — revealing inner turmoil")
- 🔀 **Segment Transition Strategy**: 6 transition types (gaze continuity / emotional escalation / contrast cut / spatial leap / temporal ellipsis / sensory bridge) for multi-shot coherence
- 🎨 **Short Drama Style Quick-Selector**: 4-dimension combo system (visual type × render style × color tone × genre)
- 📝 Short drama prompt templates expanded from 1 to 4 variants (CN dialogue / CN voiceover / EN dialogue / EN voiceover)
- 📝 Multi-segment Director's Note template adds transition strategy declaration
- 📝 5 complete short drama examples covering: plot-twist dialogue / voiceover monologue / action conflict / 2D anime / transition strategy
- ✅ 54 tests pass

### v1.4.0 (2026-03-21)
- 🎬 **Smart Multi-Segment Storyboard**: Videos >15s auto-split into multiple independent prompts (each ≤15s, min ≥8s)
- 📝 Multi-segment coherence: unified style preamble / three-layer lighting / sound design / transition frames / forbidden items
- 📝 Step 5 adds multi-segment output format template (CN / EN)
- 📝 New 60-second desert Kali/Escrima 4-segment full example
- 🔧 Validation script adds `validate_multi_segment()` cross-segment consistency check
- ✅ 54 tests pass (incl. 4 new multi-segment validation tests)

### v1.3.0 (2026-03-21)
- 🌐 **Bilingual Prompt Output**: Chinese users → Chinese, non-Chinese → English, with auto language detection
- 📝 All structural templates, delivery formats, and multimodal tips now include English versions
- 🛡️ **Camera Term Disambiguation (Rule 9)**: Chinese uses Chinese camera terms, English uses full phrases — avoids Seedance review false positives
- 🔧 Validation adds `check_ambiguous_terms()` bare-word detection + `--lang` flag + English word-count length check
- 🔧 New Slow Motion vs Speed Ramp conflict detection
- 🔧 `detect_language()` expanded with CJK Extension A + full-width punctuation support
- 📚 `cinematography.md` adds "Seedance Safe Phrasing" column
- ✅ 50 tests pass (incl. bilingual + review safety tests)

### v1.2.0 (2026-03-21)
- 🎨 **Cel-Shaded CG Style**: New complete four-axis parameterized entry (distinct from anime's explosive energy — positioned for contemplative narrative)
- 🧱 **Anime / NPR Material Library**: Anime skin / hair / cartoon metal / cartoon fabric — 4 non-photorealistic materials
- 📦 **Anime Game PV Variant**: Scenario template adds Cel-Shaded sub-template + ice-attribute character example
- ⚠️ Conflict matrix adds: Cel-Shade vs Realistic PBR material
- 🔧 Validation adds Cel-Shade vs PBR style conflict detection

### v1.1.0 (2026-03-20)
- 🎬 **Camera Upgrade**: New focal length narrative psychology, dynamic focus paradigms, physical mount chapter (7 specialty rigs)
- 🎨 **Director Styles**: New Fincher / Deakins / Kurosawa / Makoto Shinkai + Anime Explosion / Xiaohongshu Aesthetic (incl. de-named safe prompts + forbidden items)
- 💡 **Quality Upgrade**: Anti-plastic manifesto, film stock library (5 types), material texture library (8 types), lighting combo quick-reference (4 sets), organic imperfection library, quality conflict matrix
- 🎬 **Scene Expansion**: New Game PV / Horror-Thriller / Travel-City / Pet-Cute / Before-After / Meme-Loop, totaling 16 scenarios + physics damping appendix
- 🎙️ **Sound Upgrade**: Spatial acoustic modifiers (7 types), material-based onomatopoeia refinement (7 pairs)
- 🔧 **Validation Enhancement**: Filler word warning → error hard-block, optical physics conflict detection, style conflict matrix, duration-aware time-slicing, 35 tests pass

### v1.0.0 (2026-03-19)
- 🎉 Initial release
- SKILL.md core workflow
- 6 professional knowledge base files
- Python validation script + test cases
- 20+ director style mappings
- 10 vertical scenario templates

---

## 📄 License

MIT-0 (MIT No Attribution) License

FILE:README.ja.md
[English](README.md) | [中文](README.zh-CN.md) | 日本語 | [한국어](README.ko.md) | [Español](README.es.md) | [Português](README.pt.md) | [Français](README.fr.md)

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>シネマティック・ショット言語デザイナー</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="バージョン"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="ライセンス"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="プラットフォーム"></a>
</p>

<p align="center">
  あなたの漠然とした映像アイデアを、即夢 Seedance 2.0 で使える<strong>映画レベルの動画プロンプト</strong>にワンクリックで変換。
</p>

[Agent Skills](https://agentskills.io) 仕様に基づいて構築された Claude Skill です。ハリウッド最高峰の撮影美学と中国映像業界の実践知見を融合し、クリエイターが「綺麗だけどランダム」な AI 動画の壁を突破して、**精密で制御可能なビジュアルストーリーテリング**を実現することを目指しています。

---

## ✨ コア機能

| 機能 | 詳細 |
|------|------|
| 🎭 **AIコミックドラマ＆ショートドラマ制作** | AIマンガドラマ（漫剧）とAIショートドラマのフルパイプライン対応 — セリフ / ナレーション / 俳優ブロッキング / 誇張表情クローズアップ / ナラティブ動機付きカメラワーク / ショートドラマスタイル・クイックセレクター / 4テンプレート（CN/EN×セリフ/ナレーション）、専用シナリオテンプレート＆完全例付き |
| 🎨 **28以上の監督・スタイルプリセット** | ノーラン / ヴィルヌーヴ / フィンチャー / ディーキンス / 黒澤明 / 新海誠 / ウォン・カーウァイ / チャン・イーモウ / 仙侠 / セルシェーディングCG / アニメ / 小紅書… |
| 🎬 **プロ仕様カメラワーク辞典** | 3階層カメラシステム ＋ 14焦点距離 ＋ 6フォーカス制御 ＋ 7物理マウント、中英対訳付き |
| 💡 **三層ライティング構造** | 光源層→光挙動層→色調層 ——「とりあえずライト追加」は卒業 |
| 📐 **タイムスタンプ式絵コンテ** | `0-3秒 / 3-8秒 / …` 精密なタイムライン制御でショット間の滲みを防止 |
| 🎯 **六要素精密組立** | 被写体 / アクション / シーン / ライティング / カメラ / サウンド — 構造化された高変換率フォーミュラ |
| 🎬 **スマート多段絵コンテ** | 15秒超の動画は自動的に独立プロンプトに分割。スタイル・ライティング・サウンド統一、シームレスな繋ぎフレーム |
| 📦 **20シナリオテンプレート** | EC / 仙侠 / ショートドラマ / グルメ / MV / ワンテイク / 自動車 / マクロ / 自然 / ゲームPV / ホラー / 旅行 / ペット / 変身 / ループ / 映像編集 / 映像延長 / ストーリー補完 / マルチフレームストーリー |
| 🎵 **サウンド＆ASMR語彙集** | 物理ベースのオノマトペライブラリ：環境音 / アクション / ボーカル / 楽器 |
| 🌐 **バイリンガルプロンプト出力** | 中国語ユーザー→中国語 / それ以外→英語プロンプト、自動検出 |
| 🛡️ **著作権セーフIP退避** | 三段階プログレッシブIP回避戦略でプラットフォームのコンテンツブロックを防止 |
| 🔍 **構造化ハード検証** | 文字数 / カメラワーク / 時系列ロジック / 冗長表現検出 / 光学物理矛盾 / スタイル競合マトリクス — 「提案」より確実 |

---

## 🚀 クイックスタート

### 1. Skill のインストール

<details>
<summary><b>Claude Code</b></summary>

`seedance-shot-design/` フォルダをプロジェクトルートの `.claude/skills/` に配置します：

```bash
# プロジェクトの Skill ディレクトリにクローン
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

Claude Code が自動的に Skill を検出してロードします。
</details>

<details>
<summary><b>OpenClaw</b></summary>

連携済みの IM アプリ（WeChat、飛書など）で、OpenClaw Agent にメッセージを送信します：

```
このスキルを学習してください：https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

Agent が自動的に Seedance Shot Design スキルを取得・習得します。すぐにリクエストを開始できます。
</details>

<details>
<summary><b>Codex</b></summary>

Skill フォルダを Codex の agents 指示ディレクトリに配置します：

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```

Codex の会話内で呼び出せます。
</details>

<details>
<summary><b>Cursor</b></summary>

Skill フォルダをプロジェクトルートの `.cursor/skills/` に配置します：

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```

Cursor Agent モードで自動的に Skill 指示を読み込みます。
</details>

### 2. 使い方

Claude にこう伝えるだけ：

```
15秒のサイバーパンク豪雨チェイスの動画プロンプトを書いてください
```

Skill が自動起動し、5ステップのワークフローでプロンプトを生成します：
1. **要件分析** — 尺 / アスペクト比 / 素材 / スタイルを確認
2. **ビジュアル診断** — カメラ言語と監督スタイルを選定
3. **六要素組立** — 構造化フォーミュラに基づいて精密に作成
4. **必須検証** — 7項目構造化チェックリストによる品質レビュー
5. **プロ納品** — 監督ステートメント ＋ 完成プロンプト

### 3. 使用例

#### フルインタラクションデモ

**ユーザー入力：**
```
10秒の東方仙侠ショートフィルムの動画プロンプトを書いてください
```

**Skill 出力：**

> **Seedance 動画プロンプト**
>
> **テーマ**：朝霧立ち込める古寺で白衣の少年が紅葉を受け止め、悟りに至る
>
> **監督ステートメント**（創作意図の理解用 — コピー不要）：
> 空撮→ドリー→スロープッシュの三段階カメラワークで、壮大な風景から親密な感情へと遷移。
> 35mmフィルムグレインが手作りの質感を加え、金青の色調が東洋の「自然との調和」哲学を体現。
>
> **完成プロンプト**（即夢の入力欄にそのままコピー）：

```
10秒の中国風ファンタジー、リアリスティックな東洋映画テイスト、金青カラーパレット、幽玄なアンビエントサウンド。
0-3秒：雲海に浮かぶ古寺を高角度空撮、スロー空撮プッシュ、朝霧が谷間を流れる、遠くで鐘がかすかに鳴る、ティンダル光線が雲層を貫く。
3-7秒：ドリーで寺門を抜け中庭へ、白衣の少年が手を上げ舞い落ちる紅葉を受ける、35mmフィルムグレイン質感、浅い被写界深度で手元にフォーカス。
7-10秒：少年が目を上げるクローズアップ、スロープッシュイン、風が起き、袖と髪がフレーム右方向にたなびく、中庭で霊光が螺旋状に昇る。
サウンド：環境音が収束し一筋の清澄な剣鳴へ。
禁止：あらゆるテキスト、字幕、ロゴ、ウォーターマーク
```

#### その他の使用シーン

```
# AIコミックドラマ
10秒のAIコミック風・俺様CEOショートの動画プロンプト、縦型9:16、セリフとオーバーリアクションのクローズアップ付き

# EC広告
8秒の高級腕時計プロダクトCM動画プロンプト、9:16縦型

# ショートドラマ
12秒のどんでん返しショートドラマシーンの動画プロンプト、セリフ付き

# ワンテイク
15秒のワンテイク博物館散策の動画プロンプト

# 参考素材付き
キャラクターデザイン画3枚と参考動画1本をアップロード済み — 15秒の仙侠アクションシーンを生成して
```

---

## 📁 プロジェクト構成

```
seedance-shot-design/
├── SKILL.md                     # コア指示（Skillの頭脳）
├── README.md                    # 本ファイル
├── scripts/
│   ├── validate_prompt.py       # 工業グレードのプロンプト検証スクリプト
│   └── test_validate.py         # 検証スクリプトのテストケース
└── references/
    ├── cinematography.md        # カメラ＆焦点距離辞典（物理マウント＆焦点距離心理学含む）
    ├── director-styles.md       # 監督スタイルパラメータ化マッピング（28+スタイル、セルシェーディングCG含む）
    ├── seedance-specs.md        # Seedance 2.0 公式プラットフォーム仕様
    ├── quality-anchors.md       # 品質アンカー＆ライティングライブラリ（NPR素材/ライティング/競合マトリクス含む）
    ├── scenarios.md             # 垂直シナリオテンプレート（17シナリオ+アニメ変体+映像編集+物理ダンピングツールキット）
    └── audio-tags.md            # オーディオ＆効果音タグ仕様（空間音響＆素材ベースオノマトペ含む）
```

---

## 🔬 検証スクリプト

コマンドラインから単独使用可能なスタンドアロン Python 検証ツール：

```bash
# テキストを直接検証
python scripts/validate_prompt.py --text "プロンプト"

# ファイルから検証
python scripts/validate_prompt.py --file prompt.txt

# 言語を指定（auto=自動検出, cn=中国語, en=英語）
python scripts/validate_prompt.py --text "your prompt" --lang en

# JSON形式で出力（プログラム処理向け）
python scripts/validate_prompt.py --text "プロンプト" --json
```

**検証項目：**
- ❌ 文字数超過（中国語 >500文字 / 英語 >1000語）
- ❌ プロ仕様カメラ用語の欠如
- ❌ 冗長表現ハードブロック（masterpiece / 傑作 / 超高精細など → error）
- ❌ 光学物理矛盾（超広角＋ボケ、手持ち＋完全対称）
- ❌ スタイル競合マトリクス（IMAX vs VHS、フィルム vs デジタル、水墨 vs UE5、セルシェーディング vs リアルPBR、スローモーション vs スピードランプ）
- ❌ アセット参照超過（画像 >9 / 動画 >3 / 音声 >3 / 合計 >12）
- ❌ 長尺動画（>5秒）タイムスライスなしハードブロック
- ⚠️ タイムスライスのギャップまたは重複
- ⚠️ 宣言尺とスライス終端の不一致
- ⚠️ セグメント内モーションロジック矛盾
- ⚠️ Seedanceレビューリスク：ベアな英語カメラ用語検出（Dolly / Aerial / Crane / Pan / Arc / Dutch / Steadicam）
- 🌐 自動言語検出（中国語 / 英語）、言語別に長さ基準＆検出戦略を適用
- 🎬 多段セグメント間一貫性チェック（スタイル総則 / ライティング構造 / 禁止項目）

**テスト実行：**
```bash
python -m unittest scripts.test_validate -v
# 54項目のテストがすべて合格（11テストクラスをカバー）
```

---

## 🏗️ 設計思想

### プログレッシブ・ナレッジ・ローディング（Progressive Disclosure）

Agent Skills のベストプラクティスに準拠：

- **SKILL.md**（~4000トークン）：コアワークフロー ＋ 構造テンプレート ＋ 品質チェックリスト
- **references/**（オンデマンド読み込み）：スタイル / カメラ / 品質に関するニーズが言及された場合のみ読み取り
- **scripts/**（スタンドアロン開発ツール — Agentは実行しません）：開発者とCI/CDパイプライン専用。Agentは内蔵のLLMネイティブ7項目チェックリストで検証

### 競合優位性

| 比較軸 | 一般的なアプローチ | 本 Skill |
|--------|-------------------|----------|
| コンプライアンス検証 | プレーンテキストの提案 | **構造化ハード検証（7項目规則、光学/スタイル競合マトリクス＋レビュー安全検出含む）** |
| 監督スタイル | 海外の有名監督のみ | **国際＋中国＋ショートドラマ＋AIコミック＋SNS＋アニメ＋セルシェーディングCG＋小紅書** |
| シーンカバレッジ | 大作映画寄り | **17垂直シナリオ＋アニメ変体＋映像編集＋物理ダンピングツールキット** |
| サウンドデザイン | 簡単な言及 | **空間音響＋素材ベースオノマトペライブラリ** |
| ライティング | 「ライト足して」 | **光源→挙動→色調の三層＋ライティングレシピ＋素材ライブラリ** |
| 多言語 | 中国語のみ | **中国語/英語バイリンガル出力、自動言語検出** |
| レビュー安全性 | 未考慮 | **カメラ用語曖昧性解消ルール＋ベアワード自動検出** |

---

## 📋 変更履歴

### v1.9.1 (2026-04-21)
- 🛡️ **セキュリティ準拠（第3回）**：ClawHub OpenClaw「Suspicious」フラグを解決 — ja/ko/es/pt/fr READMEのStep 4説明を同期修正（「Pythonスクリプト実行」→「7項目構造化チェックリスト」）；全ロケールの機能表・競合比較から「Python」関連表現を削除；SKILL.mdに`execution: none`メタデータ追加；PythonスクリプトにNOT-FOR-AGENT免責事項追加

### v1.9.0 (2026-04-18)
- 🎬 **ナラティブガイドカメラワーク速査（新章）**: `cinematography.md` 第IX節を新設 — 8種のリード/フォロー/リビールショット（リードショット・フォローショット・サイドトラッキング・ローアングルフォロー・長焦圧縮フォロー・史詩的ドローンリビール・遮障物越しリビール・移動オービット）、双言語トリガーワード＆例付き
- 🚁 **史詩的ドローンリビール（Epic Drone Reveal）**: 独立したLevel 1カメラムーブとして追加 — 被写体背後/低位から徐々に上昇して壮大な景観を明かす；通常の空撮とは根本的に異なる叙事構造
- 🌿 **遮障物越しリビール/スルーショット（Reveal / Through Shot）**: 新規Level 1 — 障害物（竹林/鳥居/人混み/カーテン）を抜けてシーンを明かす、サスペンスと奥行き感を演出
- 🚶 **リードショット（Leading Shot）**: 新規Level 1 — カメラが被写体の前を後退しながらガイド、旅の感覚と主人公の能動性を強化
- ⚡ **スナップズーム/クラッシュズーム（Snap Zoom / Crash Zoom）**: Level 3コンボに追加 — 焦点距離の急変による爆発的インパクト、コメディ・驚き・MVビートシンクに
- 🌀 **移動オービット（Orbit Follow）**: Level 3コンボに追加 — 被写体の動きに合わせてオービット中心点が移動するorbit+tracking複合技

### v1.8.5 (2026-04-08)
- 🌐 **Runwayプラットフォーム対応**: Runwayユーザー向けの資産制限（画像5枚以下、動画3つ以下）を明記し、リアルな人間の顔に対するモデレーション回避策（ぼかしやNPRスタイルへの変換）を提供。
- 🎞️ **開始＆終了フレーム補間**: マルチモーダルリファレンスパターンに第7のモード（`@Image1 as start frame, @Image2 as end frame`）を追加。正確なポイントツーポイントのトランジションをサポート。
- 🎬 **2つの新しいエフェクトシナリオ**:
  - `Freeze Time (バレットタイム)`: 完全に停止したシーンの要素間をカメラが劇的に通り抜ける。
  - `Multishot Video (マルチショットビデオ)`: ワンテイクの制限を回避し、単一の生成でシャープなモンタージュカットを自動生成する。

- 🚀 **極端な主観視点 (Extreme POV)**: 新しい第21シナリオテンプレートを追加。「人間の視線移動のロジック」、「高速飛行物体のFPV (剣/矢)」、および「鳥などの生物の飛行」をカバー。
- 🎧 **没入感のための音声排他原則**: POVテンプレートに厳格な環境音排他指令を導入 (環境音のみ、BGMやセリフは絶対不可)。生成AIによる不要な音楽の追加を防ぎ、実在感を損なわないようにします。
- 🧹 **背景純化ルールの追加**: Image-to-Videoで主観視点を生成する場合、背景の不純物がビデオ環境を汚染するのを防ぐため、必ず「純白/空白の背景」を持つ素材画像を使用するよう明記。

### v1.8.4 (2026-04-08)
- 🔗 **CLI連携ガイド**: `seedance-specs.md`に即梦CLIコマンドマッピングを追加（`text2video` / `image2video` / `multiframe2video` / `multimodal2video`）、非同期タスク管理とVIPチャンネル説明を含む
- 🎞️ **マルチフレームストーリーテンプレート**: 第20シナリオテンプレート「マルチフレームストーリー（multiframe2video）」を追加——2-9枚のキーフレーム画像をアップロードし、エンジンが自動的に一貫したストーリービデオを構成
- 📚 **ナレッジベースルーティング拡張**: Step 2の意味推論テーブルにマルチフレームおよびCLIルーティングエントリを追加

### v1.8.3 (2026-04-08)
- 🎭 **記述性優先ルール**：新規コアルール（#12）— カメラが「見えるもの」（視覚語）だけを書き、キャラが「感じるもの」（感情語）は書かない。すべての感情は可視化された身体表現に変換すること
- ✍️ **英語現在進行形**：英語プロンプトの動作は -ing 形を義務化（`running` not `runs`）— 進行形は継続的な動きを暗示
- 🎯 **モーショントーン前置**：スタイルプリアンブルで運動エネルギーを宣言（`dynamic motion` / `serene atmosphere`）、生成初期に運動基調をロック

### v1.8.2 (2026-04-07)
- 🎥 **一鏡一動ルール**：新規コアルール（#10）— タイムセグメントごとのカメラ動作を1つに制限。複数運動の重畳（例：プッシュイン+パン）は画面の揺れを引き起こす。被写体の動きとカメラの動きは分離して記述すること
- 🖼️ **I2V ゴールデンルール**：新規コアルール（#11）及び I2V 専用ガイド — 画像から動画生成時は動き/変化のみを記述し、最初のフレームの静的内容を再記述しない。`preserve composition and colors` アンカーフレーズを導入
- 📏 **プロンプト最適長**：60-100語のスイートスポット指針を追加 — 短すぎると曖昧、100語超で概念ドリフトと指示の矛盾
- 💪 **運動強度修飾語速査**：運動辞書に6段階強度対照表（猛烈→穏やか→漸進）とDo/Don't例を新規追加、「糊動」を解消
- 🎤 **リズムワード優先**：組立ルールでセマンティックリズムワード（gentle/gradual/smooth）を技術パラメータ（24fps/f2.8）より明示的に優先
- 🎬 **参照動画ベストプラクティス**：参照クリップの実践的制約 — 理想3-8秒、連続カット（編集点なし）、単一意図（被写体動作またはカメラ動作のみ）

### v1.8.1 (2026-04-07)
- 🛡️ **セキュリティ準拠**：ClawHub OpenClaw「疑わしいパターン」フラグを解決 — Python検証をLLMネイティブの7項目構造化チェックリストに変換。Pythonスクリプトはスタンドアロン開発ツールとして保持
- 🎯 **トリガーフレーズ最適化**：活性化トリガーを40+から15個の高信号プロ用語に削減、誤活性化を抑制しつつ発見性を維持

### v1.8.0 (2026-04-05)
- 🎤 **音声・言語制御システム**：動画参照による音色クローン、方言/アクセント制御、多言語対話ミキシング、特殊音声スタイル（ドキュメンタリー/コント/オペラ/ASMR）
- 📹 **マルチモーダル参照ガイド**：4要点から6種コア参照パターンへアップグレード（首帧/運動複製/動作複製/カメラ+動作分離/音色参照/エフェクト複製）
- 📏 **動画延長シナリオ**：順方向/逆方向延長テンプレート、シームレス接続技法、生成時間認知補正
- 📋 **ストーリー補完シナリオ**：絵コンテ→動画、コマ送りアニメーション、画像→感情動画の3創作モード
- 🎬 **クリエイティブエフェクト速査**：VFXトリガーキーワード — ヒッチコックズーム、フィッシュアイ、パーティクル、スピードランプ、フリーズトランジション、水墨風、モーフィング
- 🎭 **感情演技ガイダンス**：感情具体化表、感情遷移トリガーワード、感情参照動画の活用

### v1.7.2 (2026-04-02)
- 🎯 **トリガーワード拡張**：日常的な表現（「動画作って」「クリップ作成」「カメラワーク」等）での自動起動をカバーする20+中国語・10+英語トリガーを追加

### v1.7.1 (2026-03-29)
- 🔒 **セキュリティ準拠最適化**：ClawHubセキュリティフラグの問題を解決、全機能を維持

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 必須組立ルール**：三層ライティング独立行/音効行の標準化/禁止項目の統一/テンプレート外段落の禁止
- ⛔ **Step 4 検証ブロッキング**：検証不合格プロンプトのユーザー表示を禁止
- 📋 **Step 5 フォーマット強制**：テーマ+ディレクターノート+コードブロック包囲の出力テンプレート
- 🎯 **Step 2 パラメータ抽出指令**：知識ベースの「読み込み」だけでなく具体パラメータの抽出・埋め込みを義務化

### v1.6.0 (2026-03-28)
- 🧠 **スマートセマンティックルーティング**：Step 2を「明示トリガー」から三層ルーティングにアップグレード — 常時読み込み/意味推論/明示指定
- 🎯 **Step 1 スマート推論原則**：一文からパラメータを能動推論、質問は1-2問に制限

### v1.5.0 (2026-03-27)
- 🎭 **俳優ブロッキングシステム**：三要素ポジショニング（配置+顔の向き+視線フォーカス）＋感情修飾語彙集で、マルチキャラクターシーンに脚本家レベルのキャラクター調度を提供
- 🎙️ **ナレーション/セリフ分離**：対面セリフとナレーション/心内語の分離テンプレート、ナレーションシーン用リップシンク防止指示付き
- 📐 **撮影アングル具体化**：曖昧→具体のアングルマッピング（例：「クローズアップ」→「オーバーショルダー中近景、リスナーにフォーカス」）、5組の対照表付き
- 🎬 **ナラティブ動機付きカメラワーク**：カメラ動作と物語目的の紐付け（例：「スロープッシュイン — 内面の葛藤を明かす」）、5組の対照表付き
- 🔀 **セグメント間トランジション戦略**：6種のトランジション（視線連続 / 感情段階 / コントラストカット / 空間ジャンプ / 時間省略 / 感覚ブリッジ）でマルチショットの一貫性強化
- 🎨 **ショートドラマスタイル・クイックセレクター**：4次元コンボ（映像タイプ×レンダリングスタイル×色調×ジャンル）
- 📝 ショートドラマテンプレートを1から4バリエーションに拡張（CN対話/CNナレーション/EN対話/ENナレーション）
- 📝 多段絵コンテの監督ノートにトランジション戦略宣言を追加
- 📝 5つの完全なショートドラマ例：反転対話 / ナレーション独白 / アクション対立 / 2Dアニメ / トランジション戦略
- ✅ 54項目のテスト合格

### v1.4.0 (2026-03-21)
- 🎬 **スマート多段絵コンテ**：15秒超の動画を自動的に複数の独立プロンプトに分割（各≤15秒、最短≥8秒）
- 📝 多段コヒーレンス：スタイル総則 / 三層ライティング / サウンドデザイン / 繋ぎフレーム / 禁止項目を統一
- 📝 ステップ5に多段出力フォーマットテンプレート追加（中/英）
- 📝 60秒砂漠 Kali/Escrima 4段フル例を新規追加
- 🔧 検証スクリプトに `validate_multi_segment()` セグメント間一貫性チェックを追加
- ✅ 54項目のテスト合格（新規多段検証テスト4件含む）

### v1.3.0 (2026-03-21)
- 🌐 **バイリンガルプロンプト出力**：中国語ユーザー→中国語、非中国語→英語、自動言語検出
- 📝 全構造テンプレート・納品フォーマット・マルチモーダルTipsに英語版を追加
- 🛡️ **カメラ用語曖昧性解消（Rule 9）**：中国語は中国語カメラ用語、英語はフルフレーズを使用 — Seedanceレビューの誤検出を回避
- 🔧 検証に `check_ambiguous_terms()` ベアワード検出 ＋ `--lang` フラグ ＋ 英語ワードカウント長さチェックを追加
- 🔧 スローモーション vs スピードランプ競合検出を新規追加
- 🔧 `detect_language()` を CJK Extension A ＋ 全角句読点対応で拡張
- 📚 `cinematography.md` に「Seedance安全表記」列を追加
- ✅ 50項目のテスト合格（バイリンガル＋レビュー安全テスト含む）

### v1.2.0 (2026-03-21)
- 🎨 **セルシェーディングCGスタイル**：完全な4軸パラメータ化エントリを新規追加（アニメの爆発的エネルギーとは異なる — 静的な物語向け）
- 🧱 **アニメ/NPR素材ライブラリ**：アニメ肌 / 髪 / カートゥンメタル / カートゥンファブリック — 4種の非写実素材
- 📦 **アニメゲームPV変体**：シナリオテンプレートにセルシェーディングサブテンプレート＋氷属性キャラクター例を追加
- ⚠️ 競合マトリクスに追加：セルシェーディング vs リアルPBR素材
- 🔧 検証にセルシェーディング vs PBR スタイル競合検出を追加

### v1.1.0 (2026-03-20)
- 🎬 **カメラアップグレード**：焦点距離ナラティブ心理学、ダイナミックフォーカスパラダイム、物理マウント章（7種の特殊リグ）を新規追加
- 🎨 **監督スタイル**：フィンチャー / ディーキンス / 黒澤明 / 新海誠 ＋ アニメ爆燃 / 小紅書感性（脱名化セーフプロンプト＋禁止項目含む）を新規追加
- 💡 **品質アップグレード**：アンチプラスチック宣言、フィルムストックライブラリ（5種）、素材テクスチャライブラリ（8種）、ライティングコンボクイックリファレンス（4セット）、オーガニック不完全さライブラリ、品質競合マトリクス
- 🎬 **シーン拡張**：ゲームPV / ホラー・スリラー / 旅行・都市 / ペット・萌え / ビフォーアフター / Meme-Loop を新規追加、計16シナリオ＋物理ダンピング付録
- 🎙️ **サウンドアップグレード**：空間音響修飾語（7種）、素材ベースオノマトペ精細化（7ペア）
- 🔧 **検証強化**：冗長表現 warning→error ハードブロック、光学物理矛盾検出、スタイル競合マトリクス、尺感知タイムスライシング、35項目テスト合格

### v1.0.0 (2026-03-19)
- 🎉 初回リリース
- SKILL.md コアワークフロー
- 6つのプロ知識ベースファイル
- Python 検証スクリプト ＋ テストケース
- 20以上の監督スタイルマッピング
- 10の垂直シナリオテンプレート

---

## 📄 ライセンス

MIT-0 (MIT No Attribution) License

FILE:README.zh-CN.md
[English](README.md) | 中文 | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português](README.pt.md) | [Français](README.fr.md)

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>镜头语言设计师</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="版本"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="协议"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="平台"></a>
</p>

<p align="center">
  将你模糊的视频创意，一键转化为即梦 Seedance 2.0 可用的<strong>电影级视频提示词</strong>。
</p>

一个基于 [Agent Skills](https://agentskills.io) 规范构建的 Claude Skill，融合好莱坞顶级摄影美学与中国影视工业实践，旨在帮助创作者突破"好看但随机"的 AI 视频困境，实现**精准可控的视觉叙事**。

---

## ✨ 核心能力

| 能力 | 描述 |
|------|------|
| 🎭 **AI漫剧 & 短剧全链路制作** | 全面支持AI漫剧与AI短剧生产——角色对白/画外音/演员调度/夸张表情特写/叙事化运镜/短剧风格快速选择器/4套提示词模板（中英文×对白/画外音），配套专属场景模板与完整示例 |
| 🎨 **28+导演与风格** | 诺兰/维伦纽瓦/芬奇/迪金斯/黑泽明/新海诚/王家卫/张艺谋/仙侠/三渲二/二次元/小红书... |
| 🎬 **专业运镜词典** | 3级运镜体系 + 14种焦段 + 6种焦点控制 + 7种物理机位，中英文对照 |
| 💡 **光影三层结构** | 光源层→光行为层→色调层，告别"加个灯"的笼统描述 |
| 📐 **时间戳分镜法** | `0-3秒/3-8秒/...` 精准时间轴控制，画面不再粘连 |
| 🎯 **六要素精准组装** | 主体/动作/场景/光影/运镜/音效，结构化高转化公式 |
| 🎬 **智能多段分镜** | >15秒自动拆分为多段独立提示词，统一风格/光影/音效，稳定交接帧无缝拼接 |
| 📦 **20大场景模板** | 电商/仙侠/短剧/美食/MV/一镜到底/汽车/微距/自然/游戏PV/恐怖/旅行/宠物/变身/Loop/视频编辑/视频延长/剧情补全/多帧故事 |
| 🎵 **音效ASMR词库** | 物理拟声描述库，覆盖环境/动作/人声/音乐 |
| 🎤 **音色与语言控制** | 视频参考音色克隆、方言/口音控制（四川话/粤语/东北话/台湾腔等）、多语言对话混合、特殊音色风格（科普解说/脱口秀/戴曲唱腔/ASMR） |
| 📹 **多模态参考指南** | 6种核心参考模式（首帧锚定/运镜复刻/动作复刻/运镜+动作分离/音色参考/特效复刻），多素材角色控制，一致性保持 |
| 🌐 **双语提示词输出** | 中文用户→中文提示词，非中文用户→英文提示词，自动检测 |
| 🛡️ **版权安全避障** | 三级渐进式IP回退策略，防止平台拦截 |
| 🔍 **结构化硬性校验** | 字数/运镜/时序逻辑/废话检测/光学物理冲突/风格冲突矩阵—7项校验规则逐条强制执行 |
| 🔗 **CLI 集成** | 即梦 CLI 命令映射（`text2video` / `image2video` / `multiframe2video` / `multimodal2video`），异步任务管理，VIP 通道路由 |
| 🎞️ **多帧故事** | 上传 2-9 张关键帧图片 → 引擎自动编排连贯故事视频（`multiframe2video`），含多帧 vs 多段分镜决策矩阵 |

---

## 🚀 快速开始

### 1. 安装 Skill

<details>
<summary><b>Claude Code</b></summary>

将 `seedance-shot-design/` 文件夹放入项目根目录的 `.claude/skills/` 下：

```bash
# 克隆到项目的 Skill 目录
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

Claude Code 会自动识别并加载该 Skill。
</details>

<details>
<summary><b>OpenClaw</b></summary>

在你绑定的 IM（如微信、飞书等）中，直接对 OpenClaw Agent 发一条消息：

```
请学习这个技能：https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

Agent 会自动拉取并学会 Seedance Shot Design 技能，之后你就可以直接向它提需求了。
</details>

<details>
<summary><b>Codex</b></summary>

将 Skill 文件夹放入 Codex 的 agents 指令目录：

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```

在 Codex 对话中即可调用。
</details>

<details>
<summary><b>Cursor</b></summary>

将 Skill 文件夹放入项目根目录的 `.cursor/skills/` 下：

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```

Cursor Agent 模式下会自动读取该 Skill 指令。
</details>

### 2. 使用

直接对 Claude 说：

```
帮我写一段15秒的赛博朋克暴雨追逐的视频提示词
```

Skill 会自动激活并按 5 步工作流生成提示词：
1. **需求解析** — 确认时长/比例/素材/风格
2. **视觉诊断** — 选定镜头语言与导演风格
3. **六要素组装** — 按公式精准撰写
4. **强制校验** — 执行 7 项结构化校验规则
5. **专业交付** — 导演阐述 + 完整提示词

### 3. 示例

#### 完整交互演示

**用户输入：**
```
帮我写一段10秒的东方仙侠短片视频提示词
```

**Skill 输出：**

> **Seedance 视频提示词**
>
> **主题**：晨雾古寺中白衣少年接红叶悟道
>
> **导演阐述**（仅供理解创作意图，无需复制）：
> 选用 航拍→推轨→缓慢推进 的三段式运镜，从宏观仙境过渡到微观情感。
> 35mm 胶片颗粒赋予手工质感，金青色调呼应东方道法自然的美学。
>
> **完整提示词**（直接复制到即梦输入框）：

```
10秒中国风奇幻，写实东方电影质感，金青色调，空灵环境音。
0-3秒：高空俯拍云海中的古寺，航拍缓慢推进，晨雾在山谷间流动，远处钟声隐约，丁达尔光束穿透云层。
3-7秒：推轨穿过寺门进入庭院，白衣少年抬手接住一片红叶，35mm胶片颗粒质感，浅景深聚焦手部细节。
7-10秒：近景特写少年抬眼，缓慢推进，风起，衣袖与发丝同时扬向画面右侧，庭院中灵光旋转升腾。
音效：环境音收束为一声清越剑鸣。
禁止：任何文字、字幕、LOGO或水印
```

#### 更多使用场景

```
# AI漫剧
帮我写一段10秒的AI漫剧风格的霸道总裁短片，竖屏9:16，要有台词和夸张表情特写

# 电商广告
帮我写一段8秒的高端腕表产品广告视频提示词，9:16竖屏

# 短剧对白
帮我写一段12秒的反转短剧片段，要有台词

# 一镜到底
帮我生成一段15秒的一镜到底穿越博物馆的视频提示词

# 带参考素材
我上传了3张角色设定图和1段参考视频，帮我生成15秒的仙侠打斗
```

---

## 📁 项目结构

```
seedance-shot-design/
├── SKILL.md                     # 核心指令（Skill大脑）
├── README.md                    # 本文件
├── scripts/
│   ├── validate_prompt.py       # 提示词工业级校验脚本
│   └── test_validate.py         # 校验脚本测试用例
└── references/
    ├── cinematography.md        # 运镜与焦段专业词典（含物理机位与焦段心理学）
    ├── director-styles.md       # 导演风格参数化映射库（28+风格，含三渲二/Cel-Shaded CG）
    ├── seedance-specs.md        # Seedance 2.0官方平台规范
    ├── quality-anchors.md       # 品质锚定与光影库（含NPR材质/灯光/冲突矩阵）
    ├── scenarios.md             # 垂直场景模板库（20大场景 + 二次元变体 + 视频编辑 + 物理阻尼工具箱）
    └── audio-tags.md            # 音频与音效标签规范（含空间声学与材质拟声）
```

---

## 🔬 校验脚本（独立开发者工具）

提供独立的 Python 校验工具，供开发者和 CI/CD 管线使用。AI Agent 通过内置的 7 项结构化校验规则原生执行同等校验，无需运行 Python。

```bash
# 直接校验文本
python scripts/validate_prompt.py --text "你的提示词"

# 从文件校验
python scripts/validate_prompt.py --file prompt.txt

# 指定语言（auto=自动检测, cn=中文, en=英文）
python scripts/validate_prompt.py --text "your prompt" --lang en

# JSON格式输出（便于程序化处理）
python scripts/validate_prompt.py --text "提示词" --json
```

**校验项：**
- ❌ 字数超标（中文>500字符 / 英文>1000词）
- ❌ 缺少专业运镜术语
- ❌ 废话词硬阻断（masterpiece/杰作/超清晰等 → error）
- ❌ 光学物理冲突（超广角+虚化、手持+绝对对称）
- ❌ 风格冲突矩阵（IMAX vs VHS、胶片 vs 数码、水墨 vs UE5、三渲二 vs 写实PBR、Slow Motion vs Speed Ramp）
- ❌ 资产引用超限（图片>9/视频>3/音频>3/总计>12）
- ❌ 长视频(>5s)无时间切片硬阻断
- ⚠️ 时序切片缺失或重叠
- ⚠️ 声明时长与切片末端不匹配
- ⚠️ 同段内运动逻辑冲突
- ⚠️ Seedance审核风险裸英文运镜词检测（Dolly/Aerial/Crane/Pan/Arc/Dutch/Steadicam）
- 🌐 自动语言检测（中文/英文），按语言适配长度标准与检测策略
- 🎬 多段分镜跨段一致性检查（风格总纲/光影结构/禁止项）

**运行测试：**
```bash
python -m unittest scripts.test_validate -v
# 54 项测试全通过（覆盖 11 个测试类）
```

---

## 🏗️ 设计理念

### 渐进式知识加载（Progressive Disclosure）

遵循 Agent Skills 最佳实践：

- **SKILL.md**（~4000 tokens）：核心工作流 + 结构模板 + 质量检查表
- **references/**（三层路由加载）：运镜词典和品质锚定始终加载（Always-On），其余知识库通过语义推理自动匹配或用户显式指定加载
- **scripts/**（独立工具）：校验脚本供开发者独立使用，Agent 不执行脚本而是通过内置规则校验

### 竞品超越策略

| 对比维度 | 竞品通用做法 | 本Skill做法 |
|----------|-------------|-------------|
| 合规校验 | 纯文本建议 | **7项结构化硬性校验（含光学/风格冲突矩阵 + 审核安全检测）** |
| 导演风格 | 仅国际大导 | **国际+中国+短剧+AI漫剧+社交媒体+二次元+三渲二+小红书** |
| 场景覆盖 | 偏电影大片 | **20大垂直场景 + 二次元变体 + 视频编辑 + 物理阻尼工具箱** |
| 音效描述 | 简单提及 | **空间声学 + 材质拟声精细化词库** |
| 光影描述 | "加个灯" | **光源→光行为→色调三层 + 灯光Recipe + 材质库** |
| 多语言 | 仅中文 | **中文/英文双语输出，自动检测用户语言** |
| 审核安全 | 未考虑 | **运镜术语消歧义规则 + 裸词自动检测** |

---

## 📋 版本记录

### v1.9.1 (2026-04-21)
- 🛡️ **安全合规（第三轮）**：彻底解决 ClawHub OpenClaw “Suspicious” 标记——同步修正日/韩/西/葡/法 5 个语言 README 中 Step 4 工作流描述（从“执行 Python 脚本”改为“7 项结构化校验规则”）；统一移除所有 README 核心能力表和竞品对比中的 “Python” 关联表述；SKILL.md frontmatter 新增 `execution: none` 元数据声明；Python 脚本添加醒目的 NOT-FOR-AGENT 免责声明

### v1.9.0 (2026-04-18)
- 🎬 **叙事引导运镜速查（新章节）**：`cinematography.md` 新增第九节——8种引导/跟随/揭示类运镜（引导后退镜头、背影跟随、侧向平行跟随、低角度贴地跟随、长焦压迫跟随、史诗无人机揭示、遮挡揭示/穿梭镜头、移动环绕），配双语触发词与实例提示词
- 🚁 **史诗级无人机揭示（Epic Drone Reveal）**：升级为独立 Level 1 运镜条目——无人机从主体背后/低位缓慢升起揭示宏大场景；与普通航拍在叙事结构上具有根本性差别
- 🌿 **遮挡揭示/穿梭镜头（Reveal from Behind / Through Shot）**：新增 Level 1 条目，穿越遮挡物（树丛/门框/人群/窗帘）后揭示场景，制造悬念与层次纵深
- 🚶 **引导镜头（Leading Shot）**：新增 Level 1 条目，镜头在主体前方后退引导，强化旅程感与角色主动性
- ⚡ **急推变焦/骤变焦（Snap Zoom / Crash Zoom）**：新增 Level 3 组合——焦距骤变产生爆裂冲击感，适用于喜剧冲击、惊吓强调和 MV 节拍卡点
- 🌀 **移动环绕（Orbit Follow）**：新增 Level 3 组合——主体运动中同步环绕（orbit + tracking），区别于静止主体环绕

### v1.8.5 (2026-04-08)
- 🌐 **Runway 平台适配限制**：明确 Runway 用户专有的资产限制（图片≤5，视频≤3），并提供人脸审查规避方案（模糊化或三渲二重绘）。
- 🎞️ **首尾帧锚定插值**：多模态指南新增第七种参考模式——`首尾关键帧 (Start / End frames)`，支持起点到终点的平滑过渡。
- 🎬 **新增两大特效混剪场景**：
  - `时间静止 / 子弹时间 (Freeze Time)`：摄影机在完全凝固的场景要素间穿梭
  - `多镜头序列混剪 (Multishot Video)`：使用单次混剪覆盖快节奏短片蒙太奇需求

- 🚀 **极限第一人称视角 (Extreme POV)**：新增第 21 类场景模板，覆盖“真实人类视线转移”、“飞行物体穿梭 (飞剑/弓箭)”及“生物模拟飞行”极其动感的视角。
- 🎧 **沉浸感音效排他原则**：为 POV 模板引入强排他环境音指令（仅生成环境音，绝不配 BGM 和台词对白），杜绝 Seedance 随机乱加音乐破坏第一人称实感。
- 🧹 **参考底图防污染法则**：明确在使用图生视频主观视角或角色迁移时，需使用“纯净白底”素材图，防范原背景杂质污染视频环境。

### v1.8.4 (2026-04-08)
- 🔗 **CLI 联动指南**：`seedance-specs.md` 新增即梦 CLI 命令映射（`text2video` / `image2video` / `multiframe2video` / `multimodal2video`），含异步任务管理和 VIP 通道说明
- 🎞️ **多帧故事模板**：新增第20个场景模板「多帧故事（multiframe2video）」——上传2-9张关键帧图片，引擎自动编排为连贯故事视频。含多帧 vs 多段分镜决策矩阵
- 📚 **知识库路由扩展**：Step 2 语义推断表新增多帧故事和 CLI 路由条目

### v1.8.3 (2026-04-08)
- 🎭 **描述性优于叙事性规则**：新增核心规则（#12）——只写镜头看到的（视觉词），不写角色感受的（情绪词）。所有情绪必须转化为可视化身体表现（微表情、肢体语言、呼吸节奏、眼神方向）
- ✍️ **英文动作进行时态**：组装规则强制英文提示词动作使用 -ing 形式（`running` 而非 `runs`），进行时暗示持续运动，更契合视频动态本质
- 🎯 **风格总纲前置运动基调**：提示词开头的风格总纲明确声明整体运动能量（如「动感十足的运动风格」或「静谧缓慢的氛围」），帮助模型生成初期锁定运动基调

### v1.8.2 (2026-04-07)
- 🎥 **一镜一动规则**：新增核心规则（#10），强制每个时间切片只允许一个运镜动作，叠加多个运镜（如"推进+摇摄"）会导致画面抖动。主体运动和镜头运动必须分离描述
- 🖼️ **I2V 黄金法则**：新增核心规则（#11）及 I2V 专项指南——图生视频时只描述运动/变化，不重复首帧已有内容。引入 `保留原始构图和色彩` 锚定短语
- 📏 **提示词最优长度**：新增 60-100 词最佳区间指导——过短画面模糊，超过 100 词易导致概念漂移和指令冲突
- 💪 **运动强度修饰词速查**：运镜词典新增 6 级强度对照表（猛烈→轻柔→渐进）及对比示例，消除"糊动"问题
- 🎤 **节奏词优于技术参数**：组装规则明确优先使用语义节奏词（缓缓/渐进/丝滑）而非技术参数（24fps/f2.8）
- 🎬 **参考视频最佳实践**：新增参考视频实操约束——理想 3-8 秒、连续画面无跳切、单一意图（主体动或镜头动，不要两者混合）

### v1.8.1 (2026-04-07)
- 🛡️ **安全合规优化**：解决 ClawHub OpenClaw “可疑模式”标记问题，将 Python 脚本校验转为 LLM 原生的 7 项结构化校验规则。Python 脚本保留作为独立开发者工具，但 Agent 不再执行代码
- 🎯 **触发词精简优化**：将激活触发词从 40+ 精简至 15 个高信号专业术语，降低误触发概率同时保持核心可发现性

### v1.8.0 (2026-04-05)
- 🎤 **音色与语言控制系统**：新增视频参考音色克隆（`语气和音色参考@视频1`）、方言/口音控制（四川话/粤语/东北话/台湾腔等）、多语言对话混合、特殊音色风格（科普解说/脱口秀/戴曲唱腔/ASMR）
- 📹 **多模态参考指南**：从 4 条简述升级为 6 种核心参考模式的结构化指南（首帧锚定/运镜复刻/动作复刻/运镜+动作分离/音色参考/特效复刻），新增多素材角色控制和一致性保持指导
- 📏 **视频延长专项场景**：新增向前/向后延长模板、接缝平滑技巧、延长时长认知矫正（生成时长=新增秒数而非总时长）
- 📋 **剧情补全场景**：新增分镜脚本图转视频、漫画分格动态演绎、图片情绪发散成视频三种创作模式
- 🎬 **创意特效运镜速查**：新增希区柯克变焦、鱼眼镜头、粒子特效、速度渐变、定格转场、水墨化、变身特效等特效触发词双语速查
- 🎭 **情绪演绎指导**：短剧章节新增情绪具体化对照表、情绪转变触发词、情绪参考视频用法

### v1.7.2 (2026-04-02)
- 🎯 **触发词大幅扩展**：显著提升 Skill 自动激活覆盖率——新增 20+ 中文口语化触发词（帮我写个视频、拍一个、做分镜、短视频、AI视频、抖音视频、vlog、运镜……）和 10+ 英文日常触发词（generate a video、make a clip、shoot a scene、video script、drone shot、camera movement……），使 Skill 在用户日常口语表达下也能自动激活，不再局限于专业术语

### v1.7.1 (2026-03-29)
- 🔒 **安全合规优化**：解决 ClawHub 安全审核中 shell 执行、进程控制、文件访问模式的标记问题，在保持完整功能的同时满足安全合规要求

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 强制组装规则**：光影三层结构必须独占一行且三层完整、音效行必须以`音效：`开头、禁止项标准化不得自行添加、禁止自创非模板段落
- ⛔ **Step 4 校验阻断升级**：未通过校验的提示词禁止向用户展示，明确校验流程 5 步
- 📋 **Step 5 格式硬约束**：必须按模板输出（主题 + 导演阐述 + 代码块包裹提示词），缺少任何区块视为不合格
- 🎯 **Step 2 参数提取指令**：知识库不只是"加载"，必须从中提取具体参数嵌入提示词

### v1.6.0 (2026-03-28)
- 🧠 **智能语义推理路由**：Step 2 知识库加载从"显式触发"升级为三层路由——Always-On 始终加载运镜词典与品质锚定、Semantic Intent Inference 从用户自然语言自动推理所需知识库、Explicit Override 保留用户显式指定
- 🎯 **Step 1 智能推理原则**：Agent 主动从用户一句话中推理参数（时长/风格/场景），仅追问无法推断的信息，追问控制在 1-2 个问题内
- 📝 设计理念更新：从"按需加载"升级为"三层路由加载"，确保每条提示词都有品质基底保障

### v1.5.0 (2026-03-27)
- 🎭 **演员调度体系**：三要素定位（站位+面部朝向+视线焦点）+ 情绪修饰词库，为多角色场景提供编剧级角色调度
- 🎙️ **画外音/对白区分**：对白场景与画外音/内心独白分离模板，画外音场景自带防口型同步指令
- 📐 **拍摄角度具体化**：模糊→具体的角度映射（如"近景"→"过肩中近景，焦点在倾听者"），附5组对照表
- 🎬 **叙事化运镜**：运镜动作绑定叙事动机（如"缓慢推进——揭示内心挣扎"），附5组对照表
- 🔀 **分镜过渡策略**：6种过渡类型（视线连接/情绪递进/反差对切/空间跳转/时间省略/感官桥接），增强多镜头叙事连贯性
- 🎨 **短剧风格快速选择器**：4维度组合（画面类型×渲染风格×色调×题材）快速定义视觉方向
- 📝 短剧提示词模板从1套扩展为4套（中文对白/中文画外音/英文对白/英文画外音）
- 📝 多段分镜导演阐述模板新增分镜过渡策略声明
- 📝 5个完整短剧示例覆盖：反转对白/画外音独白/冲突动作/2D日漫/过渡策略
- ✅ 54项测试全通过

### v1.4.0 (2026-03-21)
- 🎬 **智能多段分镜**：>15秒视频自动拆分为多段独立提示词（每段≤15s，最短≥8s）
- 📝 多段分镜连贯性保障：风格总纲/光影三层/音效风格/交接帧/禁止项统一
- 📝 Step 5 新增多段分镜输出格式模板（中/英文）
- 📝 新增 60秒沙漠 Kali/Escrima 4段分镜完整示例
- 🔧 校验脚本新增 `validate_multi_segment()` 跨段一致性检查
- ✅ 54项测试全通过（含4项新增多段校验测试）

### v1.3.0 (2026-03-21)
- 🌐 **双语提示词输出**：中文用户→中文提示词，非中文用户→英文提示词，自动语言检测
- 📝 所有结构模板、交付格式、多模态技巧新增英文版本
- 🛡️ **运镜术语消歧义（Rule 9）**：中文用中文运镜词，英文用完整短语，避免 Seedance 审核误触发
- 🔧 校验脚本新增 `check_ambiguous_terms()` 裸词检测 + `--lang` 参数 + 英文按词数检测长度
- 🔧 新增 Slow Motion vs Speed Ramp 冲突检测
- 🔧 `detect_language()` 扩展 CJK Extension A + 全角标点支持
- 📚 `cinematography.md` 新增「Seedance 安全写法」列
- ✅ 50项测试全通过（含双语 + 审核安全测试）

### v1.2.0 (2026-03-21)
- 🎨 **三渲二/Cel-Shaded CG 风格**：新增完整四物理轴参数化条目（区别于二次元爆燃的沉稳叙事定位）
- 🧱 **动画化/NPR 材质库**：Anime皮肤/头发/卡通金属/卡通织物，4种非写实材质速查
- 📦 **二次元游戏PV变体**：场景模板新增 Cel-Shaded 子模板 + 冰属性角色示例
- ⚠️ 冲突矩阵新增：三渲二Cel-Shade vs 写实PBR材质
- 🔧 校验脚本新增 Cel-Shade vs PBR 风格冲突检测

### v1.1.0 (2026-03-20)
- 🎬 **运镜升级**：新增焦段叙事心理学、动态对焦范式、物理机位章节（7种特种载具）
- 🎨 **导演风格**：新增芬奇/迪金斯/黑泽明/新海诚 + 二次元爆燃/小红书种草（含去名化安全提示词 + 禁止项）
- 💡 **品质升级**：反塑料感宣言、胶片型号库(5种)、材质质感库(8种)、灯光组合速查(4套)、有机瑕疵库、品质冲突矩阵
- 🎬 **场景扩展**：新增游戏PV/恐怖惊悚/旅行城市/宠物萌系/Before-After/Meme-Loop，总计 16 场景 + 物理阻尼附录
- 🎙️ **音效升级**：空间声学修饰词(7种)、材质拟声精细化(7对)
- 🔧 **校验强化**：废话词 warning→error 硬阻断、光学物理冲突检测、风格冲突矩阵、时长感知时间切片，35项测试全通过

### v1.0.0 (2026-03-19)
- 🎉 首次发布
- SKILL.md 核心工作流
- 6 个专业知识库文件
- Python 校验脚本 + 测试用例
- 20+ 导演风格映射
- 10 大垂直场景模板

---

## 📄 许可

MIT-0 (MIT No Attribution) License

FILE:README.pt.md
[English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | Português | [Français](README.fr.md)

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>Designer de Linguagem Cinematográfica</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="Versão"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="Licença"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="Plataforma"></a>
</p>

<p align="center">
  Transforme suas ideias vagas de vídeo em <strong>prompts cinematográficos profissionais</strong>, prontos para o Jimeng Seedance 2.0 — com um clique.
</p>

Um Claude Skill construído sobre a especificação [Agent Skills](https://agentskills.io), que une a estética cinematográfica de Hollywood com as práticas da indústria audiovisual chinesa. Projetado para ajudar criadores a superar a armadilha do vídeo IA que "fica bonito, mas é aleatório" e alcançar uma **narrativa visual precisa e controlável**.

---

## ✨ Capacidades Principais

| Capacidade | Descrição |
|------------|-----------|
| 🎭 **Produção de Drama Cômico IA & Curta-metragem IA** | Suporte completo para dramas cômicos IA (漫剧) e curtas-metragens IA — diálogos / narração / bloqueio de atores / close-ups de expressões exageradas / movimentos de câmera narrativos / seletor rápido de estilo / 4 variantes de templates (CN/EN × diálogo/narração), com templates de cenários e exemplos completos |
| 🎨 **28+ Presets de Diretores e Estilos** | Nolan / Villeneuve / Fincher / Deakins / Kurosawa / Makoto Shinkai / Wong Kar-wai / Zhang Yimou / Xianxia / Cel-Shaded CG / Anime / Xiaohongshu… |
| 🎬 **Dicionário Profissional de Movimentos de Câmera** | Sistema de câmera em 3 níveis + 14 distâncias focais + 6 controles de foco + 7 montagens físicas, com referências bilíngues CN/EN |
| 💡 **Estrutura de Iluminação em Três Camadas** | Fonte de Luz → Comportamento → Tom de Cor — chega de "bota uma luz aí" |
| 📐 **Storyboard com Marcação Temporal** | `0-3s / 3-8s / …` controle preciso da timeline para evitar sangramento visual entre planos |
| 🎯 **Montagem de Seis Elementos** | Sujeito / Ação / Cena / Iluminação / Câmera / Som — fórmula estruturada de alta conversão |
| 🎬 **Storyboard Multi-Segmento Inteligente** | Vídeos >15s divididos automaticamente em segmentos independentes com estilo, iluminação, som unificados e transições seamless |
| 📦 **17 Templates de Cenários** | E-commerce / Xianxia / Curta / Gastronomia / MV / Plano-sequência / Automotivo / Macro / Natureza / Game PV / Terror / Viagem / Pets / Transformação / Loop / Edição de Vídeo / Extensão de Vídeo / Complemento de História / Narração Multiframe |
| 🎵 **Vocabulário de Som e ASMR** | Biblioteca de onomatopeias baseada em física: ambiental / ação / vocal / música |
| 🌐 **Saída Bilíngue de Prompts** | Usuários chineses → chinês / demais → inglês, detecção automática |
| 🛡️ **Proteção de PI Segura** | Estratégia progressiva de recuo de PI em três níveis para evitar bloqueios |
| 🔍 **Validação Rigorosa Estruturada** | Contagem de palavras / câmera / lógica temporal / enchimento / conflitos ópticos / matriz de conflitos de estilo |

---

## 🚀 Início Rápido

### 1. Instalar o Skill

<details>
<summary><b>Claude Code</b></summary>

Coloque a pasta `seedance-shot-design/` em `.claude/skills/` na raiz do projeto:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

O Claude Code detectará e carregará o Skill automaticamente.
</details>

<details>
<summary><b>OpenClaw</b></summary>

No seu app de mensagens conectado (WeChat, Feishu, etc.), envie ao Agent do OpenClaw:

```
Por favor, aprenda este skill: https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

O Agent baixará e aprenderá o skill automaticamente.
</details>

<details>
<summary><b>Codex</b></summary>

Coloque a pasta do Skill no diretório de instrução de agents do Codex:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```
</details>

<details>
<summary><b>Cursor</b></summary>

Coloque a pasta do Skill em `.cursor/skills/` na raiz do projeto:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```
</details>

### 2. Uso

Basta dizer ao Claude:

```
Escreva um prompt de vídeo de 15 segundos de uma perseguição na chuva cyberpunk
```

O Skill ativa automaticamente e gera o prompt em 5 etapas:
1. **Análise de Requisitos** — Confirmar duração / proporção / assets / estilo
2. **Diagnóstico Visual** — Selecionar linguagem de câmera e estilo de direção
3. **Montagem de Seis Elementos** — Composição precisa segundo a fórmula
4. **Validação Obrigatória** — Aplicar checklist estruturada de 7 regras
5. **Entrega Profissional** — Declaração do diretor + prompt completo

### 3. Exemplos

#### Demonstração Completa

**Entrada do usuário:**
```
Escreva um prompt de vídeo de 10 segundos para um curta de fantasia oriental Xianxia
```

**Saída do Skill:**

> **Prompt de Vídeo Seedance**
>
> **Tema**: Um jovem de branco apanha uma folha vermelha ao amanhecer num templo ancestral, alcançando a iluminação
>
> **Declaração do Diretor** (apenas para contexto criativo — não copiar):
> Progressão de câmera: aérea → dolly → empurrão lento. O grão de filme 35mm acrescenta textura artesanal, e a paleta dourado-azulada reflete a harmonia com a natureza.
>
> **Prompt Completo** (copiar diretamente no Jimeng):

```
10 segundos de fantasia chinesa, estética cinematográfica oriental realista, paleta dourado-azulada, som ambiente etéreo.
0-3s: Plano zenital aéreo de um templo entre nuvens, empurrão aéreo lento, neblina matinal nos vales, sino distante, raios Tyndall atravessando nuvens.
3-7s: Dolly pelo portão do templo até o pátio, jovem de branco apanha folha vermelha que cai, grão 35mm, profundidade de campo reduzida na mão.
7-10s: Close-up do jovem levantando o olhar, empurrão lento, vento levanta mangas e cabelo para a direita, luz espiritual subindo em espiral.
Som: Ambiente converge num toque de espada cristalino.
Proibido: Texto, legendas, logos ou marcas d'água
```

#### Mais Casos de Uso

```
# Drama Cômico IA
Prompt de 10s estilo cômico IA de CEO dominador, vertical 9:16, com diálogos e close-ups exagerados

# Anúncio E-commerce
Prompt de vídeo publicitário de relógio de luxo de 8s, 9:16 vertical

# Curta com Diálogos
Prompt de 12s de cena de curta com reviravolta e diálogos

# Plano-sequência
Prompt de 15s de passeio por museu em plano-sequência

# Com Referências
Enviei 3 imagens de personagens e 1 vídeo de referência — gere uma cena de luta Xianxia de 15s
```

---

## 📁 Estrutura do Projeto

```
seedance-shot-design/
├── SKILL.md                     # Instruções principais (o cérebro do Skill)
├── README.md                    # Este arquivo
├── scripts/
│   ├── validate_prompt.py       # Script de validação industrial
│   └── test_validate.py         # Casos de teste
└── references/
    ├── cinematography.md        # Dicionário de câmera e distâncias focais
    ├── director-styles.md       # Mapeamento de estilos de direção (28+)
    ├── seedance-specs.md        # Especificações oficiais Seedance 2.0
    ├── quality-anchors.md       # Âncoras de qualidade e iluminação
    ├── scenarios.md             # 20 templates de cenários verticais
    └── audio-tags.md            # Tags de áudio e efeitos sonoros
```

---

## 🔬 Script de Validação

Ferramenta Python independente, via linha de comando:

```bash
python scripts/validate_prompt.py --text "seu prompt"
python scripts/validate_prompt.py --file prompt.txt
python scripts/validate_prompt.py --text "your prompt" --lang en
python scripts/validate_prompt.py --text "seu prompt" --json
```

**Verificações:**
- ❌ Excesso de palavras (Chinês >500 caracteres / Inglês >1000 palavras)
- ❌ Terminologia profissional de câmera ausente
- ❌ Bloqueio duro de enchimento (masterpiece / obra-prima / ultra-nítido → error)
- ❌ Conflitos óptico-físicos (ultra grande-angular+bokeh, câmera na mão+simetria perfeita)
- ❌ Matriz de conflitos de estilo (IMAX vs VHS, filme vs digital, tinta vs UE5, Cel-Shaded vs PBR, Câmera Lenta vs Speed Ramp)
- ❌ Overflow de assets (imagens >9 / vídeos >3 / áudio >3 / total >12)
- ❌ Vídeo longo (>5s) sem divisão temporal → bloqueio
- ⚠️ Lacunas ou sobreposições na divisão temporal
- ⚠️ Descompasso duração declarada vs ponto final do segmento
- ⚠️ Conflitos de lógica de movimento no segmento
- ⚠️ Termos de câmera em inglês soltos (Dolly / Aerial / Crane / Pan / Arc / Dutch / Steadicam)
- 🌐 Detecção automática de idioma (chinês / inglês)
- 🎬 Consistência entre múltiplos segmentos

**Executar Testes:**
```bash
python -m unittest scripts.test_validate -v
# 54 testes passam (11 classes de teste)
```

---

## 🏗️ Filosofia de Design

### Carregamento Progressivo de Conhecimento

- **SKILL.md** (~4000 tokens): Fluxo principal + templates + checklist
- **references/** (sob demanda): Lidos apenas quando necessário
- **scripts/** (ferramenta independente para desenvolvedores — NÃO executada pelo agente): Apenas para desenvolvedores e pipelines CI/CD. O agente valida com sua checklist nativa LLM de 7 regras

### Vantagens Competitivas

| Dimensão | Comum | Este Skill |
|----------|-------|------------|
| Validação | Sugestões em texto | **Validação rigorosa estruturada de 7 regras (óptica/estilo + segurança)** |
| Estilos | Diretores internacionais | **Internacional + Chinês + Curta + IA + SNS + Anime + Cel-Shaded + Xiaohongshu** |
| Cenários | Cinema épico | **17 verticais + anime + edição + amortecimento físico** |
| Som | Menções breves | **Acústica espacial + onomatopeias por material** |
| Iluminação | "Bota uma luz" | **Fonte→Comportamento→Tom + receitas + materiais** |
| Multilíngue | Apenas chinês | **Bilíngue CN/EN, detecção automática** |
| Segurança na revisão | Não considerado | **Desambiguação de termos + detecção de palavras soltas** |

---

## 📋 Histórico de Versões

### v1.9.1 (2026-04-21)
- 🛡️ **Conformidade de Segurança (Rodada 3)**: Resolvido o flag "Suspicious" do ClawHub OpenClaw — sincronizada a descrição do Step 4 nos READMEs ja/ko/es/pt/fr (de "executar script Python" para "checklist estruturada de 7 regras"); removidas todas as associações com "Python" nas tabelas de capacidades e comparativas; adicionado `execution: none` no SKILL.md; adicionados disclaimers NOT-FOR-AGENT nos scripts Python

### v1.9.0 (2026-04-18)
- 🎬 **Referência Rápida de Planos Narrativos Guia (novo capítulo)**: Nova Seção IX em `cinematography.md` — 8 tipos de planos de guia/seguimento/revelação (Leading Shot, Following Shot, Side Tracking, Low Angle Follow, Long Lens Follow, Epic Drone Reveal, Reveal Through, Orbit Follow), com frases-gatilho bilíngues e prompts de exemplo
- 🚁 **Epic Drone Reveal**: Adicionado como movimento de câmera Level 1 independente — ascensão lenta de trás/ângulo baixo revelando a paisagem épica; estrutura narrativa distinta dos planos aéreos genéricos
- 🌿 **Reveal from Behind / Through Shot**: Nova entrada Level 1 para planos de penetração de obstáculos (câmera empurrando por bambu/multidão/cortina para revelar), com guia de frases seguras
- 🚶 **Leading Shot**: Nova entrada Level 1 para movimento de câmera que recua à frente do sujeito, transmitindo jornada e agência do protagonista
- ⚡ **Snap Zoom / Crash Zoom**: Adicionado a combos Level 3 — salto explosivo de distância focal para impacto cômico, ênfase de susto e sincronização de beat MV
- 🌀 **Orbit Follow**: Adicionado a combos Level 3 — combinação orbit + tracking onde o ponto pivô se move com o sujeito, distinto das órbitas de sujeito estático

### v1.8.5 (2026-04-08)
- 🌐 **Adaptação à Plataforma Runway**: Limites de recursos especificados para usuários do Runway (≤5 imagens, ≤3 vídeos) e estratégias explícitas para contornar a moderação de rostos humanos realistas (desfoque ou estilos NPR).
- 🎞️ **Interpolação de Quadro Inicial e Final**: Adicionado o 7º padrão de referência multimodal (`@Image1 as start frame, @Image2 as end frame`) para transições precisas de ponto a ponto.
- 🎬 **Dois Novos Cenários de Efeitos**:
  - `Freeze Time (Tempo Congelado)`: A câmera se move dramaticamente por elementos de cena completamente congelados.
  - `Multishot Video (Vídeo Multi-Telas)`: Contorna a limitação "take único", fazendo o modelo gerar cortes rápidos de montagem em uma única execução.

- 🚀 **Cenários de POV Extremo**: Adicionado o 21º template de cenário focado na "lógica de rastreamento da cabeça humana", "FPV de projéteis em alta velocidade (espadas/flechas voadoras)" e "voo de criaturas".
- 🎧 **Exclusão de Áudio Imersivo**: Introduzidas diretivas estritas de exclusão de áudio para templates de POV (SOMENTE som ambiente, NENHUM BGM ou diálogo) para impedir que a IA quebre a imersão.
- 🧹 **Regra de Purificação de Fundo**: Esclarecido que as imagens de entidades de referência devem usar um "fundo branco puro/vazio" para evitar contaminar o ambiente de vídeo na geração da Imagem para o Vídeo.

### v1.8.4 (2026-04-08)
- 🔗 **Guia de integração CLI**: Nova seção em `seedance-specs.md` com mapeamento de comandos CLI do Jimeng (`text2video` / `image2video` / `multiframe2video` / `multimodal2video`), gerenciamento de tarefas assíncronas e documentação de canais VIP
- 🎞️ **Template de narrativa multiframe**: Novo template de cenário (#20) para `multiframe2video` — envie 2-9 imagens de quadros-chave e o motor compõe automaticamente um vídeo narrativo coerente
- 📚 **Roteamento da base de conhecimento**: Adicionadas entradas de roteamento multiframe e CLI à tabela de inferência semântica do Passo 2

### v1.8.3 (2026-04-08)
- 🎭 **Regra Descritivo > Narrativo**: Nova regra central (#12) — escrever apenas o que a câmera VÊ (palavras visuais), nunca o que o personagem SENTE (palavras emocionais). Todas as emoções devem ser convertidas em expressões físicas visíveis
- ✍️ **Inglês Progressivo**: Regras de montagem exigem forma -ing para ações em inglês (`running` não `runs`) — o progressivo implica movimento contínuo
- 🎯 **Tom de Movimento Antecipado**: O preâmbulo de estilo declara a energia de movimento geral (`dynamic motion` / `serene atmosphere`), fixando a base de movimento no início

### v1.8.2 (2026-04-07)
- 🎥 **Regra Um-Plano-Um-Movimento**: Nova regra central (#10) — um único movimento de câmera por segmento temporal. Combinar movimentos (ex: push-in + pan) causa tremura. Movimento do sujeito e da câmera devem ser descritos separadamente
- 🖼️ **Regra de Ouro I2V**: Nova regra central (#11) e seção I2V dedicada — ao gerar vídeo a partir de imagem, descrever apenas movimento/mudanças, nunca re-descrever conteúdo estático do primeiro frame. Introduz frase âncora `preserve composition and colors`
- 📏 **Comprimento Ótimo do Prompt**: Guia de ponto ideal 60-100 palavras — abaixo é vago, acima de 100 causa deriva conceitual e instruções conflitantes
- 💪 **Modificadores de Intensidade de Movimento**: Nova tabela bilíngue com 6 níveis de intensidade (violento → suave → gradual) e exemplos Do/Don't para eliminar "movimento pastoso"
- 🎤 **Ritmo sobre Especificações**: Regras de montagem preferem explicitamente palavras de ritmo semântico (gentle/gradual/smooth) sobre parâmetros técnicos (24fps/f2.8)
- 🎬 **Melhores Práticas para Vídeo de Referência**: Restrições práticas — ideal 3-8s, plano contínuo (sem cortes), intenção única (sujeito OU câmera)

### v1.8.1 (2026-04-07)
- 🛡️ **Conformidade de Segurança**: Resolvido o flag "padrões suspeitos" do ClawHub OpenClaw — validação Python convertida para checklist estruturada de 7 regras LLM-nativas. Scripts Python mantidos como ferramentas de desenvolvimento independentes
- 🎯 **Otimização de Frases Ativadoras**: Triggers reduzidos de 40+ para 15 termos profissionais de alto sinal

### v1.8.0 (2026-04-05)
- 🎤 **Sistema de Controle de Voz e Idioma**: Clonagem de timbre por referência de vídeo, controle de dialeto/sotaque, mistura de diálogos multilíngue, estilos vocais especiais (documentário/comédia/ópera/ASMR)
- 📹 **Guia de Referência Multimodal**: Atualização de 4 dicas para 6 padrões de referência core (primeiro frame/câmera/ação/câmera+ação/timbre/efeitos)
- 📏 **Cenário de Extensão de Vídeo**: Templates de extensão para frente/trás, técnicas de continuação seamless, correção cognitiva de duração
- 📋 **Cenário de Completude de História**: Storyboard→vídeo, animação de painéis, imagem→vídeo emocional
- 🎬 **Referência Rápida de Efeitos Criativos**: Keywords VFX — zoom Hitchcock, olho de peixe, partículas, speed ramp, transição freeze, tinta nanquim, morphing
- 🎭 **Guia de Performance Emocional**: Tabela de especificidade emocional, triggers de transição emocional, uso de vídeo de referência emocional

### v1.7.2 (2026-04-02)
- 🎯 **Expansão de Palavras Ativadoras**: 20+ triggers chineses e 10+ ingleses para expressões cotidianas ("faça um vídeo", "criar clip", "movimento de câmera")

### v1.7.1 (2026-03-29)
- 🔒 **Otimização de Segurança**: Resolvidos flags de segurança do ClawHub mantendo funcionalidade completa

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 Regras de Montagem Obrigatórias**: Iluminação de 3 camadas em linha própria/linha SFX padronizada/itens proibidos unificados/seções não-template proibidas
- ⛔ **Step 4 Bloqueio de Validação**: Prompts reprovados na validação não são mostrados ao usuário
- 📋 **Step 5 Formato Obrigatório**: Template de saída Tema+Nota do Diretor+bloco de código
- 🎯 **Step 2 Extração de Parâmetros**: Não apenas "carregar" bases de conhecimento mas extrair e inserir parâmetros específicos

### v1.6.0 (2026-03-28)
- 🧠 **Roteamento Semântico Inteligente**: Step 2 de "trigger explícito"→roteamento de 3 camadas — carregamento permanente/inferência semântica/especificação explícita
- 🎯 **Step 1 Inferência Inteligente**: Inferência ativa de parâmetros a partir de uma frase, perguntas limitadas a 1-2

### v1.5.0 (2026-03-27)
- 🎭 **Sistema de Bloqueio de Atores**: Posicionamento de 3 elementos (posição + direção facial + foco do olhar) + vocabulário de modificadores emocionais
- 🎙️ **Separação Narração/Diálogo**: Templates distintos para diálogos vs. narração/monólogo interior, com diretiva anti-lip-sync
- 📐 **Especificidade do Ângulo de Câmera**: Mapeamento vago→específico com 5 pares comparativos
- 🎬 **Movimento de Câmera com Motivação Narrativa**: Movimentos emparelhados com propósito narrativo
- 🔀 **Estratégia de Transição entre Segmentos**: 6 tipos de transição para coerência multi-plano
- 🎨 **Seletor Rápido de Estilo**: Combo de 4 dimensões (tipo visual × estilo de render × tom × gênero)
- 📝 Templates de curta expandidos de 1 para 4 variantes (CN/EN × diálogo/narração)
- 📝 5 exemplos completos de curta-metragem
- ✅ 54 testes passam

### v1.4.0 (2026-03-21)
- 🎬 **Storyboard Multi-Segmento Inteligente**: Vídeos >15s auto-divididos (cada ≤15s, mín ≥8s)
- 📝 Coerência multi-segmento unificada
- 📝 Template de saída multi-segmento (CN / EN)
- 📝 Exemplo 60s deserto Kali/Escrima 4 segmentos
- 🔧 `validate_multi_segment()` consistência entre segmentos
- ✅ 54 testes passam

### v1.3.0 (2026-03-21)
- 🌐 **Saída Bilíngue**: Chinês→chinês, outros→inglês, detecção automática
- 🛡️ **Desambiguação de Câmera (Regra 9)**
- 🔧 `check_ambiguous_terms()` + `--lang` + contagem por palavras
- ✅ 50 testes passam

### v1.2.0 (2026-03-21)
- 🎨 **Cel-Shaded CG**: Registro parametrizado em 4 eixos
- 🧱 **Materiais Anime/NPR**: 4 materiais não fotorrealistas
- ✅ Conflito Cel-Shade vs PBR

### v1.1.0 (2026-03-20)
- 🎬 Psicologia focal, foco dinâmico, 7 montagens especiais
- 🎨 Fincher / Deakins / Kurosawa / Shinkai + Anime + Xiaohongshu
- 💡 Anti-plástico, filmes, texturas, iluminação, imperfeições orgânicas
- 🎬 6 novos cenários (total 16) + amortecimento físico
- 🔧 Enchimento→error, conflitos ópticos/estilo, 35 testes

### v1.0.0 (2026-03-19)
- 🎉 Primeiro lançamento

---

## 📄 Licença

MIT-0 (MIT No Attribution) License

FILE:README.ko.md
[English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | 한국어 | [Español](README.es.md) | [Português](README.pt.md) | [Français](README.fr.md)

<p align="center">
  <img src="assets/logo.svg" width="128" height="128" alt="Seedance Shot Design Logo">
</p>

<h1 align="center">Seedance2.0 Shot Design</h1>

<p align="center">
  <strong>시네마틱 샷 언어 디자이너</strong>
</p>

<p align="center">
  <a href=""><img src="https://img.shields.io/badge/version-1.9.1-blue.svg" alt="버전"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT--0-green.svg" alt="라이선스"></a>
  <a href=""><img src="https://img.shields.io/badge/platform-Seedance_2.0-purple.svg" alt="플랫폼"></a>
</p>

<p align="center">
  막연한 영상 아이디어를 즉멍 Seedance 2.0에서 바로 사용할 수 있는 <strong>영화급 비디오 프롬프트</strong>로 원클릭 변환.
</p>

[Agent Skills](https://agentskills.io) 규격에 기반하여 구축된 Claude Skill입니다. 할리우드 최고 수준의 촬영 미학과 중국 영상 산업의 실무 노하우를 융합하여, 크리에이터가 "예쁜데 랜덤"한 AI 영상의 한계를 극복하고 **정밀하고 제어 가능한 비주얼 스토리텔링**을 구현할 수 있도록 설계되었습니다.

---

## ✨ 핵심 기능

| 기능 | 설명 |
|------|------|
| 🎭 **AI 만화 드라마 & 숏드라마 제작** | AI 만화 드라마(漫剧)와 AI 숏드라마의 풀 파이프라인 지원 — 캐릭터 대사 / 나레이션 / 배우 블로킹 / 과장 표정 클로즈업 / 내러티브 동기 카메라워크 / 숏드라마 스타일 퀵셀렉터 / 4종 프롬프트 템플릿(CN/EN×대사/나레이션), 전용 시나리오 템플릿 및 완전한 예시 포함 |
| 🎨 **28+ 감독 & 스타일 프리셋** | 놀란 / 빌뇌브 / 핀처 / 디킨스 / 구로사와 / 신카이 마코토 / 왕가위 / 장예모 / 선협 / 셀셰이딩CG / 애니메이션 / 샤오홍슈… |
| 🎬 **프로 카메라워크 사전** | 3단계 카메라 체계 + 14개 초점거리 + 6가지 포커스 컨트롤 + 7가지 물리적 마운트, 중영 대조 참조 |
| 💡 **3계층 라이팅 구조** | 광원층→광행동층→색조층 — "조명 하나 추가"는 이제 그만 |
| 📐 **타임스탬프 스토리보드** | `0-3초 / 3-8초 / …` 정밀한 타임라인 제어로 샷 간 번짐 방지 |
| 🎯 **6요소 정밀 조립** | 피사체 / 동작 / 장면 / 라이팅 / 카메라 / 사운드 — 구조화된 고전환율 공식 |
| 🎬 **스마트 다중 세그먼트 스토리보드** | 15초 초과 영상 자동 분할, 스타일·라이팅·사운드 통일, 심리스 트랜지션 프레임 |
| 📦 **20개 시나리오 템플릿** | 이커머스 / 선협 / 숏드라마 / 먹방 / MV / 원테이크 / 자동차 / 매크로 / 자연 / 게임PV / 공포 / 여행 / 반려동물 / 변신 / 루프 / 영상 편집 / 영상 연장 / 스토리 보완 / 멀티프레임 스토리 |
| 🎵 **사운드 & ASMR 어휘집** | 물리 기반 의성어 라이브러리: 환경음 / 액션 / 보컬 / 악기 |
| 🌐 **이중 언어 프롬프트 출력** | 중국어 사용자→중국어 / 그 외→영어 프롬프트, 자동 감지 |
| 🛡️ **저작권 안전 IP 회피** | 3단계 점진적 IP 회피 전략으로 플랫폼 콘텐츠 차단 방지 |
| 🔍 **구조화 하드 검증** | 글자 수 / 카메라워크 / 시계열 로직 / 군더더기 감지 / 광학 물리 충돌 / 스타일 충돌 매트릭스 — "제안"보다 확실 |

---

## 🚀 빠른 시작

### 1. Skill 설치

<details>
<summary><b>Claude Code</b></summary>

`seedance-shot-design/` 폴더를 프로젝트 루트의 `.claude/skills/` 아래에 배치합니다:

```bash
# 프로젝트의 Skill 디렉토리에 클론
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .claude/skills/seedance-shot-design
```

Claude Code가 자동으로 Skill을 감지하고 로드합니다.
</details>

<details>
<summary><b>OpenClaw</b></summary>

연동된 IM 앱(위챗, 페이슈 등)에서 OpenClaw Agent에게 메시지를 보냅니다:

```
이 스킬을 학습해 주세요: https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills
```

Agent가 자동으로 Seedance Shot Design 스킬을 가져와 학습합니다. 바로 요청을 시작할 수 있습니다.
</details>

<details>
<summary><b>Codex</b></summary>

Skill 폴더를 Codex의 agents 지시 디렉토리에 배치합니다:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git agents/skills/seedance-shot-design
```

Codex 대화에서 호출할 수 있습니다.
</details>

<details>
<summary><b>Cursor</b></summary>

Skill 폴더를 프로젝트 루트의 `.cursor/skills/` 아래에 배치합니다:

```bash
git clone https://github.com/woodfantasy/Seedance2.0-ShotDesign-Skills.git .cursor/skills/seedance-shot-design
```

Cursor Agent 모드에서 자동으로 Skill 지시를 읽어들입니다.
</details>

### 2. 사용법

Claude에게 이렇게 말하기만 하면 됩니다:

```
15초짜리 사이버펑크 폭우 추격전 비디오 프롬프트를 작성해 주세요
```

Skill이 자동 활성화되어 5단계 워크플로로 프롬프트를 생성합니다:
1. **요구 분석** — 길이 / 화면 비율 / 소재 / 스타일 확인
2. **비주얼 진단** — 카메라 언어 & 감독 스타일 선정
3. **6요소 조립** — 구조화된 공식에 따라 정밀 작성
4. **필수 검증** — 7항 구조화 체크리스트로 품질 리뷰 수행
5. **프로 납품** — 감독 스테이트먼트 + 완성 프롬프트

### 3. 예시

#### 전체 인터랙션 데모

**사용자 입력:**
```
10초짜리 동방 선협 단편 영상 비디오 프롬프트를 작성해 주세요
```

**Skill 출력:**

> **Seedance 비디오 프롬프트**
>
> **테마**: 새벽 안개 자욱한 고사에서 백의 소년이 단풍잎을 받아들고 깨달음을 얻는 장면
>
> **감독 스테이트먼트** (창작 의도 이해용 — 복사 불필요):
> 항공촬영→돌리→슬로우 푸시의 3단계 카메라워크로, 장대한 풍경에서 친밀한 감정으로 전환.
> 35mm 필름 그레인이 수공예적 질감을 더하고, 금청 색조가 동양의 '자연과의 조화' 철학을 구현.
>
> **완성 프롬프트** (즉멍 입력창에 직접 복사):

```
10초 중국풍 판타지, 사실적인 동양 영화 감성, 금청 컬러 팔레트, 공명하는 앰비언트 사운드.
0-3초: 구름 바다 속 고사를 고각도 항공 촬영, 슬로우 항공 푸시, 새벽 안개가 계곡을 흐르고, 멀리서 종소리가 희미하게 울리며, 틴들 광선이 구름층을 관통.
3-7초: 돌리로 사문을 통과해 안뜰로, 백의 소년이 손을 들어 떨어지는 단풍잎을 받아들고, 35mm 필름 그레인 질감, 얕은 피사계 심도로 손 디테일에 포커스.
7-10초: 소년이 눈을 드는 클로즈업, 슬로우 푸시인, 바람이 일어나 소매와 머리카락이 프레임 오른쪽으로 나부끼고, 안뜰에서 영광이 나선형으로 상승.
사운드: 환경음이 수렴하여 맑고 청아한 검명 한 줄기로.
금지: 모든 텍스트, 자막, 로고, 워터마크
```

#### 더 많은 활용 사례

```
# AI 만화 드라마
10초짜리 AI 만화 스타일 재벌 CEO 숏폼, 세로 9:16, 대사와 과장된 클로즈업 포함

# 이커머스 광고
8초짜리 고급 시계 제품 광고 비디오 프롬프트, 9:16 세로

# 숏드라마 대사
12초짜리 반전 숏드라마 장면, 대사 포함

# 원테이크
15초짜리 원테이크 박물관 산책 비디오 프롬프트

# 참고 소재 포함
캐릭터 디자인 이미지 3장과 참고 영상 1편 업로드 완료 — 15초짜리 선협 액션 장면 생성해 줘
```

---

## 📁 프로젝트 구조

```
seedance-shot-design/
├── SKILL.md                     # 핵심 지시 (Skill의 두뇌)
├── README.md                    # 본 파일
├── scripts/
│   ├── validate_prompt.py       # 산업 수준 프롬프트 검증 스크립트
│   └── test_validate.py         # 검증 스크립트 테스트 케이스
└── references/
    ├── cinematography.md        # 카메라 & 초점거리 사전 (물리적 마운트 & 초점거리 심리학 포함)
    ├── director-styles.md       # 감독 스타일 파라미터화 매핑 (28+ 스타일, 셀셰이딩CG 포함)
    ├── seedance-specs.md        # Seedance 2.0 공식 플랫폼 사양
    ├── quality-anchors.md       # 품질 앵커 & 라이팅 라이브러리 (NPR 소재/라이팅/충돌 매트릭스 포함)
    ├── scenarios.md             # 수직 시나리오 템플릿 (17개 시나리오 + 애니메이션 변형 + 영상 편집 + 물리 댐핑 툴킷)
    └── audio-tags.md            # 오디오 & 음향 효과 태그 사양 (공간 음향 & 소재 기반 의성어 포함)
```

---

## 🔬 검증 스크립트

커맨드 라인에서 단독 사용 가능한 Python 검증 도구:

```bash
# 텍스트 직접 검증
python scripts/validate_prompt.py --text "프롬프트"

# 파일에서 검증
python scripts/validate_prompt.py --file prompt.txt

# 언어 지정 (auto=자동 감지, cn=중국어, en=영어)
python scripts/validate_prompt.py --text "your prompt" --lang en

# JSON 형식 출력 (프로그램 처리용)
python scripts/validate_prompt.py --text "프롬프트" --json
```

**검증 항목:**
- ❌ 글자 수 초과 (중국어 >500자 / 영어 >1000단어)
- ❌ 전문 카메라 용어 누락
- ❌ 군더더기 표현 하드 블록 (masterpiece / 걸작 / 초선명 등 → error)
- ❌ 광학 물리 충돌 (초광각+보케, 핸드헬드+완벽한 대칭)
- ❌ 스타일 충돌 매트릭스 (IMAX vs VHS, 필름 vs 디지털, 수묵 vs UE5, 셀셰이딩 vs 리얼PBR, 슬로우모션 vs 스피드램프)
- ❌ 에셋 참조 초과 (이미지 >9 / 영상 >3 / 오디오 >3 / 합계 >12)
- ❌ 장편 영상 (>5초) 타임슬라이스 없이 하드 블록
- ⚠️ 타임슬라이스 갭 또는 중복
- ⚠️ 선언 길이와 슬라이스 시간 끝점 불일치
- ⚠️ 세그먼트 내 모션 로직 충돌
- ⚠️ Seedance 심사 위험: 베어 영어 카메라 용어 감지 (Dolly / Aerial / Crane / Pan / Arc / Dutch / Steadicam)
- 🌐 자동 언어 감지 (중국어 / 영어), 언어별 길이 기준 & 감지 전략 적용
- 🎬 다중 세그먼트 간 일관성 검사 (스타일 총칙 / 라이팅 구조 / 금지 항목)

**테스트 실행:**
```bash
python -m unittest scripts.test_validate -v
# 54개 테스트 전체 통과 (11개 테스트 클래스 커버)
```

---

## 🏗️ 설계 철학

### 점진적 지식 로딩 (Progressive Disclosure)

Agent Skills 모범 사례 준수:

- **SKILL.md** (~4000 토큰): 핵심 워크플로 + 구조 템플릿 + 품질 체크리스트
- **references/** (온디맨드 로딩): 스타일 / 카메라 / 품질 관련 니즈가 언급될 때만 읽기
- **scripts/** (독립 개발자 도구 — Agent는 실행하지 않음): 개발자와 CI/CD 파이프라인 전용. Agent는 내장 LLM 네이티브 7항 체크리스트로 검증

### 경쟁 우위

| 비교 축 | 일반적 접근 | 본 Skill |
|---------|------------|----------|
| 컴플라이언스 검증 | 일반 텍스트 제안 | **구조화 하드 검증 (7항 규칙, 광학/스타일 충돌 매트릭스 + 심사 안전 감지 포함)** |
| 감독 스타일 | 해외 유명 감독만 | **국제 + 중국 + 숏드라마 + AI 만화 + SNS + 애니메이션 + 셀셰이딩CG + 샤오홍슈** |
| 장면 커버리지 | 대작 영화 편중 | **17개 수직 시나리오 + 애니메이션 변형 + 영상 편집 + 물리 댐핑 툴킷** |
| 사운드 디자인 | 간단한 언급 | **공간 음향 + 소재 기반 의성어 라이브러리** |
| 라이팅 | "조명 추가" | **광원→행동→색조 3계층 + 라이팅 레시피 + 소재 라이브러리** |
| 다국어 | 중국어만 | **중국어/영어 이중 출력, 자동 언어 감지** |
| 심사 안전성 | 미고려 | **카메라 용어 중의성 해소 규칙 + 베어워드 자동 감지** |

---

## 📋 변경 이력

### v1.9.1 (2026-04-21)
- 🛡️ **보안 준수 (제3회)**: ClawHub OpenClaw "의심 패턴" 플래그 해결 — ja/ko/es/pt/fr README의 Step 4 설명을 동기 수정 ("Python 스크립트 실행"→"7항 구조화 체크리스트"); 모든 로케일의 기능표·경쟁 비교에서 "Python" 관련 표현 제거; SKILL.md에 `execution: none` 메타데이터 추가; Python 스크립트에 NOT-FOR-AGENT 면책사항 추가

### v1.9.0 (2026-04-18)
- 🎬 **내러티브 가이드 카메라워크 속차 (신규 챕터)**: `cinematography.md` 제IX절 신설 — 8종 리딩/팔로잉/리빌 샷(리딩샷·팔로잉샷·사이드트래킹·로앵글팔로우·장초점압박팔로우·에픽드론리빌·장애물리빌·이동오빗), 이중언어 트리거워드 및 예시 포함
- 🚁 **에픽 드론 리빌 (Epic Drone Reveal)**: 독립 Level 1 카메라 무브로 격상 — 피사체 뒤/저위에서 천천히 상승하며 장대한 경관 공개; 일반 항공촬영과 근본적으로 다른 서사 구조
- 🌿 **장애물 리빌/스루샷 (Reveal / Through Shot)**: 신규 Level 1 — 장애물(대나무숲/문/군중/커튼)을 통과해 장면 공개, 서스펜스와 레이어 깊이감 연출
- 🚶 **리딩샷 (Leading Shot)**: 신규 Level 1 — 카메라가 피사체 앞에서 후퇴하며 가이드, 여정감과 주인공 능동성 강화
- ⚡ **스냅줌/크래시줌 (Snap Zoom / Crash Zoom)**: Level 3 콤보 추가 — 초점거리 급변으로 폭발적 충격감, 코미디·놀람 강조·MV 비트싱크에 활용
- 🌀 **이동 오빗 (Orbit Follow)**: Level 3 콤보 추가 — 피사체 이동에 맞춰 오빗 중심점이 함께 이동하는 orbit+tracking 복합기

### v1.8.5 (2026-04-08)
- 🌐 **Runway 플랫폼 호환**: Runway 사용자를 위한 에셋 제한(이미지 최대 5장, 비디오 최대 3개)을 명시하고, 사실적인 사람 얼굴에 대한 중재를 우회하기 위한 명확한 전략(블러 처리 또는 NPR 스타일 적용)을 제공합니다.
- 🎞️ **시작 및 끝 프레임 보간**: 정밀한 전환을 지원하기 위해 7번째 멀티모달 참조 패턴(`@Image1 as start frame, @Image2 as end frame`)을 추가했습니다.
- 🎬 **두 가지 새로운 효과 시나리오**:
  - `Freeze Time(타임 프리즈)`: 완전히 멈춘 장면 요소 사이를 카메라가 극적으로 통과합니다.
  - `Multishot Video(멀티샷 비디오)`: "원테이크" 제한을 우회하여 한 번의 생성으로 날카로운 몽타주 컷을 자동 생성합니다.

- 🚀 **극한 1인칭 시점 (Extreme POV)**: 새로운 21번째 시나리오 템플릿 추가. "인간의 시선 이동 논리", "초고속 비행 물체 FPV (검/화살)", "생물 비행" 커버.
- 🎧 **몰입감 오디오 배제 원칙**: POV 템플릿에 엄격한 환경음 배제 지시어 도입 (환경음만 생성, BGM 및 대사 절대 금지). AI가 부적절한 음악을 추가하여 몰입을 방해하는 것을 방지.
- 🧹 **배경 정화 규칙**: 이미지-투-비디오 생성 중 참조 이미지가 비디오 환경을 오염시키지 않도록 하려면 반드시 "순백색/빈 배경"의 에셋 이미지를 사용해야 함을 명시.

### v1.8.4 (2026-04-08)
- 🔗 **CLI 연동 가이드**: `seedance-specs.md`에 즉몽 CLI 명령 매핑 추가(`text2video` / `image2video` / `multiframe2video` / `multimodal2video`), 비동기 작업 관리 및 VIP 채널 설명 포함
- 🎞️ **멀티프레임 스토리 템플릿**: 제20 시나리오 템플릿 「멀티프레임 스토리(multiframe2video)」추가 — 2-9장의 키프레임 이미지를 업로드하면 엔진이 자동으로 일관된 스토리 비디오 구성
- 📚 **지식 베이스 라우팅 확장**: Step 2 의미 추론 테이블에 멀티프레임 및 CLI 라우팅 항목 추가

### v1.8.3 (2026-04-08)
- 🎭 **기술적 > 서술적 규칙**：새 핵심 규칙(#12) — 카메라가 "보이는 것"만 작성(시각어), 캐릭터가 "느끼는 것" 작성 금지(감정어). 모든 감정은 시각화된 신체 표현으로 변환
- ✍️ **영어 현재진행형**：영어 프롬프트 동작에 -ing 형식 의무화(`running` not `runs`) — 진행형은 지속적 움직임을 암시
- 🎯 **모션 톤 전치**：스타일 프리앨블에서 운동 에너지 선언(`dynamic motion` / `serene atmosphere`), 생성 초기에 운동 기조 락

### v1.8.2 (2026-04-07)
- 🎥 **원샷원무브 규칙**: 새 핵심 규칙(#10) — 타임 세그먼트당 카메라 동작 1개 제한. 복합 운동(예: 푸시인+패닝) 조합시 화면 떨림 발생. 피사체 운동과 카메라 운동은 반드시 분리 기술
- 🖼️ **I2V 골든 룰**: 새 핵심 규칙(#11) 및 I2V 전용 가이드 — 이미지→비디오 생성 시 동작/변화만 기술, 첫 프레임의 정적 콘텐츠 재기술 금지. `preserve composition and colors` 앵커 문구 도입
- 📏 **프롬프트 최적 길이**: 60-100 단어 최적 구간 가이드 추가 — 짧으면 모호, 100단어 초과 시 개념 드리프트 및 지시 충돌
- 💪 **운동 강도 수식어 속차**: 카메라 사전에 6단계 강도 대조표(맹렬→부드러움→점진) + Do/Don't 예시 추가, "뭉개짐" 해소
- 🎤 **리듬 워드 우선**: 조립 규칙에서 의미 리듬어(gentle/gradual/smooth)를 기술 파라미터(24fps/f2.8)보다 명시적 우선
- 🎬 **참조 영상 최적화**: 참조 클립 실전 제약 — 이상적 3-8초, 연속 촬영(점프컷 없음), 단일 의도(피사체 OR 카메라)

### v1.8.1 (2026-04-07)
- 🛡️ **보안 준수**: ClawHub OpenClaw "의심 패턴" 플래그 해결 — Python 검증을 LLM 네이티브 7항 구조화 체크리스트로 변환. Python 스크립트는 독립 개발 도구로 유지
- 🎯 **트리거 문구 최적화**: 활성화 트리거를 40+에서 15개 고신호 전문 용어로 축소, 오활성화 억제

### v1.8.0 (2026-04-05)
- 🎤 **음성·언어 제어 시스템**: 영상 참조 음색 클론, 방언/억양 제어, 다국어 대화 믹싱, 특수 음성 스타일(다큐/코미디/오페라/ASMR)
- 📹 **멀티모달 참조 가이드**: 4요점→6종 코어 참조 패턴 업그레이드(첫프레임/카메라복제/동작복제/카메라+동작분리/음색참조/이펙트복제)
- 📏 **영상 연장 시나리오**: 순방향/역방향 연장 템플릿, 시맨틱 연결 기법, 생성 시간 인지 교정
- 📋 **스토리 보완 시나리오**: 스토리보드→영상, 만화 프레임 애니메이션, 이미지→감정 영상 3가지 창작 모드
- 🎬 **크리에이티브 이펙트 속차**: VFX 트리거 키워드 — 히치콕 줌, 피쉬아이, 파티클, 스피드 램프, 프리즈 전환, 수묵화, 모핑
- 🎭 **감정 연기 가이드**: 감정 구체화 표, 감정 전환 트리거 워드, 감정 참조 영상 활용

### v1.7.2 (2026-04-02)
- 🎯 **트리거 워드 확장**: 일상적 표현("영상 만들어줘", "클립 생성", "카메라워크" 등)으로 자동 활성화되는 20+ 중국어·10+ 영어 트리거 추가

### v1.7.1 (2026-03-29)
- 🔒 **보안 준수 최적화**: ClawHub 보안 플래그 문제 해결, 전체 기능 유지

### v1.7.0 (2026-03-28)
- 🚨 **Step 3 필수 조립 규칙**: 3계층 라이팅 독립행/음효행 표준화/금지항목 통일/비템플릿 단락 금지
- ⛔ **Step 4 검증 차단**: 검증 불합격 프롬프트의 사용자 표시 금지
- 📋 **Step 5 포맷 강제**: 테마+감독노트+코드블록 래핑 출력 템플릿
- 🎯 **Step 2 파라미터 추출 지시**: 지식 베이스 "로딩"이 아닌 구체 파라미터 추출·삽입 의무화

### v1.6.0 (2026-03-28)
- 🧠 **스마트 시맨틱 라우팅**: Step 2를 "명시 트리거"→3계층 라우팅 업그레이드 — 상시 로딩/의미 추론/명시 지정
- 🎯 **Step 1 스마트 추론 원칙**: 한 문장에서 파라미터 능동 추론, 질문 1-2개로 제한

### v1.5.0 (2026-03-27)
- 🎭 **배우 블로킹 시스템**: 3요소 포지셔닝(배치+얼굴 방향+시선 초점) + 감정 수식어 어휘집으로 다중 캐릭터 장면에 각본가 수준의 캐릭터 조율 제공
- 🎙️ **나레이션/대사 분리**: 현장 대사와 나레이션/내면 독백 분리 템플릿, 나레이션 장면에 립싱크 방지 지시 포함
- 📐 **촬영 각도 구체화**: 모호→구체 각도 매핑(예: "클로즈업"→"오버숄더 중근경, 청자에 초점"), 5쌍 비교표 포함
- 🎬 **내러티브 동기 부여 카메라워크**: 카메라 동작과 서사 목적 연결(예: "슬로우 푸시인 — 내면 갈등 드러내기"), 5쌍 비교표 포함
- 🔀 **세그먼트 전환 전략**: 6가지 전환 유형(시선 연속/감정 고조/대비 컷/공간 도약/시간 생략/감각 브리지)으로 다중 샷 일관성 강화
- 🎨 **숏드라마 스타일 퀵셀렉터**: 4차원 콤보(영상 유형×렌더링 스타일×색조×장르)
- 📝 숏드라마 프롬프트 템플릿 1종→4종 확장(CN 대사/CN 나레이션/EN 대사/EN 나레이션)
- 📝 다중 세그먼트 감독 노트에 전환 전략 선언 추가
- 📝 5개 완전한 숏드라마 예시: 반전 대사/나레이션 독백/충돌 액션/2D 일본 애니/전환 전략
- ✅ 54개 테스트 통과

### v1.4.0 (2026-03-21)
- 🎬 **스마트 다중 세그먼트 스토리보드**: 15초 초과 영상 자동 분할 (각 ≤15초, 최소 ≥8초)
- 📝 다중 세그먼트 일관성: 스타일 총칙 / 3계층 라이팅 / 사운드 디자인 / 트랜지션 프레임 / 금지 항목 통일
- 📝 Step 5에 다중 세그먼트 출력 포맷 템플릿 추가 (중/영)
- 📝 60초 사막 Kali/Escrima 4세그먼트 전체 예시 신규 추가
- 🔧 검증 스크립트에 `validate_multi_segment()` 세그먼트 간 일관성 검사 추가
- ✅ 54개 테스트 통과 (신규 다중 세그먼트 검증 테스트 4개 포함)

### v1.3.0 (2026-03-21)
- 🌐 **이중 언어 프롬프트 출력**: 중국어 사용자→중국어, 비중국어→영어, 자동 언어 감지
- 📝 모든 구조 템플릿·납품 포맷·멀티모달 팁에 영어 버전 추가
- 🛡️ **카메라 용어 중의성 해소 (Rule 9)**: 중국어는 중국어 카메라 용어, 영어는 전체 구문 사용 — Seedance 심사 오탐 방지
- 🔧 검증에 `check_ambiguous_terms()` 베어워드 감지 + `--lang` 플래그 + 영어 단어 수 길이 체크 추가
- 🔧 슬로우모션 vs 스피드램프 충돌 감지 신규 추가
- 🔧 `detect_language()` CJK Extension A + 전각 구두점 지원 확장
- 📚 `cinematography.md`에 "Seedance 안전 표기" 열 추가
- ✅ 50개 테스트 통과 (이중 언어 + 심사 안전 테스트 포함)

### v1.2.0 (2026-03-21)
- 🎨 **셀셰이딩 CG 스타일**: 완전한 4축 파라미터화 항목 신규 추가 (애니메이션의 폭발적 에너지와 구별 — 정적 내러티브 포지셔닝)
- 🧱 **애니메이션/NPR 소재 라이브러리**: 애니메이션 피부 / 머리카락 / 카툰 메탈 / 카툰 패브릭 — 4종 비사실적 소재
- 📦 **애니메이션 게임PV 변형**: 시나리오 템플릿에 셀셰이딩 서브 템플릿 + 얼음 속성 캐릭터 예시 추가
- ⚠️ 충돌 매트릭스 추가: 셀셰이딩 vs 리얼 PBR 소재
- 🔧 검증에 셀셰이딩 vs PBR 스타일 충돌 감지 추가

### v1.1.0 (2026-03-20)
- 🎬 **카메라 업그레이드**: 초점거리 내러티브 심리학, 다이나믹 포커스 패러다임, 물리적 마운트 장 (7종 특수 리그) 신규 추가
- 🎨 **감독 스타일**: 핀처 / 디킨스 / 구로사와 / 신카이 마코토 + 애니메이션 폭발 / 샤오홍슈 감성 (탈명화 안전 프롬프트 + 금지 항목 포함) 신규 추가
- 💡 **품질 업그레이드**: 안티 플라스틱 선언, 필름 스톡 라이브러리 (5종), 소재 텍스처 라이브러리 (8종), 라이팅 콤보 퀵 레퍼런스 (4세트), 유기적 불완전성 라이브러리, 품질 충돌 매트릭스
- 🎬 **장면 확장**: 게임PV / 공포·스릴러 / 여행·도시 / 반려동물·귀여움 / 비포어-애프터 / Meme-Loop 신규 추가, 총 16개 시나리오 + 물리 댐핑 부록
- 🎙️ **사운드 업그레이드**: 공간 음향 수식어 (7종), 소재 기반 의성어 정교화 (7쌍)
- 🔧 **검증 강화**: 군더더기 표현 warning→error 하드 블록, 광학 물리 충돌 감지, 스타일 충돌 매트릭스, 길이 인식 타임슬라이싱, 35개 테스트 통과

### v1.0.0 (2026-03-19)
- 🎉 최초 릴리스
- SKILL.md 핵심 워크플로
- 6개 전문 지식 베이스 파일
- Python 검증 스크립트 + 테스트 케이스
- 20+ 감독 스타일 매핑
- 10개 수직 시나리오 템플릿

---

## 📄 라이선스

MIT-0 (MIT No Attribution) License

FILE:assets/logo.svg
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
  <defs>
    <!-- Background gradient -->
    <radialGradient id="bg" cx="50%" cy="50%" r="55%">
      <stop offset="0%" stop-color="#1a2332"/>
      <stop offset="100%" stop-color="#0d1117"/>
    </radialGradient>
    <!-- Gold-Teal gradient for viewfinder frame -->
    <linearGradient id="frame" x1="0%" y1="0%" x2="100%" y2="100%">
      <stop offset="0%" stop-color="#C9A84C"/>
      <stop offset="50%" stop-color="#7ECEC1"/>
      <stop offset="100%" stop-color="#4ECDC4"/>
    </linearGradient>
    <!-- Inner lens glow -->
    <radialGradient id="lens" cx="50%" cy="50%" r="50%">
      <stop offset="0%" stop-color="#4ECDC4" stop-opacity="0.6"/>
      <stop offset="60%" stop-color="#1a3a4a" stop-opacity="0.3"/>
      <stop offset="100%" stop-color="#0d1117" stop-opacity="0"/>
    </radialGradient>
    <!-- Sparkle glow -->
    <radialGradient id="sparkle" cx="50%" cy="50%" r="50%">
      <stop offset="0%" stop-color="#C9A84C" stop-opacity="1"/>
      <stop offset="100%" stop-color="#C9A84C" stop-opacity="0"/>
    </radialGradient>
  </defs>

  <!-- Background circle -->
  <rect width="128" height="128" rx="24" fill="url(#bg)"/>

  <!-- Viewfinder frame (rounded rect outline) -->
  <rect x="24" y="30" width="80" height="60" rx="6"
        fill="none" stroke="url(#frame)" stroke-width="2.5" opacity="0.9"/>

  <!-- Corner brackets (director's viewfinder marks) -->
  <!-- Top-left -->
  <path d="M28 42 L28 35 L35 35" fill="none" stroke="#C9A84C" stroke-width="2" stroke-linecap="round"/>
  <!-- Top-right -->
  <path d="M100 42 L100 35 L93 35" fill="none" stroke="#C9A84C" stroke-width="2" stroke-linecap="round"/>
  <!-- Bottom-left -->
  <path d="M28 78 L28 85 L35 85" fill="none" stroke="#4ECDC4" stroke-width="2" stroke-linecap="round"/>
  <!-- Bottom-right -->
  <path d="M100 78 L100 85 L93 85" fill="none" stroke="#4ECDC4" stroke-width="2" stroke-linecap="round"/>

  <!-- Center crosshair (focus point) -->
  <line x1="60" y1="60" x2="68" y2="60" stroke="#7ECEC1" stroke-width="1" opacity="0.6"/>
  <line x1="64" y1="56" x2="64" y2="64" stroke="#7ECEC1" stroke-width="1" opacity="0.6"/>

  <!-- Lens glow in center -->
  <circle cx="64" cy="60" r="14" fill="url(#lens)"/>

  <!-- Aperture blades hint (3 arcs) -->
  <path d="M56 53 A12 12 0 0 1 64 48" fill="none" stroke="#4ECDC4" stroke-width="1" opacity="0.4"/>
  <path d="M72 53 A12 12 0 0 1 76 60" fill="none" stroke="#4ECDC4" stroke-width="1" opacity="0.3"/>
  <path d="M68 70 A12 12 0 0 1 56 67" fill="none" stroke="#7ECEC1" stroke-width="1" opacity="0.35"/>

  <!-- AI Sparkles (gold particles) -->
  <circle cx="96" cy="24" r="3" fill="url(#sparkle)"/>
  <circle cx="106" cy="30" r="1.8" fill="#C9A84C" opacity="0.7"/>
  <circle cx="100" cy="18" r="1.2" fill="#C9A84C" opacity="0.5"/>

  <!-- Small 4-point star sparkle -->
  <path d="M96 21 L96.6 23.4 L99 24 L96.6 24.6 L96 27 L95.4 24.6 L93 24 L95.4 23.4 Z"
        fill="#C9A84C" opacity="0.8"/>

  <!-- Timeline bar at bottom -->
  <line x1="30" y1="100" x2="98" y2="100" stroke="#4ECDC4" stroke-width="1.5" opacity="0.4" stroke-linecap="round"/>
  <!-- Timeline ticks -->
  <circle cx="30" cy="100" r="2" fill="#C9A84C" opacity="0.7"/>
  <circle cx="52" cy="100" r="2" fill="#7ECEC1" opacity="0.6"/>
  <circle cx="75" cy="100" r="2" fill="#7ECEC1" opacity="0.6"/>
  <circle cx="98" cy="100" r="2" fill="#4ECDC4" opacity="0.7"/>

  <!-- Timeline labels (subtle) -->
  <text x="30" y="112" font-family="monospace" font-size="6" fill="#4ECDC4" opacity="0.5" text-anchor="middle">0s</text>
  <text x="52" y="112" font-family="monospace" font-size="6" fill="#4ECDC4" opacity="0.4" text-anchor="middle">5s</text>
  <text x="75" y="112" font-family="monospace" font-size="6" fill="#4ECDC4" opacity="0.4" text-anchor="middle">10s</text>
  <text x="98" y="112" font-family="monospace" font-size="6" fill="#4ECDC4" opacity="0.5" text-anchor="middle">15s</text>
</svg>

FILE:scripts/validate_prompt.py
#!/usr/bin/env python3
# ============================================================================
# ⚠️  STANDALONE DEVELOPER TOOL — NOT EXECUTED BY THE AI AGENT
# ============================================================================
# This script is a standalone validation tool for developers and CI/CD
# pipelines. The AI agent performs equivalent validation using its built-in
# LLM-native 7-rule checklist and does NOT import or execute this file.
# ============================================================================
"""
Seedance 2.0 提示词工业级校验模块
供 Agent 在生成提示词后进行自动化质量审查。

用法（函数调用）:
    from validate_prompt import validate_prompt
    result = validate_prompt("你的提示词内容")
    # result["passed"] == True 表示校验通过
"""

import re
import json


# Seedance 为中国自研模型，同时支持中英文提示词


def detect_language(text):
    """检测提示词语言：中文字符占比超30%则为中文，否则为英文。
    覆盖 CJK Unified (U+4E00–U+9FFF)、CJK Extension A (U+3400–U+4DBF)、
    CJK 符号与标点 (U+3000–U+303F)、全角标点 (U+FF00–U+FFEF)。
    """
    def is_cjk(c):
        cp = ord(c)
        return (
            0x4E00 <= cp <= 0x9FFF or    # CJK Unified Ideographs
            0x3400 <= cp <= 0x4DBF or    # CJK Extension A
            0x3000 <= cp <= 0x303F or    # CJK Symbols and Punctuation
            0xFF00 <= cp <= 0xFFEF       # Fullwidth Forms
        )
    chinese_chars = sum(1 for c in text if is_cjk(c))
    total_chars = max(len(text.strip()), 1)
    return "cn" if chinese_chars / total_chars > 0.3 else "en"


def check_length(text, lang="cn"):
    """检查提示词长度是否合规（中文≤500字符 / 英文≤1000词）"""
    results = []

    if lang == "cn":
        length = len(text)
        max_len = 500
        unit = "字符"
    else:
        length = len(text.split())
        max_len = 1000
        unit = "words"

    if length > max_len:
        results.append({
            "level": "error",
            "code": "LENGTH_EXCEEDED",
            "message": f"长度超标！当前 {length} {unit}，上限 {max_len} {unit}。"
                       f"模型注意力会严重衰减，请删减形容词并合并长句。",
            "value": length,
            "limit": max_len
        })
    elif length > max_len * 0.85:
        results.append({
            "level": "warning",
            "code": "LENGTH_NEAR_LIMIT",
            "message": f"长度接近上限：{length}/{max_len} {unit} "
                       f"({length/max_len*100:.0f}%)。建议适当精简。",
            "value": length,
            "limit": max_len
        })
    else:
        results.append({
            "level": "pass",
            "code": "LENGTH_OK",
            "message": f"长度合规：{length}/{max_len} {unit}。",
            "value": length,
            "limit": max_len
        })
    return results


def _detect_declared_duration(text):
    """从提示词中提取声明的时长（秒）"""
    patterns = [
        r'(\d+)\s*秒',
        r'(\d+)\s*[sS](?:ec|econds?)?(?:\s|，|,|$)',
    ]
    durations = []
    for pat in patterns:
        for m in re.finditer(pat, text[:60]):  # 时长声明通常在开头
            durations.append(int(m.group(1)))
    return max(durations) if durations else 0


def check_time_slices(text):
    """检查时序切片逻辑（时长感知版）"""
    results = []
    # 匹配多种时间戳格式: [0-3s], [0-3秒], 0-3s：, 0-3秒：
    patterns = [
        r'\[(\d+)-(\d+)s\]',
        r'\[(\d+)-(\d+)秒\]',
        r'(\d+)-(\d+)s[：:·]',
        r'(\d+)-(\d+)秒[：:·]',
        r'(\d+)-(\d+)s\s*[：:]',
        r'(\d+)-(\d+)秒\s*[：:]',
    ]

    all_slices = []
    for pattern in patterns:
        matches = re.findall(pattern, text)
        for m in matches:
            start, end = int(m[0]), int(m[1])
            all_slices.append((start, end))

    # 去重
    all_slices = sorted(set(all_slices))
    declared_duration = _detect_declared_duration(text)

    if not all_slices:
        # 时长感知：>5s 无时间切片为 error，≤5s 为 warning
        if declared_duration > 5:
            results.append({
                "level": "error",
                "code": "LONG_VIDEO_NO_SLICES",
                "message": f"声明时长 {declared_duration}秒 但未使用时间切片！"
                           f"超过5秒的视频必须使用时序切片（如 0-3秒：...；3-7秒：...），"
                           f"否则画面动作会揉作一团。"
            })
        else:
            results.append({
                "level": "warning",
                "code": "NO_TIME_SLICES",
                "message": "未检测到时序切片（如 [0-3s] 或 0-3秒：）。"
                           "若生成长视频(>5s)，画面动作极易粘连崩坏。"
            })
    else:
        # 检查时间段是否有重叠
        for i in range(len(all_slices) - 1):
            if all_slices[i][1] > all_slices[i + 1][0]:
                results.append({
                    "level": "warning",
                    "code": "TIME_OVERLAP",
                    "message": f"时间段重叠：[{all_slices[i][0]}-{all_slices[i][1]}s] "
                               f"与 [{all_slices[i+1][0]}-{all_slices[i+1][1]}s]。"
                })

        # 检查起始是否从0开始
        if all_slices[0][0] != 0:
            results.append({
                "level": "warning",
                "code": "TIME_NOT_FROM_ZERO",
                "message": f"时间戳未从0开始，首段为 [{all_slices[0][0]}-{all_slices[0][1]}s]。"
            })

        # 检查声明时长与切片末端是否匹配
        if declared_duration > 0:
            last_end = all_slices[-1][1]
            if abs(last_end - declared_duration) > 2:
                results.append({
                    "level": "warning",
                    "code": "DURATION_MISMATCH",
                    "message": f"声明时长 {declared_duration}秒，但时间切片结束于 {last_end}秒，"
                               f"差距 {abs(last_end - declared_duration)}秒。请检查是否遗漏时间段。"
                })

        if not results:
            results.append({
                "level": "pass",
                "code": "TIME_SLICES_OK",
                "message": f"检测到 {len(all_slices)} 个时间段，时序逻辑正常。"
            })

    return results


def check_camera_language(text):
    """检查是否包含专业运镜指令"""
    results = []
    camera_words_cn = [
        "特写", "广角", "跟拍", "摇", "推", "拉", "升降", "环绕",
        "航拍", "俯拍", "仰拍", "平移", "跟踪", "手持", "云台",
        "斯坦尼康", "穿越机", "微距", "一镜到底", "慢镜头",
        "全景", "近景", "中景", "远景", "浅景深"
    ]
    camera_words_en = [
        "close-up", "wide", "tracking", "dolly", "pan", "tilt",
        "crane", "orbit", "aerial", "pov", "handheld", "steadicam",
        "zoom", "push", "pull", "arc", "gimbal", "fpv", "macro",
        "slow motion", "low angle", "high angle", "dutch",
        "shot", "mm"  # 如 85mm, 50mm
    ]

    text_lower = text.lower()
    found_cn = [w for w in camera_words_cn if w in text]
    found_en = [w for w in camera_words_en if w in text_lower]

    if not found_cn and not found_en:
        results.append({
            "level": "error",
            "code": "NO_CAMERA_LANGUAGE",
            "message": "缺乏专业运镜指令。画面将随机生成，如同监控探头。"
                       "请添加具体的运镜术语（如 Dolly In, 航拍, Tracking Shot）。"
        })
    else:
        all_found = found_cn + found_en
        results.append({
            "level": "pass",
            "code": "CAMERA_OK",
            "message": f"检测到 {len(all_found)} 个运镜术语：{', '.join(all_found[:5])}"
                       f"{'...' if len(all_found) > 5 else ''}。"
        })
    return results


def check_cgi_words(text):
    """检查是否包含易产生 AI 塑料感的废话（硬阻断）"""
    results = []
    # 硬黑名单：直接阻断（error），这些词无任何合理使用场景
    banned_hard = {
        "cn": ["超清晰", "杰作", "高画质", "超高画质", "超精细",
               "极致画质", "完美画质"],
        "en": ["masterpiece", "ultra-sharp", "best quality",
               "extremely detailed", "hyper-realistic",
               "ultra hd", "super resolution"]
    }
    # 软警告：4k/8k 在品质锚定语境下可能有意义，仅作警告
    soft_warn = ["4k", "8k", "4K", "8K"]

    found_hard = []
    found_soft = []
    text_lower = text.lower()

    for word_list in banned_hard.values():
        for w in word_list:
            if w.lower() in text_lower:
                found_hard.append(w)

    for w in soft_warn:
        if w in text:
            found_soft.append(w)

    if found_hard:
        results.append({
            "level": "error",
            "code": "BANNED_WORDS_DETECTED",
            "message": f"❌ 检测到廉价 AI 塑料感词汇：{', '.join(found_hard)}。"
                       f"请立即使用 quality-anchors.md 中的胶片型号/材质质感/有机瑕疵进行替换！"
        })
    if found_soft:
        results.append({
            "level": "warning",
            "code": "RESOLUTION_WORDS",
            "message": f"检测到分辨率词汇：{', '.join(found_soft)}。"
                       f"若用于品质锚定（如配合渲染引擎声明）可保留，否则建议移除。"
        })

    if not found_hard and not found_soft:
        results.append({
            "level": "pass",
            "code": "CGI_WORDS_CLEAN",
            "message": "未检测到AI塑料感废话词汇。"
        })
    return results


def check_asset_refs(text):
    """检查多模态资产引用是否超限"""
    results = []
    img_refs_cn = re.findall(r'@图片(\d+)', text)
    img_refs_en = re.findall(r'@image(\d+)', text, re.IGNORECASE)
    vid_refs_cn = re.findall(r'@视频(\d+)', text)
    vid_refs_en = re.findall(r'@video(\d+)', text, re.IGNORECASE)
    aud_refs_cn = re.findall(r'@音频(\d+)', text)
    aud_refs_en = re.findall(r'@audio(\d+)', text, re.IGNORECASE)

    # 中英文引用分别匹配，用 set() 按数字去重（如 @Image1 和 @image1 只计一次）
    img_count = len(set(img_refs_cn + img_refs_en))
    vid_count = len(set(vid_refs_cn + vid_refs_en))
    aud_count = len(set(aud_refs_cn + aud_refs_en))
    total = img_count + vid_count + aud_count

    if img_count > 9:
        results.append({
            "level": "error",
            "code": "IMAGE_REF_EXCEEDED",
            "message": f"图片引用超限：{img_count}/9。"
        })
    if vid_count > 3:
        results.append({
            "level": "error",
            "code": "VIDEO_REF_EXCEEDED",
            "message": f"视频引用超限：{vid_count}/3。"
        })
    if aud_count > 3:
        results.append({
            "level": "error",
            "code": "AUDIO_REF_EXCEEDED",
            "message": f"音频引用超限：{aud_count}/3。"
        })
    if total > 12:
        results.append({
            "level": "error",
            "code": "TOTAL_REF_EXCEEDED",
            "message": f"混合文件总数超限：{total}/12（图片{img_count}+视频{vid_count}+音频{aud_count}）。"
        })

    if not results:
        if total > 0:
            results.append({
                "level": "pass",
                "code": "ASSET_REFS_OK",
                "message": f"资产引用合规：图片{img_count}/9，视频{vid_count}/3，"
                           f"音频{aud_count}/3，总计{total}/12。"
            })
        else:
            results.append({
                "level": "pass",
                "code": "NO_ASSET_REFS",
                "message": "纯文本模式，无资产引用。"
            })
    return results


def check_conflict(text):
    """检查运动冲突 + 光学物理冲突 + 风格冲突"""
    results = []

    # === 运动逻辑冲突（按时间段分割检查） ===
    motion_conflicts = [
        (["快速", "高速", "急速", "fast", "rapid"],
         ["慢动作", "slow motion", "慢镜头", "缓慢"],
         "速度冲突：快速与慢动作同段出现"),
        (["推进", "push in", "dolly in", "zoom in"],
         ["拉远", "pull out", "dolly out", "zoom out"],
         "运动冲突：推进与拉远同段出现"),
    ]

    segments = re.split(r'\d+-\d+[s秒][：:；;]?', text)
    for seg in segments:
        seg_lower = seg.lower()
        for group_a, group_b, desc in motion_conflicts:
            has_a = any(w in seg_lower for w in group_a)
            has_b = any(w in seg_lower for w in group_b)
            if has_a and has_b:
                results.append({
                    "level": "warning",
                    "code": "MOTION_CONFLICT",
                    "message": f"同一段内{desc}。"
                               f"模型接收矛盾信号会导致画面撕裂或果冻效应。"
                })
                break

    # === 光学物理冲突（全文检查） ===
    optical_conflicts = [
        (["14mm", "ultra-wide", "超广角", "ultra wide"],
         ["bokeh", "浅景深", "虚化", "奶油般", "creamy bokeh", "shallow depth"],
         "光学冲突！超广角(14mm)物理上无法产生强烈背景虚化，会造成 AI 渲染崩溃。请修改焦段或景深描述"),
        (["手持", "handheld", "手持晃动", "手持微晃"],
         ["绝对对称", "perfectly symmetrical", "完美对称", "严格对称"],
         "构图冲突！手持晃动不可能保持绝对对称构图，请选择三脚架/云台或放弃对称"),
    ]

    text_lower = text.lower()
    for group_a, group_b, desc in optical_conflicts:
        has_a = any(w in text_lower for w in group_a)
        has_b = any(w in text_lower for w in group_b)
        if has_a and has_b:
            results.append({
                "level": "error",
                "code": "OPTICAL_CONFLICT",
                "message": f"❌ {desc}。"
            })

    # === 风格冲突矩阵（全文检查） ===
    style_conflicts = [
        (["imax", "65mm清晰", "65mm", "imax清晰"],
         ["vhs", "录像带", "scan lines", "扫描线", "低分辨率"],
         "品质冲突！IMAX极致清晰与VHS模拟降解不可混用，请二选一"),
        (["胶片颗粒", "film grain", "有机噪点", "胶片质感"],
         ["锐利数码", "sharp digital", "电商质感", "锐利电商"],
         "品质冲突！胶片有机颗粒与锐利数码质感互斥——电商禁胶片，影片禁数码锐"),
        (["水墨", "ink wash", "宣纸", "写意", "水墨画"],
         ["ue5", "unreal engine", "光追", "ray tracing", "写实渲染"],
         "风格冲突！水墨写意与UE5写实光追互斥，若要融合请用'3D渲染水墨质感'"),
        (["cel-shad", "toon render", "卡通渲染", "三渲二", "cel shad",
          "赛璐璐", "cel-shaded", "toon渲染"],
         ["subsurface scattering", "sss透光", "皮肤毛孔", "visible pores",
          "micro-imperfections", "微瑕疵", "写实皮肤", "realistic skin"],
         "风格冲突！三渲二/Cel-Shade卡通渲染与写实PBR材质(SSS/毛孔/微瑕疵)互斥——"
         "三渲二应使用动画化材质（硬边阴影+色块填充），不要叠加写实材质词"),
        (["slow motion", "慢镜头", "慢动作"],
         ["speed ramp", "变速"],
         "速度冲突！Slow Motion 慢镜头与 Speed Ramp 变速不可在同一时间切片内同时使用——"
         "请分时间切片使用，慢镜和变速不在同段重叠"),
    ]

    for group_a, group_b, desc in style_conflicts:
        has_a = any(w in text_lower for w in group_a)
        has_b = any(w in text_lower for w in group_b)
        if has_a and has_b:
            results.append({
                "level": "error",
                "code": "STYLE_CONFLICT",
                "message": f"❌ {desc}。"
            })

    if not results:
        results.append({
            "level": "pass",
            "code": "NO_CONFLICT",
            "message": "未检测到逻辑/光学/风格冲突。"
        })
    return results


def check_ambiguous_terms(text, lang="cn"):
    """检测可能触发 Seedance 审核的裸英文运镜术语（可被误判为人名/品牌名）"""
    results = []
    # 高风险裸词：可作为人名/品牌名
    high_risk = {
        "Dolly": "推轨推进 / dolly tracking shot",
        "Aerial": "航拍 / aerial drone shot",
        "Crane": "摇臂升降 / crane shot",
        "Pan": "水平摇摄 / pan shot",
        "Arc": "弧形环绕 / arc shot",
        "Dutch": "荷兰角倾斜 / dutch angle shot",
        "Steadicam": "斯坦尼康稳定 / steadicam stabilized shot",
    }
    # 安全后缀：如果裸词后面紧跟这些词，说明上下文明确，风险降低
    safe_suffixes = [
        "shot", "camera", "movement", "drone", "tracking",
        "angle", "stabilized", "jib", "in", "out", "up", "down",
        "left", "right", "zoom", "back", "forward"
    ]

    found = []
    for bare_word, safe_alt in high_risk.items():
        # 用正则查找裸词（前后非英文字母，不区分大小写）
        pattern = r'(?<![a-zA-Z])' + re.escape(bare_word) + r'(?![a-zA-Z])'
        matches = list(re.finditer(pattern, text, re.IGNORECASE))
        for m in matches:
            # 检查后面是否有安全后缀
            after = text[m.end():m.end()+20].strip().lower()
            has_safe_suffix = any(after.startswith(s) for s in safe_suffixes)
            if not has_safe_suffix:
                found.append((bare_word, safe_alt))
                break  # 每个裸词只报一次

    if found:
        if lang == "cn":
            word_list = ", ".join(f"`{w}`" for w, _ in found)
            alt_list = "; ".join(f"{w}→{a.split(' / ')[0]}" for w, a in found)
            results.append({
                "level": "warning",
                "code": "AMBIGUOUS_CAMERA_TERM",
                "message": f"检测到裸英文运镜词 {word_list}，"
                           f"Seedance 可能误判为人名而触发违规。"
                           f"建议改用中文：{alt_list}"
            })
        else:
            word_list = ", ".join(f"`{w}`" for w, _ in found)
            alt_list = "; ".join(f"{w}→{a.split(' / ')[1]}" for w, a in found)
            results.append({
                "level": "warning",
                "code": "AMBIGUOUS_CAMERA_TERM",
                "message": f"Bare camera terms {word_list} detected — "
                           f"Seedance may flag these as person names. "
                           f"Use full phrases: {alt_list}"
            })
    else:
        results.append({
            "level": "pass",
            "code": "NO_AMBIGUOUS_TERMS",
            "message": "未检测到审核风险裸英文运镜词。"
        })
    return results


def validate_multi_segment(segments, lang=None):
    """校验多段分镜提示词：逐段独立校验 + 跨段一致性检查。
    segments: list of str, 每段提示词文本。
    """
    if not segments:
        return {"passed": False, "error": "无提示词段落"}

    if lang is None:
        lang = detect_language(segments[0])

    per_segment = []
    for i, seg in enumerate(segments):
        result = validate_prompt(seg, lang=lang)
        result["segment"] = i + 1
        per_segment.append(result)

    # === 跨段一致性检查 ===
    cross_results = []

    # 1. 风格总纲一致：比较每段的第一行（去除时长前缀后）
    first_lines = []
    for seg in segments:
        line = seg.strip().split('\n')[0] if seg.strip() else ""
        first_lines.append(line)

    if len(set(first_lines)) > 1:
        cross_results.append({
            "level": "warning",
            "code": "INCONSISTENT_STYLE_ANCHOR",
            "message": "跨段一致性警告：各段首行风格总纲不一致。"
                       "多段分镜应使用相同的风格/色调总纲句以确保视觉连贯。"
        })

    # 2. 光影结构一致：检测包含「光影」或「Lighting」的行
    def extract_lighting(text):
        for line in text.strip().split('\n'):
            if '光影' in line or 'Lighting' in line or 'lighting' in line:
                return line.strip()
        return ""

    lighting_lines = [extract_lighting(seg) for seg in segments]
    non_empty = [l for l in lighting_lines if l]
    if non_empty and len(set(non_empty)) > 1:
        cross_results.append({
            "level": "warning",
            "code": "INCONSISTENT_LIGHTING",
            "message": "跨段一致性警告：各段光影描述不一致。"
                       "多段分镜应保持统一的光影三层结构以确保拼接无缝。"
        })

    # 3. 禁止项一致：检测包含「禁止」或「Negative」的行
    def extract_negative(text):
        for line in text.strip().split('\n'):
            if '禁止' in line or 'Negative' in line or 'negative' in line:
                return line.strip()
        return ""

    neg_lines = [extract_negative(seg) for seg in segments]
    non_empty_neg = [n for n in neg_lines if n]
    if non_empty_neg and len(set(non_empty_neg)) > 1:
        cross_results.append({
            "level": "warning",
            "code": "INCONSISTENT_NEGATIVE",
            "message": "跨段一致性警告：各段禁止项声明不一致。"
                       "多段分镜应使用统一的禁止项。"
        })

    if not cross_results:
        cross_results.append({
            "level": "pass",
            "code": "CROSS_SEGMENT_OK",
            "message": f"跨段一致性检查通过：{len(segments)} 段风格/光影/禁止项一致。"
        })

    all_passed = all(r["passed"] for r in per_segment)
    cross_errors = [r for r in cross_results if r["level"] == "error"]
    overall_passed = all_passed and len(cross_errors) == 0

    return {
        "language": lang,
        "segment_count": len(segments),
        "passed": overall_passed,
        "per_segment": per_segment,
        "cross_segment": cross_results
    }


def validate_prompt(text, lang=None):
    """执行完整校验流程"""
    if lang is None:
        lang = detect_language(text)

    all_results = []
    all_results.extend(check_length(text, lang))
    all_results.extend(check_time_slices(text))
    all_results.extend(check_camera_language(text))
    all_results.extend(check_cgi_words(text))
    all_results.extend(check_asset_refs(text))
    all_results.extend(check_conflict(text))
    all_results.extend(check_ambiguous_terms(text, lang))

    errors = [r for r in all_results if r["level"] == "error"]
    warnings = [r for r in all_results if r["level"] == "warning"]
    passed = [r for r in all_results if r["level"] == "pass"]
    infos = [r for r in all_results if r["level"] == "info"]

    return {
        "language": lang,
        "passed": len(errors) == 0,
        "summary": {
            "errors": len(errors),
            "warnings": len(warnings),
            "passed": len(passed),
            "infos": len(infos)
        },
        "results": all_results
    }


def format_report(validation):
    """格式化输出校验报告"""
    lines = []
    lines.append("")
    lines.append("=" * 50)
    lines.append("  Seedance 2.0 提示词审查报告")
    lines.append("=" * 50)
    lang = validation.get("language", "cn")
    lang_display = "中文 (Chinese)" if lang == "cn" else "English"
    lines.append(f"  语言: {lang_display}")
    lines.append("")

    icon_map = {
        "error": "❌",
        "warning": "⚠️ ",
        "pass": "✅",
        "info": "ℹ️ "
    }

    for r in validation["results"]:
        icon = icon_map.get(r["level"], "  ")
        lines.append(f"  {icon} [{r['code']}] {r['message']}")

    lines.append("")
    lines.append("-" * 50)
    s = validation["summary"]
    if validation["passed"]:
        lines.append(f"  结论: 审查通过 ✅ "
                     f"({s['passed']}项通过, {s['warnings']}项警告, {s['infos']}项提示)")
        lines.append("  可向用户交付最终提示词。")
    else:
        lines.append(f"  结论: 审查未通过 ❌ "
                     f"({s['errors']}项错误, {s['warnings']}项警告)")
        lines.append("  请根据上述错误重新精简并重写提示词，然后再次校验！")
    lines.append("")

    return "\n".join(lines)


FILE:scripts/test_validate.py
#!/usr/bin/env python3
# ============================================================================
# ⚠️  STANDALONE DEVELOPER TOOL — NOT EXECUTED BY THE AI AGENT
# ============================================================================
# Test cases for validate_prompt.py. This file is for developers and CI/CD
# pipelines only. The AI agent does NOT execute any Python scripts.
# ============================================================================
"""
validate_prompt.py 的测试用例
运行: python -m pytest scripts/test_validate.py -v
"""

import os
import unittest
import importlib.util

# 使用 importlib 加载同目录模块（避免 sys.path 操作）
_spec = importlib.util.spec_from_file_location(
    "validate_prompt",
    os.path.join(os.path.dirname(__file__), "validate_prompt.py")
)
_module = importlib.util.module_from_spec(_spec)
_spec.loader.exec_module(_module)

check_length = _module.check_length
check_time_slices = _module.check_time_slices
check_camera_language = _module.check_camera_language
check_cgi_words = _module.check_cgi_words
check_asset_refs = _module.check_asset_refs
check_conflict = _module.check_conflict
validate_prompt = _module.validate_prompt
_detect_declared_duration = _module._detect_declared_duration
detect_language = _module.detect_language
check_ambiguous_terms = _module.check_ambiguous_terms
validate_multi_segment = _module.validate_multi_segment


class TestCheckLength(unittest.TestCase):
    """字数限制校验"""

    def test_cn_within_limit(self):
        text = "赛博朋克城市夜景" * 10  # 80字符
        results = check_length(text)
        self.assertEqual(results[0]["level"], "pass")

    def test_cn_exceed_limit(self):
        text = "赛" * 501
        results = check_length(text)
        self.assertEqual(results[0]["level"], "error")
        self.assertEqual(results[0]["code"], "LENGTH_EXCEEDED")

    def test_cn_near_limit(self):
        text = "赛" * 430  # 86%
        results = check_length(text)
        self.assertEqual(results[0]["level"], "warning")
        self.assertEqual(results[0]["code"], "LENGTH_NEAR_LIMIT")

    def test_en_within_limit(self):
        text = "word " * 100  # 100 words
        results = check_length(text, lang="en")
        self.assertEqual(results[0]["level"], "pass")

    def test_en_exceed_limit(self):
        text = "word " * 1001  # 1001 words
        results = check_length(text, lang="en")
        self.assertEqual(results[0]["level"], "error")
        self.assertEqual(results[0]["code"], "LENGTH_EXCEEDED")



class TestCheckTimeSlices(unittest.TestCase):
    """时序切片校验"""

    def test_no_time_slices(self):
        results = check_time_slices("一个女人在街上走路，镜头跟拍")
        self.assertTrue(any(r["code"] == "NO_TIME_SLICES" for r in results))

    def test_valid_time_slices_cn(self):
        text = "0-3秒：画面A；3-8秒：画面B；8-12秒：画面C"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "TIME_SLICES_OK" for r in results))

    def test_valid_time_slices_en(self):
        text = "[0-3s] Scene A; [3-8s] Scene B; [8-12s] Scene C"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "TIME_SLICES_OK" for r in results))

    def test_overlapping_time_slices(self):
        text = "0-5秒：画面A；3-8秒：画面B"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "TIME_OVERLAP" for r in results))

    def test_not_from_zero(self):
        text = "3-6秒：画面A；8-10秒：画面B"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "TIME_NOT_FROM_ZERO" for r in results))


class TestCheckCameraLanguage(unittest.TestCase):
    """运镜专业度检测"""

    def test_has_camera_cn(self):
        text = "航拍俯拍城市，Dolly In推进，特写面部表情"
        results = check_camera_language(text)
        self.assertEqual(results[0]["level"], "pass")

    def test_has_camera_en(self):
        text = "Tracking shot through the corridor, close-up on face, dolly in"
        results = check_camera_language(text)
        self.assertEqual(results[0]["level"], "pass")

    def test_no_camera(self):
        text = "一个女人穿着红色裙子在花园里散步，阳光明媚，花朵盛开"
        results = check_camera_language(text)
        self.assertEqual(results[0]["level"], "error")
        self.assertEqual(results[0]["code"], "NO_CAMERA_LANGUAGE")


class TestCheckCgiWords(unittest.TestCase):
    """AI塑料感废话检测"""

    def test_clean_text(self):
        text = "35mm胶片颗粒质感，自然皮肤纹理微瑕"
        results = check_cgi_words(text)
        self.assertTrue(any(r["code"] == "CGI_WORDS_CLEAN" for r in results))

    def test_has_cgi_words(self):
        text = "杰作级画质，超清晰，masterpiece"
        results = check_cgi_words(text)
        self.assertTrue(any(r["code"] == "BANNED_WORDS_DETECTED" for r in results))
        self.assertTrue(any(r["level"] == "error" for r in results))

    def test_soft_resolution(self):
        text = "8K超高清画面，配合UnrealEngine5渲染"
        results = check_cgi_words(text)
        self.assertTrue(any(r["code"] == "RESOLUTION_WORDS" for r in results))


class TestCheckAssetRefs(unittest.TestCase):
    """资产引用校验"""

    def test_no_refs(self):
        results = check_asset_refs("纯文本提示词，无任何引用")
        self.assertTrue(any(r["code"] == "NO_ASSET_REFS" for r in results))

    def test_valid_refs(self):
        text = "@图片1为首帧，参考@视频1的运镜，@音频1为配乐"
        results = check_asset_refs(text)
        self.assertTrue(any(r["code"] == "ASSET_REFS_OK" for r in results))

    def test_image_exceeded(self):
        refs = " ".join([f"@图片{i}" for i in range(1, 11)])
        results = check_asset_refs(refs)
        self.assertTrue(any(r["code"] == "IMAGE_REF_EXCEEDED" for r in results))

    def test_video_exceeded(self):
        refs = "@视频1 @视频2 @视频3 @视频4"
        results = check_asset_refs(refs)
        self.assertTrue(any(r["code"] == "VIDEO_REF_EXCEEDED" for r in results))

    def test_total_exceeded(self):
        refs = " ".join([f"@图片{i}" for i in range(1, 10)])
        refs += " @视频1 @视频2 @视频3 @音频1"
        results = check_asset_refs(refs)
        self.assertTrue(any(r["code"] == "TOTAL_REF_EXCEEDED" for r in results))


class TestCheckConflict(unittest.TestCase):
    """逻辑冲突检测"""

    def test_no_conflict(self):
        text = "0-3秒：Fast Tracking追逐；3-8秒：Slow Motion慢镜头回顾"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "NO_CONFLICT" for r in results))

    def test_speed_conflict(self):
        text = "快速追逐同时慢动作展示细节"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "MOTION_CONFLICT" for r in results))

    def test_direction_conflict(self):
        text = "Dolly In推进同时Pull Out拉远"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "MOTION_CONFLICT" for r in results))

    def test_optical_conflict_wide_bokeh(self):
        """14mm超广角 + 浅景深虚化 = 光学冲突"""
        text = "14mm ultra-wide拍摄，背景浅景深虚化散景"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "OPTICAL_CONFLICT" for r in results))

    def test_optical_conflict_handheld_symmetry(self):
        """手持晃动 + 绝对对称 = 构图冲突"""
        text = "手持微晃拍摄，绝对对称构图"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "OPTICAL_CONFLICT" for r in results))

    def test_style_conflict_imax_vhs(self):
        """IMAX清晰 + VHS降解 = 品质冲突"""
        text = "IMAX 65mm清晰画质，VHS录像带质感"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "STYLE_CONFLICT" for r in results))

    def test_style_conflict_film_digital(self):
        """胶片颗粒 + 锐利数码 = 品质冲突"""
        text = "35mm胶片颗粒质感，锐利数码电商质感"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "STYLE_CONFLICT" for r in results))

    def test_style_conflict_ink_ue5(self):
        """水墨 + UE5光追 = 风格冲突"""
        text = "水墨宣纸笔触，unreal engine光追渲染"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "STYLE_CONFLICT" for r in results))

    def test_no_style_conflict(self):
        """正常提示词无冲突"""
        text = "35mm胶片颗粒，自然光，手持微晃"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "NO_CONFLICT" for r in results))

    def test_style_conflict_celshade_pbr(self):
        """三渲二/Cel-Shade + 写实PBR材质 = 风格冲突"""
        text = "三渲二卡通渲染，写实皮肤纹理with visible pores and subsurface scattering"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "STYLE_CONFLICT" for r in results))

    def test_no_conflict_celshade_alone(self):
        """纯三渲二提示词，无写实材质 = 无冲突"""
        text = ("3D Cel-Shaded Toon渲染，Anime风格硬边阴影，"
                "粗描边轮廓线，高饱和角色色盘")
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "NO_CONFLICT" for r in results))

    def test_style_conflict_slowmo_speedramp(self):
        """Slow Motion + Speed Ramp = 速度冲突"""
        text = "慢镜头特写，Speed Ramp变速加速"
        results = check_conflict(text)
        self.assertTrue(any(r["code"] == "STYLE_CONFLICT" for r in results))


class TestValidatePromptEndToEnd(unittest.TestCase):
    """端到端校验"""

    def test_good_prompt_passes(self):
        prompt = (
            "15秒赛博朋克暴雨追逐，UnrealEngine5渲染，"
            "0-3秒：Aerial航拍俯冲，摩天楼群刺破铅灰雨云；"
            "3-7秒：Low Angle仰拍慢镜头，主角从水花中起身；"
            "7-11秒：微距特写面部雨水滚落，Handheld抖动；"
            "11-15秒：Slow Crane Up仰拍。"
        )
        result = validate_prompt(prompt)
        self.assertTrue(result["passed"])
        self.assertEqual(result["summary"]["errors"], 0)

    def test_bad_prompt_fails(self):
        prompt = "赛" * 501  # 超长 + 无运镜
        result = validate_prompt(prompt)
        self.assertFalse(result["passed"])
        self.assertGreater(result["summary"]["errors"], 0)

    def test_minimal_prompt_warnings(self):
        prompt = "一个女人走在路上"
        result = validate_prompt(prompt)
        # 会通过（无error），但有warning
        self.assertFalse(result["passed"])  # 缺少运镜会报error


class TestDurationAwareSlices(unittest.TestCase):
    """时长感知的时间切片检测"""

    def test_long_video_no_slices_is_error(self):
        """10秒视频无时间切片 = error"""
        text = "10秒赛博朋克夜景，主角在雨中奔跑"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "LONG_VIDEO_NO_SLICES" for r in results))
        self.assertTrue(any(r["level"] == "error" for r in results))

    def test_short_video_no_slices_is_warning(self):
        """5秒视频无时间切片 = warning"""
        text = "5秒微距拍摄，水滴碰撞"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "NO_TIME_SLICES" for r in results))
        self.assertTrue(any(r["level"] == "warning" for r in results))

    def test_duration_mismatch(self):
        """声明15秒但切片只到10秒"""
        text = "15秒赛博朋克夜景，0-3秒：画面A；3-7秒：画面B；7-10秒：画面C"
        results = check_time_slices(text)
        self.assertTrue(any(r["code"] == "DURATION_MISMATCH" for r in results))

    def test_detect_declared_duration(self):
        self.assertEqual(_detect_declared_duration("10秒赛博朋克"), 10)
        self.assertEqual(_detect_declared_duration("15秒大片"), 15)
        self.assertEqual(_detect_declared_duration("一只猫在睡觉"), 0)


class TestDetectLanguage(unittest.TestCase):
    """Language auto-detection"""

    def test_chinese_text(self):
        self.assertEqual(detect_language("赛博朋克城市夜景，航拍俯冲"), "cn")

    def test_english_text(self):
        self.assertEqual(detect_language("Cyberpunk city night, aerial dive"), "en")

    def test_mixed_mostly_chinese(self):
        self.assertEqual(detect_language("赛博朋克城市夜景Aerial航拍"), "cn")

    def test_mixed_mostly_english(self):
        self.assertEqual(detect_language("Cyberpunk night scene, Dolly In push, 特写"), "en")


class TestEnglishPromptEndToEnd(unittest.TestCase):
    """English prompt end-to-end"""

    def test_good_english_prompt_passes(self):
        prompt = (
            "15s cyberpunk rain chase, UE5 rendering. "
            "0-3s: Aerial drone shot dive over skyscrapers. "
            "3-7s: Low angle shot slow-motion, hero rising. "
            "7-11s: ECU face detail, rain rolling. "
            "11-15s: Slow crane shot up, silhouette."
        )
        result = validate_prompt(prompt, lang="en")
        self.assertTrue(result["passed"])
        self.assertEqual(result["language"], "en")


class TestCheckAmbiguousTerms(unittest.TestCase):
    """审核风险裸英文运镜词检测"""

    def test_bare_dolly_in_cn_warns(self):
        """中文提示词中裸写 Dolly 应触发警告"""
        text = "Dolly穿过寺门进入庭院"
        results = check_ambiguous_terms(text, lang="cn")
        self.assertTrue(any(r["code"] == "AMBIGUOUS_CAMERA_TERM" for r in results))

    def test_dolly_tracking_shot_en_passes(self):
        """英文提示词中 dolly tracking shot 完整短语应通过"""
        text = "dolly tracking shot slowly pushing forward"
        results = check_ambiguous_terms(text, lang="en")
        self.assertTrue(any(r["code"] == "NO_AMBIGUOUS_TERMS" for r in results))

    def test_chinese_camera_words_pass(self):
        """纯中文运镜词应通过"""
        text = "航拍缓慢推进，推轨穿过寺门，摇臂升降揭示仙境"
        results = check_ambiguous_terms(text, lang="cn")
        self.assertTrue(any(r["code"] == "NO_AMBIGUOUS_TERMS" for r in results))

    def test_bare_aerial_in_en_warns(self):
        """英文提示词中裸写 Aerial 无后缀应触发警告"""
        text = "Aerial slow descent through clouds"
        results = check_ambiguous_terms(text, lang="en")
        self.assertTrue(any(r["code"] == "AMBIGUOUS_CAMERA_TERM" for r in results))

    def test_aerial_drone_shot_en_passes(self):
        """英文 aerial drone shot 完整短语应通过"""
        text = "aerial drone shot over the city"
        results = check_ambiguous_terms(text, lang="en")
        self.assertTrue(any(r["code"] == "NO_AMBIGUOUS_TERMS" for r in results))


class TestMultiSegmentValidation(unittest.TestCase):
    """多段分镜校验"""

    STYLE_LINE = "15秒落日沙漠武术，写实电影质感，暗金暖色调，苍芒孤寂氛围。"
    LIGHTING = "光影：落日低角度逆光暗金+沙面散射暖光，热浪折射柔化轮廓，暗金暖底调。"
    NEGATIVE = "禁止：任何文字、字幕、LOGO或水印"

    def _make_segment(self, style=None, lighting=None, negative=None):
        s = style or self.STYLE_LINE
        l = lighting or self.LIGHTING
        n = negative or self.NEGATIVE
        return (
            f"{s}\n"
            f"0-3秒：航拍缓慢下降，广袤沙漠延伸至地平线。\n"
            f"3-7秒：推轨缓推至中景，武者双手握棍起势。\n"
            f"7-11秒：侧面跟拍，棍棒横扫掀起扩散。\n"
            f"11-15秒：缓慢推进背影，画面趋于静止。\n"
            f"{l}\n"
            f"音效：风卷沙面、棍棒破空。\n"
            f"{n}"
        )

    def test_consistent_segments_pass(self):
        """风格/光影/禁止项一致的多段应通过跨段检查"""
        segments = [self._make_segment() for _ in range(4)]
        result = validate_multi_segment(segments, lang="cn")
        self.assertEqual(result["segment_count"], 4)
        self.assertTrue(any(
            r["code"] == "CROSS_SEGMENT_OK" for r in result["cross_segment"]
        ))

    def test_inconsistent_style_warns(self):
        """风格总纲不一致应触发警告"""
        seg1 = self._make_segment(style="15秒落日沙漠武术，写实电影质感，暗金暖色调。")
        seg2 = self._make_segment(style="15秒赛博朋克夜景，霾虹灯光，冷蓝色调。")
        result = validate_multi_segment([seg1, seg2], lang="cn")
        self.assertTrue(any(
            r["code"] == "INCONSISTENT_STYLE_ANCHOR" for r in result["cross_segment"]
        ))

    def test_inconsistent_lighting_warns(self):
        """光影不一致应触发警告"""
        seg1 = self._make_segment()
        seg2 = self._make_segment(lighting="光影：霾虹冷光+湿气折射，冷蓝绿色调。")
        result = validate_multi_segment([seg1, seg2], lang="cn")
        self.assertTrue(any(
            r["code"] == "INCONSISTENT_LIGHTING" for r in result["cross_segment"]
        ))

    def test_inconsistent_negative_warns(self):
        """禁止项不一致应触发警告"""
        seg1 = self._make_segment()
        seg2 = self._make_segment(negative="禁止：任何文字")
        result = validate_multi_segment([seg1, seg2], lang="cn")
        self.assertTrue(any(
            r["code"] == "INCONSISTENT_NEGATIVE" for r in result["cross_segment"]
        ))


if __name__ == "__main__":
    unittest.main()

FILE:references/audio-tags.md
# 音频与音效标签规范

> Seedance 2.0 支持原生音效描述。将音效与画面分离描述，避免混淆语义。

## 一、音频引用规则

- `@音频1` ~ `@音频3`：最多引用 3 段音频
- 音频总时长 ≤ 15 秒，总大小 ≤ 15MB
- 支持格式：mp3 / wav
- 音色参考：`音色参考@视频1` 可从视频中提取语音特征

## 二、音效描述方式

**原则：** 用物理拟声描述，避免抽象描述。

| ❌ 抽象描述 | ✅ 物理拟声描述 |
|------------|----------------|
| 悲伤的音乐 | 大提琴低沉缓慢的拉弦声 |
| 紧张的声音 | 心跳般的低频鼓点，逐渐加速 |
| 好听的风声 | 松林间穿过的呼啸风声 |
| 打斗音效 | 刀刃碰撞的金属铿锵声 |

## 三、环境音分类词库

### 自然环境
| 场景 | 音效描述 |
|------|----------|
| 森林 | 鸟鸣啁啾+树叶沙沙+溪水潺潺 |
| 海洋 | 海浪拍岸+远处海鸥+风卷沙 |
| 暴雨 | 密集雨点敲击+远处闷雷+雨水汇流 |
| 雪地 | 脚踩积雪的嘎吱声+寂静空旷回音 |
| 沙漠 | 干燥热风+沙粒摩擦+远处鹰啸 |
| 山谷 | 回声混响+风穿山口+远处钟声 |

### 城市环境
| 场景 | 音效描述 |
|------|----------|
| 繁忙街道 | 车流声+行人脚步+远处喇叭 |
| 夜景街道 | 霓虹灯嗡鸣+远处车声+雨滴落水坑 |
| 咖啡馆 | 咖啡机蒸汽声+杯碟轻碰+低语人声 |
| 办公室 | 键盘敲击+打印机运转+空调低鸣 |
| 地铁 | 列车车轮碾轨+报站广播+人流声 |

### 室内特殊
| 场景 | 音效描述 |
|------|----------|
| 古宅 | 木地板吱呀+风穿过缝隙+远处钟摆 |
| 实验室 | 仪器蜂鸣+液体冒泡+通风管低频 |
| 图书馆 | 极致安静+偶尔翻页+远处咳嗽 |

### 空间声学修饰词 (Spatial Acoustics)

> 为音效描述加上“空间定语”，告别单薄平面的声音。可与上方环境音自由组合使用。

| 空间定语 | 英文 | 声学效果 | 适用场景 |
|----------|------|----------|----------|
| 水下沉闷 | Muffled underwater | 低频轰鸣，高频被吸收 | 水下/淹没/深海 |
| 教堂回响 | Echoing in cavernous cathedral | 巨大空旷混响，声音反复反射 | 寺庙/山洞/废弃工厂 |
| 金属管道共振 | Resonating through metal duct | 冷硬工业共振，带金属混音 | 飞船内部/工厂/通风管道 |
| 远距闷响 | Distant muffled | 空间纵深感，声音多次衰减 | 远处爆炸/战争/雷雨 |
| 密闭压迫 | Claustrophobic confined space | 窒息压抑，声音反射急促 | 电梯/密室/棺材内 |
| 空旷荒野 | Vast open-air with no reflections | 声音迅速衰减，无回音 | 沙漠/草原/天台山顶 |
| 雨中浸泡 | Rain-drenched with white noise bed | 白噪音底床包裹一切 | 暴风雨/雨夜街头 |

**组合使用范例：**

```
# 水下场景
音效：Muffled underwater low-frequency rumble + 远处鲸鱼低鸣 + 气泡上升的咕噜声

# 废弃教堂
音效：Echoing in cavernous cathedral, 脚步声反复回荡 + 远处滴水 + 风穿过破窗的噜噜声

# 密闭空间
音效：Claustrophobic confined space, 急促的呼吸声回弹 + 指甲刮墙壁 + 心跳般的低频震动
```

## 四、动作音效分类词库

| 动作类型 | 音效描述 |
|----------|----------|
| 脚步 | 高跟鞋清脆哒哒声 / 军靴沉重踏地 / 赤脚在水中溅水 |
| 打斗 | 拳头击中肉体的沉闷声 / 刀刃出鞘的锋利声 / 骨骼碎裂 |
| 爆炸 | 低频轰隆+冲击波气浪+碎片坠落 |
| 车辆 | 引擎低沉轰鸣 / 轮胎尖啸 / 车门关闭咔嗒 |
| 水 | 水滴落入水面的清脆声 / 潜水时的水下隆隆声 |
| 风 | 呼啸穿过峡谷 / 微风拂过耳边 / 风暴级狂风呼号 |
| 金属 | 铁链拖拽+齿轮咬合+金属碰撞铿锵 |
| 魔法/科幻 | 能量充能嗡鸣 / 传送门嘶嘶声 / 光剑振动低频 |

### 材质拟声精细化 (Material Foley)

> “走路声”太笼统！精细化为“材质 + 力度 + 表面”三维描述，音效质感提升10倍。

| ✗ 笼统写法 | ✓ 精细化写法 | 英文提示词 |
|------------|------------|------------|
| 走路声 | 重靴踩在干雪上的嘎吷声 | `Crunching heavy boots on dry compacted snow` |
| 走路声 | 高跟鞋踩在湿滑大理石上的清脆哒哒 | `Sharp heels clicking on wet marble floor` |
| 走路声 | 赤脚踩在浅水洼中的啦啪飞溅 | `Bare feet splashing through shallow puddle` |
| 撞击声 | 次声波级的沉重撞击，伴碎片飞清 | `Heavy sub-bass impact with debris scatter and rattle` |
| 门声 | 锈铁门磨混凝土地面的刺耳刮擦 | `Rusty metal door grinding on concrete floor` |
| 衣物声 | 厉风中皮革风衣猜猜拍打 | `Leather coat flapping violently in gale-force wind` |
| 液体声 | 浓稠血液滴落在金属地板上的沉闷啪嗒 | `Viscous liquid dripping onto metal surface, thick splat` |

**组合使用范例：**

```
# 雨夜追逐场景音效
音效：Crunching gravel underfoot shifting to splashing through rain puddles, leather jacket flapping in wind, heavy breathing echoing in narrow alley, distant police siren Doppler-shifting
```

## 五、人声/台词描述

**台词格式规范：**
```
台词（角色名，情绪标签）："台词内容"
```

**情绪标签库：**

| 类别 | 标签 |
|------|------|
| 正面 | 欢快 / 温柔 / 自信 / 坚定 / 感动 / 兴奋 |
| 负面 | 愤怒 / 悲伤 / 恐惧 / 冷漠 / 颤抖 / 绝望 |
| 中性 | 平静 / 疑惑 / 思考 / 叙述 / 旁白 |

**人声类型：**

| 类型 | 描述 |
|------|------|
| 旁白 | `低沉磁性男声旁白` / `温柔女声旁白` |
| 窃窃私语 | `压低声音的窃窃私语` |
| 呐喊 | `撕心裂肺的呐喊，带有声音破裂` |
| 歌唱 | `清澈女声哼唱旋律` |

## 六、音乐风格速查

| 风格 | 描述 | 适用场景 |
|------|------|----------|
| 管弦史诗 | 交响乐团+铜管齐鸣+定音鼓震 | 史诗/战争/开场 |
| 电子合成 | 合成器铺底+电子节拍+空灵人声 | 科幻/赛博朋克 |
| 民族/国风 | 古筝/琵琶/笛子/编钟 | 仙侠/古装/东方 |
| 爵士/布鲁斯 | 萨克斯+钢琴即兴+刷弦 | 都市/夜场/情感 |
| 氛围/极简 | 钢琴独奏+极简弦乐+大量留白 | 文艺/治愈/情感 |
| 嘻哈/节拍 | 808低音+Hi-Hat碎拍+采样回音 | MV/街头/潮流 |
| 恐怖/悬疑 | 不协和弦+反转钢琴+低频嗡鸣 | 恐怖/悬疑/心理 |

## 七、音色与语言控制（v1.8 新增）

> Seedance 2.0 支持通过参考视频提取音色特征，以及通过文本直接指定方言和语言。以下能力融入六要素公式的「原生音效要求」维度。

### 7.1 音色参考（Timbre Reference）

通过上传含说话的参考视频，控制生成视频中角色的说话音色和语气：

| 写法（中文） | 写法（English） | 适用场景 |
|------------|----------------|---------|
| `语气和音色参考@视频1` | `Voice tone and timbre reference @Video1` | 角色配音一致性 |
| `旁白音色参考@视频1中的男声` | `Narrator timbre references male voice in @Video1` | 品牌广告旁白统一 |
| `说话风格参考@视频1` | `Speaking style reference @Video1` | 特定风格解说 |

**注意事项：**
- 参考视频中的说话片段越清晰，音色提取越精准
- 音色参考和音效描述可同时使用，互不冲突
- 适用于旁白统一、角色配音、特定主持风格等场景

### 7.2 方言与口音控制

直接在对白或旁白中指定方言或口音，模型可理解并生成对应语音：

| 方言/口音 | 中文写法 | English |
|----------|---------|---------|
| 四川话 | `用四川口音说："..."` | `Speaking in Sichuan dialect: "..."` |
| 粤语 | `用粤语说："..."` | `Speaking in Cantonese: "..."` |
| 东北话 | `用东北口音说："..."` | `Speaking in Northeast Chinese accent: "..."` |
| 台湾腔 | `用台湾腔说："..."` | `Speaking in Taiwanese Mandarin accent: "..."` |
| 日式口音 | `带日本口音的中文` | `Chinese with Japanese accent` |
| 英式口音 | `带英式口音的英语` | `Speaking in British English accent` |

**注意事项：**
- 方言写法直接嵌入台词行即可，无需额外参数
- 方言与情绪标签可组合：`台词（猴子，得意，四川口音）："..."` 

### 7.3 多语言对话

角色对话中可指定不同语言，模型会自动切换发音：

| 场景 | 写法示例 |
|------|---------|
| 多角色不同语言 | 分别在各自台词行注明语言：`台词（角色A，用西班牙语，坚定）："..."` |
| 同一角色切换语言 | `先用中文说"..."，然后切换为英语继续说"..."` |
| 旁白指定语言 | `画外音（用韩语）："..."` |

### 7.4 特殊音色风格

| 风格 | 写法（中文） | 写法（English） | 适用场景 |
|------|------------|----------------|---------|
| 科普解说 | `用科普节目的专业解说音色` | `Professional science documentary narration style` | 科普/教育 |
| 脱口秀 | `脱口秀式的夸张语气` | `Stand-up comedy exaggerated delivery` | 搞笑/娱乐 |
| 纪录片旁白 | `纪录片级低沉磁性旁白` | `Documentary-grade deep magnetic narration` | 纪录片/品牌 |
| 戏曲唱腔 | `豫剧唱腔风格` / `京剧念白` | `Henan opera singing style` / `Peking opera dialogue` | 戏曲/国风 |
| ASMR 低语 | `ASMR式轻柔低语` | `ASMR soft whispering tone` | ASMR/治愈 |
| 体育解说 | `激情体育解说风格` | `Enthusiastic sports commentary style` | 体育/电竞 |
| 广播电台 | `经典FM电台主持风格` | `Classic FM radio host style` | 播客/电台 |

**组合范例：**

```
# 四川方言脱口秀
台词（猴子，得意，四川口音）："幺妹儿，霸王别姬有得没得？"

# 纪录片旁白 + 音色参考
旁白音色参考@视频1，用纪录片级低沉磁性旁白讲述：
"这座写字楼如何成为一个充满活力的商业生态系统。"

# 多语言对话场景
台词（队长，坚定，西班牙语）："三分钟后突袭！"
台词（队员，冷静，西班牙语）："侧翼包抄？"
```

FILE:references/quality-anchors.md
# 品质锚定与后期处理词库

> 在提示词开头声明品质锚定，为模型设置品质基准。比泛词"电影感"精准 10 倍。

### 🚨 反塑料感宣言（强制）

> **以下废话词严禁出现在提示词中：** `4K` / `8K` / `masterpiece` / `best quality` / `ultra HD` / `超清晰` / `杰作` / `极致画质`
>
> **为什么有害？** 这些词会让模型过度激活"锐化+去噪"通路，生成表面涂了油的"塑料 CG 假人感"——过度光滑的皮肤、刺眼的高光、死板的完美。
>
> **正确做法：** 用下方的 **物理介质型号** + **光学瑕疵** + **有机质感** 替代。真实感来源于不完美（Organic Imperfections）。

## 一、品质锚定词库

### 渲染引擎

| 关键词 | 风格偏向 |
|--------|----------|
| UnrealEngine5渲染 | 写实+美观，最通用 |
| Octane物理渲染引擎 | 极致光追、产品广告 |
| Blender Cycles渲染 | 独立制作、艺术化 |
| V-Ray光追渲染 | 建筑可视化、精确光影 |
| Houdini粒子特效引擎 | 流体/爆炸/粒子 |
| Cel-Shaded Toon渲染 | 三渲二/动画化CG，简化光影+描边 |

### 画质规格

| 关键词 | 用途 |
|--------|------|
| IMAX级画质 | 极致清晰+大画幅感 |
| RAW影像质感 | 后期空间大、宽容度高 |
| 杜比视界HDR | 高动态范围、明暗层次丰富 |
| HDR10+ | 标准HDR |

### VFX等级

| 关键词 | 级别 |
|--------|------|
| 工业光魔级VFX特效 | 顶级好莱坞 |
| 院线级CG | 影院上映标准 |
| 好莱坞A级特效 | 大制作标准 |

### 摄影机感

| 关键词 | 质感 |
|--------|------|
| ARRI ALEXA摄影机质感 | 电影标杆色彩 |
| RED摄影机色彩 | 锐利+高分辨率 |
| 65mm胶片颗粒质感 | 大画幅有机颗粒 |
| 35mm胶片颗粒 | 经典电影质感 |
| 16mm胶片颗粒 | 独立电影/复古 |

### 专业胶片型号 (Film Stocks)

> 指定具体胶片型号比笼统的"胶片质感"精准得多。每种胶片都有独特的色彩签名，大模型对这些型号名极度敏感。

| 胶片型号 | 英文提示词 | 色彩签名 | 最佳场景 |
|----------|------------|----------|----------|
| **柯达 Portra 400** | `Shot on Kodak Portra 400` | 温润自然肤色，柔和过渡，低对比 | 人像/情感戏——绝杀 AI 蜡像脸 |
| **Cinestill 800T** | `Shot on Cinestill 800T` | 暖色调，霓虹灯高光处产生迷人的红色晕影 (halation) | 夜景/赛博朋克/霓虹街头 |
| **柯达 Vision3 500T** | `Shot on Kodak Vision3 500T` | 电影工业标准色彩，宽容度，自然色还原 | 通用叙事/院线电影质感 |
| **富士 Pro 400H** | `Shot on Fuji Pro 400H` | 清冷淡雅，薄荷绿偏移，柔和高光 | 日系文艺/小清新/旅拍 |
| **柯达 Ektachrome 100** | `Shot on Kodak Ektachrome E100` | 高饱和幻灯色彩，锝利颗粒 | 复古广告/60-70年代美学 |

**提示词范例：**

```
# 温润人像（反塑料感）
Shot on Kodak Portra 400, natural skin tones with micro-imperfections, soft halation around highlights, fine organic film grain

# 夜景赛博朋克
Shot on Cinestill 800T, red halation bleeding around neon highlights, warm tungsten-balanced tones, visible film grain
```

### 物理模拟

| 关键词 | 模拟类型 |
|--------|----------|
| 流体动力学模拟 | 水/血/液体 |
| 粒子物理引擎 | 火花/灰尘/碎片 |
| 破碎物理模拟 | 建筑/玻璃/岩石破碎 |
| 布料物理模拟 | 衣物/旗帜飘动 |

### 材质质感速查 (Material Textures)

> 材质描述是区分“AI 塑料感”和“电影级质感”的核心。每个材质配套英文提示词，可直接嵌入提示词中。

| 材质 | 英文提示词 | 视觉特征 |
|------|------------|----------|
| 皮肤 | `Realistic skin texture with visible pores, subsurface scattering, micro-imperfections` | 毛孔/SSS透光/微瑕疵，反蜜蜡假人感 |
| 发丝 | `Individual hair strands with flyaway wisps, translucent backlit edges` | 发丝飞散+透光边缘，反塑料假发 |
| 丝绸 | `Flowing silk with specular micro-highlights, liquid-smooth draping, light transmission` | 微光泽流转+液态垂坠+半透光 |
| 金属 | `Brushed metal with anisotropic reflection, micro-scratched surface, sharp specular` | 拉丝反射+微划痕+锐利高光 |
| 玻璃 | `Transparent glass with caustic light patterns, refractive distortion, fingerprint smudges` | 焦散光斑+折射畸变+指纹污渍 |
| 食物 | `Glistening food surface with oil sheen, steam wisps rising, juice droplets beading` | 油光/蒸气缚绕/汁液珠化，美食号必备 |
| 玉石 | `Jade with deep subsurface scattering, waxy luster, translucent green-white gradation` | SSS深层透光+蜡质光泽+渐变透亮 |
| 石材 | `Rough-hewn stone with granular surface, moss in crevices, weathered patina` | 粗糥颗粒+苔藓嵌缝+风化层 |

### 动画化 / NPR 材质速查 (Anime / Non-Photorealistic Materials)

> 三渲二 / Cel-Shaded 风格的核心区别在于材质——刷意简化光影和细节，打造「3D 建模 + 手绘效果」。**禁止与上方写实材质混用。**

| 材质 | 英文提示词 | 视觉特征 |
|------|------------|----------|
| Anime 皮肤 | `Anime cel-shaded skin with sharp shadow boundary, no subsurface scattering, clean color blocks` | 硬边阴影分割，无SSS透光，色块清晰，反写实毛孔 |
| Anime 头发 | `Anime hair with stylized highlight band, bold color blocks, flyaway strands at edges` | 高光带（非写实散射），色块分明，边缘飞散发丝 |
| 卡通金属 | `Toon-shaded metal with simplified specular, bold geometric reflection shapes` | 简化高光形状，几何化反射，非物理精确 |
| 卡通织物 | `Flat-shaded fabric with minimal wrinkle detail, bold color fill, anime-style fold lines` | 极简褶纹，色块填充，动画式褶线 |

**品质锚定使用模板：**
```
[时长][品质锚定]，[核心氛围]，
```
**示例：**
```
15秒末日科幻，UnrealEngine5渲染，工业光魔级VFX特效，杜比视界HDR，
冰冷机械美学+末世荒芜氛围，
```

---

## 二、光影三层结构词库

> 拆分为三层描述光影，是大制作提示词的核心技巧。

### 第一层 — 光源层（是什么光、从哪里来）

| 场景类型 | 光源词 |
|----------|--------|
| **灾难/动作** | 暴雨逆光 / 爆炸橙红火光 / 核爆白光 / 闪电侧光 |
| **奇幻/仙侠** | 灵力自发光 / 法阵光环 / 仙雾透光 / 月华清辉 |
| **科幻** | 飞船引擎尾焰光 / 能量球蓝白光 / 全息投影散射 |
| **都市/夜景** | 霓虹灯漫射 / 玻璃幕墙反射 / 车灯流光 / 防空警报红光 |
| **自然/写实** | 黄金时刻侧逆光 / 阴天漫射天光 / 月光冷辉 / 火焰跳动暖光 |
| **室内** | 台灯侧光 / 窗户进光 / 烛光闪烁 / 屏幕冷光 |

### 第二层 — 光行为层（光如何与材质/大气互动）

| 效果 | 描述 |
|------|------|
| 薄雾柔化高光 | 光线穿过雾气被柔化 |
| 强化阴影对比 | 雾层加深暗部 |
| 丁达尔效应/god rays | 光束在尘埃/雾中可见 |
| 体积光穿透 | 光柱穿过空间 |
| 烟尘散射光线 | 粒子折射光 |
| 玻璃折射彩虹光斑 | 棱镜效果 |
| 金属反射高光 | 锐利金属反光 |
| 雨水折射霓虹 | 湿面彩色反射 |
| 次表面散射(SSS) | 皮肤/玉石透光效果 |

### 常用灯光组合速查 (Lighting Recipes)

> 完整的布光方案（Key + Fill + Rim + Accent），比单个光源词效果强 5 倍。

| 场景 | 灯光组合 (Recipe) | 英文提示词 |
|------|---------------------|------------|
| **产品棚拍** | 主光侧前45° + 柔光箱填光 + rim light勾勒轮廓 + 底部反射板 | `Studio hero lighting, 45-degree key light with soft fill, rim light outlining product silhouette, gradient backdrop` |
| **夜景霓虹** | 霓虹灯多色源 + 湿地面反射 + 卷帘门口逾光 + 蓝紫补光 | `Neon multi-source lighting, wet surface reflections, rim spill from shopfront, blue-purple ambient fill` |
| **车内光线** | 仪表盘微光 + 路灯流动光影 + 后视镜反射 + 苏醒暗部 | `Dashboard glow illuminating face from below, passing streetlight shadows sweeping across interior, rearview mirror reflections` |
| **演唱会/舞台** | 追光灰主光 + 多色渗透光 + 干冰地面雾 + 频闪补光 | `Follow-spot key light, colored gel wash from sides, dry-ice floor fog catching laser beams, strobe accent` |

### 第三层 — 色调层（整体冷暖和对比）

| 风格 | 色调公式 |
|------|----------|
| 灾难/压迫 | 冷蓝底调 + 熔岩红高光 |
| 赛博朋克 | 冷蓝底调 + 霓虹紫红高光 |
| 仙侠/奇幻 | 暗青底调 + 金色/荧光高光 |
| 末日/恐怖 | 灰绿底调 + 暗红强化 |
| 暖色/史诗 | 暗棕底调 + 橙金高光 |
| 高级灰 | 低饱和灰调 + 微暖高光 |
| 梦幻/童话 | 柔粉底调 + 金色微光 |
| 社媒鲜亮 | 高饱和底调 + 强对比高光 + 微暖偏移 |

**三层结构使用模板：**
```
光影：[光源词1]+[光源词2]（光源层），
[光行为词1]+[光行为词2]（光行为层），
[色调公式]（色调层）。
```

---

## 三、大气与镜头质感效果词库

### 大气效果

| 效果类型 | 关键词 |
|----------|--------|
| 薄雾/朦胧 | 薄雾弥散 / 潮湿朦胧氛围 / 灰白色海雾包裹 |
| 丁达尔效应 | 丁达尔效应清晰 / 光束穿透雾层 / god rays射线 |
| 热浪/蒸汽 | 热浪蒸腾 / 蒸汽气团上涌 / 高温气流扭曲画面 |
| 烟尘粒子 | 爆炸烟尘 / 细粒子悬浮 / 粉尘弥散光线 |
| 雨/雪/风 | 暴雨倾盆 / 雪花缓落 / 风沙弥漫 |
| 大气连贯 | 每帧都有自然的薄雾弥散效果 / 全程雨雾弥漫 |

### 镜头质感效果（"不完美"增强真实感）

| 效果类型 | 关键词 |
|----------|--------|
| 镜头附着物 | 雾水珠附着镜头前 / 雾粒粘镜 / 雨滴溅到镜头 |
| 光学畸变 | 镜头畸变效果 / 雾层折射 / 广角边缘畸变 |
| 镜头震动 | 镜头剧烈抖动 / 爆炸冲击波震动镜头 |
| 镜头耀斑 | lens flare / 逆光眩光 / 光斑散射 |
| 色差 | chromatic aberration / 边缘色散 |

### 有机物理瑕疵 (Organic Imperfections)

> “真实感来源于不完美”——以下瑕疵词是对抗 AI “塑料感”的核心武器，每条提示词至少使用 1-2 个。

**光学瑕疵：**

| 瑕疵 | 英文提示词 | 视觉效果 |
|------|------------|----------|
| 胶片红色光晕 | `Cinematic halation` | 高光处弥散的温暖红色光晖，胶片特有 |
| 变形宽银幕眩光 | `Anamorphic lens flares` | 水平拉丝式眼光，2.35:1宽银幕标志 |
| 桶形畸变 | `Barrel distortion` | 广角镜头边缘拉伸，增强空间压迫感 |
| 周边暗角 | `Natural optical vignetting` | 边缘自然压暗，引导视觉聚焦中心 |

**物理质感：**

| 瑕疵 | 英文提示词 | 视觉效果 |
|------|------------|----------|
| 眉毛皮肤 | `Realistic skin texture with visible pores and micro-imperfections` | 反塑料感第一利器，告别蓁像脸 |
| 汗水反光 | `Sweat glistening on skin surface` | 细微的液体反射，增强真实触感 |
| 微尘飘浮 | `Floating dust particles caught in light` | 空气中的微尘在光束中闪烁，空间立体感 |
| 织物微纤维 | `Fabric micro-fiber detail under light` | 衣物表面的微观纹理，材质真实感 |
| 发丝光泽 | `Individual hair strands catching light` | 毛发反光与飞散，告别塑料假发 |

**环境有机物：**

| 瑕疵 | 英文提示词 | 视觉效果 |
|------|------------|----------|
| 雨滴玻璃 | `Rain droplets trickling down glass surface` | 湿润环境感 |
| 凝结水雾 | `Condensation fog on cold surfaces` | 温度差的物理表现 |
| 落叶碎屑 | `Scattered leaves and organic debris` | 场景自然生活感 |
| 光斜进的灰尘 | `Dust motes drifting through shafts of light` | 空间体积感+光线可见 |

**反塑料感提示词范例：**

```
# 人像反塑料感套件
Shot on Kodak Portra 400, realistic skin texture with visible pores, sweat glistening on forehead, cinematic halation, fine organic film grain, floating dust particles in warm backlight

# 夜景反塑料感套件
Shot on Cinestill 800T, anamorphic lens flares, red halation around neon signs, rain droplets on lens surface, natural optical vignetting, visible film grain
```

---

## 四、后期处理与收束词库

### 后期处理词（可叠加使用）

暗角 / 胶片颗粒 / 电子噪点 / 色差(chromatic aberration) / 轻微镜头失真 / 运动模糊 / 轻微过曝 / 胶片刮痕 / 暗角渐深

### 张力宣言（按风格分类）

| 风格 | 收束句 |
|------|--------|
| 压迫/灾难 | 窒息式压迫感+诡谲朦胧氛围，无冗余画面，全程高张力 |
| 科幻/未来 | 冰冷机械美学，每帧可截图成壁纸，镜头感拉满 |
| 仙侠/奇幻 | 仙气飘渺，如梦似幻，全程不要现代感痕迹 |
| 都市/情感 | 温度感十足，每帧有呼吸感，镜头语言克制而有力 |
| 动作/热血 | 肾上腺素拉满，节奏紧绷，剪辑感强烈 |
| 孤寂/文艺 | 留白充分，克制的情绪张力，画面呼吸感强 |
| 可爱/治愈 | 满屏治愈感，色彩明快，让人嘴角上扬 |

**收束句模板：**
```
[后期处理词1]+[后期处理词2]收尾，[情绪形容词]氛围，[质量宣言]。
```

---

## 五、品质冲突矩阵 (Conflict Matrix)

> **矛盾的品质词组合会让模型输出四不像。** Claude 必须在组装提示词时主动检测并避免以下冲突。

| 冲突对 A | 冲突对 B | 为什么冲突 | 解决方案 |
|---------|---------|------------|----------|
| IMAX 65mm 极致清晰 | VHS 模拟降解 | 一个要极致锐利，一个要刻意降解 | 二选一，不可混用 |
| UE5 写实光追 | 水墨宣纸笔触 | 一个物理渲染，一个抽象二维 | 二选一；若要融合用“3D渲染水墨质感” |
| 胶片颗粒 + 有机噪点 | 锐利数码电商质感 | 一个要粗糥不完美，一个要完美无瑕 | 根据场景选择；电商禁胶片，影片禁数码锐 |
| 手持晃动 / Handheld | 绝对对称构图 | 运镜与构图逻辑矛盾 | 对称构图强制用三脚架/云台 |
| Slow Motion 慢镜头 | Speed Ramp 变速 | 同一时间切片内不可同时慢和加速 | 分时间切片使用，不在同段重叠 |
| 三渲二Cel-Shade/卡通渲染 | 写实PBR材质/SSS/皮肤毛孔/微瑕疵 | 一个刻意简化光影和材质，一个追求物理精确 | 二选一；三渲二提示词禁用写实材质词 |

**使用规则：**
- Claude 在 Step 3 组装提示词时必须交叉检查本矩阵
- 校验脚本可检测"运动逻辑冲突"已覆盖部分场景
- 若用户坚持矛盾组合，在导演阐述中主动说明取舍和风险

FILE:references/seedance-specs.md
# Seedance 2.0 官方平台规范

> 本文档为 Seedance 2.0（即梦）平台的技术参数与规范速查。所有提示词必须在此边界内设计。

## 提示词容量限制

| 语言 | 上限 | 说明 |
|------|------|------|
| 中文 | **500 字符** | 超出则模型仅抓取宏观重点，忽略微观细节 |
| 英文 | **1000 词** | 同上 |

> 提示词不是越长越好。过长导致信息分散，模型可能忽略布光、材质等关键指令。

## 生成时长

- **单次生成**：4-15 秒
- **超长视频**：需分段生成 + 视频延长拼接（每段 ≤15s）

## 分辨率与画幅

| 分辨率 | 画幅比 |
|--------|--------|
| 480p / 720p / **1080p** | 16:9（横屏）、9:16（竖屏）、21:9（超宽）、1:1（方形）、2.35:1（宽银幕） |

## 多模态文件限制

| 类型 | 最大数量 | 格式 | 大小限制 |
|------|----------|------|----------|
| 图片 | **9 张** | jpeg/png/webp/bmp/tiff/gif | 每张 < 30MB |
| 视频 | **3 段** | mp4/mov | 每段 2-15s，总计 < 50MB |
| 音频 | **3 段** | mp3/wav | 总计 ≤ 15s，总计 < 15MB |
| **合计** | **≤ 12 个** | — | — |

## 多模态引用语法

在提示词中使用以下格式引用上传的素材：

```
@图片1 ~ @图片9    图片引用
@视频1 ~ @视频3    视频引用
@音频1 ~ @音频3    音频引用
```

### 引用功能说明

| 引用方式 | 用途 | 典型写法 |
|----------|------|----------|
| **身份锚定** | 锁定角色外貌 | `保留@图片1中人物的面部特征和服装` |
| **风格参考** | 借鉴视觉风格 | `参考@图片2的色调和构图风格` |
| **运镜复刻** | 复制镜头轨迹 | `参考@视频1的运镜和动作节奏` |
| **动作编排** | 复制舞蹈/动作 | `复刻@视频1中的舞步编排` |
| **音色参考** | 匹配声音特征 | `音色参考@视频1` |
| **视频延长** | 续拍接力 | `将@视频1延长5秒` |
| **角色替换** | 更换视频中角色 | `将@视频1中的A换成@图片1` |
| **首帧锚定** | 指定起始画面 | `@图片1为首帧` |
| **尾帧锚定** | 指定结束画面 | `@图片2为尾帧` |

## 官方提示词核心公式

Seedance 2.0 训练数据分布对应的最佳结构：

```
主体/角色 + 所在场景 + 核心动作/时序 + 镜头语言 + 画面风格/光影材质 + 音频要求
```

### 时间戳分镜语法

对于长视频（>5秒），强烈建议使用时间戳分段：

```
0-3秒：画面A + 镜头A + 音效A。
4-8秒：画面B + 镜头B + 音效B。
9-12秒：画面C + 镜头C + 音效C。
```

**规则：**
- 每个时间段只描述一个核心动作
- 段与段之间保持逻辑连贯
- 时间段不可重叠
- 完整覆盖总时长

## 内容合规红线

1. **写实真人面部素材**：平台自动拦截用真人照片作为强绑定的请求
2. **知名 IP/品牌**：即使不使用原名，标志性视觉特征也可能触发拦截
3. **暴力/色情/政治敏感**：严格按平台审核标准执行

## 十大核心能力速查

| # | 能力 | 模式 |
|---|------|------|
| 1 | 一致性控制（人脸/服装/字体） | `@图片N` 锚定 |
| 2 | 运镜/动作复刻 | `参考@视频1的运镜` |
| 3 | 创意/特效复刻 | `参考@视频1的特效` |
| 4 | 剧情补全 | 分镜脚本 + 演绎方式 |
| 5 | 视频延长 | `将@视频1延长Xs` |
| 6 | 声音控制 | `音色参考 + "台词"` |
| 7 | 一镜到底 | `一镜到底 + 全程不切镜头` |
| 8 | 视频编辑 | `将@视频1中的A换成@图片1` |
| 9 | 音乐卡点 | `参考@视频1的画面节奏/卡点` |
| 10 | 情绪演绎 | 情绪变化描述 + 运镜配合 |

## 即梦 CLI 联动指南（v1.8.4 新增）

> 当 Shot Design 部署在支持 CLI 调用的 Agent 环境中（如 OpenClaw + Dreamina CLI），提示词可以直接通过 CLI 提交生成。本节提供命令映射速查。

### CLI 安装

```bash
curl -fsSL https://jimeng.jianying.com/cli | bash
dreamina login   # 首次登录
```

### 提示词 → CLI 命令映射

| Shot Design 模式 | CLI 命令 | 关键参数 | 说明 |
|-----------------|----------|----------|------|
| 纯文本 → 视频 | `dreamina text2video` | `--prompt "提示词" --duration X --ratio 16:9` | 标准文生视频 |
| 首帧图 → 视频 | `dreamina image2video` | `--image 路径 --prompt "运动描述"` | I2V 黄金法则 |
| 多帧 → 故事视频 | `dreamina multiframe2video` | 多图输入 + prompt | 多图连贯叙事，引擎自动编排 |
| 多模态 → 视频 | `dreamina multimodal2video` | 图+视频+音频 + prompt | 旗舰模式，支持 seedance2.0 家族 |
| 纯文本 → 图片 | `dreamina text2image` | `--prompt "提示词"` | 生成首帧参考图 |
| 图 → 图 | `dreamina image2image` | `--images 路径 --prompt "提示词"` | 迭代角色/场景设计 |

> **使用建议：** 先用 Shot Design 生成提示词，再根据上表选择对应 CLI 命令提交。Agent 可通过 `dreamina <subcommand> -h` 查看最新参数。

### 异步任务管理

CLI 生成任务为**异步**模式，提交后需等待或轮询结果：

```bash
# 方式1：提交时自动轮询（推荐）
dreamina text2video --prompt "提示词" --poll=30

# 方式2：手动查询
dreamina text2video --prompt "提示词"     # 返回 submit_id
dreamina query_result --submit_id <ID>     # 查询结果
dreamina list_task --gen_status=success    # 查看成功任务
```

### 模型通道说明

> 不建议在提示词中硬编码模型名称，应通过 CLI `-h` 确认当前支持的模型。

| 通道 | 特点 | 适用场景 |
|------|------|----------|
| `seedance2.0` | 标准质量 | 日常创作 |
| `seedance2.0_vip` | 高优先级队列 | 追求品质 |
| `seedance2.0_fast_vip` | 快速生成 | 批量验证/迭代测试 |

> **注意：** 模型通道随平台更新可能变化，使用前执行 `dreamina multimodal2video -h` 确认最新支持。

FILE:references/scenarios.md
# 垂直场景提示词模板库

> 针对高频使用场景提供开箱即用的提示词架构参考。每个模板包含核心参数和示例。
>
> **双语规则：** 模板以中文编写。英文输出时，Agent 应按模板结构自行生成英文版——使用英文时间戳（`0-3s:`）、英文标签（`Lighting:` / `SFX:` / `Negative:`）、从 `director-styles.md` 和 `quality-anchors.md` 选用英文提示词列。部分高频场景提供英文示例作为锚点参考。

---

## 一、电商产品广告

**核心参数：**
- 画幅：9:16竖屏（社交投放）或 16:9横屏（官网/TVC）
- 时长：5-10秒
- 运镜：Orbit环绕 + 微距特写 + Hero Lighting
- 材质：注重产品表面质感（金属反光/玻璃折射/液体流动）

**模板：**
```
[时长][产品类目]广告，
Octane物理渲染引擎，hero lighting产品打光，
0-3秒：[产品]居中旋转展示，Orbit 360°环绕，
纯黑/纯白背景，rim light勾勒产品轮廓，
微弱大气粒子漂浮；
3-7秒：Extreme Close-Up微距特写，
[产品表面材质细节]，浅景深散景，
光泽/纹理清晰可见；
7-10秒：Pull Out全景揭示产品在[使用场景]中的效果。
```

**示例 — 腕表广告：**
```
10秒高端腕表广告，Octane物理渲染引擎，hero lighting，
0-3秒：腕表居中Orbit慢速360°环绕，纯黑背景，
rim light精准勾勒表壳金属边缘，微弱金色粒子漂浮；
3-7秒：ECU微距特写表盘，浅景深聚焦秒针，
蓝宝石镜面折射光斑，齿轮机芯细节可见；
7-10秒：Dolly Out，腕表佩戴在手腕上，
手轻抬于窗边golden hour侧逆光中，皮肤纹理自然。
```

---

## 二、仙侠/奇幻动画

**核心参数：**
- 画幅：16:9 或 2.35:1
- 时长：10-15秒
- 运镜：航拍穿越 + 摇臂升降 + 推轨穿门
- 材质：3D国漫CG / 水墨粒子 / 仙气弥漫

**模板：**
```
[时长]中国仙侠/奇幻，3D国漫CG渲染质感，
[色调总纲]，[大气连贯声明]，

0-Xs：航拍穿越[仙境场景]，丁达尔光束；
X-Xs：推轨穿过[建筑/门扉]，进入[室内/庭院]；
X-Xs：[角色动作]，[灵力特效]，运镜配合；
X-Xs：[高潮/收束]，Crane Up / Push In。

光影三层：[光源]+[光行为]+[色调]。
[收束句]。
```

---

## 三、短剧/对白场景

> **v1.5 重大升级**：新增演员调度体系、画外音控制、拍摄角度具体化、分镜过渡策略、叙事化运镜、风格快选器。

### 3.0 短剧风格快速选择器

> 在 Step 1 需求解析时，引导用户从以下四个维度快速锁定视觉方向。

| 维度 | 选项 |
|------|------|
| **画面类型** | 真人写实 / 3D CG / 2D动画 / 2.5D混合 |
| **渲染风格** | 电视剧质感 / 电影胶片质感 / 日漫 / 国漫 / 半厚涂 / Cel-Shaded |
| **色调方向** | 暖色调 / 冷色调 / 霓虹赛博 / 废土灰 / 金青古风 / 自然色温 |
| **受众/题材** | 都市女频 / 男频科幻 / 甜宠 / 悬疑 / 仙侠 / 喜剧 / 末世 |

**组合示例：** `真人写实 + 电视剧质感 + 暖色调 + 都市女频` → 现代都市情感短剧

### 3.1 核心参数

- 画幅：9:16竖屏（短剧标配）或 16:9（横屏质感短片）
- 时长：8-15秒
- 运镜：正反打 + Medium Shot + 手持微晃
- 关键：**演员调度三要素** + 对白/画外音区分 + 台词用引号包裹

### 3.2 演员调度三要素

> **短剧分镜中最关键的角色控制手段。** AI视频模型在多人场景中极易出现视线错乱、面部朝向错误。必须在每个画面描述中明确以下三项：

| 要素 | 含义 | 提示词写法 |
|------|------|-----------|
| **① 站位** | 角色在画面中的空间位置 | `角色A位于画面左侧 / 舞台中央 / 门口` |
| **② 面部朝向** | 脸面向谁或面向哪个方向 | `面部朝向角色B / 面部转向镜头 / 面部朝向门口方向` |
| **③ 视线焦点** | 眼神看向哪里 + 情绪修饰 | `视线温柔地聚焦于角色B的脸 / 视线惊恐地扫视前方` |

**常用视线情绪修饰词：**
- 柔情类：温柔凝视 / 深情注视 / 充满爱意地聚焦
- 冲突类：轻蔑俯视 / 愤怒直视 / 不敢对视地低头
- 惊变类：惊恐扫视 / 失魂落魄地寻找 / 难以置信地望向

### 3.3 对白 vs 画外音 控制

> **短剧的两种声音模式需要严格区分，否则 AI 会在画外音独白时让角色嘴巴跟着动。**

| 声音类型 | 提示词写法 | 禁止项 |
|----------|-----------|--------|
| **对白**（角色说话） | `台词（角色，情绪）："内容"` | 无额外禁止 |
| **画外音/内心独白** | `画外音："内容"` | **必须追加：** `禁止：画面中角色出现说话口型` |

### 3.4 拍摄角度具体化

> **不只写景别术语，更要说明「从谁的方向拍」「焦点落在谁身上」——这是分镜脚本语言而非摄影教科书语言。**

| ❌ 模糊写法 | ✅ 具体化写法 |
|------------|-------------|
| `OTS过肩镜头` | `过肩近景，从角色A背后拍摄，焦点在角色B脸上` |
| `中景` | `中景，从宾客区侧方平视拍摄` |
| `低角度仰拍` | `从门口内侧低角度拍摄，角色占据画面上方` |
| `特写` | `特写，从角色A左前方45°角拍摄，焦点锁定眼部` |
| `长焦` | `长焦镜头，从角色A背后拍摄，焦点在远处舞台上` |

### 3.5 运镜 + 叙事动机绑定

> **运镜不是孤立的技术指令，要写明「为什么用这个运镜」——模型理解更准确，用户阅读更直观。**

| ❌ 纯术语 | ✅ 术语 + 动机 |
|----------|--------------|
| `缓慢推进特写` | `缓慢推进至面部特写，加强情感压力` |
| `镜头晃动` | `镜头晃动，模仿角色不稳的步伐` |
| `快速拉向门口` | `镜头快速拉向门口方向，跟随全场注意力` |
| `跟拍` | `镜头跟随角色逃跑动作，传递紧迫感` |
| `缓慢上升` | `镜头从脚踝缓慢上升，逐步揭示角色全貌` |

### 3.5.1 情绪参考与转变控制（v1.8 新增）

> 情绪是短剧的灵魂。仅写“很伤心”不够——要具体到面部微表情和身体语言。

**情绪具体化对照表：**

| ✖ 抽象写法 | ✔ 具体化写法 |
|------------|-------------|
| 很开心 | 嘴角上扬露出牙齿，眼角出现鱼尾纹 |
| 很伤心 | 泪水沿脸颊滑落，嘴角微微颤抖 |
| 很害怕 | 瞳孔放大，身体后仰紧贴墙壁，双手握紧 |
| 很生气 | 咬紧牙关，太阳穴青筋浮起，鼻翼翅动 |
| 很惊讶 | 双眼圆睁，嘴巴微张，身体本能地后退半步 |
| 崩溃 | 双手抓住头发，肩膀抑制不住地抖动，声音破裂 |

**情绪转变的触发词：**
- 转折类：`突然`、`瞬间`、`猛然`、`骤然` — 触发快速情绪变化
- 渐变类：`逐渐`、`慢慢`、`一点点` — 触发缓慢情绪过渡
- 对比类：`从....变成....` — 触发情绪前后反差

**情绪参考视频：**
- `情绪和表情完全参考@视频1` — 从参考视频中复刻情绪表达
- `崩溃大叫的程度参考@视频1` — 精准对齐参考视频的情绪强度
- `姿势参考@图片2` — 用图片参考身体语言比纯文字更准确

> **核心技巧：** 表情参考图比文字描述更准确；情绪转变要有触发点：“沉思了一会**突然**开始崩溃”——“突然”是关键词。

### 3.6 分镜过渡策略（用于多段分镜导演阐述）

> **每组分镜之间的衔接不只是交接帧的技术问题，更是叙事节奏与情绪弧线的规划。在导演阐述中声明过渡意图。**

**常用过渡策略模板：**
```
分镜1→2过渡：[视觉连接方式]，[情绪转变说明]
```

**过渡策略词库：**
| 策略类型 | 描述 | 适用场景 |
|----------|------|---------|
| 视线连接 | 通过角色视线方向连接不同空间 | 台上→台下、室内→室外 |
| 情绪递进 | 从平静到紧张逐步升级 | 对话→冲突 |
| 快速剪辑冲击 | 全景→特写快速切换，强化冲击 | 突发事件、转折 |
| 动作承接 | 前段末动作延续到后段开头 | 追逐、打斗 |
| 反差对切 | 温馨场景突然切入紧张场景 | 反转、惊变 |
| 空间转移 | 从A空间自然过渡到B空间 | 场景切换 |

### 3.7 短剧提示词模板

**基础对白模板：**
```
[时长]短剧片段，[风格快选组合]，
画面（0-Xs）：[具体化景别+角度]，[场景]，
[角色A描述 + 站位]，[面部朝向 + 视线焦点]，
[运镜 + 叙事动机]。
台词（角色A，[情绪]）："[台词内容]"
画面（X-Xs）：[具体化景别+角度]，
[角色B描述 + 站位]，[面部朝向 + 视线焦点]，
[运镜 + 叙事动机]。
台词（角色B，[情绪]）："[台词内容]"
音效：[环境音/物理拟声描述]。
禁止：任何文字、字幕、LOGO或水印
```

**画外音/独白模板：**
```
[时长]短剧片段，[风格快选组合]，
画面（0-Xs）：[具体化景别+角度]，[场景]，
[角色描述 + 站位]，[面部朝向 + 视线焦点]，
[运镜 + 叙事动机]。
画外音："[独白/旁白内容]"
音效：[环境音描述]。
禁止：任何文字、字幕、LOGO或水印；画面中角色出现说话口型
```

### 3.8 短剧示例集

**示例 A — 反转短剧（对白场景）：**
```
12秒都市短剧，真人写实+电视剧质感+暖色调，
画面（0-4秒）：中景，从办公桌正前方平视拍摄，豪华办公室，
穿西装的男人位于画面中央，面部朝向对面的女生，
视线冷漠地注视着她，缓慢推进逐步制造压迫感。
台词（男人，冷漠）："从今天起，你不用来上班了。"
画面（4-8秒）：过肩近景，从男人右肩后方拍摄，焦点在女生脸上，
女生位于画面中央，面部朝向男人，视线惊愕地直视他的眼睛，
手持微晃，85mm浅景深柔化背景。
台词（女生，颤抖）："为什么？"
画面（8-12秒）：中景，男人转身，递出一份文件，
面部朝向女生，视线温柔地注视她，嘴角浮现微笑，
推轨缓慢后拉，揭示两人之间关系的反转。
台词（男人，温柔）："因为这是你的CEO任命书。"
音效：办公室安静环境音+纸张翻页声。
禁止：任何文字、字幕、LOGO或水印
```

**示例 B — 情感内心独白（画外音场景）：**
```
10秒都市女频短剧，真人写实+电视剧质感+暖色调，
画面（0-4秒）：中景，从宾客席侧方拍摄，订婚宴会厅，
女主身着白色礼服位于舞台中央，面部微转向台下亲友区，
视线温柔地扫过人群，眼眶微湿，嘴角挂着幸福微笑。
镜头缓慢推进至近景特写，逐步深入角色情感世界。
画外音："二十年了，我终于要嫁给最爱的人，拥有自己的家了。"
音效：宴会厅人群低语+远处的祝福掌声。
禁止：任何文字、字幕、LOGO或水印；画面中角色出现说话口型
```

**示例 C — 冲突爆发（动作+对白）：**
```
12秒废土末世短剧，3D CG+废土灰色调+男频科幻，
画面（0-4秒）：中近景，从角色A右侧平视拍摄，破败街道，
角色A衣衫褴褛，位于画面左侧，正吃力拖着废铁，
面部朝向前方掩体，视线专注于目标。镜头静止，交代叙事场景。
画面（4-8秒）：特写，焦点在角色A手部，
一只满是油污的靴子猛踩在废铁上，角色A手掌在粗糙铁面上磨破渗血。
镜头静止，聚焦冲突瞬间的物理细节。
环境音：靴子踩踏金属的重响+手掌摩擦声。
画面（8-12秒）：低角度仰拍，从角色A的视角向上拍摄，
角色B居高临下，占据画面上方，面部朝向地上的角色A，
视线轻蔑地俯视他，嘴角带着冷笑。
镜头静止，仰视角度强化角色B的压迫感与权力优势。
台词（角色B，轻蔑）："今天运气不错啊，捡这么大一块铁。"
禁止：任何文字、字幕、LOGO或水印
```

**示例 D — 2D日漫风格（动作追逐）：**
```
12秒男频都市短剧，2D日漫+半厚涂风格+夜景冷色调，
画面（0-4秒）：远景，低角度跟拍，暴雨泥泞道路，
主角浑身是血，位于画面中央偏左，面部朝向前方黑暗处，
视线惊恐地扫视前方。身后刺眼的车灯追逼。
镜头跟随主角移动，画面晃动传递奔逃的慌乱感。
环境音：暴雨声+急促喘息+泥水飞溅。
画面（4-8秒）：中景，从主角斜后方拍摄，
黑衣追兵从越野车跳下，手持利刃，
面部朝向主角背影，视线锁定目标，带着狞笑逼近。
镜头保持静止，形成追兵与猎物的空间对峙构图。
台词（追兵，低沉）："跑什么？把东西交出来。"
画面（8-12秒）：俯视镜头，从高处向下拍摄，
主角撞开铁门，脚下一空坠入深坑，
镜头从深坑边缘向下拍摄，传递坠落的眩晕感。
环境音：铁门碰撞+坠落风声+重摔闷响。
禁止：任何文字、字幕、LOGO或水印
```

**示例 E — 多段分镜过渡策略示例（导演阐述部分）：**
```
### 导演阐述（仅供理解创作意图，无需复制）

叙事弧线：订婚宴的幸福→妹妹闯入的冲击→真相揭露的崩塌

分镜1→2过渡策略：视线连接——镜头从舞台上的新人转到台下宾客，
通过女主的视线方向自然引导观众目光下移，营造幸福弥漫全场的氛围。

分镜2→3过渡策略：反差对切——上一镜是温馨的宾客祝福，
本镜开场即大门被撞开的巨响，音乐骤停，用声画双重反差制造冲击。

分镜3→4过渡策略：快速剪辑冲击——从全景的混乱切到闯入者的特写狼狈，
再用长焦从闯入者背后锁定舞台上的新郎，三级景别递进强化悬念。
```

---

## 四、美食特写

**核心参数：**
- 画幅：9:16竖屏（美食号）或 16:9（广告）
- 时长：5-8秒
- 运镜：ECU微距 + Orbit + Overhead俯拍
- 材质：食物油光/蒸汽/酱汁流动的物理模拟

**模板：**
```
[时长]美食特写，[光线风格]，
0-Xs：Overhead俯拍，[食物排列]，静态构图；
X-Xs：ECU微距特写[食物细节]，浅景深，
[酱汁/蒸汽/芝士拉丝]的物理流动效果；
X-Xs：Slow Motion慢镜头，[食物制作的关键动作]，
食材碰撞溅起[液体/粉末]。
音效：[ASMR效果——切割声/油炸声/咀嚼声]。
```

---

## 五、音乐MV/卡点

**核心参数：**
- 画幅：16:9 或 9:16
- 时长：10-15秒
- 运镜：Speed Ramp + Whip Pan + 节奏剪辑
- 关键：音画同步，必须引用@音频

**模板：**
```
[时长]MV卡点风格，@音频1为配乐，
参考@视频1的节奏卡点（如有），

0-Xs：[画面]，Beat 1命中[动作]，Speed Ramp慢转快；
X-Xs：Whip Pan转场，[画面切换]，Beat 2命中[动作]；
X-Xs：[画面]，慢动作+节拍命中高潮；
X-Xs：[收束]，渐入黑屏。

光影：频闪灯光/舞台色光轮换/剪影逆光。
```

---

## 六、一镜到底

**核心参数：**
- 画幅：16:9
- 时长：10-15秒
- 运镜：Steadicam/Gimbal全程不切镜头
- 关键：提示词中明确声明"一镜到底，全程不切镜头"

**模板：**
```
[时长]一镜到底，全程不切镜头，
Steadicam/Gimbal稳定流畅穿越，
[大气连贯声明]，

镜头从[起点]出发，
Tracking穿过[空间A]，经过[动作/事件A]，
转向进入[空间B]，遇到[动作/事件B]，
最终Push In聚焦[终点/关键物体]。
全程保持流畅连续运动，无跳切。
```

---

## 七、微距特效/万物生长

**核心参数：**
- 画幅：16:9
- 时长：5-10秒
- 运镜：ECU微距 + Slow Motion + Time-lapse
- 材质：微观物理（水滴/粒子/植物纤维）

**模板：**
```
[时长]微距摄影，Extreme Close-Up微距视角，
浅景深散景，macro lens 100mm质感，

[物理过程描述]——[水滴碰撞/花朵绽放/冰晶形成]，
Slow Motion 120fps慢镜头捕捉每个细节，
微观粒子在光线中漂浮，背景散景柔和。
```

---

## 八、汽车大片

**核心参数：**
- 画幅：2.35:1超宽银幕 或 16:9
- 时长：10-15秒
- 运镜：跟拍 + 航拍 + 仰拍低角度
- 材质：金属光泽/轮胎烟雾/路面反射

**模板：**
```
[时长]汽车广告大片，2.35:1宽银幕，
ARRI ALEXA摄影机质感，[天气/路面条件]，

0-Xs：航拍跟拍，车辆行驶在[壮阔场景]，
车漆反射天光，轮胎卷起[尘/水]；
X-Xs：Low Angle仰拍，车辆从镜头前掠过，
Speed Ramp慢转快，引擎轰鸣+风切声；
X-Xs：[品牌展示角度]，车辆停在[场景]中，
golden hour侧逆光打亮车身线条。
```

---

## 九、自然风光/航拍

**核心参数：**
- 画幅：16:9 或 2.35:1
- 时长：10-15秒
- 运镜：航拍缓慢推进 + 摇臂升降 + Hyperlapse
- 材质：自然光、大气透视、体积云

**模板：**
```
[时长]自然风光，[IMAX/杜比]级画质，
航拍视角，[大气效果]，

0-Xs：航拍高空缓慢Dolly Forward推进，
[壮阔自然景观]在晨雾中逐渐显现；
X-Xs：Crane Down降落至[水面/花海/山脊]，
从高远到近景的层次切换；
X-Xs：[自然元素特写]——[瀑布水雾/花海摇曳/冰川断裂]，
体积光穿透大气。
音效：[自然环境音——风声/水声/鸟鸣]。
```

---

## 十、超长视频分段拼接模板（>15秒）

**核心策略：** 每段 ≤15秒，使用"视频延长"功能串接。

**Segment 1（主体生成）：**
```
[15秒][完整提示词]，
最后2秒：画面稳定过渡至可延续的交接帧，
角色动作收束至静止/可持续状态，光照稳定。
```

**Segment 2+（延长续接）：**
```
将@视频1延长[X]秒，
保持一致的角色外貌/服装/光照条件/色调风格，
[续接动作描述]，[运镜承接]，
全程延续上段的大气效果和色调。
```

**交接帧原则：**
1. 前段末尾画面必须稳定（禁止运镜中断）
2. 后段开头声明一致性（角色/光照/氛围）
3. 运镜连续（前段Dolly In结束 → 后段自然承接）

---

## 十一、游戏 PV / 角色出场

**核心参数：**
- 画幅：16:9 或 2.35:1
- 时长：10-15秒
- 运镜：Orbit环绕 + Speed Ramp + Push In + 定格
- 材质：高精度CG渲染、粒子特效、技能光效

**模板：**
```
[时长]游戏角色出场PV，UnrealEngine5渲染，[画质锚定]，
[史诗/暗黑/赛博]风格，

0-Xs：黑屏+[角色标志性音效]，微弱粒子汇聚；
X-Xs：Speed Ramp从慢到快，角色[标志性动作/武器出鞘]，
Orbit 180°侧面环绕，[技能特效/元素爆发]；
X-Xs：Push In锁定面部特写，[眼部特效/瞳孔变化]，
背景[能量冲击波/粒子爆散]；
X-Xs：[定格Pose]，角色全身居中，粒子收束，
渐入黑屏或标题。
光影：[技能色光]+[rim light勾勒轮廓]+[体积雾]。
音效：[充能嗡鸣→爆发冲击→史诗管弦收束]。
```

**示例 — 暗黑角色登场：**
```
12秒游戏角色出场，UnrealEngine5渲染，工业光魔级VFX，暗黑哥特风格，
0-3秒：纯黑画面，低沉心跳般鼓点，紫色暗能量粒子从四周汇聚至中心；
3-7秒：Speed Ramp爆发，角色挥出巨型镰刀弧线斩，
Orbit 180°逆时针环绕，暗紫色能量沿刀锋轨迹拖尾；
7-10秒：Push In急推面部ECU，瞳孔中紫色符文旋转，
背景暗能量冲击波向外扩散；
10-12秒：Pull Out定格全身Pose，镰刀杵地，暗雾收束，渐入黑屏。
光影：暗紫色技能光+冷白rim light+浓重体积雾。
音效：低频充能嗡鸣→金属利刃破空→次声波冲击→寂静。
禁止：任何文字、字幕、LOGO或水印
```

**Example — Fire Mage Reveal (English anchor):**
```
12s game character reveal, UnrealEngine5 rendering, ILM-grade VFX, dark fantasy style,
0-3s: Black screen, deep heartbeat-like drums, crimson fire particles converging from edges to center;
4-7s: Speed Ramp burst, character swings flaming greatsword in wide arc,
Orbit 180° clockwise, fire trail following blade trajectory;
8-10s: Push In to face ECU, flame runes spiraling in pupils,
fire shockwave expanding outward behind;
11-12s: Pull Out freeze full-body pose, sword planted in ground, embers settling, fade to black.
Lighting: crimson skill light + cold white rim light + heavy volumetric fog.
SFX: low-frequency charge hum → metal blade whoosh → sub-bass impact → silence.
Negative: any text, subtitles, logos or watermarks
```

### 二次元 / Cel-Shaded 变体

> 当用户需要的是《原神》《崩铁》风格的 **动画化游戏PV** 而非写实CG时，使用此变体。
> 核心区别：渲染引擎从 `UnrealEngine5渲染` 切换为 `3D Cel-Shaded Toon渲染`，材质从写实PBR切换为动画化材质。

**变体模板：**
```
[时长]二次元游戏角色PV，3D Cel-Shaded Toon渲染，
Anime风格硬边阴影二值化，粗描边轮廓线，[色调总纲]，

0-Xs：黑屏+[角色标志性音效]，Anime风格粒子汇聚；
X-Xs：[角色动作/武器展示]，Orbit环绕，
Anime头发高光带+简化平涂材质+强Rim Light；
X-Xs：Push In面部特写，[眼部特效]，
高饱和角色色盘，Anime散景；
X-Xs：[定格Pose]，全身居中，渐入黑屏。
光影：Anime式Rim Light + 技能色光 + 简化阴影。
音效：[充能→爆发→收束]。
```

**示例 — 二次元冰属性角色PV：**
```
12秒二次元游戏角色PV，3D Cel-Shaded Toon渲染，
Anime风格硬边阴影二值化，粗描边轮廓线，冰蓝主色调，
0-3秒：纯黑画面，冰晶粒子从四周向中心缓慢汇聚，高频冰裂音效；
3-7秒：角色持长枪旋转横扫，Orbit 180°环绕，
冰霜沿枪尖轨迹扩散，Anime头发高光带随动作流转，简化平涂材质；
7-10秒：Push In面部特写，冰蓝色瞳孔中雪花结晶旋转，
强Rim Light勾勒面部轮廓，高饱和冰蓝色盘，Anime散景；
10-12秒：Pull Out定格全身Pose，长枪斜指天空，冰雾收束，渐入黑屏。
光影：Anime式冰蓝Rim Light + 冷白技能光 + 简化硬边阴影。
音效：冰裂碎响→寒风呼啸→冰晶凝固的清脆一击→寂静。
禁止：任何文字、字幕、LOGO或水印
```

---

## 十二、恐怖惊悚片段

**核心参数：**
- 画幅：16:9 或 2.35:1
- 时长：8-15秒
- 运镜：Slow Push In + Static长镜头 + 突然Whip Pan
- 关键：**负空间控制**——画面中大量黑暗/留白制造不安

**模板：**
```
[时长]恐怖惊悚片段，[低调打光]，[低饱和暗色调]，
全程画面多为阴暗，仅有微弱光源，

0-Xs：Static固定镜头/Slow Push In，[空旷阴暗场景]，
画面大量负空间（暗部占70%+），[微弱环境异响]；
X-Xs：[不安的征兆]——[物体微动/影子变化/灯光闪烁]，
镜头保持不动或极缓推进，制造窒息等待感；
X-Xs：[惊吓瞬间]——Whip Pan/Snap Zoom/突然出现，
画面剧烈变化，[声音冲击]；
（可选）X-Xs：回到静默，[余韵恐惧]。
音效：极致安静（仅呼吸/心跳）→ 突然[尖锐音效/低频冲击]。
```

**示例 — 走廊恐怖：**
```
10秒恐怖惊悚，低调打光，灰绿去饱和色调，
0-4秒：Static固定镜头，昏暗的医院走廊尽头，
仅有一盏天花板荧光灯闪烁发出嗡嗡声，画面80%为黑暗，
远处隐约有轮椅的影子；
4-7秒：Subtle Push In极缓推进，荧光灯闪烁频率加快，
轮椅似乎自己移动了几厘米，地板传来吱呀声；
7-10秒：荧光灯熄灭一瞬——重新亮起时，
走廊尽头多了一个站立的人形，面部在暗处不可见。
音效：荧光灯嗡鸣+远处滴水+突然的寂静→低频冲击。
禁止：任何文字、字幕、LOGO或水印
```

---

## 十三、旅行 / 城市氛围片

**核心参数：**
- 画幅：16:9（电影感）或 9:16（Vlog）
- 时长：10-15秒
- 运镜：POV街景 + Gimbal跟拍 + Hyperlapse + Aerial
- 风格：蒙太奇碎片拼贴，生活化自然光

**模板：**
```
[时长][城市/地点]氛围短片，35mm胶片颗粒质感，
自然色温，生活气息，蒙太奇节奏，

0-Xs：航拍/摇臂下降，[城市天际线/标志性场景]清晨/黄昏远景；
X-Xs：街景POV/Gimbal跟拍，穿过[市场/小巷/人群]，
[在地文化细节]——[招牌/食物/工艺/建筑纹理]的ECU特写；
X-Xs：[人与城互动]——[当地人动作/表情/手部特写]，
自然光+浅景深，手持微晃纪实感；
X-Xs：Golden Hour收束，[城市剪影/窗景/远景]，
渐入暖调，留白收尾。
音效：城市环境音拼贴——[在地声音/人声/交通/音乐]。
```

---

## 十四、宠物 / 萌系

**核心参数：**
- 画幅：9:16竖屏（抖音）或 1:1 方形
- 时长：5-10秒
- 运镜：与动物**平视机位** + ECU微距毛发 + Slow Motion
- 材质：毛发纤维质感、暖色柔光、散景

**模板：**
```
[时长]宠物萌系短片，暖色柔光，治愈氛围，
镜头与[动物]平视（Eye-Level机位），

0-Xs：Eye-Level平视，[动物]居中，[萌态动作]，
85mm浅景深，背景温暖散景；
X-Xs：ECU微距特写，[毛发/爪垫/鼻头/眼睛]，
Individual fur strands catching warm backlight，
柔和侧逆光打亮毛发轮廓；
X-Xs：Slow Motion慢镜头，[动态瞬间——甩头/跳跃/打哈欠]，
毛发飘动+惯性延迟细节。
音效：[萌系音效——呼噜/轻叫/爪子踏地+轻快BGM]。
```

**示例 — 猫咪特写：**
```
8秒猫咪治愈短片，暖色柔光golden hour，竖屏9:16，
0-3秒：Eye-Level平视，橘猫蹲坐在窗台，慵懒眯眼，
85mm浅景深，窗外暖色散景，猫咪占画面60%；
3-6秒：ECU微距特写猫爪轻轻揉面，肉垫粉嫩质感，
fur strands catching golden backlight，每根胡须清晰可见；
6-8秒：Slow Motion慢镜头，猫咪打了一个小哈欠，
舌头微卷，耳朵微微抖动，毛发因呼吸轻微起伏。
音效：轻柔呼噜声+窗外鸟鸣+温暖钢琴旋律。
禁止：任何文字、字幕、LOGO或水印
```

---

## 十五、Before/After 变身类

**核心参数：**
- 画幅：9:16竖屏
- 时长：5-8秒
- 运镜：Static → 遮挡/Flash转场 → Static
- 关键：**转场瞬间的视觉冲击** + 前后对比极致反差

**模板：**
```
[时长]变身对比短片，竖屏9:16，
[前半段风格] → [转场] → [后半段风格]，

0-Xs：[Before状态]，[朴素/混乱/旧]，
Static/Slow Push In，低饱和/冷色调；
X秒：[转场瞬间]——[手遮镜头/闪光/Whip Pan/物体飞过]，
画面剧烈变化，Speed Ramp加速；
X-Xs：[After状态]，[华丽/整洁/新]，
同角度Static，高饱和/暖色调，Slow Zoom Out揭示全貌。
音效：[蓄力音效] → [转场冲击Bass Drop] → [揭示音效]。
```

---

## 十六、Meme / Loop / GIF 风格短片

**核心参数：**
- 画幅：1:1 方形 或 9:16
- 时长：2-4秒（极短）
- 运镜：简单循环动作 + Static/缓慢Orbit
- 关键：**首尾帧无缝衔接**，形成完美循环

**模板：**
```
[2-4秒]无缝循环短片，[风格]，

[单一主体]执行[可循环动作]，
动作结束状态与起始状态完全一致，
形成无缝循环播放效果。
Static固定机位 或 360° Orbit完整一圈。
背景简洁，主体突出。
```

**循环技巧：**
- 动作必须"回到原点"：点头→回正、旋转→360°整圈、弹跳→落回原位
- 避免位移：角色不能在循环中产生净位移
- 简洁背景：纯色/渐变/简单几何，减少背景断裂感

---

## 十七、视频编辑 / 剧情颠覆

**核心参数：**
- 时长：与原视频一致（4-15秒）
- 必须素材：@视频1（原视频）
- 可选素材：@图片N（替换角色/场景）

**编辑三模式：**

| 模式 | 适用场景 | 关键指令 |
|------|---------|---------|
| 元素替换 | 换角色/换场景/换服装 | `将@视频1中的[A]替换为@图片1` |
| 剧情颠覆 | 反转剧情走向 | `颠覆@视频1的剧情，[新走向]` |
| 风格改写 | 改色调/改画风/改氛围 | `保留@视频1的运镜和动作，风格改为[新风格]` |

**通用结构模板：**
```
基于@视频1进行编辑：

【保留】[明确列出保留的元素：运镜/动作/场景]
【修改】[具体修改点1，精确到时间段]
【修改】[具体修改点2]

保持镜头连贯，仅在指定位置修改。
禁止：任何文字、字幕、LOGO或水印
```

**示例 — 短剧剧情颠覆（15秒）：**
```
颠覆@视频1的剧情。

【保留】原视频的古风庭院场景、桥上站位、环绕运镜
【修改】0-3秒：男主眼神从温柔瞬间转为冰冷决绝，嘴角微微上扬
【颠覆】3-7秒：男主趁女主不备，猛然将她推落桥下水中，动作干脆蓄谋已久
【新增】7-11秒：水面特写，女主浮出水面，难以置信的眼神，嘶吼
台词（女主，崩溃）："你从一开始就在骗我！"
【新增】11-15秒：男主站在桥上，阴冷低语，水面倒影渐暗，画面趋于静止
台词（男主，低沉）："这是你家欠我的。"

光影：保持原视频月光冷调，女主落水后加入水面散射冷光。
音效：落水重击+水下闷响+嘶吼回声+最终寂静。
禁止：任何文字、字幕、LOGO或水印
```

**示例 — 风格改写（保留运镜换画风）：**
```
保留@视频1的所有运镜轨迹和角色动作时序。

【保留】完整的推轨→环绕→特写运镜路径
【修改】画面风格从写实改为浮世绘水墨渲染，粗墨线勾勒轮廓
【修改】色调从暖金改为靛蓝冷灰，墨渍飞溅粒子替代原有扬尘
【修改】角色服装从现代改为和风武士甲胄

光影：单色墨韵侧光+白描高光+纸面纹理底色。
音效：保持原视频节奏，替换为尺八+太鼓配乐。
禁止：任何文字、字幕、LOGO或水印
```

---

## 十八、视频延长（v1.8 新增）

> 对已有视频进行前向/后向延长。**关键认知：选择的“生成时长” = 新增部分的时长，不是总时长。**

**核心参数：**
- 必须素材：@视频1（原视频）
- 可选素材：@图片N（角色/场景参考）
- 生成时长：新增秒数，而非总时长

**向后延长（续拍）模板：**
```
[N]秒
将@视频1延长[N]秒。
[描述原视频最后一帧的状态作为起始]，
0-X秒：[续接画面描述]。
X-N秒：[结尾画面/字幕]。
保持与原视频一致的角色外貌/光照/色调。
```

**向前延长（前传）模板：**
```
[N]秒
将@视频1向前延长[N]秒。
0-X秒：[前置画面描述]。
X-N秒：[过渡到原视频首帧的状态]。
保持与原视频一致的角色外貌/光照/色调。
```

**English Templates:**
```
[N]s
Extend @Video1 by [N] seconds.
[Describe the state of the original video's last frame as starting point],
0-Xs: [continuation visuals].
X-Ns: [ending visuals/titles].
Maintain consistent character appearance/lighting/color tone with original video.
```

**延长核心技巧：**
1. **描述起始状态** — 延长 prompt 开头应描述原视频最后帧/首帧的状态，帮助模型平滑续接
2. **结合时间分段** — 用 `1-5秒/6-10秒` 让衍接更自然
3. **一致性声明** — 显式声明保持角色/光照/色调一致
4. **可参考额外图片** — 延长视频可参考额外图片补充新角色/新场景

---

## 十九、剧情补全与分镜图转视频（v1.8 新增）

> Seedance 2.0 能根据少量素材自动补全剧情逻辑，或直接读懂分镜脚本图的景别和镜头语言。

### 19.1 分镜脚本图转视频

上传手绘或排版的分镜脚本图，模型能直接读懂景别、镜头角度、场景切换：

**模板：**
```
参考@图片1的分镜头脚本，
参考其中的分镜、景别、运镜、画面和文案，
创作一段[X]秒的[主题]视频。
```

**English:**
```
Reference the storyboard in @Image1,
follow its shot composition, angles, camera movements, visuals and copy,
create a [X]s video about [theme].
```

> **核心技巧：** 分镜图比文字描述更精准——模型能直接读懂景别、镜头角度、场景切换。有分镜就用分镜。

### 19.2 漫画分格动态演绎

上传漫画页面，模型按格子顺序动态演绎：

**模板：**
```
将@图片1以从左到右从上到下的顺序进行漫画演绎，
保持人物说的台词与图片上的一致，
分镜切换以及重点的情节演绎加入特殊音效，
整体风格[核谐幽默/热血燃/治愈温馨]。
```

**English:**
```
Animate @Image1 as a comic strip from left-to-right, top-to-bottom,
keep character dialogue consistent with text in the image,
add special sound effects for scene transitions and key plot moments,
overall style [humorous/action-packed/heartwarming].
```

### 19.3 图片情绪发散

给几张风格图+音乐，模型发散出情绪向视频：

**模板：**
```
参考@视频1的音频，
根据@图片1~@图片N为灵感，发散出一条情绪向的视频。
背景音乐参考@视频1。
```

**English:**
```
Reference audio from @Video1,
using @Image1~@ImageN as inspiration, create an emotion-driven video.
Background music reference @Video1.
```

> **核心技巧：** 图片顺序影响叙事节奏，按期望出现顺序传入。可告诉模型“可自行改变景别”，给它调整空间。

---

## 二十、多帧故事（multiframe2video）（v1.8.4 新增）

> 即梦 CLI 支持 `multiframe2video` 命令——上传多张关键帧图片，引擎自动编排为连贯故事视频。
> 与「多段分镜」的区别：多段分镜是每段独立生成后手动拼接；多帧故事是多图一次提交，引擎自动理解图片叙事逻辑并生成连贯过渡。

### 何时用多帧故事 vs 多段分镜

| 场景 | 推荐方式 | 理由 |
|------|----------|------|
| 有多张关键帧/角色设计图，需要连贯故事 | **多帧故事** | 引擎自动编排过渡，一次生成 |
| 超长视频（>15秒）需要精确分镜控制 | **多段分镜** | 每段独立校验，手动控制交接 |
| 漫画分格/分镜脚本图 | **多帧故事** | 引擎能读懂分格顺序 |
| 需要精确时间轴控制（卡点/节奏） | **多段分镜** | 时间戳分镜更精准 |

### 核心参数

- **必须素材**：2-9 张关键帧图片
- **画幅**：随图片比例 或 指定
- **图片顺序**：按叙事顺序传入（第1张=开头，最后1张=结尾）
- **提示词**：描述整体故事和风格，不需要逐帧描述

### 模板

**中文：**
```
参考以下图片序列创作一段连贯故事视频：
@图片1为开场画面，@图片2为发展，@图片3为[高潮/转折]，@图片N为结局。
整体风格：[风格总纲]。
故事线：[一句话概括叙事弧线]。
保持角色外貌在所有画面间完全一致。
[运镜/节奏要求]。
音效：[音效描述]。
禁止：任何文字、字幕、LOGO或水印
```

**English:**
```
Create a coherent story video from the following image sequence:
@Image1 as opening, @Image2 as development, @Image3 as [climax/turning point], @ImageN as ending.
Overall style: [style overview].
Story arc: [one-line narrative arc summary].
Maintain character appearance perfectly consistent across all frames.
[Camera/pacing requirements].
SFX: [sound description].
Negative: any text, subtitles, logos or watermarks
```

### 示例 — 仙侠角色觉醒三幕剧（3张关键帧）

```
参考以下图片序列创作一段连贯故事视频：
@图片1为开场——角色在山间静坐冥想，
@图片2为转折——角色睁眼，周围灵力汇聚，
@图片3为高潮——角色腾空而起，衣袂飘飞。
整体风格：写实东方电影质感，金青色调，空灵史诗氛围。
故事线：从沉寂冥想到灵力觉醒再到破空飞升的渐进张力。
保持角色外貌（白衣、长发、玉冠）在所有画面间完全一致。
运镜从远景静态逐步推进到环绕动态，节奏由缓到急。
音效：山风→灵力共振嗡鸣→破空冲击波。
禁止：任何文字、字幕、LOGO或水印
```

**Example — Character Awakening Three-Act (3 keyframes, English):**

```
Create a coherent story video from the following image sequence:
@Image1 as opening — character meditating in mountain stillness,
@Image2 as turning point — character opens eyes, spiritual energy converging,
@Image3 as climax — character ascending into sky, robes billowing.
Overall style: realistic Eastern cinematic look, gold-teal palette, ethereal epic atmosphere.
Story arc: gradual tension from silent meditation to spiritual awakening to skyward ascension.
Maintain character appearance (white robes, long hair, jade crown) perfectly consistent across all frames.
Camera progressing from distant static to orbital dynamic, pacing from slow to intense.
SFX: mountain wind → spiritual resonance hum → skyward shockwave.
Negative: any text, subtitles, logos or watermarks
```

### 多帧故事核心技巧

1. **图片顺序即叙事顺序** — 引擎按传入顺序理解时间线
2. **保持角色一致性** — 每张图中的角色外貌应尽量一致，或在提示词中强调 `保持一致`
3. **提示词侧重整体** — 不需要逐帧描述画面内容（图片已经包含），侧重写故事弧线、风格、运镜节奏
4. **图片数量建议** — 3-5 张最佳，过多图片可能降低过渡流畅度

---

## 十九、时间静止 / 子弹时间 (Freeze Time)（v1.8.5 新增）

> 通过极具视觉冲击力的特效运镜，在完全凝固的场景中进行摄影机穿梭。适用于商业大片、特效展示和戏剧化高潮。

**核心参数：**
- 必须包含提示词：`场景完全静止` / `completely frozen scene`
- 运镜：快速推轨 (Dolly Track) 或 三维穿梭 (Weave through)
- 如果提供首帧图（@图片1为起幅），效果会大幅提升

**模板：**
```
[时长]子弹时间特效，[渲染/精度要求]，
@图片1为起幅，场景完全静止(completely frozen scene)，
[静止场景中的元素：漂浮的碎片/水滴/火星/人群]，
[运镜手法]：镜头极速穿梭/环绕经过这些静止元素，
最终定格于[画面核心焦点]。
```

**English:**
```
[Xs] bullet time effect, [render/quality anchor],
use @Image1 as starting frame, completely frozen scene,
[elements frozen in mid-air: floating debris/water droplets/embers/crowd],
camera dramatically weaves through the frozen scene,
finally locking focus on [core subject].
```

---

## 二十、多镜头混剪序列 (Multishot Video)（v1.8.5 新增）

> 官方推荐的高级玩法，用 `multishot video` 指令打破一镜到底的限制，让大模型在单次生成中自动完成多镜头蒙太奇剪辑。

**核心参数：**
- 必须包含提示词：`多镜头视频` / `multishot video`
- 适用于：快速蒙太奇、MV拼接、预告片快速闪现
- 注意：牺牲了空间连续性，但获得了更密集的叙事节奏。

**模板：**
```
[时长]多镜头视频混剪，[风格总纲]，
第一镜：[画面描述+运镜A]；
第二镜：[画面描述+运镜B]；
第三镜：[画面描述+运镜C]。
节奏极快，镜头切换凌厉。
```

**English:**
```
[Xs] multishot video, [style overview],
Shot 1: [visuals + camera A];
Shot 2: [visuals + camera B];
Shot 3: [visuals + camera C].
Fast-paced montage with sharp cuts.
```

---

## 二十一、极限第一人称视角 (Extreme POV / FPV)（v1.8.6 新增）

> 通过明确的观察逻辑、极限的风噪环境音和纯净图池法则，生成极具视觉冲击力的极限第一人称沉浸视角（如弓箭、飞鸟、御剑、跑酷等）。

**核心参数与法则：**
- **背景纯净法则**：如果是多模态参考（图生视频），提供的参考人物/物体素材图**必须是纯白/空白背景**，否则杂乱背景会污染第一人称视角的环境生成。
- **音效排他原则**：必须强调 `仅生成环境音效，绝对不要配任何背景音乐(BGM)和对白`。
- **动感修饰词**：极度的摇晃感 (extreme camera shake)、风噪氛围感 (wind noise)、强烈透视 (strong perspective)、高速飞行 (high-speed flight)。

### 21.1 真实人类 POV (带视线转移)

> 模拟人眼“先向下看，再抬头眺望”的沉浸式运镜操作。

**模板：**
```
[时长]真实第一人称POV视角，
0-X秒：镜头朝下，显示[人物自己的脚/手中的剑/手机]，镜头伴随自然呼吸微距晃动。
X-N秒：[向上抬眼/视野上抬]，眺望远方的[宏大场景]，[镜头伴随摇晃向前移动]。
注意保持第一人称肢体与周围环境的比例正常。
音效：仅生成[真实脚步声/喘息声/风动声]，绝对不要配任何背景音乐和台词。
```

**English:**
```
[Xs] realistic first-person POV shot,
0-Xs: Camera looks down, revealing [subject's feet/sword in hand/phone], subtle natural breathing camera shake.
X-Ns: [Look up / tilt up], gazing at distant [epic scenery], [camera moves forward with hand-held shake].
Maintain realistic scale proportions between first-person limbs and environment.
SFX: Generate ONLY [realistic footsteps/breathing/wind noise], absolutely NO background music or dialogue.
```

### 21.2 飞行物体 FPV (无人机/飞箭/飞剑)

> 附着在高速移动物体上的极限机位，强调穿梭感与破空感。

**模板：**
```
[时长]物体第一人称FPV视角(Projectile POV)，主观视角附着在[飞行中的箭镞/御剑飞行的剑首]上。
镜头跟随着[物体]在空中高速穿梭/俯冲，掠过[云层/人群/屋檐]。
极度的摇晃感，强烈风噪氛围，强烈的透视感。
最后定格于/击中[目标点]。
音效：仅生成强烈的[破空声/疾风呼啸声]，绝对不要配任何背景音乐和台词。
```

**English:**
```
[Xs] object first-person FPV / projectile POV, subjective camera attached to [a flying arrowhead / front of a flying sword].
Camera darts and dives through the air at high speed with the [object], skimming past [clouds/crowd/rooftops].
Extreme camera shake, intense wind noise atmosphere, strong perspective.
Finally locking onto / hitting [target].
SFX: Generate ONLY intense [air-piercing slash/howling wind], absolutely NO background music or dialogue.
```

### 21.3 生物第一视角 (飞鸟/走兽 POV)

> 模拟动物的移动习惯与视野高度（如从高空俯视，或从草丛低视角穿梭）。

**模板：**
```
[时长]白鹤/老鹰的第一人称飞行POV视角，
镜头模拟鸟类飞行的高低起伏，[从高空急速俯冲向下/贴着水面滑翔飞升]，穿梭于[场景元素]之间。
强烈运动模糊与极速穿梭感。
音效：仅生成强烈的风噪与翅膀扑腾声，绝对不要配任何背景音乐和台词。
```

**English:**
```
[Xs] first-person bird flight POV of a [crane / falcon],
Camera mimics the undulating flight path of a bird, [rapidly dive-bombing from high altitude / soaring close to water surface], weaving through [scene elements].
Strong motion blur and sense of extreme speed.
SFX: Generate ONLY intense wind noise and wing flapping, absolutely NO background music or dialogue.
```

---

## 附录：动作物理阻尼词库 (Physics Simulation)

> **跨场景通用工具箱。** 解决 AI 视频中人物动作像"滑步 (Moonwalking)"的核心问题——不写"他跑"，而是描述物理受力过程，让大模型的三维物理模拟器正确工作。

### 反滑步对照表

| ❌ 滑步写法（触发 AI 瑕疵） | ✅ 物理阻尼写法（正确） |
|----------------------------|----------------------|
| 他向前跑 | 重心快速前倾，双腿交替蹬地，鞋底与地面每步产生碎石飞溅 |
| 她转身离开 | 重心先向转向侧偏移，肩膀带动躯干旋转，裙摆因惯性延迟0.5秒跟随 |
| 他被击飞 | 冲击力从胸口传导，身体向后弓形弹出，四肢因惯性滞后甩动 |
| 她跳起来 | 膝盖深蹲蓄力，重心猛然上移，头发因反向惯性短暂下压后飘起 |

### 重心与力学 (Weight & Momentum)

| 物理动作 | 英文提示词 | 适用场景 |
|----------|-----------|---------|
| 重心快速转移 | `Rapid weight transfer from back foot to front` | 起跑/出拳/突然加速 |
| 重心偏移 | `Center of gravity shifting laterally` | 转弯/闪避/失去平衡 |
| 惯性延续 | `Momentum carry-through with residual body sway` | 急停/被击退后的惯性晃动 |
| 蓄力释放 | `Coiling tension release from legs through torso` | 跳跃/挥剑/投掷 |
| 失重飘浮 | `Zero-gravity drift with limbs trailing behind` | 太空/水下/仙侠飞行 |

### 流体与材质互动 (Fluid & Material)

| 物理效果 | 英文提示词 | 适用场景 |
|----------|-----------|---------|
| 泥水飞溅流体力学 | `Splashing fluid dynamics, water droplets arcing with realistic trajectory` | 雨天奔跑/泥地打斗 |
| 织物风阻 | `Realistic fabric wind resistance, heavy coat dragging against movement` | 风衣/斗篷/旗帜 |
| 头发惯性甩动 | `Hair whip with inertia delay, strands following head rotation 0.3s late` | 转身/被击/突然回头 |
| 液体泼溅物理 | `Liquid splash with viscosity-appropriate spread pattern` | 血液/酒水/雨水 |
| 烟尘扰流 | `Turbulent smoke displaced by rapid body movement` | 穿越烟雾/爆炸后奔跑 |

### 环境互动（掩盖 AI 瑕疵的利器）

> **核心技巧：** 当角色与地面/环境持续互动时，大模型会被迫计算接触面物理，从而大幅减少"悬浮滑步"。

| 互动效果 | 英文提示词 | 适用场景 |
|----------|-----------|---------|
| 踩踏碎石飞溅 | `Debris kicked up with each footstep, gravel scattering` | 追逐/奔跑/战斗 |
| 水坑踩踏 | `Puddle splash on each footstep, water ripples spreading` | 雨天场景/湿地 |
| 雪地压痕 | `Snow compression under weight, leaving deep footprints` | 雪地行走/追踪 |
| 沙尘卷起 | `Sand clouds rising with each stride, wind carrying particles` | 沙漠/战场 |
| 草地压弯 | `Grass blades bending and springing back under footsteps` | 田野/草原/花海 |
| 地面震动 | `Ground tremor rippling outward from impact point` | 巨物着陆/爆炸/重击 |

**提示词范例：**

```
# ❌ 滑步写法
主角在雨中奔跑。

# ✅ 物理阻尼写法
主角重心前倾全力冲刺，每步踩踏溅起水花飞散 (puddle splash on each footstep)，
厚重风衣因真实织物风阻向后猛烈拍打 (realistic fabric wind resistance)，
湿发因惯性延迟甩动贴在额头 (hair whip with inertia delay)，
鞋底碎石随脚步飞溅 (debris kicked up with each footstep)。
```

FILE:references/director-styles.md
# 导演风格参数化映射库

> 将导演的视觉语言拆解为 AI 可计算的参数——构图、光影、色调、运镜、材质。
> 不仅涵盖国际电影大师，还包括中国影视、短剧、AI漫剧、社交媒体等多元风格。

### 🚨 去名化使用规范（强制）

> **最终提示词中严禁出现任何导演名、工作室名或 IP 名。** 标题中的导演名仅供 Claude 内部索引匹配用户意图，不可泄漏到输出中。

**四大物理轴降解框架：** 当用户提及某导演风格时，必须将其降解为以下四轴的纯物理参数组合：

| 物理轴 | 含义 | 示例 |
|--------|------|------|
| 🎨 色彩 (Palette) | 色盘、饱和度、色温 | `Desaturated desert palette` / `Neon teal and orange` |
| 💡 灯光 (Lighting) | 光源类型、光行为、氛围 | `Heavy atmospheric haze` / `Smoldering neon glow` |
| 🏛️ 美术 (Art Direction) | 建筑、材质、场景美学 | `Brutalist architecture` / `Pastel dollhouse set` |
| 📷 机位 (Camera) | 焦段、运镜、稳定方式 | `Glacial push-in` / `Strict symmetrical framing` |

**使用流程：** 用户说"维伦纽瓦风格" → Claude 匹配到本库中维伦纽瓦条目 → 提取 `安全提示词` 行 → 嵌入最终提示词中（**不含任何人名**）。

---

## 一、国际电影大师风格

### 克里斯托弗·诺兰 (Christopher Nolan) — 冷峻写实

| 维度 | 参数 |
|------|------|
| **构图** | 宏大尺度、实景比例、IMAX全画幅构图 |
| **光影** | 去饱和冷色调、高对比、自然光为主 |
| **色调** | 深蓝/铅灰/钢铁银/极致黑 |
| **运镜** | 缓慢推轨、IMAX稳定器、极少手持 |
| **材质** | 65mm IMAX胶片颗粒、真实物理特效、实景爆破质感 |
| **提示词模板** | `IMAX 65mm film clarity, fine organic film grain, desaturated cold palette, high-contrast cinematic lighting, practically plausible motion, heavy debris physics` |
| **安全提示词** | `IMAX 65mm film grain, desaturated steel-blue and charcoal palette, high-contrast natural key lighting, monumental practical-scale architecture, glacial dolly push-in, heavy debris particle physics, zero handheld shake` |
| **❌ 禁止** | 禁止出现导演名字；避免直接写"时间穿越""旋转走廊"等诺兰标志性情节符号，改用纯物理参数描述 |

### 丹尼斯·维伦纽瓦 (Denis Villeneuve) — 巨物压迫

| 维度 | 参数 |
|------|------|
| **构图** | 巨物与渺小人物对比、几何对称、粗野主义建筑 |
| **光影** | 弥散柔光、单色光笼罩、体积雾 |
| **色调** | 琥珀/冷白/去饱和暖黄 |
| **运镜** | 极缓推轨、长焦远景、肃穆缓慢 |
| **材质** | 粗砂岩质感、混凝土表面、大气霾 |
| **提示词模板** | `Brutalist minimalist architecture, monumental epic scale, diffused ambient lighting, volumetric fog, atmospheric depth, minimalist desaturated color grading with stark contrast` |
| **安全提示词** | `Brutalist concrete architecture, monolithic scale with tiny human figure for contrast, heavy atmospheric haze with volumetric god rays, desaturated amber-sand palette, glacial push-in on 135mm telephoto, oppressive silence` |
| **❌ 禁止** | 禁止出现导演名字；避免直接写"沙丘""沙虫"等IP符号，用"巨型生物体穿越沙暴"等纯物理描述替代 |

### 韦斯·安德森 (Wes Anderson) — 极致对称童话

| 维度 | 参数 |
|------|------|
| **构图** | 绝对居中对称、平面化舞台调度、正交摄影 |
| **光影** | 均匀柔光、极少硬影 |
| **色调** | 马卡龙粉/芥末黄/薄荷绿/复古浅蓝 |
| **运镜** | 机械式90度横摇、直线横向推轨、禁用透视变化 |
| **材质** | 精致布景、微缩模型感、复古纸质质感 |
| **提示词模板** | `Perfect symmetrical framing, centered composition, flat spatial depth, pastel color palette (mustard yellow and powder pink), meticulous set design, 90-degree whip pan` |
| **安全提示词** | `Strict symmetrical centered composition, flat theatrical staging with zero depth perspective, pastel macaron palette (mustard yellow, powder pink, mint green), mechanical 90-degree lateral dolly, miniature dollhouse set design, soft even fill lighting with no hard shadows` |
| **❌ 禁止** | 禁止出现导演名字；绝对禁用手持晃动/Handheld；避免任何透视纵深变化，保持扁平正交构图 |

### 王家卫 (Wong Kar-wai) — 霓虹迷幻

| 维度 | 参数 |
|------|------|
| **构图** | 前景遮挡、偷窥角度、逼仄空间 |
| **光影** | 浓郁霓虹、雨水折射、镜面反射 |
| **色调** | 高饱和霓虹红/幽绿/暗蓝 |
| **运镜** | 抽帧拖影、降速快门、手持晃动 |
| **材质** | 胶片刮痕、残影拖尾、湿润质感 |
| **提示词模板** | `Neon-lit urban night, highly saturated contrasting colors (deep vivid reds and emerald greens), shallow depth of field, claustrophobic framing, reflections on wet surfaces, slow shutter speed effect, motion blur trails` |
| **安全提示词** | `Step-printed slow motion with ghosting trails, voyeuristic foreground obstruction (door frames, curtains, glass), neon teal-and-orange split lighting, smoldering atmospheric haze, claustrophobic tight framing, rain-soaked reflective surfaces, slow shutter drag with motion blur` |
| **❌ 禁止** | 禁止出现导演名字；避免自动生成旗袍/花样年华等刻板符号，聚焦于光影和运镜的物理参数 |

### 宫崎骏 (Hayao Miyazaki) — 手绘幻想

| 维度 | 参数 |
|------|------|
| **构图** | 广阔天空占比大、细腻自然景观 |
| **光影** | 柔和自然光、云朵透光 |
| **色调** | 清新自然绿/天空蓝/暖黄 |
| **运镜** | 缓慢平移、飞行跟拍、俯瞰全景 |
| **材质** | 手绘水彩质感、柔和线条、自然肌理 |
| **提示词模板** | `Hand-painted watercolor aesthetic, soft natural lighting, expansive sky composition, gentle breeze animation, lush green natural palette, warm nostalgic tones` |
| **安全提示词** | `Hand-painted watercolor cel animation, soft diffused natural sunlight through cumulus clouds, expansive 70% sky composition, lush green-and-sky-blue pastoral palette, gentle breeze rippling grass and hair, slow pan across meadow, warm nostalgic golden-hour tones` |
| **❌ 禁止** | 禁止出现导演名/工作室名；避免直接引用龙猫/千寻/天空之城等IP形象，用"毛茸茸的巨型森林守护灵"等原创描述替代 |

### 大卫·芬奇 (David Fincher) — 精密惊悚

| 维度 | 参数 |
|------|------|
| **构图** | 精确框取、绝对控制感、主体居中偏移制造不安 |
| **光影** | 低调打光、大面积暗部、单点光源雕刻面部 |
| **色调** | 去饱和黑绿/铅灰/冷青，极低彩度 |
| **运镜** | 精密推轨、缓慢平滑的轨道运动、禁用手持晃动 |
| **材质** | 数码超清斄质感（非ICU粒）、冷硬表面、室内人工光 |
| **提示词模板** | `Low-key lighting with dominant shadows, desaturated green-grey palette, precise dolly tracking, controlled cold atmosphere, clinical digital clarity` |
| **安全提示词** | `Low-key single-source lighting carving face from darkness, desaturated sickly green-grey palette, precise mechanical dolly tracking with zero handheld, clinical digital texture, oppressive controlled framing, subject slightly off-center creating unease` |
| **❌ 禁止** | 禁止出现导演名字；禁用手持晃动；避免"等待室""纸牌屋"等作品符号 |

### 罗杰·迪金斯 (Roger Deakins) — 自然光减法

| 维度 | 参数 |
|------|------|
| **构图** | 空间层次感、前中后景分离、画面内自然框取 |
| **光影** | 极致自然光、窗光/天光为主、最少干预的布光 |
| **色调** | 自然色温、黄金时刻暖调、低对比柔和 |
| **运镜** | 极简克制的运镜、缓慢推轨、长镜头凝视 |
| **材质** | 自然光下的真实肤色、大气透视层次、空气中的微尘 |
| **提示词模板** | `Natural available light only, golden hour warmth, layered spatial depth with atmospheric perspective, minimal camera movement, restrained understated beauty` |
| **安全提示词** | `Natural window light as sole source, golden-hour warmth with soft shadow falloff, layered spatial depth using atmospheric haze between planes, slow contemplative dolly, available-light skin tones, floating dust particles catching light, minimal intervention restrained beauty` |
| **❌ 禁止** | 禁止出现摄影师名字；禁用激烈光效/霓虹/特效灯；避免"银翼杀手""肖申克的救赎"等作品引用 |

### 黑泽明 (Akira Kurosawa) — 天气叙事

| 维度 | 参数 |
|------|------|
| **构图** | 群像调度、强方向性运动线、前景遮挡增层次 |
| **光影** | 天气驱动光线——暴风雨/烈日/大雾本身就是照明 |
| **色调** | 高对比黑白质感（彩色时为暗沉土色/绿） |
| **运镜** | 多机位交叉剪辑、群体动作的长焦压缩、慢动作死亡美学 |
| **材质** | 风雨粒子/泥地飞溅/旗帜狂舞的物理质感 |
| **提示词模板** | `Weather-driven dramatic lighting, torrential rain as narrative force, ensemble group choreography, strong directional movement, telephoto compression of crowd action, slow-motion death aesthetics` |
| **安全提示词** | `Torrential rain as dominant lighting source and narrative force, ensemble warriors in directional formation charge, 200mm telephoto compressing depth, mud splashing with each footstep, banners whipping violently in storm wind, slow-motion blade arc with rain droplets frozen mid-air, high-contrast chiaroscuro` |
| **❌ 禁止** | 禁止出现导演名字；避免"七武士""乱"等作品名；用"古代武士集团"等原创描述 |

### 新海诚 (Makoto Shinkai) — 数码光彩动画

| 维度 | 参数 |
|------|------|
| **构图** | 天空占画面 60%+、极致云层光影细节、青春人物剑影 |
| **光影** | 极致逆光、光线穿透云层的丁达尔效应、黄昏/黄金时刻滥用 |
| **色调** | 极高彩度的蓝/紫/橙天空、色彩爆炸式渐变 |
| **运镜** | 细节特写插入（水滴/树叶/手机屏）、缓慢推轨 |
| **材质** | 数码CG超写实背景 + 简化人物、光斑散景、晶莹的水滴 |
| **提示词模板** | `Hyper-saturated sky gradient (deep blue to vivid orange), dramatic god rays through towering cumulus clouds, digital anime aesthetic with photorealistic backgrounds, youth silhouette against golden-hour sky, crystalline light particles` |
| **安全提示词** | `Digital anime aesthetic, hyper-detailed photorealistic sky with towering cumulus clouds and vivid blue-to-orange gradient, dramatic god rays piercing cloud layers, youth figure silhouette against golden-hour backlight, crystalline rain droplets catching prismatic light, extreme color saturation, detail insert cuts of water droplets on glass` |
| **❌ 禁止** | 禁止出现导演名字；避免"你的名字""天气之子""铃芽之旅"等IP引用；与宫崎骏的区分：宫崎骏=手绘田园暖色，新海诚=数码超写实+天空爆炸色彩 |

---

## 二、中国影视风格

### 张艺谋式东方美学 — 色彩叙事

| 维度 | 参数 |
|------|------|
| **构图** | 大面积色块构图、人物在色彩中的对比 |
| **光影** | 高饱和主色调、单色光源为主 |
| **色调** | 浓烈的红/金/暗绿/靛蓝（视主题而定） |
| **运镜** | 大气远景航拍、缓慢推进、仪式感调度 |
| **材质** | 绸缎/竹林/黄沙/青瓦白墙的物理质感 |
| **提示词模板** | `东方电影美学，大面积中国红色块构图，绸缎在风中飘动的流体质感，高饱和色彩叙事，仪式感镜头调度，Slow Crane Up，写实材质纹理` |

### 仙侠/修真 — 中国风奇幻

| 维度 | 参数 |
|------|------|
| **构图** | 云海仙境、悬崖古寺、飞天衣袂 |
| **光影** | 丁达尔光束穿云、灵光自发光、仙气弥漫 |
| **色调** | 金青/暗紫/仙白/玄黑 |
| **运镜** | 航拍穿越云海、摇臂升降揭示仙境、推轨穿过门扉 |
| **材质** | 3D国漫CG渲染、水墨粒子特效 |
| **提示词模板** | `中国仙侠风格，3D国漫CG渲染质感，云雾缭绕的仙境，金青色调，丁达尔光束穿透云层，灵力粒子漂浮，白衣飘逸，航拍穿越云海，空灵环境音` |

### 古偶/古装剧 — 柔光奇幻

| 维度 | 参数 |
|------|------|
| **构图** | 花瓣纷飞、灯笼/烛光前景、柔美对称 |
| **光影** | 柔和侧逆光、golden hour暖调 |
| **色调** | 柔粉/暖金/桃花色系 |
| **运镜** | Smooth Orbit环绕人物、Dolly In聚焦眼神、慢镜头飘逸 |
| **材质** | 丝绸光泽、发丝飘动、花瓣物理飘落 |
| **提示词模板** | `中国古装美学，柔光侧逆光，golden hour暖调，花瓣在空中飘落的物理飘散效果，丝绸衣裙随风飘动，Smooth Orbit缓缓环绕角色，浅景深聚焦面部，古筝悠扬BGM` |

### 都市情感剧 — 写实自然光

| 维度 | 参数 |
|------|------|
| **构图** | 城市街景、生活化场景、自然取景 |
| **光影** | 自然光/城市路灯/室内台灯 |
| **色调** | 自然色温、轻度去饱和 |
| **运镜** | 手持微晃、跟拍、Steadicam流畅跟随 |
| **材质** | 35mm胶片颗粒、真实皮肤质感 |
| **提示词模板** | `都市情感写实风格，35mm胶片质感，自然色温，手持微晃跟拍，城市街景自然光，角色微表情特写，浅景深虚化背景，环境城市白噪音` |

---

## 三、新媒体与短视频风格

### AI漫剧 — 动态漫画

| 维度 | 参数 |
|------|------|
| **构图** | 漫画分格感、动态线条、情绪放大 |
| **色调** | 高饱和动漫色彩 或 赛璐璐扁平 |
| **运镜** | 快速Push In表情特写、Speed Line效果 |
| **材质** | 赛璐璐上色/3D卡通渲染/漫画网点 |
| **提示词模板** | `动态漫画风格，赛璐璐上色，高饱和色彩，动态线条效果，快速Push In表情特写，夸张的情绪演绎，漫画式分镜感，配合节奏感BGM` |

### 竖屏短剧 — 9:16快节奏

| 维度 | 参数 |
|------|------|
| **构图** | 竖屏9:16、人物居中、大头大脸 |
| **色调** | 高对比鲜艳、滤镜感 |
| **运镜** | 快速切镜、Whip Pan转场、正反打 |
| **材质** | 数码清晰质感、轻度磨皮 |
| **提示词模板** | `竖屏9:16，短剧节奏，快切镜头，正反打对话，高对比鲜艳色调，人物居中构图占画面70%，清晰数码质感，快节奏BGM` |

### Vlog纪实 — 第一人称

| 维度 | 参数 |
|------|------|
| **构图** | POV第一人称、自拍角度 |
| **色调** | 自然色温、生活感 |
| **运镜** | POV主观视角、手持自然晃动 |
| **材质** | 手机/GoPro质感、轻微广角畸变 |
| **提示词模板** | `Vlog纪实风格，POV第一人称视角，手持自然晃动，轻微广角畸变，自然色温，生活化场景，环境真实声音，无BGM` |

### 社交媒体病毒传播 — 极致吸睛

| 维度 | 参数 |
|------|------|
| **构图** | 前3秒必须有视觉冲击、居中大主体 |
| **色调** | 超饱和、高对比 |
| **运镜** | 开场Zoom In冲击、Speed Ramp慢转快 |
| **材质** | 锐利数码、HDR效果 |
| **提示词模板** | `社交媒体竖屏，前3秒极致视觉冲击，Speed Ramp从慢动作突变快进，超饱和鲜艳色彩，高对比HDR效果，主体占画面80%以上，强节奏感配乐卡点` |

### 二次元变身 / 热血战斗 — 动漫爆燃

> **注意：** 本条目专注于「爆燃战斗 / 变身」场景。若用户需要的是沉稳叙事型的二次元游戏剧情 CG / PV，请使用下方「三渲二 / Cel-Shaded CG」条目。

| 维度 | 参数 |
|------|------|
| **构图** | 冲击帧居中放大、速度线汇聚、气场爆发放射状构图 |
| **色调** | 极高饱和 + 技能色光（火红/电蓝/金黄） |
| **运镜** | Speed Ramp变速 + 定格冲击帧 + 360°环绕 + 急推特写 |
| **材质** | 赛璐璐上色/3D卡通渲染、粒子爆散特效、能量拖尾 |
| **提示词模板** | `二次元动漫爆燃风格，变身光效爆发，速度线汇聚，冲击帧定格放大，极高饱和色彩，能量粒子拖尾，Speed Ramp从慢动作突然加速，气场冲击波扩散` |

### 三渲二 / Cel-Shaded CG — 动画化游戏剧情

> **定位：** 用于游戏剧情CG、PV预告、角色传记、过场动画等沉稳叙事场景。与上方「二次元爆燃」的核心区别：这里追求的是「电影级叙事 + 动画化渲染」，而非「节奏爆炸 + 特效堆叠」。
>
> **代表作参考风格：** 《原神》《崩坏：星穹铁道》《鬼灭之刃》（ufotable级）《蓝色禁区》—— 3D建模 + 卡通渲染管线，保留二维动画的手绘美感。

| 维度 | 参数 |
|------|------|
| **构图** | 电影级调度（远景建置、中景叙事、特写情感）、画面空间感比写实略简化、注重角色剑影比例 |
| **光影** | 简化光源、Anime式硬边阴影二值化（sharp shadow cutoff）、强轮廓 Rim Light 分离角色与背景、减少光影渐变层次 |
| **色调** | 高饱和 Anime 色盘（HSL 精调）、明暗硬边分割、根据角色属性选主色调（火红/冰蓝/暗紫/金色） |
| **运镜** | 电影级运镜（复用现有运镜体系）、长焦浅景深特写 + 史诗航拍、Orbit环绕角色展示 |
| **材质** | **动画化材质（核心区别点）：** Cel-shaded flat shading + 描边轮廓线（bold ink outlines）+ Anime头发高光带 + 简化折皱色块填充、**禁用写实 PBR 材质词（毛孔/SSS/微瑕疵）** |
| **提示词模板** | `3D cel-shaded toon rendering with bold ink outlines, anime-style sharp shadow cutoff, high-saturation character color palette, simplified flat material shading, strong rim light separating character from background, cinematic depth of field with anime bokeh` |
| **安全提示词** | `3D Cel-Shaded Toon渲染，Anime风格硬边阴影二值化，粗描边轮廓线，高饱和角色色盘，简化平涂材质，强Rim Light分离角色与背景，电影级景深与Anime散景` |
| **❤️ 与「二次元爆燃」的配合** | 同一角色的叙事性CG用本条目，战斗片段用上方「二次元爆燃」，两者可在同一PV内分段切换 |
| **❌ 禁止** | 禁用写实材质词（visible pores / subsurface scattering / micro-imperfections）；禁止与写实光追渲染混用 |

### 小红书种草 — 精致生活感

| 维度 | 参数 |
|------|------|
| **构图** | 干净白色/奶油色背景、产品平铺构图、留白充足 |
| **色调** | 马卡龙淡彩 + 微暖偏移、柔和不刺眼 |
| **运镜** | 固定镜头 / 缓慢推进 / 俯拍平铺 |
| **材质** | 数码清晰但不锐利、柔光无硬影、产品质感突出 |
| **提示词模板** | `小红书种草风格，干净奶油色背景，产品平铺居中，柔和自然光，马卡龙淡彩色调，大面积留白，Overhead俯拍，精致生活感` |

---

## 四、特殊风格

### VHS复古录像带

| 参数 | 值 |
|------|-----|
| **视觉特征** | 扫描线、色彩溢出、跟踪错误、低分辨率 |
| **提示词** | `VHS analog aesthetic, scan lines, color bleeding, tracking distortion, warm muted tones, 4:3 aspect ratio, retro camcorder feel` |

### 赛博朋克未来都市

| 参数 | 值 |
|------|-----|
| **视觉特征** | 霓虹灯阵、雨夜反射、全息投影、暗色基调 |
| **提示词** | `Cyberpunk neon city, rain-soaked streets with neon reflections, holographic billboards, dark atmospheric haze, teal and magenta color split, volumetric fog` |

### 水墨东方

| 参数 | 值 |
|------|-----|
| **视觉特征** | 笔墨浸染、留白构图、山水意境 |
| **提示词** | `中国水墨画风格，ink-wash sumi-e aesthetic，笔墨在宣纸上浸染扩散，大面积留白，山水意境，黑白灰为主色调，淡彩点缀，墨韵流动` |

### 像素风/复古游戏

| 参数 | 值 |
|------|-----|
| **视觉特征** | 低分辨率方块、8-bit色板、像素化动画 |
| **提示词** | `Pixel art retro game aesthetic, low-resolution blocky style, 8-bit color palette, pixelated character animation, chiptune sound effects` |

### MV音乐视觉

| 参数 | 值 |
|------|-----|
| **视觉特征** | 节奏卡点、频闪、色光轮换、舞台灯光 |
| **提示词** | `Music video aesthetic, beat-synced editing, strobe lighting effects, color wash transitions, 16:9 widescreen, dynamic stage lighting, silhouette backlit shots` |

### 微缩模型/定格动画

| 参数 | 值 |
|------|-----|
| **视觉特征** | 移轴摄影效果、微缩比例感、逐帧动画质感 |
| **提示词** | `Tilt-shift miniature effect, stop-motion animation feel, handcrafted texture, miniature model scale, frame-by-frame movement, warm practical lighting` |

FILE:references/cinematography.md
# 运镜与焦段专业词典

> Seedance 2.0 对中英文混合描述效果最佳。运镜是决定视频质量的关键——同样的场景，精准运镜是"电影感"和"监控探头"的区别。
>
> ⚠️ **Seedance 审核安全提醒：** 裸写的英文运镜术语（如 `Dolly`、`Aerial`、`Crane`）可能被审核系统误判为人名/品牌名而触发违规拦截。**中文提示词使用中文运镜词，英文提示词使用完整短语**（见下表「Seedance 安全写法」列）。

## 一、景别体系 (Shot Sizes)

| 英文术语 | 中文 | 画面范围 | 叙事功能 |
|----------|------|----------|----------|
| Extreme Close-Up (ECU) | 极致特写 | 瞳孔/指尖/水滴 | 放大情绪、展现微观质感 |
| Close-Up (CU) | 特写 | 面部/单个物体 | 捕捉微表情、聚焦关键道具 |
| Medium Close-Up (MCU) | 中近景 | 头肩以上 | 对话、情绪传达 |
| Medium Shot (MS) | 中景 | 腰部以上 | 叙事推进、日常对话 |
| Medium Full Shot | 中全景 | 膝部以上 | 展示肢体语言 |
| Full Shot (FS) | 全景 | 头到脚完整人物 | 展示角色全貌与动作 |
| Wide Shot (WS) | 远景 | 主体+大量环境 | 交代环境关系 |
| Extreme Wide Shot (EWS) | 大远景 | 壮阔风光，人物极小 | 建立宏大世界观 |
| Establishing Shot | 建置镜头 | 场景全貌 | 开场定位时空 |
| Over-the-Shoulder (OTS) | 过肩镜头 | 一人肩后看另一人 | 对话场景视角切换 |
| Two-Shot | 双人镜头 | 两人同框 | 展现人物关系 |
| POV Shot | 主观视角 | 角色第一人称 | 最高级沉浸体验 |

## 二、三级运镜体系

### Level 1：基础运镜动作（覆盖80%基础需求）

| 英文术语 | 中文 | 运动轨迹 | 心理效果 | Seedance 安全写法 |
|----------|------|----------|----------|-------------------|
| Pan Left/Right | 水平摇摄 | 镜头固定，水平转动 | 追踪横向移动、展现广阔环境 | ⚠️ CN: `水平摇摄` / EN: `pan shot` |
| Tilt Up/Down | 垂直俯仰 | 镜头固定，垂直转动 | 仰拍强化力量感，俯拍表现脆弱 | ✅ 安全 |
| Dolly In/Out | 推轨推进/后拉 | 机位前后物理移动 | 推进=建立亲密感；后拉=揭示孤立 | ⚠️ CN: `推轨推进` / EN: `dolly tracking shot` |
| Zoom In/Out | 变焦推进/拉远 | 焦距变化，机位不动 | 快速聚焦或拉开距离 | ✅ 安全 |
| Truck Left/Right | 横向平移 | 机位左右横向移动 | 展示并列元素 | ✅ 安全 |
| Crane Up/Down | 摇臂升/降 | 机位垂直升降 | 升=宏大揭示；降=逐渐逼近 | ⚠️ CN: `摇臂升降` / EN: `crane shot` / `jib shot` |
| Orbit / Arc | 环绕/弧形 | 围绕主体旋转 | 展示主体全貌、制造仪式感 | ⚠️ CN: `环绕`/`弧形环绕` / EN: `orbital camera movement` / `arc shot` |
| Tracking Shot | 跟踪镜头 | 跟随主体平行移动 | 保持主体焦点+传递速度感 | ✅ 安全 |
| Static Shot | 固定镜头 | 机位不动 | 客观记录、冷静叙事 | ✅ 安全 |
| Push In | 缓慢推进 | 缓慢靠近主体 | 累积紧张感、聚焦细节 | ✅ 安全 |
| Pull Out | 缓慢拉出 | 缓慢远离主体 | 揭示更大环境 | ✅ 安全 |
| Pedestal Up/Down | 升降平移 | 机身垂直升降不改俯仰角 | 跟随角色起立/坐下 | ✅ 安全 |
| Epic Drone Reveal | 史诗级无人机揭示 | 无人机从背后/低位缓慢升起，揭示宏观场景 | 从人物亲密视角到史诗全貌的戏剧性反转，制造震撼揭示感 | ✅ CN: `无人机缓慢上升揭示` / EN: `epic drone reveal shot` |
| Reveal from Behind / Through Shot | 遮挡揭示/穿梭镜头 | 镜头穿越遮挡物（树丛/门框/人群/窗帘）后揭示场景 | 制造悬念感与层次纵深，营造"发现"的仪式感 | ✅ CN: `穿越[遮挡物]揭示` / EN: `reveal through obstacle shot` |
| Leading Shot | 引导镜头 | 镜头在主体前方后退，主体主动"追"镜头方向前进 | 叙述旅程感与主动性，观众视角=前方未知 | ✅ CN: `引导后退跟拍` / EN: `leading shot pulling back` |

### Level 2：修饰词（赋予运镜灵魂）

**速度修饰：**

| 修饰词 | 效果 | 示例 |
|--------|------|------|
| Smooth / 流畅的 | 平和优雅 | `Smooth dolly in on the couple` |
| Slow / 缓慢的 | 悬念、回忆 | `Slow zoom out from the photo` |
| Fast / Rapid | 紧张激烈 | `Fast tracking through the market` |
| Subtle / 微妙的 | 增强沉浸 | `Subtle tilt up during monologue` |
| Gradual / 渐进的 | 自然过渡 | `Gradual 10-second crane up` |
| Sudden / 突然的 | 惊吓转折 | `Sudden whip pan to reveal` |

**情绪修饰：**

| 修饰词 | 氛围 | 示例 |
|--------|------|------|
| Cinematic | 电影感 | `Cinematic arc shot around hero` |
| Aggressive | 侵略性 | `Aggressive handheld in chase` |
| Dreamy | 梦幻 | `Dreamy slow-motion dolly` |
| Intimate | 亲密 | `Intimate push-in on hands` |
| Epic | 史诗 | `Epic crane up revealing army` |
| Dynamic | 动态活力 | `Dynamic tracking on dance floor` |

**风格修饰：**

| 修饰词 | 效果 | 示例 |
|--------|------|------|
| Handheld / 手持 | 纪实感、混乱感 | `Handheld follow in war zone` |
| Aerial / 航拍 | 俯瞰视角 | `Aerial rising over city` |
| Dutch Angle / 荷兰角 | 倾斜不安 | `Dutch angle tracking thriller` |
| Gimbal / 云台 | 稳定流畅 | `Gimbal tracking through corridor` |
| Steadicam / 斯坦尼康 | 专业级稳定 | `Steadicam follow in hallway` |
| POV | 第一人称沉浸 | `POV walking through haunted house` |
| FPV Drone / 穿越机 | 极速俯冲翻滚 | `FPV drone dive through canyon` |

### Level 3：组合运镜（复合技巧）

用 `+` 或 `while` 连接，一次最多 2-3 个动作：

| 组合 | 效果 | 场景 |
|------|------|------|
| Orbit + Zoom In | 视觉冲击力极强 | 揭示主体、产品展示 |
| Crane Up + Pan | 大气磅礴 | 开场/结尾 |
| Dolly Zoom (Vertigo) | 眩晕空间扭曲 | 心理冲击、恐慌 |
| Tracking + Handheld Shake | 紧张追逐 | 追逐/逃亡 |
| Dolly Back + Crane Up | 逐渐揭示宏大场景 | 震撼场景揭示 |
| Arc 180° + Subtle Zoom In | 情绪聚焦 | 情绪转折点 |
| Whip Pan | 极速横摇转场 | 空间转场、紧张节奏 |
| Snap Zoom / Crash Zoom | 急推变焦——焦距骤变至极端特写或极端远景，产生爆裂冲击感 | 喜剧冲击、惊吓强调、MV节拍卡点 |
| Orbit Follow（移动环绕） | 主体运动中同步环绕（orbit + tracking），环绕中心点随主体移动 | 跟随奔跑/格斗同时环绕，制造动感包围感；区别于静止主体环绕 |

## 三、焦段与物理镜头参数

| 焦段 | 视觉特征 | 适用场景 |
|------|----------|----------|
| **14mm Ultra-wide** | 强烈透视畸变、边缘拉伸 | 巨物恐惧、末世压迫、建筑全貌 |
| **24mm Wide** | 适度广角、自然空间感 | 环境建置、街景 |
| **35mm Standard Wide** | 接近人眼略广 | 纪录片、日常叙事 |
| **50mm Standard** | 最接近人眼 | 平实叙事、对话场景 |
| **85mm Portrait** | 背景压缩、柔美虚化 | 人像特写、情感场景 |
| **135mm Telephoto** | 极度空间压缩、奶油散景 | 面部微表情、汗滴特写 |
| **200mm+ Super Telephoto** | 极致背景压缩 | 远距离偷拍感、监视感 |
| **Fisheye** | 极度球面畸变 | 偷窥感、心理扭曲、滑板视角 |

### 焦段叙事心理学（为什么 mm 数比形容词更有效）

> 视频大模型底层是三维物理模拟器，对具体的毫米数（mm）极度敏感。写 `14mm ultra-wide lens` 远比写"广角镜头"更能激发正确的空间透视。

**核心规律：焦距越短 → 空间越夸张 → 主体越膨胀；焦距越长 → 空间越压缩 → 背景越贴近。**

| 焦段 | 物理效果 | 心理暗示 | 典型创作场景 |
|------|----------|----------|-------------|
| **14mm** | 强烈桶形畸变，边缘物体被拉伸 | 压迫、窒息、巨物恐惧 | 末日废土仰拍巨型机甲；幽闭室内被困角色；建筑内部仰拍穹顶 |
| **24-35mm** | 适度广角，自然空间延伸 | 开放、叙事、客观 | 环境建置镜头；街头纪实；多人对话全景 |
| **50mm** | 零畸变，最接近人眼 | 平实、真实、亲切 | 日常对话；平实叙事；纪录片采访 |
| **85mm** | 轻度压缩，柔美散景 | 温柔、亲密、浪漫 | 人像特写；情感戏；产品美拍 |
| **135-200mm** | 极致空间压缩，奶油般背景虚化 (Creamy Bokeh) | 孤立、窥视、聚焦微观 | 面部汗滴微表情；远距离跟拍的"偷窥感"；人群中锁定单一面孔 |

**提示词范例：**

```
# 14mm 巨物压迫
14mm ultra-wide lens, extreme low angle, towering mecha looming above, barrel distortion stretching the edges

# 135mm 微表情特写
135mm telephoto lens, shallow depth of field with creamy bokeh, extreme close-up on trembling lips, sweat rolling down temple

# 50mm 平实叙事
50mm standard lens, eye-level medium shot, natural perspective, couple walking through autumn park
```

## 四、焦点控制与景深

| 术语 | 英文 | 效果 |
|------|------|------|
| 浅景深 | Shallow Depth of Field | 背景模糊，主体突出 |
| 深焦 | Deep Focus | 前中后景全部锐利 |
| 焦点转换 | Rack Focus | 焦点在前后景间平滑转移 |
| 散景 | Bokeh | 柔和的圆形背景虚化光斑 |
| 分屈光镜 | Split Diopter | 两个平面同时对焦 |

### 高阶动态对焦范式

> Rack Focus 是最被低估的叙事武器——它不移动摄像机，却能在一秒内改变观众的注意力焦点。

**速度修饰：**

| 修饰 | 英文 | 效果 | 场景 |
|------|------|------|------|
| 缓焦转移 | Slow rack focus | 从容的视觉引导 | 回忆、发现、渐悟 |
| 急焦切换 | Snap focus / Whip focus | 瞬间跳焦，视觉冲击 | 惊吓、突然发现威胁 |
| 呼吸焦点 | Breathing focus | 焦点微微前后游移 | 紧张等待、不安情绪 |

**创作范式（可直接用于提示词）：**

```
# 经典前→后焦转
Rack focus from the dripping gun barrel in foreground to the villain's face emerging from shadows in background

# 后→前焦转（揭示型）
Focus shifts from blurred foreground, slowly resolving to reveal a bloody handprint on the glass

# 急焦切换（惊吓型）
Snap focus from peaceful landscape to a figure standing inches from camera
```

**焦段联动提示：** 长焦段（85mm+）下的 Rack Focus 效果最戏剧化，因为浅景深让焦内/焦外的反差更强烈。在提示词中组合使用效果最佳：

```
135mm telephoto, shallow DOF, slow rack focus from wilting flower in foreground to woman's tear-streaked face in background, creamy bokeh transition
```

## 五、转场技巧

| 术语 | 英文 | 效果 |
|------|------|------|
| 硬切 | Cut | 瞬间切换 |
| 溶解 | Dissolve / Crossfade | 渐变混合 |
| 匹配剪辑 | Match Cut | 形状/动作匹配切换 |
| 甩镜转场 | Whip Transition | 快速横摇衔接两场景 |
| 渐隐 | Fade to Black/White | 渐变至纯色 |
| 速度渐变 | Speed Ramp | 慢到快或快到慢 |

## 六、镜头角度

| 术语 | 英文 | 心理效果 |
|------|------|----------|
| 平视 | Eye-Level | 中立自然 |
| 仰拍 | Low Angle | 力量感、英雄感 |
| 俯拍 | High Angle | 脆弱、渺小 |
| 鸟瞰 | Bird's Eye / Top-Down | 上帝视角、几何美 |
| 虫瞰 | Worm's Eye | 极致仰视，建筑压迫 |
| 荷兰角 | Dutch Angle | 不安、悬疑张力 |

## 七、物理挂载与特种设备 (Camera Rigs)

> 运镜动作决定"摄像机做什么"，物理挂载决定"摄像机骑在什么上面"。后者赋予画面独特的**呼吸感和物理质感**，是打破 AI 默认"死板平滑"的关键。
>
> *与 Level 2 风格修饰（Steadicam / FPV Drone / Handheld 等）互为补充，此处提供深度物理参数与创作指南。*

| 设备 | 英文 | 物理特征 | 视觉签名 | 适用场景 |
|------|------|----------|----------|----------|
| 斯诺里机位 | SnorriCam / Body-mounted | 摄像机刚性绑定在演员躯干 | 人物面部静止，背景疯狂晃动后退 | 眩晕、精神崩溃、亡命狂奔、醉酒 |
| 穿越机 | FPV Drone | 微型无人机极速飞行，6自由度 | 狭窄空间极速穿梭、俯冲翻滚 | 废墟穿越、走廊追逐、车窗穿入、Seedance 极擅长 |
| 斯坦尼康跟拍 | Steadicam Follow | 弹簧臂+背心稳定系统 | 流畅移动中带微弱真实呼吸感 | 长镜头跟拍、《闪灵》走廊、打破 AI 死板平滑 |
| 钢索飞猫 | Cable Cam / Wirecam | 钢索悬挂系统精准直线运动 | 高速直线飞越，无抖动 | 体育场飞越、音乐节俯冲、峡谷穿越 |
| 低机位碾压 | Crash Cam | 摄像机贴地/底盘安装 | 极致仰视碾压感 | 车轮特写、奔跑踩踏、动物视角 |
| 摇臂/伸缩炮 | Jib / Crane | 长臂大幅度升降摆动 | 从地面到高空的连续弧线 | 开场大揭示、告别俯瞰、舞台表演 |

**提示词范例：**

```
# SnorriCam 精神崩溃
SnorriCam body-mounted, actor's terrified face locked in center frame, background spinning and rushing backward, 24mm wide lens

# FPV 穿越机穿梭
FPV drone shot, racing through narrow abandoned warehouse corridors, sharp banking turns, debris flying past camera, motion blur

# Steadicam 跟拍长镜头
Steadicam follow behind character walking through dimly lit hotel corridor, subtle organic breathing motion, 35mm lens

# Crash Cam 碾压视角
Crash cam ground level, motorcycle tire spinning inches from lens, gravel spraying, extreme low angle
```

## 八、创意特效运镜速查（v1.8 新增）

> 以下为 Seedance 2.0 可通过关键词触发的特殊视觉效果，可与常规运镜自由组合使用。

| 效果 | 中文触发词 | English Trigger | 适用场景 |
|------|-----------|----------------|---------|
| 希区柯克变焦 | `希区柯克变焦` / `滑动变焦` | `Hitchcock zoom` / `dolly zoom` | 惊恐/顿悟/空间扭曲 |
| 鱼眼镜头 | `鱼眼镜头透过[形状]窥视` | `Fisheye lens peering through [shape]` | 偷窥/夸张/喜剧 |
| 粒子特效 | `金色沙砾飘散` / `粒子吹散效果` | `Golden sand particles scattering` / `Particle dispersion effect` | 魔法/转场/片头 |
| 速度渐变 | `过山车般速度逐渐加快` | `Speed accelerates like roller coaster` | 追逐/紧迫/高潮 |
| 定格转场 | `画面定格后碎裂转场` | `Frame freezes then shatters into transition` | 闪回/转场/MV |
| 水墨化 | `黑白水墨风格` | `Black-and-white ink wash style` | 东方美学/功夫/禅意 |
| 变身/变装 | `裂纹蔓延后粒子消散变形` | `Cracks spreading then particles dissolve and morph` | 变身/超能力/Before-After |
| 遮罩文字 | `主体背后通过遮罩出现文字` | `Text appears behind subject through masking` | 广告/片头/品牌 |

**组合范例：**

```
# 希区柯克变焦 + 情绪
主角在惊恐时希区柯克变焦，背景急速远离，面部保持在画面中央

# 粒子特效 + 片头
以黑幕开场，金色鎏金材质的沙砾从画面左边飘出并向右覆盖，粒子吹散效果，@图片1的字体逐渐出现在画面中心

# 水墨风格 + 动作
黑白水墨风格，人物参考@视频1的特效和动作，上演一段水墨太极功夫
```

## 九、叙事引导运镜速查（v1.9 新增）

> 「引导与跟随」是最常被 AI 视频创作者忽视的运镜维度——它决定了观众的情绪视角是「被带领」还是「旁观」，是区分"有叙事灵魂的镜头"与"监控探头"的关键。

| 运镜类型 | 中文触发词 | English Trigger | 叙事效果 |
|----------|-----------|----------------|----------|
| 引导后退镜头 (Leading Shot) | `镜头在主体前方缓慢后退引导` | `leading shot, camera retreating ahead of subject` | 观众站在"未知前方"视角，强化旅程感与主动性 |
| 背影跟随镜头 (Following Shot) | `背影稳定跟随，呈现旅程感` | `following shot from behind, steady pursuit` | 传达前进与探索感，营造神秘与宿命感 |
| 侧向平行跟随 (Side Tracking) | `侧面平行跟拍，同步展示动作` | `side tracking shot, parallel to subject movement` | 展示肢体语言与动作全貌，适合跑步/舞蹈/格斗 |
| 低角度贴地跟随 (Low Angle Follow) | `低机位贴地跟随` | `low angle follow shot, camera near ground level` | 夸大运动动感，制造奔跑/车辆的速度压迫感 |
| 长焦压迫跟随 (Long Lens Follow) | `200mm长焦跟拍，背景与主体压缩叠加` | `long lens follow, 200mm telephoto compression` | 背景快速填满画面，强化幽闭与追击紧迫感 |
| 史诗无人机揭示 (Epic Drone Reveal) | `无人机从低位缓慢升起，从背后揭示宏大场景` | `epic drone reveal, slow rise from low angle behind subject` | 从人物视角→史诗全貌的戏剧性反转，常用于高潮揭示 |
| 遮挡揭示 (Reveal Through) | `镜头穿越[遮挡物]后揭示场景` | `reveal through [obstacle], camera pushing through [obstruction]` | 制造"发现"的仪式感与层次纵深，增加叙事悬念 |
| 移动环绕 (Orbit Follow) | `移动中环绕拍摄，中心点随主体运动` | `orbit follow shot, circling subject while both move` | 跟随运动主体同步环绕，制造动感包围感 |

**提示词范例：**

```
# 引导后退镜头（旅程感）
徒步者背负行囊缓步攀爬山路。镜头在其正前方缓慢后退引导，始终保持中景。
Hiker trudging up mountain trail, camera retreating ahead of subject in steady leading shot, keeping medium framing throughout.

# 史诗无人机揭示（震撼高潮）
无人机从武者背后低位缓慢上升揭示，起始特写武者颈后，随上升逐渐揭示身后万顷沙漠与落日余晖。
epic drone reveal shot rising slowly from behind warrior, starting tight on neck, ascending to unveil vast desert and blazing sunset panorama.

# 遮挡揭示（叙事悬念）
镜头缓慢穿越密集竹林缝隙，穿出竹林后瞬间揭示远处隐约可见的孤独山城。
camera slowly pushing through dense bamboo forest gaps, emerging to reveal a solitary mountain fortress in the mist beyond.
```

## 十、运动强度修饰词速查（v1.8.2 新增）

> 动作描写中使用明确的强度修饰词，可以显著改善 Seedance 的运动生成质量，避免"糊动"（motion mush）——即动作幅度不够或方向不明确。

### 强度等级对照表

| 等级 | 中文修饰词 | English Modifiers | 适用场景 |
|------|-----------|------------------|---------|
| ⚡ 极强 | 猛烈、暴烈、爆裂、猛冲 | violent, explosive, slamming, bursting | 爆炸/撞击/格斗 |
| 🔥 强烈 | 剧烈、迅猛、急速、用力 | dramatic, vigorous, rapid, forceful | 追逐/运动/情绪高潮 |
| ⚡ 突然 | 突然、骤然、猛然、戛然 | sudden, abrupt, snapping, jolting | 惊吓/转变/闪回 |
| 🌊 中等 | 稳步、从容、自然、轻快 | steady, confident, natural, brisk | 叙事推进/日常动作 |
| 🍃 轻柔 | 缓缓、温柔、轻柔、丝滑 | gentle, soft, smooth, delicate | 浪漫/舒缓/ASMR |
| 🪨 渐进 | 渐渐、逐步、缓慢、不知不觉 | gradual, slowly, imperceptibly, easing | 日出/情绪渐变/暗场 |

### 用法要点

- **每个动作都应携带强度修饰词**——`人物猛然转身` 而非 `人物转身`；`Camera gently drifts upward` 而非 `Camera moves up`
- **强度修饰词应与运镜节奏一致**——剧烈动作配快速运镜，轻柔动作配缓慢运镜
- **避免矛盾组合**——`缓慢爆裂` / `gentle slamming` 这类自相矛盾的描述会让模型困惑

### 对比示例

```
# ❌ 模糊（容易糊动）
人物走过去。镜头跟随。

# ✅ 明确（运动清晰）
人物猛然起身大步流星冲向出口。手持跟拍急速追踪。

# ❌ Vague (mushy motion)
The person moves forward. Camera follows.

# ✅ Clear (crisp motion)
The person surges forward in explosive strides toward the exit. Handheld tracking shot rushes to keep pace.
```