核心用法
Stitch Design 是 Google Stitch 的官方 OpenClaw SDK 封装，将 AI 驱动的 UI 设计能力集成到命令行工作流中。核心功能围绕四大场景展开：
1. 从零生成 (generate)：将文本描述转化为完整界面，支持 desktop/mobile/tablet 设备类型
2. 精准编辑 (edit)：基于现有屏幕进行定向修改，保持视觉一致性
3. 变体探索 (variants)：生成 1-5 个设计变体，支持 refine/explore/reimagine 三种创意范围
4. 导出交付 (export/html/image)：获取 HTML 源码或高分辨率截图
技能采用三层状态管理：不可变的 runs/ 工件目录、追加式 events.jsonl 事件日志、可重建的 names.json 别名指针。屏幕别名（如 concept-a）机制让长 ID 变得可记忆，且支持完整的历史追溯与谱系查询。
显著优点
- 官方背书：直接调用 Google Stitch API，生成质量与 Web UI 一致
- 生产级工作流：强制推行 Hub-first 设计模式，确保多屏幕概念的一致性
- 韧性设计：长时操作（1-5分钟）内置自动重试与恢复机制
- 完整血缘追踪：每个操作的父屏幕、提示词、时间戳均记录，支持
history/lineage查询 - 高分辨率输出：通过
=w780/=w1440参数获取出版级截图
潜在局限
- 无图像上传：草图必须通过 Stitch Web UI 预上传，SDK 端仅支持文本驱动
- 内容幻觉：Stitch 常自行添加未要求的标签、头像、文案，需人工审核
- 细节不可控：像素级间距、阴影、圆角等无法精准指定，复杂编辑需外部工具收尾
- 依赖 Node.js 18+：运行环境有硬性版本要求
适合人群
- 需要快速产出可点击原型的产品设计师
- 追求设计一致性的多屏幕项目团队
- 熟悉命令行、偏好版本控制工作流的开发者
- 希望将 AI 设计集成到 CI/CD 或自动化流程的技术团队
常规风险
| 风险类别 | 说明 | 缓释措施 |
|---------|------|---------|
| **API 密钥泄露** | `STITCH_API_KEY` 需配置在环境变量中 | 使用 OpenClaw 加密存储，避免硬编码 |
| **生成超时** | 网络波动导致 `ECONNRESET` | 内置自动重试，无需手动干预 |
| **状态损坏** | `names.json` 可能因异常中断损坏 | 提供 `rebuild` 命令从事件日志恢复 |
| **设计漂移** | 多次编辑后视觉偏离原始概念 | 强制 Hub-first 模式，限制单次编辑变更数量 |