Scorewright - Claude 作曲，工具來渲染
第零條規則： Claude 在 score.json 中做出所有創意決定，並寫下理由（direction、cue 的 why）。腳本沒有預設風格、BPM、調式或進行。切勿重複使用上一次的配樂當作模板；每次從影片重新開始。
PY = 已安裝 requirements.txt 的 Python 3.10+ 環境。SW = <此資料夾>/scripts/scorewright.py。
在機器上首次渲染之前，請執行 PY SW doctor。如果顯示「MISSING」，請依照 README.md > 安裝步驟操作，然後停下來告知使用者。
操作手冊（快速入門）
| # | 步驟 | 指令 / 動作 | 完成條件 |
|---|---|---|---|
| 0 | 檢查 | PY SW doctor | 顯示 ready |
| 1 | 事實 | PY SW analyze <video> <work> --words <words.json>（或 --voice） | 產生 facts.json（時長、剪輯點、語音區域、時間軸文字）+ contact.jpg |
| 2 | 觀看 | 閱讀 contact.jpg（tile i = t i*step）與時間軸文字；閱讀腳本/分鏡表（如有） | 能說出訊息、觀眾感受、情緒弧線 |
| 3 | 標記 | 編寫標記表：cue 進/出點、重點時刻（字詞時間點、揭露點、轉折點）、何處留白更好、各段落的情緒（主情緒 + 次情緒 + 強度） | 每個 cue 開始 / 重點時刻都是已測量的時間 |
| 4 | 方向 | 選擇音樂身分並附上理由：曲風融合、調式、各 cue 的 BPM、音色調色盤、主題動機（+ 如何變化）、動態弧線。參考 references/craft.md | 寫入 direction |
| 5 | 配樂 | 撰寫 score.json（參考 references/score-format.md、範例 examples/bed_demo.json）。每個 cue 從其重點時刻開始；使用 s:<秒數> 將音符置於對應字詞上；PY SW fit <times> 只用來在單一 cue 內測試一個速度 | 有效的 JSON |
| 6 | 渲染 | PY SW render score.json <out> | 產生分軌、完整混音、無打擊樂版、composition.mid、預覽檔、SCORE_NOTES.md、qc.json、spectrogram.png |
| 7 | QC | 閱讀 qc.json + spectrogram.png；修正錯誤並重新渲染（每個版本使用新的輸出資料夾） | 所有 checks 為 true；每個重點時刻的 rise_db >= 3；無預期外的靜音 |
| 8 | 聆聽 | 使用者收聽 preview_with_voice.mp3。Claude 無法聽：告知此限制、回報數據、詢問需要修改之處 | 使用者批准 |
| 9 | 交付 | 將 full_soundtrack.wav（已比原始人聲低 X LU，直接以 0 dB 放入）或分軌交給使用者的剪輯軟體 | - |
首要決定：襯底配樂（Bed）還是完整配樂（Score）
- 解說片 / 有旁白的影片（語音幾乎連續）= 襯底配樂。 沒有旋律、沒有主題動機、語音下方沒有曲調。使用脈動、織體、緩慢和聲、僅用低音。能量在段落邊界處變化；在真正的重點時刻有 2-3 個重音/淡入淡出；音樂身分來自音色/節奏，而非曲調。只有在完全沒有語音的地方（第一句話之前的開場、最後一句話後的最後 1-2 秒）才使用簡短的旋律。
- 有真正無語音段落的影片 / 紀錄片 = 完整配樂。 主題動機和旋律存在於那些空隙中。
- 在解說下放旋律等於第二個聲音：觀眾必須選擇聽哪一個，結果解說會失去焦點。
注意事項（DO）
- 靜默、克制與對比也是工具。不是每部影片都需要從頭到尾有音樂。
- 每個核心概念使用一個主題動機；在故事轉折處發展它（轉位、增值、重新和聲、改變一個音符）。
- 在密集解說下減少音樂密度；讓音樂在語音空隙和純視覺時刻發聲。
- 每個音軌的引擎選擇：
gm用於真實樂器（鋼琴、弦樂、銅管、木管、合唱、打擊樂器），aac用於合成器 / 音效設計的聲音（速度慢：約為 gm 的 10 倍；只用於少數、稀疏的音軌；選擇性），sfx用於重點時刻的衝擊聲/漸強/低音下行。 - 襯底配樂的
bed_lu_under_voice：11（充滿活力）至 12.6（平靜），以語音區段為測量範圍——腳本會精確設定此值。 - 新版本 = 新的輸出資料夾；切勿覆寫已批准的渲染結果。
禁止事項（DON'T）
- 禁止出現嗖聲、呼嘯聲、翻頁聲。
riser/swell是音調漸強，請節制使用。 - 禁止抄襲現有旋律、可辨識的主題或參考曲目的編曲。
- 禁止每部影片使用相同的 BPM / 調式 / 和弦進行；禁止使用音量大小代替情緒。
- 沒有視覺或故事理由就不使用音效；音效不得大於旁白音量。
已知限制（經測試）
- GM SoundFont 管弦樂是良好的模擬，而非 Spitfire/Kontakt 的真實感。獨奏鋼琴、pad、撥弦、撥奏與合成器表現最佳。
- 每個 cue 只有一個速度（變速 = 新的 cue）。
composition.mid使用絕對時間，並以第一個 cue 的速度為基礎。 - 音效即程式碼渲染速度較慢（全 aac 的 76 秒配樂：在 Ryzen 5 5600H 上約需 8 分鐘；混和配樂約需 50 秒）。
- Claude 無法聆聽；QC 數字 + 頻譜圖 + 使用者耳朵是反饋循環。