分析视频
你无法直接观看视频。此脚本将其转换为你可以审查的形式：关键帧（带精确秒数的图像）和带时间戳的转录。所有处理均在用户计算机上完成。
1. 执行脚本
从本技能所在目录运行：
python scripts/analizar_video.py "RUTA/AL/VIDEO.mp4" --salida "analisis-<nombre>"
实用选项：
--idioma es如果你知道语言（比自动检测更快更准确）。--modelo base在较慢设备上使用；--modelo medium如果音频质量较差。--max-fotogramas 40用于长视频。--sin-transcripcion如果你只需要视觉信息。
如果失败：
- 未找到 ffmpeg → 请用户安装它 (https://ffmpeg.org/download.html) 或依赖用户的摘要信息。
- 无语音引擎 → 脚本会在
info.json中说明。继续使用关键帧，并请用户提供对话摘要，或建议运行pip install faster-whisper。 - 转录耗时（首次会下载模型）→ 如果环境允许，在后台运行它。
2. 检查输出
info.json：时长、分辨率、方向、音频、帧列表和转录状态。fotogramas/*.jpg：按顺序查看所有帧。文件名包含时间（f03_00-12.jpg= 第12秒）。transcripcion.txt：对话内容及时间戳。transcripcion.srt：可直接上传作为字幕。
如果某个重要片段缺少关键帧（两帧之间有剧烈变化），可以手动提取一帧：
ffmpeg -v error -ss 00:00:15 -i "VIDEO.mp4" -frames:v 1 extra_00-15.jpg
3. 报告
提供以下简洁具体的报告：
## 视频分析
**技术规格：** 0:42 · 竖屏 1080x1920 · 60 fps · 有音频 · 语言：西班牙语
**主题：** <2-3行>
**分段视觉内容：**
- 00:00-00:05：…
- 00:05-00:18：…
**对话内容：** <摘要；关键短语的直接引语>
**检测到的主题/游戏：** <名称>（确定 / 可能 / 未识别，并说明原因）
**最佳钩子时刻：** <秒数及原因>。视频是否以此作为开场？如果不是，建议剪辑。
**推荐封面帧：** <文件名及秒数>
**建议章节（仅限长视频，至少3个，每个≥10秒）：**
00:00 …
**检测到的关键词：** <对话或屏幕上的文字>
**警报：**
- 商业音乐或第三方音频 → 存在 Content ID 或静音风险
- 可见品牌或产品 → 是否有赞助？
- 敏感内容（暴力画面、粗俗语言）→ 年龄限制
- 看起来由 AI 生成的人物或场景 → AI 标签
- 被界面遮挡的重要文字或元素（竖屏：顶部、底部、右侧）
- 视频中已嵌入字幕 → 不要启用可能重叠的自动字幕（Facebook）
- 屏幕上的标题或文字承诺了视频未实现的内容
- 画面剪切、黑屏或丢失
- 质量：音频过低或过饱、图像模糊、开头缓慢
**观众可能不清楚之处：** <缺失的背景信息；在文案中需要解释什么>
**建议：** <2-4条具体操作>
规则
- 描述你看到和听到的，而不是你假设的。如果有不确定的内容，请说明（"似乎是…"）。
- 如果用户提供了摘要，将其与你发现的内容进行对比。如果矛盾，请询问。
- Whisper 可能会错误拼写专有名词（课程、角色、行话）。根据屏幕上看到的内容进行纠正，不要错误地复制到文案中。
- 识别游戏：关注界面（HUD）、菜单、标志和屏幕上的名称。如果不确定，请询问。
- 不要根据面部识别真实人物。仅使用屏幕上、音频中或用户提供的名称。
- 分析文件夹保留在用户计算机上。完成后，告知用户文件夹位置，并说明可以删除它。