用途:把一张或多张图片(截图、设计稿、线框图)上传到 Stitch 项目,作为新屏幕导入,是“重新设计现有 UI”工作流的入口。导入后可用编辑屏幕功能迭代,或直接转换为代码。
前提:仅在用户明确提到 Stitch 时使用。调用前必须已有 projectId;没有时可通过 stitch-mcp-create-project 新建,或用 stitch-mcp-list-projects 查找现有项目。
适用场景:用户提供截图并希望在 Stitch 中重新设计;用户想把现有设计稿导入 Stitch 编辑;编排器将意图归类为“上传截图”;用户说“导入这个设计”“上传这张图片”或“重新设计这个屏幕”。
使用方式:第一步,用辅助脚本把本地图片转为 base64:bash scripts/encode-image.sh "path/to/screenshot.png",脚本将原始 base64 输出到 stdout,捕获后用于 API 调用。支持的格式与 MIME 类型:.png 为 image/png,.jpg/.jpeg 为 image/jpeg,.webp 为 image/webp,.gif 为 image/gif。第二步,调用 MCP 工具 upload_screens_from_images,参数包含 projectId 和 images 数组。projectId 只能填数字 ID,不能带 projects/ 前缀。images 中每个对象需包含 fileContentBase64(base64 编码的图片数据,不带 data: 前缀)和 mimeType(与图片格式匹配的 MIME 类型)。一次调用可上传多张图片,每张成为独立屏幕。
输出与后续:返回类似 generate_screen_from_text 的会话信息,上传的图片会作为新屏幕出现在项目中。上传后可调用 stitch-mcp-list-screens 查找新屏幕 ID,并向用户提供选项:编辑该屏幕(改颜色、布局、内容)走 stitch-mcp-edit-screens;直接转代码走 stitch-mcp-get-screen 再做框架转换;基于该设计生成变体走 stitch-mcp-generate-variants。
限制:必须已有 projectId;projectId 不能带前缀;base64 数据不能带 data: 前缀;MIME 类型需与图片格式一致;仅在用户明确提到 Stitch 时使用。