# 🎬 Seedance Storyboard Plugin for Claude Code

<p align="center">
  <img src="https://img.shields.io/badge/Version-1.1.0-blue?style=for-the-badge" alt="version" />
  <img src="https://img.shields.io/badge/Seedance-2.0-orange?style=for-the-badge" alt="seedance" />
</p>

将任何想法转换成即梦 Seedance 2.0 专业分镜提示词的 Claude Code 插件。

## 简介

Seedance 2.0 是即梦（剪映）推出的强大多模态 AI 视频生成模型，但写出好的提示词对普通人来说很困难。这个插件通过一步步引导，帮你把简单的想法转换成专业的分镜提示词。

## 功能特点

### 🎯 核心能力
- ✅ **分步引导** - 从想法到完整提示词的完整流程
- ✅ **覆盖全能力** - 支持 Seedance 2.0 所有功能（多模态、延长、编辑等）
- ✅ **高级技巧** - 复杂运镜复刻、角色一致性控制、视频延长
- ✅ **实战案例** - 10+ 真实场景案例（希区柯克变焦、广告成片、多场景转场等）
- ✅ **中文优化** - 专门针对中文用户设计

### 🚀 v1.1.0 新增功能
- 🔥 **视频延长** - 在已有视频基础上"接着拍"
- 🔥 **复杂运镜** - 希区柯克变焦、环绕跟拍、一镜到底
- 🔥 **特效复刻** - 变装特效、粒子特效、拼图转场
- 🔥 **角色一致性** - 保持人物形象的连续叙事
- 🔥 **多场景融合** - 无缝转场、空间转换

## 安装方法

### 前提条件

