$npx -y skills add freestylefly/canghe-skills --skill canghe-manga-drama漫剧生成器 - 基于 Seedance 的漫画风格短剧生成工具。支持以主角图片为基础,自动生成漫剧分镜脚本并生成视频。适用于创作漫画风格的短视频、角色故事、动画短片等。当用户想要生成漫画风格的视频短剧、角色故事或漫剧时使用此技能。
| 1 | # 漫剧生成器 |
| 2 | |
| 3 | 基于 Seedance 视频生成能力,专门用于创作**漫画风格的短剧**(漫剧)。 |
| 4 | |
| 5 | ## 核心功能 |
| 6 | |
| 7 | - **主角识别**:分析提供的角色图片,提取角色特征 |
| 8 | - **自动分镜**:根据主题自动生成漫剧分镜脚本 |
| 9 | - **图生视频**:以主角图片为基础生成各分镜视频 |
| 10 | - **漫画风格**:内置漫画风格提示词模板 |
| 11 | - **分镜管理**:支持自定义分镜脚本 |
| 12 | |
| 13 | ## 前置要求 |
| 14 | |
| 15 | 需要设置 `ARK_API_KEY` 环境变量。 |
| 16 | |
| 17 | ### 配置方式(推荐) |
| 18 | |
| 19 | 1. 复制配置模板: |
| 20 | ```bash |
| 21 | cp .canghe-skills/.env.example .canghe-skills/.env |
| 22 | ``` |
| 23 | |
| 24 | 2. 编辑 `.canghe-skills/.env` 文件,填写你的 API Key: |
| 25 | ``` |
| 26 | ARK_API_KEY=your-actual-api-key-here |
| 27 | ``` |
| 28 | |
| 29 | ### 或使用环境变量 |
| 30 | |
| 31 | ```bash |
| 32 | export ARK_API_KEY="your-api-key" |
| 33 | ``` |
| 34 | |
| 35 | ### 加载优先级 |
| 36 | |
| 37 | 1. 系统环境变量 (`process.env`) |
| 38 | 2. 当前目录 `.canghe-skills/.env` |
| 39 | 3. 用户主目录 `~/.canghe-skills/.env` |
| 40 | |
| 41 | --- |
| 42 | |
| 43 | 需要依赖技能:**seedance-video-generation** |
| 44 | |
| 45 | ## 使用方法 |
| 46 | |
| 47 | ### 1. 快速生成漫剧(推荐) |
| 48 | |
| 49 | 提供主角图片和主题,自动生成完整漫剧: |
| 50 | |
| 51 | ```bash |
| 52 | cd ~/.openclaw/workspace/skills/manga-drama |
| 53 | python3 scripts/manga_drama.py generate \ |
| 54 | --image /path/to/character.png \ |
| 55 | --theme "校园日常" \ |
| 56 | --scenes 3 \ |
| 57 | --send-feishu |
| 58 | ``` |
| 59 | |
| 60 | ### 2. 根据脚本生成漫剧 |
| 61 | |
| 62 | 先创建脚本,再生成视频: |
| 63 | |
| 64 | ```bash |
| 65 | # 创建脚本模板 |
| 66 | python3 scripts/manga_drama.py create-script \ |
| 67 | --output my_drama.json \ |
| 68 | --title "我的漫剧" \ |
| 69 | --character "双马尾女孩" \ |
| 70 | --num-scenes 4 |
| 71 | |
| 72 | # 编辑脚本文件后生成 |
| 73 | python3 scripts/manga_drama.py from-script \ |
| 74 | --script my_drama.json \ |
| 75 | --image /path/to/character.png \ |
| 76 | --send-feishu |
| 77 | ``` |
| 78 | |
| 79 | ## 分镜模板 |
| 80 | |
| 81 | 内置5种漫剧分镜类型: |
| 82 | |
| 83 | | 分镜类型 | 名称 | 说明 | |
| 84 | |---------|------|------| |
| 85 | | introduction | 主角登场 | 介绍主角,展示角色特征 | |
| 86 | | action | 动作场景 | 主角进行某个动作 | |
| 87 | | emotion | 情感表达 | 表达某种情感 | |
| 88 | | interaction | 互动场景 | 与环境或其他元素互动 | |
| 89 | | ending | 结尾定格 | 漫剧结尾,定格画面 | |
| 90 | |
| 91 | ## 脚本格式 |
| 92 | |
| 93 | ```json |
| 94 | { |
| 95 | "title": "漫剧标题", |
| 96 | "character": "主角描述", |
| 97 | "style": "漫画风格", |
| 98 | "total_scenes": 3, |
| 99 | "scenes": [ |
| 100 | { |
| 101 | "scene_number": 1, |
| 102 | "type": "introduction", |
| 103 | "name": "主角登场", |
| 104 | "prompt": "双马尾女孩站在画面中央,微笑看向镜头,漫画风格...", |
| 105 | "duration": 5, |
| 106 | "ratio": "9:16", |
| 107 | "resolution": "1080p" |
| 108 | } |
| 109 | ] |
| 110 | } |
| 111 | ``` |
| 112 | |
| 113 | ## 参数说明 |
| 114 | |
| 115 | ### generate 命令 |
| 116 | |
| 117 | | 参数 | 必需 | 说明 | |
| 118 | |------|------|------| |
| 119 | | `--image` | ✅ | 主角图片路径 | |
| 120 | | `--theme` | ✅ | 漫剧主题/剧情描述 | |
| 121 | | `--scenes` | ❌ | 分镜数量(默认3) | |
| 122 | | `--output` | ❌ | 输出目录(默认~/Desktop) | |
| 123 | | `--send-feishu` | ❌ | 发送到飞书 | |
| 124 | |
| 125 | ### from-script 命令 |
| 126 | |
| 127 | | 参数 | 必需 | 说明 | |
| 128 | |------|------|------| |
| 129 | | `--script` | ✅ | 脚本文件路径 | |
| 130 | | `--image` | ✅ | 主角图片路径 | |
| 131 | | `--send-feishu` | ❌ | 发送到飞书 | |
| 132 | |
| 133 | ### create-script 命令 |
| 134 | |
| 135 | | 参数 | 必需 | 说明 | |
| 136 | |------|------|------| |
| 137 | | `--output` | ✅ | 输出脚本文件路径 | |
| 138 | | `--title` | ❌ | 漫剧标题 | |
| 139 | | `--character` | ❌ | 主角描述 | |
| 140 | | `--num-scenes` | ❌ | 分镜数量 | |
| 141 | |
| 142 | ## 使用示例 |
| 143 | |
| 144 | ### 示例 1:生成校园日常漫剧 |
| 145 | |
| 146 | ```bash |
| 147 | python3 scripts/manga_drama.py generate \ |
| 148 | --image ~/Desktop/girl_character.png \ |
| 149 | --theme "校园日常" \ |
| 150 | --scenes 3 \ |
| 151 | --send-feishu |
| 152 | ``` |
| 153 | |
| 154 | 生成3个分镜: |
| 155 | 1. 主角登场(校园门口) |
| 156 | 2. 动作场景(上课/运动) |
| 157 | 3. 结尾定格(温馨画面) |
| 158 | |
| 159 | ### 示例 2:创建自定义漫剧 |
| 160 | |
| 161 | ```bash |
| 162 | # 创建脚本 |
| 163 | python3 scripts/manga_drama.py create-script \ |
| 164 | --output spring_festival.json \ |
| 165 | --title "春节团圆" \ |
| 166 | --character "白发奶奶" \ |
| 167 | --num-scenes 5 |
| 168 | |
| 169 | # 编辑 spring_festival.json 文件 |
| 170 | # 然后生成 |
| 171 | python3 scripts/manga_drama.py from-script \ |
| 172 | --script spring_festival.json \ |
| 173 | --image ~/Desktop/grandma.png \ |
| 174 | --send-feishu |
| 175 | ``` |
| 176 | |
| 177 | ## 风格特点 |
| 178 | |
| 179 | - **漫画质感**:手绘风格,线条清晰 |
| 180 | - **柔和色彩**:温馨治愈的色调 |
| 181 | - **电影构图**:专业的画面构图 |
| 182 | - **角色一致性**:基于同一张主角图片生成 |
| 183 | |
| 184 | ## 技术细节 |
| 185 | |
| 186 | ### 调用流程 |
| 187 | |
| 188 | ``` |
| 189 | 1. 分析主角图片 → 提取角色特征 |
| 190 | 2. 根据主题 → 生成分镜脚本 |
| 191 | 3. 每个分镜 → 调用 Seedance 图生视频 |
| 192 | 4. 可选 → 发送到飞书 |
| 193 | ``` |
| 194 | |
| 195 | ### 视频规格 |
| 196 | |
| 197 | - **默认比例**:9:16(竖屏,适合手机观看) |
| 198 | - **默认分辨率**:1080p |
| 199 | - **默认时长**:每分镜5秒 |
| 200 | - **风格**:漫画/手绘风格 |
| 201 | |
| 202 | ## 输出结构 |
| 203 | |
| 204 | ``` |
| 205 | ~/Desktop/drama_我的漫剧/ |
| 206 | ├── drama_script_xxx.json # 脚本文件 |
| 207 | ├── scene_1_introduction.mp4 # 分镜1 |
| 208 | ├── scene_2_action.mp4 # 分镜2 |
| 209 | ├── scene_3_emotion.mp4 # 分镜3 |
| 210 | └── ... |
| 211 | ``` |
| 212 | |
| 213 | ## 注意事项 |
| 214 | |
| 215 | 1. **主角图片质量**:清晰的角色图片能获得更好的生成效果 |
| 216 | 2. **提示词优化**:可以编辑脚本文件自定义每个分镜的提示词 |
| 217 | 3. **生成时间**:每个分镜约30-60秒,多个分镜需要耐心等待 |
| 218 | 4. **文件大小**:1080p视频较大,发送飞书可能需要分片上传 |
| 219 | |
| 220 | ## 进阶用法 |
| 221 | |
| 222 | ### 自定义分镜提示词 |
| 223 | |
| 224 | 编辑生成的脚本文件,修改 `prompt` 字段: |
| 225 | |
| 226 | ```json |
| 227 | { |
| 228 | "prompt": "{character}在樱花树下读书,花瓣飘落,漫画风格,温馨治愈..." |
| 229 | } |
| 230 | ``` |
| 231 | |
| 232 | ### 批量生成系列漫剧 |
| 233 | |
| 234 | 创建多个脚本,批量生成: |
| 235 | |
| 236 | ```bash |
| 237 | for script in scripts/*.json; do |
| 238 | python3 scripts/manga_drama.py from-script \ |
| 239 | --script "$script" \ |
| 240 | --image ~/Desktop/character.png |
| 241 | done |
| 242 | ``` |
| 243 | |
| 244 | ## 参考文档 |
| 245 | |
| 246 | - [Seedance 视频生成](../seedance-video-generation-1.0.3/SKILL.md) |
| 247 | - [火山方舟文档](https://www.volcengine.com/docs/82379) |