# Manga Drama

> AI 漫剧生成器核心技能。丢一张主角图进去，自动编排分镜短剧，从写脚本到生成视频一条龙完成。

- Skill: `lujiaheng-artpivot/manga-drama` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lujiaheng-artpivot/manga-drama`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lujiaheng-artpivot/manga-drama/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lujiaheng-artpivot (https://skillmd.com/u/lujiaheng-artpivot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lujiaheng-artpivot/manga-drama

---


# Manga Drama - AI 漫剧生成器

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

## 前置条件

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

## 工作流程

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

## 使用方法

### 一句话生成漫剧

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

```bash
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`：输出目录（必填）

### 自定义剧本生成

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

```bash
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`。