generate-grid

name generate-grid description 生成宫格分镜图。当用户说"生成宫格"、"宫格生图"、"用宫格装配生成分镜"时使用。自动按 segment_break 分组，选择最优宫格大小，生成链式过渡帧宫格联合图，随后切分落格为各分镜的起始分镜图。 生成宫格分镜图 为开启宫格装配的项目生成宫格分镜图。自动按 segment_break 分组，每组生成一张宫格联合图（分镜数超过单张宫格格数上限的分组会切为多张，末张不足一档时落到更小档并补占位格）。宫格生命周期分两段：生成任务只产出联合图并记版本；切分落格是独立操作、唯一覆写分镜格的步骤。 generate_grid 工具在每张联合图生成完成后自动执行切分，端到端仍产出各分镜的起始分镜图（仍走 i2v，与逐张生成的分镜图输入契约相同）。若某张切分失败，联合图已生成成功，引导用户在 Web 宫格面板重试切分即可，不要重新生成（避免重复计费）。 前置条件 项目 generation_mode 为 "storyboard" 且 grid_storyboard 为 true （宫格装配由用户在 Web 设置页开关，项目创建后不可经 Agent 改） 剧本已生成（scripts/episode_N.json 存在） 角色/场景/道具资产图（已生成的会作为参考图带入；一张都没有时退化为纯文生图，画面一致性会明显变差） 工具调用 操作 工具 整集生成 mcp__arcreel__generate_grid({"script": "episode_1.json"}) 指定分镜所在的组 mcp__arcreel__generate_grid({"script": "episode_1.json", "scene_ids": ["E1S01", "E1S02", "E1S03"]}) 列出当前分组信息 mcp__arcreel__generate_grid({"script": "episode_1.json", "list_only": true}) 不传 scene_ids 时只补缺：分镜格已齐备的分组会被复用，不重新生成。 结果按 requested / succeeded / failed / blocked 逐 分镜 ID 返回：同组分镜共享一张宫格， 这张宫格的入队、任务与切分结果投影到它覆盖的每个分镜。联合图已生成但切分失败的分镜 带 generation_post_processing_failed ，此时不要重新生成整张宫格（会重复计费）。 结构详见 .claude/references/generation-results.md 。 输出 宫格联合图保存到 grids/{grid_id}.png （ grid_id 自身即带 grid_ 前缀，如 grids/grid_a1b2c3d4e5f6.png ），每次生成/上传记为一个 grids 版本 帧链元数据保存到 grids/{grid_id}.json （ split_at 记录最近一次按当前联合图切分落格的时间） 切分后的单元格按 next_scene_id 分配落盘，文件名与普通分镜图对齐为 storyboards/scene_{id}.png （无 first/last 后缀），每格覆写前后均入版本史