上传的视频一直显示处理中前台放不出来怎么办

现象#

商品媒体里传了一段 4K 视频，后台显示 processing 超过半小时，preview.image.url 为 null，前台只剩一个空白占位框。

原因#

• 视频要转码成多档分辨率，异步完成前 status 一直是 PROCESSING
• 单个视频上限 10 分钟、1 GB、3840x2160，超限会停在 FAILED
• 3D 模型只收 GLB 或 USDZ，上限 500 MB，格式不对直接失败
• 外部视频（YouTube、Vimeo）不算 Shopify media，取不到 preview 图

处理步骤#

1. 轮询 media(first: 20){ nodes{ status } }，只在 READY 后读取地址
2. 用 media.preview.image.url 先渲染封面，避免空白框
3. 视频超过时长或分辨率上限时，先在本地用 ffmpeg 压缩再重传，不要反复重试原文件
4. 3D 模型转成 .glb 后上传，并确认文件小于 500 MB
5. 批量导入时把 PROCESSING 的记录写进重试队列，不要直接标记成功

验收标准#

status 变成 READY，前台能播放且封面图正常显示；失败的记录出现在重试队列里。