花生AI本地视频预览黑屏/卡顿需逐层排查：仅支持Chrome或Edge；必须使用https协议；禁用广告屏蔽插件；确认上传完成（状态条走完、无灰色锁图标、新标签页可打开）；解析状态须为“解析完成”，日志无codec错误；预览前需等待10秒；可用成片测试或诊断工具进一步验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
花生AI上传本地视频后点击预览按钮却黑屏、卡顿或提示“无法加载”，不是素材本身损坏就是解析流程中途断开，必须逐层验证才能定位真实故障点。
确认浏览器与基础环境是否达标
用 Chrome 或 Edge 浏览器打开花生AI首页，其他浏览器（如 Safari、Firefox）不支持本地视频预览功能，会直接触发黑屏且无任何错误提示。
检查地址栏左侧是否显示“不安全”警告图标：若当前页面是 http:// 开头而非 https://，预览功能将被浏览器主动拦截，【必须手动改为 https 协议重进】。
关闭所有广告屏蔽插件和隐私扩展，特别是 uBlock Origin、AdGuard 等——它们会误杀视频解码所需的 WebAssembly 模块，导致预览界面空白但控制栏仍在。
排查上传环节是否真正完成
方法一：看上传状态条是否走完。上传未完成时点击预览，界面会显示“正在加载…”并持续转圈，此时实际尚未写入临时缓存，强行预览必然失败。
方法二：检查文件名右侧是否有灰色小锁图标。有锁说明该文件被系统识别为“高风险格式”（如 .mov、.wmv、加密 MP4），花生AI暂不支持预览，仅允许解析后参与成片，【此时预览按钮不可点，点也无效】。
方法三：右键点击已上传的视频缩略图 → 选择“在新标签页中打开”。如果新页显示“Failed to load resource”，说明文件在上传过程中已损坏，需重新上传原始文件。
验证解析是否成功执行
第一步：进入左侧【资产】→ 找到对应视频 → 查看右侧状态栏。只有显示“解析完成”才具备预览条件；若仍为“智能解析中”或“解析失败”，预览功能强制禁用。
第二步：点击该视频右侧的“详情”按钮 → 滚动到底部查看“解析日志”。若出现“codec not supported”或“duration parse failed”，代表视频编码参数超出当前解析引擎支持范围（如 H.265 编码 + 非标准帧率），需用剪映导出为 H.264+AAC+25fps 标准封装后再上传。
第三步：解析完成后，等待 10 秒再点击预览。系统需要将解析结果注入前端播放器上下文，立即点击可能因上下文未就绪而返回空画布。
绕过预览直接测试素材可用性
方法一：新建项目 → 输入任意文案 → 进入【创作偏好】→ 手动勾选“仅使用本地素材” → 提交生成。若成片中能正常出现该视频画面，说明素材本身无问题，纯属预览模块偶发故障。
方法二：下载花生AI官方诊断工具（huasheng-diag-v2.3.exe），运行后自动扫描本地缓存、检查 WebCodecs 兼容性、验证 GPU 加速开关状态，输出可读性报告。
方法三：在资产页长按该视频 → 选择“重新解析”。注意：此操作不会消耗额外花生米，但会覆盖原有解析数据，适用于解析日志无报错但预览仍失败的情况。
