FilmCraft 播放卡顿与崩溃排查指南

FilmCraft（当前 v0.2.x）整体播放性能不错——原生解码器对 1080p H.264 素材普遍可以实时播放。但视频剪辑总归吃配置，加上软件还在开发中，遇到卡顿和崩溃时需要一套系统的排查思路。本指南按「由软到硬、由简到繁」的顺序排查。

第一步：确认是「卡」还是「崩」

两类问题处理方向完全不同：

现象	类型	优先动作
播放掉帧、预览不流畅	性能问题	见下文 1-4 节
软件闪退、工程打不开	稳定性问题	跳到第 5 节

降低预览质量

播放卡顿的第一嫌疑人是预览分辨率。4K 素材用 100% 分辨率预览，中端机必卡：

1. 预览监视器下方（或右上角）找到播放质量设置
2. 从 Full 降到 1/2，还卡就 1/4
3. 这只影响预览，不影响导出画质，放心降

90% 的「卡顿求助」到这一步就解决了。

素材编码排查

FilmCraft 原生支持 H.264/HEVC/ProRes/VP9，但同一种封装里的「花样」很多：

1. 检查素材规格：手机拍的 4K 60fps HEVC（10bit）目前是最重的素材类型之一，中端机不用代理基本带不动
2. 混合帧率：工程是 30fps 但塞了一堆 23.976 素材，实时重采样很耗性能——分开剪或者统一转码
3. 可变帧率（VFR）：屏幕录制素材常见 VFR，任何 NLE 都头疼，先用外部工具转成 CFR 再导入

代理工作流

素材本身太重时，上代理（Proxy）：

1. 媒体池中右键素材，选择 Create Proxy（生成代理）
2. FilmCraft 会生成低分辨率代理副本用于时间线播放，导出时自动切回原素材
3. 代理生成完成后，预览质量保持 Full 也不卡了

代理文件占用额外磁盘空间（约为原素材的 1/5~1/10），工程结束后可在设置里清理。

音频与外设

容易被忽略的项：

• 采样率不匹配：工程 48kHz 但素材是 44.1kHz，实时重采样也会引发卡顿甚至爆音，统一成 48kHz 最稳
• 外接声卡/监听设备：偶尔有驱动兼容问题，拔掉测试是否恢复
• 后台程序：浏览器开着一堆标签页 + 杀毒扫描时间线目录，先关掉再测

崩溃问题

立即可做的

1. 重新打开工程，如果是特定操作必现崩溃，记下操作步骤（例如「滚动修剪到负值时闪退」）
2. 素材文件路径尽量不要包含特殊字符与超长中文目录，移动工程时用工程管理器的「收集/重定位素材」而不是手动挪文件夹
3. 更新显卡驱动——即便 FilmCraft 不依赖 CUDA，视频输出链路仍走 GPU

反馈给开发者

FilmCraft 是开源项目，一份合格的 Bug 报告能让修复快很多。到 github.com/storytold/filmcraft/issues 提交（建议英文，附上中文说明也行），务必包含：

1. 软件版本与操作系统版本
2. 素材编码信息（用 MediaInfo 之类工具导出，或 FilmCraft 素材属性面板截图）
3. 复现步骤（1、2、3 逐步描述）
4. 崩溃时的错误日志/截图
5. 如果方便，提供最小可复现工程

性能预期参考

社区反馈的大致量级（不同机器差异很大，仅供参考）：

素材	无代理预览体验
1080p 30fps H.264	主流配置流畅
1080p 60fps H.264	流畅到偶尔掉帧
4K 30fps H.264	高配流畅，中配建议 1/2 预览
4K 60fps HEVC 10bit	建议直接上代理

小结

• 卡顿：先降预览质量 → 查素材编码/帧率 → 上代理 → 查音频与外设
• 崩溃：记复现步骤 → 简化素材路径 → 更新驱动 → 规范报 Issue
• Gamma 阶段软件，「勤保存 + 服务器无关本地数据」是第一生产力