分镜图集 · 截图待补
这个节点是做什么的
分镜图集（Shot Images）属于 Compose 分类。它读取上游 Storyboard 输出的COMFYTV_STORYBOARD JSON（内含 shots[]，每镜有 prompt、时长、镜头说明等），然后按顺序为每一镜调用一次图像 workflow，每镜产出一张图，最终打包为 COMFYTV_IMAGES 批量。
你可以把它看作「Storyboard 的渲染器」：Storyboard 只产结构化文字；Shot Images 才产像素。
典型流水线：
适用场景
- 短视频 / 广告前期：先 AI 写分镜，再一键出概念图。
- 同一故事换不同 image workflow（Flux、SD 等）快速对比视觉风格。
- 多镜共享角色参考图（images 口 autogrow 传给每一镜）。
- 为 Director Timeline 准备按镜号标注的图片素材。
工作原理（为什么 ComfyTV 这样设计）
- Stage + ▶ 运行：点 Run 只跑本节点，按镜顺序调用 workflow，不会重跑整张 ComfyUI 图；进度条显示
shot 2/6等。 - 快照：Run 完成后批量 JSON 存进项目；下游 Picker Run 时用该快照，不会自动重跑 Shot Images。
- workflow 下拉框：背后对应
workflows/shot-images/及声明了kinds: ["image","shot-images"]的workflows/image/JSON。ComfyTV 把每镜 prompt、resolution、aspect_ratio 映射进子工作流。 - Storyboard 驱动：无 storyboard 连线或 shots 为空时会失败；请先 Run Storyboard。
类型说明（COMFYTV_* vs ComfyUI 原生）
术语提示：COMFYTV_*是 ComfyTV 保存在项目里的结果引用；ComfyUI 原生的IMAGE/VIDEO/AUDIO是运行时才在内存里的数据，二者不能直接连线，需用 Bridge 转换。
Bridge：bridges.zh.md
界面与参数说明
workflow
- 是什么：图像生成后端，来自 workflows/shot-images/ 及多 kind 的 image workflow。
- 选项从哪来：仓库 workflow 配置 + 启动时扫描；内置示例含 Flux Schnell、Local Z-Image Turbo 等（视安装而定）。
- 需要什么模型：见各 workflow README 与 models.zh.md。
- 影响：决定每镜画面风格与质量；换 workflow 可 A/B 同一分镜表。
resolution / aspect_ratio
- 是什么：与 Image Stage 相同的短边档位（如 1K）与宽高比（1:1、16:9…）。
- 影响：每一镜统一使用该尺寸；不会按镜单独改（改分镜请在 Storyboard UI 或后续 Crop）。
storyboard
- 是什么：上游
COMFYTV_STORYBOARD连线。 - 填什么：Storyboard → storyboard 接到此处。
- 影响：shots 数组长度 = 运行次数；每镜
prompt/image_prompt字段作为该镜生成 prompt。 - 误区：在 Shot Images 里改 prompt——应在 Storyboard 节点 UI 编辑各镜后再 Run 本节点。
images（参考图 autogrow）
- 是什么：最多 8 槽的可选
COMFYTV_IMAGE参考。 - 影响：每一镜 workflow 都会收到相同 upstream images（如角色立绘、场景参考）。
- 用途：保持多镜角色一致性。
selected_index
- 决定 image 单输出口对应批量中第几张（1 起始）；点缩略图可改。
自定义参数（custom_params）
- 侧栏绑定的额外 workflow 参数（种子、步数等）。
输出说明
新手一步一步
- Project + Storyboard：写故事 premise，设 shot_count、时长；从下拉框选 Storyboard workflow（如 Qwen3 Storyboard，后端未就绪时可能仅为占位项），▶ 运行。
- 在 Storyboard UI 检查/修改各镜 prompt。
- 添加 Shot Images，storyboard 口接上一步输出。
- 选 workflow（如 Flux Schnell）、resolution、aspect_ratio；可选连角色参考到 images。
- ▶ 运行 Shot Images，等待逐镜进度完成。
- 接 Image Picker 挑满意镜头，或用 Director Timeline 编排。
完整教程（推荐阅读）
本页只说明这一个节点的参数与用法。端到端流程与多节点串联，请见 GitHub 上的 ComfyTV 用户指南：
仓库与工作流
常见问题
Q：报 “no shots” 或 “returned no shots”？A：先 Run Storyboard 且 shots 非空；检查模型；查看控制台逐镜失败信息。 Q：与 Image Stage 有何区别？
A：Image Stage = 一个 prompt，N 张相似图。Shot Images = N 个不同 prompt（分镜），每镜一张。分镜批量渲染 vs 单 prompt 批量。 Q：workflow 列表空白/灰色？
A：重启 ComfyUI 重新扫描；确认 shot-images 或多 kind 配置存在。 Q：不用 Storyboard 能手动写 prompt 吗？
A：设计用于分镜 JSON；先 Run Storyboard，在 UI 编辑分镜，再 Run Shot Images。 Q：Load 与 generate 的区别？
A：Loader 导入文件；Shot Images 生成分镜画面。可混用：Loader 作参考，Shot Images 产出成品。
相关节点
- Storyboard —— 必需上游；产出 COMFYTV_STORYBOARD。
- Image Picker —— 从分镜批量挑单镜。
- Image Stage —— 单 prompt 多图，非分镜流水线。
- Director Timeline —— 用分镜图编排时间线。
- Text Stage —— 可选，为 Storyboard 提供 premise 扩写。