arcreel 生成宫格分镜图
为开启宫格装配的项目生成宫格分镜图。自动按 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 后缀），每格覆写前后均入版本史