用途:为 SpriteCook 构建完整游戏 UI 屏幕与统一视觉体系,适用于菜单、HUD、背包、对话框、设置、覆盖层、商店、角色界面等需要共享一套视觉语言的组合。若只需单个孤立图标、按钮、分隔线或装饰,应改用 generate_game_art(mode="ui")。
前提:需在编辑器中连接 SpriteCook MCP 服务器,可用 npx spritecook-mcp setup 配置。建议与 spritecook-workflow-essentials 搭配,处理额度、清单、安全下载等共享默认设置。
主要能力:先确立一个统一概念,再从概念中提取生产组件,而不是分别生成控件后再拼接。支持概念生成、组件表生成、组件提取与最终定稿,可保留 UI 套件 ID、组件资产 ID 与清单。
使用方式:确认 UI 工具可用后先调用 get_credit_balance;用 create_ui_kit 创建套件并保留 ID,默认 model="gpt-image-2"。概念可用已有 concept_asset_id,或用 generate_ui_kit_concepts 生成后经 get_ui_kit 查看并 select_ui_kit_concept 选定。随后 generate_ui_kit_component_sheets(可省略 sheet_count,由系统规划 1 至 3 张)、get_ui_kit 跟踪到 sheet_review、extract_ui_kit_components(可不传 sheet_asset_ids 处理全部表)、检查 quality_summary 后 finalize_ui_kit。state_mode 在创建套件时设定,可选 visible-only 或 complete-states。
限制:每个源表最多定稿 100 个组件,最多三张表,总计最多 300 个组件。9-slice 边框自动初始化为零,仅对可扩展面板、按钮等在有把握时设非零值。付费工具立即返回 job ID,提交不等于完成。Gemini 模型需账户支持 2K 生成,否则返回 ui_kit_model_resolution_limit 后改用 gpt-image-2。可使用 list_ui_kits、cancel_ui_kit 进行恢复;review_url 为可选质检界面,非必需交接。