当工作流表现和预期不一致时，可以先按这份清单检查。
快速诊断
| 现象 | 先检查 | 相关指南 |
|---|---|---|
| 导入结果坏掉 | 简化来源，并确认图片已加载 | 把 HTML 粘贴进画布 |
| 图层选不中 | 用图层面板，或隐藏重叠图层 | 画布基础 |
| 预览不是目标场景 | 预览前先选中目标 frame | 时间轴和动效 |
| 导出失败 | 先试更短或更低分辨率的小样 | 预览和导出 MP4 |
| 生成结果不稳定 | 减少变量，一次只比较一个变化 | 选择生成模型 |
| MCP 客户端连不上 | 检查 endpoint、scopes 和 OAuth 连接 | 配置 flare.design MCP |
导入结果不对
HTML 或 Figma 粘贴前，先简化来源。尽量复制真实文字和已加载图片，避免过深 wrapper；不支持的复杂效果可以在画布里重建。
HTML 适合复制已经能在浏览器里正确渲染的结构。Figma 里只复制真正需要的 frame 或图层，不要连同外层大 workspace 一起复制。
图层难以选中
使用图层面板、放大画布，或临时隐藏附近图层。如果内容在 frame 里，先选中 frame 会更容易理解嵌套关系。
如果选中 group 后影响太多内容，展开 group，直接选择子图层。找到重要图层后顺手命名。
动效预览和版式不一致
先选中目标 frame，并从这个 frame 预览。检查图层开始和结束时间、隐藏状态、视频 trim handles，以及是否有 active motion clips。
如果图层出现得太早或太晚，先调整 layer range，再调关键帧。Range 通常比自定义 motion clip 更容易判断。
MP4 导出失败
先尝试导出更短的 frame。本地浏览器导出需要 WebCodecs 支持，如果不可用，建议用较新的 Chromium 系浏览器测试。
云渲染失败时，先看任务开始前的报价，并确认 workspace 有对应套餐额度或 Flares 余额。
生成结果不稳定
把 prompt 收敛到主体、风格、比例和用途。一次只比较一个模型或参数变化。
可以保留一个小的模型比较 frame。把输出按最终尺寸放进去，并加真实文案一起判断，不要只看单张预览。
MCP 授权失败
重新连接客户端，确认 resource URL 是 https://mcp.flare.design/mcp，并且只请求任务真正需要的 scopes。
如果授权后缺少某个工具，检查请求的 OAuth scopes 是否包含对应读写能力。先用能支持 workflow 的最小 scope 集合，再重新连接。
什么时候联系支持
记录项目名、workspace、浏览器、大致发生时间，以及失败动作。MCP 问题还要带上客户端名称、请求的 scopes，以及 OAuth 是否在 tool call 失败前完成。不要在支持消息里发送 secret 或 bearer token。