web2clip · 從網站生成一系列附旁白剪輯
將一個網站（最好是互動式頁面）轉換為 一系列按章節劃分的短片 + 一支總片，可為 9:16 直立或 16:9 橫向，包含 AI 主講人（ElevenLabs 語音）、與旁白精準同步的網頁效果（邊框高亮、滑鼠點擊、滾動、字幕），數據 100% 正確，因為直接從真實頁面錄製。
子指令（僅需單一階段時使用）
| 指令 | 階段 |
|---|---|
/web2clip-setup | 1–2 · 檢查連線、工具、網路權限、帳號 |
/web2clip-plan | 3 · 讀取網頁、建議想法、腳本 + 審查儀表板 |
/web2clip-voice | 4–5 · 建議語音、為每支片段產生語音、取得檔案 |
/web2clip-record | 4 · 同步錄製影片、輸出各片段 |
/web2clip-merge | 6 · 合成總片、命名、交付檔案、儲存 |
執行 /web2clip = 完整走完下方 7 個階段。不得跳過審查步驟。
黃金法則（從真實專案總結）
- 先審查文字，後花錢： 腳本必須先被批准才能產生語音（語音會消耗額度）。
- 先製作一支試播片（pilot），讓用戶審查語音 + 效果風格，然後再大量生產。
- 語音是旁白，不照讀網頁上的文字。 要有角色名稱（例如「Chip，X 先生的助手」）、親切的稱呼、以問題/情境開場、以引導至下一部分的句子結尾。
- 按章節分割為短片（1–2 分鐘），然後再合成總片。不要一開始就做一支長片。
- 畫面必須跟隨旁白： 提到哪個部分，該部分就在準確的時間亮起。使用同步錄製工具（
scripts/w2c/record.py），勿手動估算。 - 每次最多問用戶 1–3 個問題，並提供可點擊的選項。遇到限制時要如實告知。
7 階段流程
1. 檢查連線 → 查看 /web2clip-setup
執行 python -m w2c.check_env（在 scripts/ 目錄下）。提供一張表格：哪些工具可用、哪些連線可用（ElevenLabs、Drive、Canva、瀏覽器），缺少什麼則建議安裝並提供建立帳號的指引。
2. 準備 MCP / API / 權限
缺少網路權限 → 引導用戶開放正確的域名（設定檔中列出）。缺少 ElevenLabs 連線 → 邀請用戶連線。當工具權限請求視窗出現時，提醒選擇 「一律允許」。
3. 構思想法 → 查看 /web2clip-plan
讀取網站，列出章節/段落，建議：畫面框、長度、語音、主講人、分為幾支片段。撰寫雙欄腳本（旁白 · 網頁效果）。建立 審查儀表板（w2c.dashboard）並傳送連結，讓用戶掌握全貌，逐片審查。
4. 腳本 → 語音 → 錄製 → 合成各片段
語音：/web2clip-voice。錄製：/web2clip-record。每完成一支片段就更新儀表板。
5. 建議語音
根據語言、性別、年齡、地區篩選語音；提供 2–3 個選項並附上理由；預設選擇自然、說書風格的語音。
6. 總片 → 查看 /web2clip-merge
按照順序合成，命名為 <專案>_Clip<N>_<部分名稱>.mp4，總片命名為 0. ..._TONG-HOP，使其永遠排在資料夾最前面。
7. 交付直到用戶 100% 滿意
傳送檔案 + 更新儀表板，傳送前先自行檢查畫面（每支片段抽取 4–6 幀），列出自行發現的錯誤，反覆修改直到用戶批准。儲存腳本、語音、規格，以便快速修改。
參考文件
references/loi-thuong-gap.md—— 已遇到的常見錯誤與避免方法（錄製前務必閱讀）。references/viet-kich-ban.md—— 如何撰寫吸引人的旁白 + 腳本範例。references/chon-giong.md—— 如何建議語音、估算額度、ElevenLabs 方案。examples/spec_example.json（存放在 repository 根目錄）—— 腳本規格檔案範例。