space-storyboard-generator

name	space-storyboard-generator
description	根据用户描述的故事内容，润色故事线并拆分为分镜脚本，批量生成风格一致的故事板插图。提供8种视觉风格选择，基于故事类型推荐最佳风格。调用Gemini API生成图片，保存到Obsidian图片目录。触发词："分镜故事"、"故事板"、"做个分镜"、"创建故事板"、"storyboard"、"画个故事"。

分镜故事板生成器

根据用户描述润色故事线，拆分为分镜脚本，批量生成风格一致的故事板插图。

工作流程

Phase 1: 故事润色与分镜拆分

1. 接收故事 - 获取用户描述的故事内容（文字、大纲、或灵感片段）
2. 润色故事线 - 补充叙事细节，梳理情感弧线，输出结构化故事概要：

   故事概要：一句话概括
   情感弧线：[起点] → [转折] → [结局]
   

3. 拆分分镜 - 将故事拆为 6-10 个关键帧，每帧包含：
   • 场景标题
   • 镜头类型（远景/中景/近景/特写等）
   • 画面描述（人物动作、环境、光线）
   • 情绪基调
   • 对白/文字（如有）
4. 展示分镜脚本 - 以表格形式展示，等待用户确认或调整

展示格式：

## 分镜脚本

| # | 场景 | 镜头 | 画面描述 | 情绪 |
|---|------|------|---------|------|
| 1 | 开场 | 远景 | xxx | 平静 |
| 2 | 引入 | 中景 | xxx | 好奇 |
| ... |

Phase 2: 风格选择

分镜脚本确认后，展示 8 种视觉风格（读取 references/visual-styles.md）：

#	风格	一句话特征	适用故事
1	赛博朋克漫画	霓虹+暗色调+高对比	科技/AI/未来
2	吉卜力水彩	柔和水彩+温暖光影	日常/温馨/成长
3	美式扁平插画	矢量几何+明快配色	产品/商业/教育
4	电影分镜手稿	黑白素描+镜头标注	视频脚本/广告
5	像素艺术	复古16-bit游戏风	游戏/趣味/极客
6	中国风水墨	水墨晕染+诗意留白	传统/哲理/东方
7	清线漫画	均匀粗线+扁平上色	冒险/幽默/IP
8	写实概念艺术	电影级数字绘画	史诗/科幻/奇幻

根据故事类型和情感调性，推荐 1-2 种最适合的风格并说明理由，等待用户选择。

Phase 3: 生成提示词

用户选定风格后，为每个分镜帧生成提示词。

每个提示词结构（读取 references/visual-styles.md 获取风格前缀和镜头语言）：

1. 风格前缀 - 选定风格的标准描述
2. 镜头指令 - 如 "Wide establishing shot" / "Close-up"
3. 画面叙述 - 用完整语句描述场景内容（人物、动作、环境、光线、氛围）
4. 情绪指令 - 明确画面传递的情感
5. 一致性锚定 - IMPORTANT: This is panel [N] of [TOTAL] in a storyboard sequence. Maintain exact same art style, color palette, character design, and visual consistency with all other panels. Same character must look identical across all panels.
6. 中文指令（如需）- ALL text, signs, and dialogue in the image MUST be in Chinese (Simplified Chinese). Technical terms may remain in English.

展示提示词概要表，等待确认：

## 提示词概要

| # | 场景 | 镜头 | 风格 | 核心画面 |
|---|------|------|------|---------|
| 1 | 开场 | 远景 | 赛博朋克 | 城市天际线... |
| ... |

确认后开始生成（共 N 帧）

Phase 4: 批量生成

确认后逐帧调用脚本生成：

python3 scripts/generate_image.py \
  --prompt "提示词" \
  --output "/Users/ugreen/Documents/obsidian/09image/MMDD-故事名-storyboard/01-场景名.png" \
  --api-key "REMOVED_GEMINI_KEY" \
  --api-url "https://generativelanguage.googleapis.com" \
  --model "gemini-3-pro-image-preview" \
  --aspect-ratio "16:9" \
  --resolution "2K"

注意事项:

• 故事板默认 16:9 横版
• 分辨率默认 2K
• MMDD 为当天日期
• 文件命名：01-场景简称.png、02-场景简称.png...
• 每帧间隔 2-3 秒避免限流
• 失败帧记录并继续，最后汇报
• 关键: 角色外观描述在所有帧中保持一致（发型、服装、体型）

Phase 5: 展示与迭代

1. 生成完成后，按顺序列出所有帧路径
2. 询问用户：
   • "整体故事节奏是否满意？"
   • "需要重新生成某一帧吗？"
   • "需要增加/删除某个场景吗？"
   • "角色一致性是否满意？"
3. 迭代：调整提示词重新生成指定帧

保存路径规范

/Users/ugreen/Documents/obsidian/09image/MMDD-故事名-storyboard/
├── 01-开场-远景.png
├── 02-引入-中景.png
├── 03-转折-近景.png
├── 04-发展A-中景.png
├── 05-发展B-全景.png
├── 06-高潮-特写.png
├── 07-结局-远景.png
└── storyboard-script.md  (可选：保存分镜脚本文档)

API 配置

配置项	值
API URL	https://generativelanguage.googleapis.com
API Key	REMOVED_GEMINI_KEY
Model	gemini-3-pro-image-preview
默认比例	16:9（故事板横版）
默认分辨率	2K

镜头语言速查

镜头	英文	用途
远景	Wide Shot	开场、环境交代
全景	Full Shot	人物全身+环境
中景	Medium Shot	对话、日常互动
近景	Close-up	表情、情感
特写	Extreme Close-up	关键道具、细节
俯拍	Bird's Eye	全局、渺小感
仰拍	Low Angle	权威、震撼

常见用法

用户说	操作
"帮我画个故事分镜"	收集故事 → 润色 → 拆分镜 → 选风格 → 生成
"这个故事做成故事板"	同上
"用赛博朋克风画这个故事"	跳过风格选择，直接用指定风格
"第3帧不好，重新生成"	调整提示词重新生成单帧
"加一帧过渡镜头"	在指定位置插入新分镜帧