分析影片
你無法直接觀看影片。這個腳本會將其轉換成你能夠審查的內容:影格(附有精確秒數的影像)以及含時間戳的逐字稿。所有處理都在使用者的電腦上進行。
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)、選單、標誌及名稱。若不確定,請提問。
- 不要僅憑臉部辨識真人。僅使用畫面中、音訊中或使用者提供的姓名。
- 分析資料夾會留在使用者電腦上。完成後,告知使用者其位置,並說明可以刪除。