標誌彈出：從您的指尖彈出的標誌
使用者通常不具備技術背景。請保持回覆簡短，為他們完成工作，切勿要求他們執行指令。
所有路徑都相對於此技能所在的資料夾（即此 SKILL.md 所在的資料夾）。在指令中使用其絕對路徑。以下 PY 表示此資料夾中的 .venv/bin/python（在 Windows 上為 .venv\Scripts\python.exe）。
1. 第一次執行：設定（僅需一次）
執行 bash scripts/setup.sh。完成時會顯示 READY（第一次約需 1 到 3 分鐘）。
NEED_FFMPEG：安裝它（Mac：brew install ffmpeg，Windows：winget install ffmpeg），然後重新執行設定。NEED_PYTHON：安裝 Python 3.12（Mac：brew install [email protected]，Windows：winget install Python.Python.3.12），然後重新執行設定。
2. 找出指向與詞語
對他們的影片執行以下兩項：
PY scripts/track.py <video>：追蹤手部，儲存<video>.hands.json並列印出指向區間（手指舉起的時間）。PY scripts/words.py <video>：列印出每個詞語被說出的時間。
將每個區間與講者在其中或附近提到的品牌配對。Whisper 經常誤聽品牌名稱：「cloud」通常是 Claude，「codecs」是 Codex，「croc」/「grok」是 Grok，「chat GPT」是 ChatGPT，「Gemini」，「cursor」是 Cursor。如果使用者已經告訴您要使用哪些標誌，請依照他們指向的順序使用。 如果沒有詞語提及品牌，且使用者未說明，請問一個簡短的問題：要使用哪些標誌，以及它們的順序。
3. 撰寫計畫
將其儲存在影片旁邊，名為 <video-name>_logos.json：
{"pops": [
{"logo": "claude", "start": 1.12, "end": 1.85},
{"logo": "codex", "start": 2.10, "end": 3.05},
{"logo": "grok", "start": 3.45, "end": 4.50}
]}
start：在手部穩定後一拍（區間開始），或是在詞語上，取較晚者。end：手指放下或下一個指向開始時。每個彈出持續 0.7 到 1.2 秒效果最佳；切勿重疊兩個彈出。logo：預設名稱（如下）、來自 lobehub.com/icons 的任何圖示名稱（例如notion、figma、vercel；它會先嘗試<name>-color），或是使用者提供的 PNG/SVG 路徑。
每個彈出的選項（皆為可選）：
| 鍵 | 說明 | 預設值 |
|---|---|---|
label | 圖示下方藥丸中的文字；"" 隱藏它 | 品牌名稱 |
bg | 瓷磚的顏色（十六進位） | 預設值，否則為白色 |
fg | 單色 SVG 標誌的顏色 | 深色瓷磚上為白色，淺色上為黑色 |
accent | 彈出環的顏色 | 預設值，否則為標誌顏色 |
size | 瓷磚寬度佔影片寬度的比例 | 0.24 |
logo_scale | 瓷磚內部標誌的大小 | 0.66 |
gap | 圖示距離指尖的距離（以瓷磚大小為單位） | 0.85 |
nudge | 額外的 [x, y] 偏移量（佔寬度的比例） | [0, 0] |
avoid_face | 如果會遮住臉部則向上滑動 | true |
burst | 彈出時顯示環和火花 | true |
預設：claude、anthropic、codex、openai、chatgpt、grok、gemini、cursor、perplexity、deepseek、copilot、mistral、meta。
4. 檢查，然後渲染
- 先產生靜態圖片（快速）：
PY scripts/render.py <plan.json> <video> <folder>/check.png --still 1.5,2.6,4.0，每個彈出中間的一個時間點。自己查看 PNG 檔案。修正任何遮住臉部、被邊緣裁切、或離手指太遠的情況（調整gap、nudge、size、時間）。 - 渲染：
PY scripts/render.py <plan.json> <video> <video-name>_logos.mp4。輸出：H.264 MP4，寬度 1080，相同幀率，保留原始音訊。 - 告訴他們檔案的位置，並請他們在發佈前先觀看。
規則
- 切勿遮住臉部。臉部避免功能預設開啟；仍需檢查靜態圖片。
- 每次指向一個標誌。如果他們對同一個品牌指向兩次，則使用兩個彈出。
- 標誌為其擁有者的商標；此技能僅供評論與評測使用。除非使用者要求，否則不要添加講者未提及的標誌。