用途:为 SpriteCook 构建完整界面与统一 UI 系统,适用于菜单、HUD、背包、对话框、设置、覆盖层、商店、角色界面等需要共享同一视觉语言的组合。单个孤立图标、按钮、边框等应改用 generate_game_art(mode="ui")。
前提:需在编辑器中连接 SpriteCook MCP 服务器,可用 npx spritecook-mcp setup 配置。开始多图流程前先确认 UI-kit 工具存在并调用 get_credit_balance;工具缺失时应刷新或重连 MCP,不要退化为独立生成整屏。
主要流程:先用 create_ui_kit 创建套件并保留 id,默认 model="gpt-image-2"。概念阶段可传入已有 concept_asset_id 跳过生成,本地文件先用 spritecook-upload-assets 上传;否则调用 generate_ui_kit_concepts,用 get_ui_kit 跟踪进度,再以 select_ui_kit_concept 选定方案。随后调用 generate_ui_kit_component_sheets(省略 sheet_count 由系统规划 1 至 3 张),待状态为 sheet_review 后调用 extract_ui_kit_components,检查 quality_summary 与组件草稿,最后在 requires_review 为 false 时调用 finalize_ui_kit。
能力与规则:支持 state_mode="visible-only" 或 "complete-states" 控制状态族;可用 revision_notes、edit_source_asset_id、focus_notes、supplemental_notes 细化概念与组件表。提取默认阈值 1、最小面积 24、合并距离 1、内边距 0。每张源表最多 100 个组件、最多 3 张表、总计最多 300 个组件。9 切片边框默认全为 0,仅对可缩放面板、按钮、输入框等设置非零边框。
限制:付费概念与组件表工具立即返回 job ID,需轮询 get_ui_kit 直至到达预期状态。Gemini 模型需账户支持 2K 生成,否则返回 ui_kit_model_resolution_limit 时改用 gpt-image-2。high_resolution=true 需计划支持 4K。review_url 为可选质检入口,非必需交付步骤。套件 ID 丢失可用 list_ui_kits,取消任务用 cancel_ui_kit。