核心用法
Stitch Design 是 Google 官方 Stitch 平台的 CLI 封装，将 AI 驱动的 UI 设计能力集成到开发工作流中。核心能力包括：
生成与迭代
generate：从文本描述生成完整界面，支持桌面/移动/平板设备edit：针对现有界面进行定向修改，保持视觉一致性variants：探索多个设计方向，支持保守优化(refine)、适度探索(explore)、激进重构(reimagine)三种创意范围
设计历史管理
- 屏幕别名系统：用可读名称替代十六进制 ID，跨会话持久化
- 仅追加事件日志(
events.jsonl)：完整记录所有操作血缘关系 - 历史追溯：
history查看指定别名的所有版本，lineage遍历编辑谱系 - 故障恢复：
rebuild从事件日志重建名称索引
多屏幕一致性
- 强制要求"枢纽屏幕"(Hub Screen)模式：先生成主视觉基准，后续屏幕通过
edit派生，确保设计系统一致性 - 避免直接用
generate创建相关屏幕，防止视觉漂移
交付与导出
- 高分辨率截图通过 Google CDN 交付（
lh3.googleusercontent.com），支持=w780/=w1440尺寸参数 - 导出原始 HTML/CSS/JS 和 PNG 截图
- 支持手动复制到 Figma 进一步精修
工作流整合
- 草图转设计：用户先在 Stitch Web UI 上传手绘稿，CLI 通过标题匹配后执行
edit/variants - 4 步审查循环：结构问题在 Stitch 内修复，像素级细节标记为导出后处理
显著优点
1. 官方 API 背书：基于 Google 第一方 Stitch 服务，非第三方逆向工程
2. 工程化设计：完整的本地状态三层架构（制品层、事件层、别名层），支持审计和恢复
3. 迭代效率：variants --count 3 --range explore 单命令生成多方向探索稿
4. 连接容错：1-5 分钟的长时操作内置自动重试和断线恢复机制
5. 多概念并行：支持命名概念、并排对比、历史追溯的完整工作流
潜在缺点与局限性
1. SDK 能力边界：不支持直接上传图片（草图/截图需走 Web UI 中转），不支持原生 Design System 绑定（需 --design-system 提示词注入 workaround）
2. 生成特性限制：edit 本质是重新生成而非手术式修改，未提及元素也可能变化；内容幻觉（虚构标签/头像/文案）需人工审查
3. 长时操作成本：单操作 1-5 分钟，不适合实时交互场景
4. 精细化天花板：像素级间距、精确圆角、图标细节需导出后用 Figma/代码二次调整
5. 环境依赖：需 Node.js 18+ 和 STITCH_API_KEY，无内置密钥托管
适合人群
- 产品设计师：快速生成多方向概念稿，建立视觉基准后再精修
- 前端开发者/独立开发者：需要可导出的 HTML/CSS 原型作为开发起点
- 设计-开发协作团队：需要版本化、可审计的设计历史记录
- 设计系统建设者：通过枢纽屏幕模式维护多屏幕一致性
常规风险
- API 密钥泄露：
STITCH_API_KEY需妥善保管，目前无内置轮换机制 - 网络中断：虽内置恢复，但极端情况下可能产生孤儿屏幕状态
- 提示词注入：
--design-system参数直接拼接文件内容到提示词，需确保文件来源可信 - 幻觉内容上线：AI 生成的虚构文案/头像若未审查可能流入生产环境
- 本地状态损坏：
names.json损坏时需手动rebuild，pre-log 别名可能丢失
评估结论
T1 来源可信度（Google 官方服务封装），S 级安全（无代码执行，纯 API 调用，本地状态隔离）。适合作为设计探索阶段的加速器，而非像素级交付终点。