AI分镜生成器

需要解决的问题

在影视、广告或动画制作中，将剧本、场景描述或广告创意转化为可执行的镜头语言，是一个关键但繁琐的环节。手动拆解剧本、规划镜头景别、构图和机位，并绘制分镜草图，不仅耗时，还容易因沟通偏差导致后期返工。尤其是对于需要快速迭代的创意项目，缺乏结构化的分解工具和视觉预览手段，会直接影响制作效率与创意落地。

核心能力与工作流程

这个 AI 分镜生成器（@beatra-ai/ai-storyboard-generator）旨在解决上述问题。它并非一个简单的绘图工具，而是一个专注于剧本结构化分解与关键视觉帧生成的流程化技能。

其工作流程遵循严谨的分步验证原则：

• 输入收集与计划制定：首先，技能会要求用户提供剧本、场景简报、角色设定、视觉风格参考、预期受众、画幅比例等基础信息。它不会直接跳到绘图，而是先整理出一个详细的叙事节拍（beat）拆解方案。
• 镜头表生成：在获得用户对节拍拆解的批准后，技能会生成一份完整的镜头表（shot list）。这份表格会描述每个镜头的景别（如全景、特写）、构图、机位运动、角色动作、时长估算、台词和音效提示。这是一份纯文本的、可执行的制作蓝图。
• 关键帧计划与生成：基于已批准的镜头表，技能会提出一个关键分镜图（key frame）的生成计划，说明计划制作多少张（通常1-4张）图像，每张图的目的、画面重点以及它们在镜头表中的对应顺序。用户必须批准这个计划及其涉及的实时价格后，技能才会调用 beatra.images.generate、beatra.images.transform 或 beatra.images.edit 等工具，生成真正的栅格化关键帧图像，而非占位符。
• 任务管理与恢复：在整个过程中，技能会严格管理任务状态。如果遇到远程调用失败或响应丢失，它会通过 beatra.tasks.list 和 beatra.tasks.get 来查询和恢复状态，确保付费生成的关键帧不会被重复创建。所有远程调用都通过随包提供的 scripts/mcp_client.py 进行。

关键点：这个技能的核心价值在于将创意结构化和可视化验证，而非无节制的图像生成。它严格区分了免费的“计划制定”阶段和付费的“关键帧生成”阶段，确保每一步都得到用户明确批准。

适用边界与注意点

它并非万能的分镜全能工，其能力有明确边界：

• 输出范围：主要交付文字镜头表和少量关键分镜图。它明确声明，关键帧是“静态关键帧”，不等同于成片或动态预览。若用户只需要文字镜头表，它会在生成表格后停止。
• 功能转交：技能定义了清晰的转交边界。

- 需要更开放、更精美的图像创作时，应转交给 beatra-ai-image-studio。
- 需要保证多帧中角色外观高度一致时，应转交给 ip-character-consistency-studio。
- 需要生成或编辑实际视频时，应转交给 beatra-ai-video-studio。

• 费用与批准：每一次使用 beatra.images.* 生成或编辑图像的操作都是独立的付费请求。任何对剧本、参考图、提示词或画布的改动，都会触发新的请求并需要重新批准。慢任务或响应丢失不能作为重复创建的借口。
• 技术依赖：所有网络操作必须通过随包客户端 scripts/mcp_client.py 执行，严禁尝试使用 REST/OpenAPI 等降级方案或直接调用宿主连接器。

总之，它适合在项目前期，将模糊的创意快速转化为结构化的制作蓝图，并通过关键帧进行视觉锚定，为后续更精细的制作环节打下坚实基础。