# SD2 Prompt Optimizer — Seedance 2.0 提示词优化器

基于 Doubao Seedance 2.0 官方完整知识库的 Prompt 优化器。将用户创意自动转化为高质量视频提示词。

## 环境配置

```text
SEEDANCE_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
SEEDANCE_API_KEY=sk-xxxx
SD2_OPTIMIZER_MODEL=doubao-seed-2-0-pro-260215
```

## 使用

```python
from sd2_prompt_optimizer import SD2PromptOptimizer

optimizer = SD2PromptOptimizer()
result = await optimizer.optimize("一只猫在海边散步")
print(result)
```

## 六大优化原则

### 1. 主体定义
用 `将图片N中的[2-3个静态特征]定义为<主体N>`；严禁臆测视觉特征，没给的写"严格以图片N为准"

### 2. 控制镜头数量与节奏
- 15 秒内最多保留 5 个关键镜头，每个 ≥3 秒
- 镜头太多、每个只有 1-2 秒，是动作卡顿的首要原因
- 禁止精确时间控制（如 0-3s）

### 3. 动作改写（高爆发→低缓连贯）
- 优先缓慢、轻柔、连贯的细微动作
- 规避狂奔、大跳、爆炸、剧烈翻滚等高爆发动作
- 情绪外化为身体细节，不用抽象词

### 4. 视角一致性
若用户采用第一人称/主观视角，整条动线的所有镜头必须保持同一视角

### 5. 音画同步
台词用 `{}`、音乐用 `（）`、音效用 `<>`；不生成字幕

### 6. 忠实原意
严禁替换或新增角色/物体/场景；只优化表达方式，不改内容

## 技术架构

- 模型：Doubao Seed 2.0 Pro
- 知识注入：完整官方《Doubao Seedance 2.0 系列提示词指南》+ 社区实操技巧（sd2_knowledge.md）
- 输出：优化后的完整 prompt，可直接提交 Seedance 2.0