故障处理
本章整理常见问题和排查方向。
平台搜索没有结果
可能原因：
- 搜索词过窄。
- 平台在 设置 > 平台来源 中被关闭。
- 平台超时或临时限制。
- 当前网络无法访问该平台。
可以尝试：
- 换一个更短的中文关键词，例如从“适合短视频剪辑的深夜城市霓虹航拍”改成“城市夜景”。
- 到 设置 > 平台来源 确认平台已启用。
- 临时把搜索超时从 30 秒调高到 60 秒。
- 直接粘贴视频 URL 走链接导入。
URL 检测失败
可能原因：
- 链接不是视频详情页。
- 视频需要登录、会员或地区权限。
- 平台验证或限流。
- 视频已经下架。
可以尝试：
- 在浏览器中确认该视频能正常播放。
- 如果需要登录，先在浏览器中登录对应平台。
- 复制浏览器地址栏中的完整 URL。
- 稍后重试。
本地视频导入失败
可能原因：
- 文件路径不存在。
- 文件被移动或删除。
- 应用没有读取权限。
- 视频文件损坏。
可以尝试：
- 在 Finder 或文件管理器中确认文件仍存在。
- 把文件移动到普通视频目录后重试。
- 避免导入正在被其他软件写入的文件。
分析很慢
可以在 设置 > 分析 中调整：
- 使用 弥光经典，或确认弥光灵眸的窗口大小适合当前视频。
- 增大帧采样间隔，例如从 2 秒改到 5 秒。
- 把 AI 推理强度从“高”改成“中”。
- 降低 AI 分析窗口并发。
- 降低并发任务数。
如果只是快速挑素材，建议先用较快设置完成粗筛，再对重点视频使用更细的采样。
视频无法播放
0.3.0 会优先使用桌面端原生播放器预览原片，不需要先生成额外的播放文件。
可以尝试：
- 打开视频详情抽屉。
- 点击顶部预览区的播放按钮。
- 如果内嵌播放器无法启动，点击 用系统播放器打开。
- 如果系统播放器也无法打开，检查原始文件是否仍在本地路径、外接硬盘是否已挂载，或平台下载文件是否仍存在。
搜索不到已分析镜头
可能原因：
- 视频仍在分析或索引中。
- 检索词过窄。
- 选题过滤范围不正确。
- 本地检索索引损坏。
可以尝试：
- 到 任务 页确认分析已经完成。
- 换一个更短、更接近画面内容的描述。
- 清空选题过滤后再次检索。
- 到 设置 > 维护 点击 修复本地搜索。
片段或合集导出失败
常见原因：
- 源视频路径缺失。
- 源视频文件已不在磁盘上。
- 应用找不到 ffmpeg。
- 视频裁切超时。
- 源文件损坏。
可以尝试：
- 确认视频详情中的本地路径仍然存在。
- 如果是平台视频，重新导入或重新下载。
- 缩短片段范围或减少一次导出的片段数量。
今日额度用完
未登录时：
- 登录后可能获得更高额度。
已登录时：
- 等待次日重置。
- 避免同时开启过多分析任务。
更新检查失败
可能原因：
- 当前不是桌面客户端运行环境。
- 更新通道尚未配置。
- 网络无法访问更新服务。
- 新版本元数据暂未发布。
可以尝试：
- 确认正在使用正式桌面客户端，而不是浏览器调试模式。
- 稍后重试。
- 到产品官网下载最新安装包。