manga-drama

name	manga-drama
description	AI 漫剧生成器核心技能。丢一张主角图进去，自动编排分镜短剧，从写脚本到生成视频一条龙完成。
metadata	{"openclaw":{"emoji":"🎭","os":["darwin","linux","windows"],"primaryEnv":"ARK_API_KEY","requires":{"env":["ARK_API_KEY"],"bins":["python3"]},"install":[{"id":"pip-volcengine","kind":"command","command":"pip install 'volcengine-python-sdk[ark]'","label":"安装火山引擎 Python SDK"}]}}

Manga Drama - AI 漫剧生成器

这是核心技能，实现从一张主角图到完整漫剧短剧的自动生成。

前置条件

1. 需要火山引擎 API Key，设置环境变量 ARK_API_KEY
2. 安装 SDK：pip install 'volcengine-python-sdk[ark]'

工作流程

1. 剧本生成：根据用户输入的主题/情节，生成漫剧剧本
2. 分镜设计：将剧本拆解为多个分镜场景
3. 角色保持：基于用户提供的角色图片，保持角色一致性
4. 视频生成：为每个分镜生成视频片段
5. 结果输出：返回所有视频片段路径

使用方法

一句话生成漫剧

当用户要求生成漫剧时，执行：

python3 {baseDir}/scripts/generate_drama.py \
  --character "/path/to/character.png" \
  --theme "樱花树下的邂逅" \
  --scenes 4 \
  --style "anime_2d" \
  --output-dir "{workDir}/drama_output"

参数说明：

• --character：主角图片路径（必填）
• --theme：漫剧主题/情节描述（必填）
• --scenes：分镜数量，默认 4，可选 3-8
• --style：漫画风格，可选 anime_2d, ghibli, japanese_healing, chinese_ink, chibi_cute 等
• --ratio：视频比例，默认 16:9，可选 9:16（竖屏）
• --duration：每个分镜时长，默认 5 秒
• --output-dir：输出目录（必填）

自定义剧本生成

如果用户提供了详细的剧本：

python3 {baseDir}/scripts/generate_drama.py \
  --character "/path/to/character.png" \
  --script-file "/path/to/script.txt" \
  --style "ghibli" \
  --output-dir "{workDir}/drama_output"

剧本格式

自定义剧本文件格式示例：

【场景1】樱花树下初遇
镜头：远景，樱花飘落
动作：女主角站在树下，风吹起头发
时长：5秒

【场景2】回眸一笑
镜头：中景，正面
动作：女主角回头，微笑
时长：5秒

【场景3】花瓣飘落
镜头：特写，手部
动作：女主角伸手接住花瓣
时长：5秒

【场景4】夕阳西下
镜头：远景，背影
动作：女主角转身离开，夕阳余晖
时长：5秒

输出规范

1. 生成完成后，在 --output-dir 目录下创建：

   • script.txt：生成的完整剧本
   • scene_1.mp4, scene_2.mp4...：各个分镜视频
   • drama_info.json：漫剧元数据（场景数、时长等）

2. 向用户展示：

   • 生成的剧本内容
   • 每个分镜视频的预览
   • 视频文件路径列表

3. 提示用户：

   • 后续可以使用视频编辑工具将分镜合成为完整视频
   • 或者使用 volcengine-video-understanding 技能分析生成效果

提示词优化建议

主题描述示例：

樱花树下的邂逅：一名长发少女在春天的樱花树下等待，遇到了一只会说话的猫咪，展开了一段奇幻冒险

夏日海边回忆：少年和少女在海边相遇，一起追逐浪花，看日落，留下美好的夏日回忆

古风仙侠奇缘：白衣剑客在竹林中练剑，偶遇采药少女，一段仙侠情缘就此展开

注意事项

1. 此过程会消耗较多 token，建议使用火山引擎 Coding Plan 套餐
2. 每个分镜视频单独生成，保持角色一致性
3. 生成时间取决于分镜数量，请耐心等待

进阶资料

当需要扩展剧情结构、控制镜头节奏或把主题拆成分镜骨架时，读取 references/story-beats.md。