倒數影片 是做什麼的?
將排名清單轉化為電影/清單頻道風格的完成影片。兩種模式:
"mode": "countdown"(預設):No.N → No.1,每個條目前有一個橘色「No.X」撞擊卡。"mode": "timeline":一個「演化」影片(例如 LAIKA 動畫演化史 2005–2022),從最舊到最新,每個條目前有一個大型年份卡。
在兩種模式下,條目都可以攜帶一個預告片片段,在卡片顯示後全螢幕播放,附有底部三分之一標題和預告片自己的音效(背景音樂在其下方降低音量)。在清單頻道上,卡片 + 每部電影約 25–30 秒的預告片是留住觀眾最久的格式。
影片有開場、每個條目的「No.X」排名撞擊卡,接著是動畫卡片(圖片、標題、年份、類型、帶有長條的票房統計數據、評分、趣味小知識)、進度追蹤器,以及帶有 YouTube 片尾元素插槽的結束畫面。一切皆由資料驅動:研究放入 items.json,引擎負責渲染。
以使用者偏好的語言交談;除非他們要求螢幕文字使用另一種語言,否則保留程式碼和 items.json 為英文。
檔案(相對於此技能資料夾)
| 檔案 | 用途 |
|---|---|
templates/countdown_template.html | 引擎:開場、排名卡片、條目卡片、追蹤器、片尾。主題和時間可從 items.json 覆寫。 |
scripts/build_countdown.py | items.json → _work/build.html、timeline.json、cues.json(音效)、chapters.txt;標記缺失/無法讀取的圖片。 |
scripts/render.py | 確定性幀範圍渲染器(Playwright → x264)。 |
scripts/compose_clips.py | 將每個條目的預告片片段放置在全幀中(信箱模式),並帶有底部三分之一「TRAILER · 標題(年份)」,並提取片段音訊。由 make_countdown.sh 自動執行。 |
scripts/countdown_audio.py | 原始歡快音樂循環(或 --music your_track.mp3)、根據提示的嗖/撞/砰/滴答音效、預告片音訊(背景音樂降低至 --clip-music 預設 0.12)、可選排名語音。 |
scripts/make_countdown.sh | 完整管線:建置 → 平行渲染 → 音訊 → MP4 + QA 表 + 章節。 |
設定:pip install playwright soundfile scipy pillow --break-system-packages 以及若缺少則 playwright install chromium;ffmpeg 需在 PATH 上。可選語音:Kokoro TTS(請參閱 PPT 動畫技能的 voiceover.py)。
工作流程
- 簡報。 主題、模式(倒數或時間線)、條目數量(N)、排名指標(例如全球票房)、要顯示的欄位、是否包含預告片片段(以及長度,預設 25 秒)、影片長度(≈ 5 秒開場 + N ×(~11 秒 + 片段)+ 12 秒片尾)、音樂(使用者的曲目或生成)。若使用者線上則詢問一次;否則選擇合理的預設值並告知。
- 研究排名。 使用網路搜尋並開啟來源頁面;切勿憑記憶填寫數字。偏好來源:Box Office Mojo / The Numbers(預算、全球票房)、IMDb、Rotten Tomatoes、Metacritic(評分)、Wikipedia(年份和類型)。在每個項目的
sources中記錄 URL。如果兩個來源不一致,對排名指標一致使用一個來源並註明。如果找不到某個值,則省略該欄位(卡片會自動適應)— 切勿憑空捏造。 - 撰寫
items.json(結構如下),排名 1..N,其中 1 是最高條目。影片從 N 倒數到 1("order": "up"則反轉)。 - 圖片和片段。 使用使用者提供的圖片和預告片檔案(
posters/<slug>.jpg,2:3 直式;clips/<slug>.mp4)。請勿自行從網路下載海報、預告片、劇照或人物照片;請使用者將它們放入資料夾。若無圖片,卡片會顯示乾淨的標題佔位符;若缺少片段則會跳過,因此可先渲染草稿。對於每個片段,選擇start(跳過工作室標誌和黑色幀)和duration。預告片可能在 YouTube 上引發 Content ID 版權主張;這是頻道擁有者的決定,因此請提及一次。 - 建置 + 預覽。
python3 scripts/build_countdown.py items.json _work/然後截取幾個瞬間(開場約 3 秒、一張排名卡、一張完整的條目卡片結尾、片尾)並查看:無重疊、長標題能容納、數字在 360p 下可讀。 - 渲染。
bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir]。 - 品質保證。 開啟
out_sheet.png;對照items.json抽查數字;確認時長且每個排名出現一次。 - 交付。 MP4、章節(
out_chapters.txt,貼入 YouTube 影片說明)、來源清單,以及建議的標題/說明/標籤。提醒使用者在 YouTube Studio 中將片尾元素拖放到片尾插槽上。
items.json 結構
以下數值是展示形狀的佔位符,並非真實資料。
{
"title": "票房最高的前 5 部停格動畫電影",
"subtitle": "按全球票房排名",
"channel": "頻道名稱",
"currency": "$",
"order": "down",
"mode": "countdown",
"intro_image": "logo.png",
"outro_title": "你最喜歡哪一部?",
"outro_subtitle": "在留言區告訴我們!",
"timing": {"intro": 5, "rank": 1.8, "item": 9, "outro": 12},
"theme": {"bgA": "#8BE36A", "bgB": "#F7E25A", "border": "#F0385C", "money": "#9B59D0", "ratings": "#5BD3F5"},
"items": [
{
"rank": 1, "title": "Chicken Run", "year": 2000, "subtitle": "家庭/喜劇",
"image": "posters/chicken-run.jpg",
"stats": [{"label": "預算", "value": 45000000}, {"label": "票房", "value": 225100000}],
"multiple": "預算的 5 倍",
"ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
"fact": "一句簡短且有來源的句子。",
"teaser": "No.X 撞擊卡下方的可選文字",
"clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
"label": "撞擊卡上取代 No.X / 年份的可選文字",
"seconds": 9,
"sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
}
]
}
stats[].value作為數字 → 動畫計數並顯示比較長條(長條在每張卡片內共用一個刻度);作為字串 → 直接顯示(例如"N/A"、"8,848 m")。任何標籤都適用,因此同一引擎也適用於非電影的倒數(最高建築物、最富有的人、最快汽車)。ratings鍵為可選:imdb(0–10,星星)、rt/rt_audience/metacritic(0–100,環形)。缺少的鍵會消失;沒有評分的卡片會將其餘區塊置中對齊。clip.start接受秒數或m:ss格式;片段以 16:9 信箱模式顯示,並在卡片之後播放。章節和片尾時間會自動考量片段長度。intro_image(例如使用者提供的工作室標誌)會取代開場上的 TOP N / EVOLUTION 標章。- 在時間線模式中,條目按
year排序;卡片上的排名標章會隱藏,章節顯示為「標題(年份)」。 multiple是金錢區塊下方的一個簡短重點藥丸;根據來源數字計算(四捨五入至一位小數)。- 評分僅以文字標籤顯示 — 無品牌標誌。
- 螢幕上顯示的任何評分、數字或事實都必須來自
sources中的來源。
風格說明
- 預設主題符合經典清單頻道:交替的綠色/黃色蠟筆紋理卡片、紅色邊框、帶有光芒的橘色「No.X」撞擊卡、紫色金錢區塊、藍色評分區塊。在
theme中覆寫任何顏色。 - 360p 下的可讀性:保持標題簡短(副標題承載類型)、保持小知識 ≤ 2 行、不要添加超過 4 個統計資料。
- 觀看留存:每個條目約 11 秒;將最強的條目放在最後;排名撞擊卡 + 嗖/撞音效會在每個條目重置注意力;將開場保持在 ≤ 5 秒。
- YouTube 章節每個需要 ≥ 10 秒,因此開場會自動折疊到第一個排名的章節中。