用途:这是 Stitch 工作流中的核心文本转 UI 动作,根据结构化文本提示词生成 UI 设计屏幕。前置步骤(规格生成、提示词组装)是准备,后续步骤(屏幕获取、代码转换)是跟进。
使用前提:仅当用户明确提到 Stitch,或由上游技能(如 stitch-ideate、stitch-orchestrator)调用时使用。调用前必须有 projectId,可通过 stitch-mcp-create-project 新建,或用 stitch-mcp-list-projects 查找已有项目。
调用方式:调用 MCP 工具 generate_screen_from_text,参数包括 projectId(纯数字,无 projects/ 前缀)、prompt、deviceType、modelId、designSystem。designSystem 为可选,需带 assets/ 前缀,如 assets/15996705518239280238,用于保持多屏设计一致性。
deviceType 可选 MOBILE(默认)、DESKTOP、TABLET、AGNOSTIC。modelId 可选 GEMINI_3_1_PRO(推荐,复杂布局高保真)、GEMINI_3_FLASH(快速迭代、线框图)、GEMINI_3_PRO(已弃用)。
提示词建议采用 [Context & Style] [Layout] [Components] 结构,明确设备、明暗模式、颜色、字体、具体组件名称与真实内容,可先用 stitch-ui-prompt-architect 组装。
批量生成:若提示词是完整 PRD,Stitch 单次最多生成约 10 个屏幕。响应返回数据时,可依据 output_components 的续写建议再次调用(最多 3 次以防死循环);响应为空(HTTP 超时)时不要重试,等待 90-120 秒后用 list_screens 查看结果。
生成后:该工具返回会话信息,不返回截图或 HTML。需调用 stitch-mcp-list-screens(参数 projects/[projectId])找到新屏幕,再用 stitch-mcp-get-screen 获取截图与 HTML。
限制:单屏生成约 60-180 秒,多屏 PRD 最长约 5 分钟,属正常行为,期间不要重试,否则会产生重复屏幕。失败时等待 90 秒检查 list_screens,最多重试一次。