- 已安装 [Claude Code](https://claude.ai/code)

### 安装步骤

#### 方法 1：通过 Marketplace 安装（推荐）

```bash
# 1. 添加 Marketplace
/plugin marketplace add elementsix/claude-seedance-plugin

# 2. 安装 Plugin
/plugin install seedance-storyboard@elementsix-skills

# 3. 重启 Claude Code（重要！）
# 退出 Claude Code 后重新进入，命令 /seedance-storyboard 才会生效
```

#### 方法 2：本地安装

```bash
# 克隆到 Claude Code plugins 目录
git clone https://github.com/elementsix/claude-seedance-plugin.git \
  ~/.claude/plugins/seedance-storyboard

# 退出并重新进入 Claude Code 使命令生效
```

#### 方法 3：手动复制

```bash
# 复制 SKILL.md 到项目 skills 目录
cp -r seedance-storyboard ~/.claude/skills/

# 退出并重新进入 Claude Code 使命令生效
```

> ⚠️ **注意**：安装完成后必须**退出并重新进入 Claude Code**，命令 `/seedance-storyboard` 才能正常使用。

## 使用方法

安装后，输入以下命令使用：

```
/seedance-storyboard
```

然后 Claude 会一步步引导你：

1. **理解想法** - 你想讲什么故事？
2. **深入挖掘** - 风格、镜头、动作、声音
3. **构建分镜** - 按时间轴拆解镜头
4. **生成提示词** - 输出可直接使用的专业提示词
5. **优化建议** - 提供改进和多模态素材建议

## 示例

### 示例 1：古风舞蹈

**你的想法**："一个女孩在樱花树下跳舞"

**生成的提示词**：
```
电影级写实风格，15秒，16:9宽屏，日落黄金时刻的温暖氛围

0-3秒：远景缓慢推近，海平线夕阳，女孩剪影站在沙滩上，裙摆被海风吹动
3-7秒：中景环绕镜头，女孩开始旋转起舞，长发和裙摆飞扬，夕阳逆光形成轮廓光
7-11秒：近景跟随移动，女孩面向镜头舞动，表情自由愉悦，海浪轻拍沙滩作为背景
11-13秒：特写手部动作，手指划过夕阳，光影在指尖流转
13-15秒：远景拉远，女孩在落日余晖中定格，画面渐暗

背景音效：海浪声 + 轻柔的钢琴配乐
```

### 示例 2：产品广告

**你的想法**："展示一款新手机"

### 示例 3：希区柯克变焦

**素材**：@图片1(男人形象)、@图片2(电梯场景)、@视频1(参考运镜)

**提示词**：
```
参考@图片1的男人形象，他在@图片2的电梯中，完全参考@视频1的所有运镜效果还有主角的面部表情，
主角在惊恐时希区柯克变焦，然后几个环绕镜头展示电梯内视角，电梯门打开，跟随镜头走出电梯
```

### 示例 4：视频延长

**素材**：@视频1(原视频)、@图片1-2(角色参考)

**提示词**：
```
延长15s视频，参考@图片1、@图片2的驴骑摩托车的形象
画面1：侧面固定镜头，驴骑着摩托车冲出棚栏，旁边的鸡受到惊吓
画面2：驴骑着摩托在沙地盘旋，俯拍盘旋特技，掀起烟雾
画面3：背景雪山，驴骑着车从山坡飞越过，广告语"Inspire Creativity, Enrich Life"
```

**更多示例**见 `examples/example-prompts.md`

## 文件结构

```
skills/seedance-storyboard/
├── SKILL.md                        # 主 Skill 逻辑
├── README.md                       # Skill 详细说明
├── quick-reference.md              # 快速参考卡片
├── templates/
│   └── storyboard-template.md      # 6套分镜模板
└── examples/
    └── example-prompts.md          # 10个完整示例
```

## Seedance 2.0 核心能力

### 技术参数

| 输入类型 | 格式 | 数量限制 | 大小限制 |
|---------|------|---------|---------|
| **图片** | jpeg, png, webp, bmp, tiff, gif | ≤ 9 张 | < 30 MB |
| **视频** | mp4, mov (2-15s) | ≤ 3 个 | < 50 MB |
| **音频** | mp3, wav | ≤ 3 个 (<15s) | < 15 MB |
| **文本** | 自然语言 | - | - |
| **混合上限** | 12 个文件 | | |

### 核心功能

- **多模态输入** - 图片、视频、音频、文本自由组合
- **参考图像** - 精准还原画面构图、角色细节
- **参考视频** - 支持镜头语言、复杂动作节奏、创意特效复刻
- **视频延长** - 平滑延长与衔接，可"接着拍"
- **视频编辑** - 角色更替、剧情颠覆、片段调整、场景融合
- **基础增强** - 物理规律更合理、动作更自然、指令理解更精准

## 提示词语法

### 基础语法
使用 `@素材名` 引用多模态素材：

```
@图片1 作为首帧
@图片2 作为角色形象参考
@视频1 参考运镜方式
@音频1 用于配乐
```

### 高级用法

| 场景 | 语法示例 |
|------|---------|
| **首帧+动作** | `@图片1 为首帧，参考@视频1 的打斗动作` |
| **视频延长** | `将@视频1 延长 5s`（生成长度选"新增部分"时长） |
| **角色替换** | `将@视频1 中的女生换成@图片1 的形象` |
| **运镜复刻** | `完全参考@视频1 的所有运镜效果` |
| **多视频融合** | `在@视频1 和@视频2 之间加场景，内容为 xxx` |
| **参考声音** | `使用@视频1 的背景音乐和节奏` |

## 即梦平台信息

- **官网**：https://jimeng.jianying.com
- **入口**：Seedance 2.0 - 全能参考 / 首尾帧

### 重要限制

⚠️ **暂不支持上传包含写实真人脸部的素材**（图片和视频均会被系统拦截）

⚠️ **视频参考会消耗更多生成额度**

⚠️ **视频像素范围**：640×640 (480p) 至 834×1112 (720p)

## 贡献

欢迎提交 Issue 和 PR！

## 许可证

MIT License