Hanta AI 風格說話人頭影片
這是從 talking-head-editor 範本封裝而成的版本，用於產生 Hanta AI 風格的影片，並非舊版的 League Gothic 版本。請保留範本的佈局與動畫風格；但當內容、說話者或作業系統不同時，請勿宣稱能達到逐畫素完全一致。
接收輸入
接收說話人影片以及允許使用的插入素材。每個任務會建立專屬目錄：
job/
media/raw.mp4
media/assets/...
edit.json
analysis/
out/
以原始影片的時間為基準進行剪輯、字幕與插入。撰寫規劃前，請先閱讀 edit.json 結構；style.md 則說明 hero、sub、brand、card、compare、proof、pip、broll 及 CTA 的用法。
若已有逐字稿（transcript），請直接使用並檢查專有名詞。若需要語音辨識（ASR），則在對應後端的 Python 環境中執行 scripts/transcribe.py；--help 不需要指定模型。請參閱 runtime.md 安裝可選後端。辨識模型與 TTS 不包含在此套件中。
建置
- Hero 用來總結重點，並以金色強調關鍵字。Sub 用於轉折句；brand 在介紹節目名稱時使用；CTA 則放在結尾。每個片段都要有足夠的朗讀時間，請勿自行虛構成就或證明圖片。
- 字卡應對齊實際說出的話語，而不僅是依估計的句首對齊。檢查文字是否在被移除前已完整顯示。
- 放置 PIP 前，先檢查臉部/人物位置。以 Hanta 範例的說話者為例，插入視窗應放在上半部的空白區域，不可遮擋頭部/臉部。若背景為越南事件/企業，請保留越南場景。
- 避免使用其他活動的名牌或舞台，以免觀眾誤解正在介紹的活動。全螢幕卡片不得覆蓋 hero/sub。
- 保留影片的真實聲音；音樂與音效音量應小於人聲。不可因刪除靜音而截斷單字或改變原意。
執行
所有腳本路徑均以此技能目錄為基準，而非使用者目錄：
python3 scripts/doctor.py
python3 scripts/render.py /path/to/job --check-only
python3 scripts/render.py /path/to/job --setup-only
python3 scripts/render.py /path/to/job final.mp4
python3 scripts/qa.py /path/to/job/out/final.mp4 /path/to/job/out/qa
首次設定時，請在任務的 render-project 目錄中使用 lockfile 執行 npm ci。後續則重複使用相同版本。請勿自行開啟 Studio、瀏覽器或影片檔案。預設使用單一渲染執行緒；僅在機器合適或用戶要求時才增加。可使用 --frames=0-59 進行短片段測試，再渲染完整影片。
Anton 與 Montserrat 字型已內建於 assets/fonts 中（附 OFL 授權），渲染時無需下載。若任務尚無獨立音效檔案，會在本機產生 pop/whoosh 音效。render.sh 僅呼叫 render.py；並無第二個範本。
交付
執行 QA 腳本，完整解碼影片、比對影格數、以全尺寸檢查所有圖片表格與卡片。比對逐字稿/時間軸，並在具備實際聽覺能力時進行聆聽；若僅檢查 metadata/ASR，請勿聲稱已聽過。若無法直接聆聽，請明確標示此限制。正確清理任務產生的所有程序；請勿關閉使用者的其他應用程式。
範例 hanta-reference.json 儲存了範本版本的規劃；個人影片/音樂不包含在內。使用範例前請閱讀 reference-inputs.md 以了解如何重建。