manga-drama

漫剧生成器

基于 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 视频生成
• 火山方舟文档