/canghe-manga-drama

name: manga-drama
description: 漫剧生成器 - 基于 Seedance 的漫画风格短剧生成工具。支持以主角图片为基础，自动生成漫剧分镜脚本并生成视频。适用于创作漫画风格的短视频、角色故事、动画短片等。当用户想要生成漫画风格的视频短剧、角色故事或漫剧时使用此技能。

漫剧生成器

基于 Seedance 视频生成能力，专门用于创作**漫画风格的短剧**（漫剧）。

核心功能

• **主角识别**：分析提供的角色图片，提取角色特征
• **自动分镜**：根据主题自动生成漫剧分镜脚本
• **图生视频**：以主角图片为基础生成各分镜视频
• **漫画风格**：内置漫画风格提示词模板
• **分镜管理**：支持自定义分镜脚本

前置要求

需要设置 `ARK_API_KEY` 环境变量。

配置方式（推荐）

1. 复制配置模板：

cp .canghe-skills/.env.example .canghe-skills/.env

2. 编辑 `.canghe-skills/.env` 文件，填写你的 API Key：

ARK_API_KEY=your-actual-api-key-here

或使用环境变量

export ARK_API_KEY="your-api-key"

加载优先级

1. 系统环境变量 (`process.env`) 2. 当前目录 `.canghe-skills/.env` 3. 用户主目录 `~/.canghe-skills/.env`

---

需要依赖技能：**seedance-video-generation**

使用方法

1. 快速生成漫剧（推荐）

提供主角图片和主题，自动生成完整漫剧：

cd ~/.openclaw/workspace/skills/manga-drama
python3 scripts/manga_drama.py generate \
  --image /path/to/character.png \
  --theme "校园日常" \
  --scenes 3 \
  --send-feishu

2. 根据脚本生成漫剧

先创建脚本，再生成视频：

# 创建脚本模板
python3 scripts/manga_drama.py create-script \
  --output my_drama.json \
  --title "我的漫剧" \
  --character "双马尾女孩" \
  --num-scenes 4

# 编辑脚本文件后生成
python3 scripts/manga_drama.py from-script \
  --script my_drama.json \
  --image /path/to/character.png \
  --send-feishu

分镜模板

内置5种漫剧分镜类型：

| 分镜类型 | 名称 | 说明 | |---------|------|------| | introduction | 主角登场 | 介绍主角，展示角色特征 | | action | 动作场景 | 主角进行某个动作 | | emotion | 情感表达 | 表达某种情感 | | interaction | 互动场景 | 与环境或其他元素互动 | | ending | 结尾定格 | 漫剧结尾，定格画面 |

脚本格式

{
  "title": "漫剧标题",
  "character": "主角描述",
  "style": "漫画风格",
  "total_scenes": 3,
  "scenes": [
    {
      "scene_number": 1,
      "type": "introduction",
      "name": "主角登场",
      "prompt": "双马尾女孩站在画面中央，微笑看向镜头，漫画风格...",
      "duration": 5,
      "ratio": "9:16",
      "resolution": "1080p"
    }
  ]
}

参数说明

generate 命令

| 参数 | 必需 | 说明 | |------|------|------| | `--image` | ✅ | 主角图片路径 | | `--theme` | ✅ | 漫剧主题/剧情描述 | | `--scenes` | ❌ | 分镜数量（默认3） | | `--output` | ❌ | 输出目录（默认~/Desktop） | | `--send-feishu` | ❌ | 发送到飞书 |

from-script 命令

| 参数 | 必需 | 说明 | |------|------|------| | `--script` | ✅ | 脚本文件路径 | | `--image` | ✅ | 主角图片路径 | | `--send-feishu` | ❌ | 发送到飞书 |

create-script 命令

| 参数 | 必需 | 说明 | |------|------|------| | `--output` | ✅ | 输出脚本文件路径 | | `--title` | ❌ | 漫剧标题 | | `--character` | ❌ | 主角描述 | | `--num-scenes` | ❌ | 分镜数量 |

使用示例

示例 1：生成校园日常漫剧

python3 scripts/manga_drama.py generate \
  --image ~/Desktop/girl_character.png \
  --theme "校园日常" \
  --scenes 3 \
  --send-feishu

生成3个分镜： 1. 主角登场（校园门口） 2. 动作场景（上课/运动） 3. 结尾定格（温馨画面）

示例 2：创建自定义漫剧

# 创建脚本
python3 scripts/manga_drama.py create-script \
  --output spring_festival.json \
  --title "春节团圆" \
  --character "白发奶奶" \
  --num-scenes 5

# 编辑 spring_festival.json 文件
# 然后生成
python3 scripts/manga_drama.py from-script \
  --script spring_festival.json \
  --image ~/Desktop/grandma.png \
  --send-feishu

风格特点

• **漫画质感**：手绘风格，线条清晰
• **柔和色彩**：温馨治愈的色调
• **电影构图**：专业的画面构图
• **角色一致性**：基于同一张主角图片生成

技术细节

调用流程

1. 分析主角图片 → 提取角色特征
2. 根据主题 → 生成分镜脚本
3. 每个分镜 → 调用 Seedance 图生视频
4. 可选 → 发送到飞书

视频规格

• **默认比例**：9:16（竖屏，适合手机观看）
• **默认分辨率**：1080p
• **默认时长**：每分镜5秒
• **风格**：漫画/手绘风格

输出结构

~/Desktop/drama_我的漫剧/
├── drama_script_xxx.json    # 脚本文件
├── scene_1_introduction.mp4 # 分镜1
├── scene_2_action.mp4       # 分镜2
├── scene_3_emotion.mp4      # 分镜3
└── ...

注意事项

1. **主角图片质量**：清晰的角色图片能获得更好的生成效果 2. **提示词优化**：可以编辑脚本文件自定义每个分镜的提示词 3. **生成时间**：每个分镜约30-60秒，多个分镜需要耐心等待 4. **文件大小**：1080p视频较大，发送飞书可能需要分片上传

进阶用法

自定义分镜提示词

编辑生成的脚本文件，修改 `prompt` 字段：

{
  "prompt": "{character}在樱花树下读书，花瓣飘落，漫画风格，温馨治愈..."
}

批量生成系列漫剧

创建多个脚本，批量生成：

for script in scripts/*.json; do
  python3 scripts/manga_drama.py from-script \
    --script "$script" \
    --image ~/Desktop/character.png
done

参考文档

• [Seedance 视频生成](../seedance-video-generation-1.0.3/SKILL.md)
• [火山方舟文档](https://www.volcengine.com/docs/82379)