Skip to content

Browser Compatibility and Troubleshooting

haixin.yang edited this page Jul 20, 2026 · 1 revision

Browser Compatibility and Troubleshooting / 浏览器兼容与故障排查

Recommended environment / 推荐环境

  • A current Chromium-based desktop browser.

  • WebGPU enabled and supported by the browser, OS, and GPU driver for heavy AI workflows.

  • Enough free storage for model and app-shell caches.

  • A stable connection during the first model download.

  • 使用最新版 Chromium 桌面浏览器。

  • 大型 AI 流程需要浏览器、系统与显卡驱动共同支持 WebGPU。

  • 为模型和应用缓存预留足够磁盘空间。

  • 首次下载模型时保持网络稳定。

Common problems / 常见问题

A model is slow on first use / 模型首次运行较慢

The first run downloads and initializes model assets. Wait for the reported phase to complete. Repeat runs should reuse cached assets. Do not repeatedly refresh during initialization.

首次运行需要下载并初始化模型。请等待当前阶段完成,后续会复用缓存;初始化期间不要反复刷新页面。

WebGPU is unavailable / WebGPU 不可用

Update the browser and GPU driver, confirm hardware acceleration is enabled, and restart the browser. Some workflows can fall back to WASM, but performance will differ and not every heavy model has an equivalent fallback.

更新浏览器与显卡驱动,确认硬件加速已开启,然后重启浏览器。部分流程可回退到 WASM,但性能不同,并非每个大型模型都有等价回退路径。

Import or playback fails / 导入或播放失败

Record the media container, codec, resolution, duration, and browser version. Try a short H.264/AAC MP4 to distinguish a codec issue from an editor issue.

记录素材容器、编码、分辨率、时长和浏览器版本。可使用短 H.264/AAC MP4 区分编码兼容问题与编辑器问题。

Export has missing or doubled audio / 导出缺音或双重音频

Check clip mute controls and whether source audio has been separated. The editor prefers a separated source track when present; otherwise it can resolve enabled embedded video audio during export.

检查片段静音状态,以及是否已经分离原声。存在分离原声时优先使用该轨;否则导出会解析启用的视频内嵌音频。

Asking for help / 获取帮助

Use the Q&A Discussion for setup and compatibility questions. Use Issues for reproducible defects.

Include browser version, OS/hardware, WebGPU availability, media details, exact steps, and a screenshot or console excerpt with private data removed.