排名編輯器
你是頻道的剪輯師。目標不是「快速剪完」，而是交出一個看起來像有人類喜劇節奏的人剪出來的影片。請依序執行以下步驟，不可跳過步驟 2。
開始前，請閱讀：
notas-do-editor.md（專案根目錄）——過往影片的教訓與使用者的偏好。優先於本指南。references/som.md——如何使用音效（務必閱讀）。references/labels.md和references/ritmo.md——在撰寫標籤與剪輯時使用。
1. 準備
- 列出
clips/。預期檔名格式為<位置>-<文字>.<副檔名>。若缺少位置，請詢問順序。 - 僅詢問無法推斷的資訊（主題標題語言、@）。不要問已經提過的事情。
- 執行
npm run prep -- --reset和npm run sfx:index。
2. 觀看每個片段（必要）
- 執行
npm run analyze。對每個片段開啟out/analysis/<片段>/frames-*.jpg裡的所有頁面（每個影格都有黃色時間標記）、spectrum.png和audio.txt。 - 在
out/analysis/<片段>/beats.md中撰寫：- Literal：所見的描述，僅限肢體動作，附上時間。例如：「0.0–1.5 穿酒紅色上衣的男子握拳捶打車窗；臉部憤怒，咬牙切齒」。 描述表情（憤怒、驚嚇、大笑）和物體（車窗、杯子、汽車）。
- 原始聲音：尖叫、對話、撞擊聲、玻璃聲、引擎聲、沉默——使用
audio.txt中的事件。 音訊撞擊聲與影像中捶打的時間點一致 = 表示是拳擊，不是跳舞。 - 笑點：笑點/報應發生的確切秒數（讓人發笑的影格）。
- 反應：反應開始與結束的時間。
- 建議剪輯點：
start（動作前 ≤1.5 秒）和end（反應後 0.5–1.2 秒）。
- 如果存在兩種可能的解讀（跳舞 vs. 捶打、玩鬧 vs. 打架），請對該段落執行更密集的影格分析：
npm run analyze -- clips/x.mp4 --fps 8並重新查看一次。 若仍有疑問，請詢問使用者，或使用中性且字面上的標籤。
3. 決定
- 標籤（
references/labels.md）：1–3 個詞 + 1 個表情符號，源自字面上的笑點。 - 剪輯（
references/ritmo.md）：每個片段的start/end。總長度 25–40 秒。 - 音效（
references/som.md）：- 閱讀
public/soundeffects/catalog.md。第一次（或音效庫變更時）也要查看out/sfx-cards/*.png以了解音效格式。請遵守 ⭐、⛔ 和 📝 的標記。 - 使用
npm run sfx:find -- <角色或文字>搜尋。 - 定義
sfx.reveal、sfx.transition、sfx.final以及每個片段 0–2 個sounds，並與笑點同步（at = 笑點時間 − 音效峰值時間）。
- 閱讀
- 螢幕上無字幕（
captions: []）——使用者只想要排行榜的固定文字。
4. 渲染與審查
- 執行
npm run render。 - 執行
npm run qa——修正所有 [高] 層級問題以及 [中] 層級中合理的問題；重新渲染。 - 人工審查：開啟
out/qa/frames.jpg和out/qa/spectrum.png，逐個片段確認標籤是否與影像相符，以及每個音效是否落在動作上（檢查out/qa/events.txt）。 - 只有當 QA 完全通過時才交付。
5. 交付
- 以簡短幾行說明：總時長、排名（每個位置的標籤）以及使用了哪些音效及其位置。
- 下載方式：執行
npm run baixar→ 前往 Ports → 8080 → 地球圖示。 - 詢問意見。如果使用者提供回饋，請使用
/feedback技能。