| name | storyboard-generator |
| description | 根据用户描述的故事内容，润色故事线并拆分为分镜脚本，批量生成风格一致的故事板插图。提供8种视觉风格选择，基于故事类型推荐最佳风格。调用Gemini API生成图片，保存到Obsidian图片目录。触发词："分镜故事"、"故事板"、"做个分镜"、"创建故事板"、"storyboard"、"画个故事"。 |
分镜故事板生成器
根据用户描述润色故事线，拆分为分镜脚本，批量生成风格一致的故事板插图。
工作流程
Phase 1: 故事润色与分镜拆分
- 接收故事 - 获取用户描述的故事内容（文字、大纲、或灵感片段）
- 润色故事线 - 补充叙事细节，梳理情感弧线，输出结构化故事概要：
故事概要：一句话概括
情感弧线：[起点] → [转折] → [结局]
- 拆分分镜 - 将故事拆为 6-10 个关键帧，每帧包含：
- 场景标题
- 镜头类型（远景/中景/近景/特写等）
- 画面描述（人物动作、环境、光线）
- 情绪基调
- 对白/文字（如有）
- 展示分镜脚本 - 以表格形式展示，等待用户确认或调整
展示格式：
## 分镜脚本
| # | 场景 | 镜头 | 画面描述 | 情绪 |
|---|------|------|---------|------|
| 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 获取风格前缀和镜头语言）：
- 风格前缀 - 选定风格的标准描述
- 镜头指令 - 如 "Wide establishing shot" / "Close-up"
- 画面叙述 - 用完整语句描述场景内容（人物、动作、环境、光线、氛围）
- 情绪指令 - 明确画面传递的情感
- 一致性锚定 -
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.
- 中文指令（如需）-
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 "AIzaSyDvvGGRbH4Os3Er0dYi0kE_AzE3_2b_Az8" \
--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: 展示与迭代
- 生成完成后，按顺序列出所有帧路径
- 询问用户：
- "整体故事节奏是否满意？"
- "需要重新生成某一帧吗？"
- "需要增加/删除某个场景吗？"
- "角色一致性是否满意？"
- 迭代：调整提示词重新生成指定帧
保存路径规范
/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 | AIzaSyDvvGGRbH4Os3Er0dYi0kE_AzE3_2b_Az8 |
| 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帧不好，重新生成" | 调整提示词重新生成单帧 |
| "加一帧过渡镜头" | 在指定位置插入新分镜帧 |
