OpenClaw Agent
3.0 KiB
3.0 KiB
常见问题 (FAQ)
基础问题
Q: 为什么需要FFmpeg？
A: FFmpeg是一个强大的多媒体处理工具，本工具使用它从视频中提取关键帧。没有FFmpeg，帧提取功能将无法工作。
Q: 分析一个视频需要多长时间？
A: 取决于多个因素：
- 视频长度
- 帧提取间隔和最大帧数
- 网络速度（下载阶段）
- AI分析并行度
一般来说，10分钟视频（默认设置）约需5-10分钟完成分析。
Q: 支持哪些视频格式？
A: 支持B站所有可播放的视频格式。系统使用yt-dlp下载，会自动选择最佳质量。
错误处理
Q: 遇到"URL无效"错误怎么办？
A: 请确保URL格式正确：
- 标准格式:
https://www.bilibili.com/video/BV1xx411c7mD - 短链接:
https://b23.tv/xxxxx - 不支持番剧、直播等其他类型链接
Q: 下载失败怎么办？
A: 可能的原因和解决方案：
- 网络问题: 检查网络连接，使用
--retries增加重试次数 - 视频不存在: 确认视频未被删除或设为私有
- 地区限制: 某些视频可能有地区限制
Q: FFmpeg报错怎么办？
A:
- 确认FFmpeg已正确安装:
ffmpeg -version - 确认FFmpeg在系统PATH中
- 尝试重新安装FFmpeg
Q: AI分析失败怎么办？
A: 系统会自动重试失败的分析任务。如果仍然失败：
- 检查Claude Code配置
- 查看日志文件了解详细错误
- 部分结果会保存到
partial_report.json
高级用法
Q: 如何只分析视频的特定部分？
A: 目前不支持指定时间范围，但可以通过调整参数间接实现：
- 增大
--interval跳过更多内容 - 减小
--max-frames限制分析帧数
Q: 如何提高分析速度？
A:
- 增加并行worker:
-w 8 - 减少帧数:
-m 20 - 增大间隔:
-i 60 - 禁用场景检测:
--no-scene-detection
Q: 如何获取更详细的分析？
A:
- 减小帧间隔:
-i 10 - 增加最大帧数:
-m 100 - 启用所有分析焦点:
-f text,objects,faces,actions,scene
Q: 分析中断后如何恢复？
A: 系统会自动保存检查点。目前需要重新运行命令，未来版本将支持从检查点恢复。
输出相关
Q: 报告中的图片路径是什么格式？
A: 使用相对路径，格式为./frames/frame_XXX_HH-MM-SS.jpg，确保报告和frames目录在同一位置时图片可正常显示。
Q: 日志文件在哪里？
A: 日志文件analysis.log位于输出目录中，与report.md同级。
错误代码
| 错误 | 原因 | 解决方案 |
|---|---|---|
URLValidationError |
URL格式不正确 | 使用正确的B站视频URL |
MetadataFetchError |
无法获取视频信息 | 检查视频是否存在/私有 |
DownloadError |
下载失败 | 检查网络，增加重试次数 |
FFmpegError |
FFmpeg问题 | 安装/重装FFmpeg |
AnalysisError |
AI分析失败 | 检查Claude Code配置 |
ReportGenerationError |
报告生成失败 | 检查输出目录权限 |