用途:为 Stitch 中已有的屏幕生成替代版本,使用原生变体生成 API,比文本提示方式更高效(1 次 API 调用对 3 次),并可精细控制变化维度。
前提:仅在用户明确提到 Stitch 时使用;必须已有 projectId 和至少一个 screenId,变体始终基于已有设计,无法从零生成。
适用时机:用户想探索已有屏幕的替代版本;生成后用户说“展示一些变体”或“试试不同风格”;编排流程第 5b 步提供“生成变体”;A/B 测试,为评审创建多个选项。
调用 MCP 工具 generate_variants,参数包括 projectId(纯数字,无前缀)、selectedScreenIds(数字屏幕 ID 数组)、prompt(可选方向说明)、variantOptions、deviceType(可选)、modelId(可选)。
variantOptions 字段:variantCount 为 1–5 的整数;creativeRange 取 REFINE、EXPLORE、REIMAGINE,分别对应细微调整、有意义差异、大幅偏离;aspects 可取 LAYOUT、COLOR_SCHEME、IMAGES、TEXT_FONT、TEXT_CONTENT,可组合。
modelId 可选 GEMINI_3_1_PRO(推荐,复杂布局高保真)、GEMINI_3_FLASH(快速迭代、线框、简单改动);GEMINI_3_PRO 已弃用。
输出:新屏幕加入项目,每个变体在 list_screens 中显示为独立屏幕。生成后可调用 stitch-mcp-list-screens 查找新变体,调用 stitch-mcp-get-screen 获取截图,并排展示让用户选择;用户选定后可继续编辑、转代码或基于胜出者再生成变体。
限制:不得在无已有屏幕时生成变体;projectId 和 screenId 必须为数字,不可用 projects/ID 格式;variantCount 不得超过 5。