media-use 是做什麼的？
HyperFrames 的媒體作業系統：解析 · 生成 · 操作 · 記憶 — 所有媒體類型，一個技能，零上下文干擾。
首次執行：安裝並登入 heygen CLI（免費使用路徑），然後使用 node <SKILL_DIR>/scripts/resolve.mjs --doctor 進行驗證。設定與提供者：references/setup-providers.md。
Resolve — 單一動詞
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
回傳一行：resolved <id> → <path> (<type>, <metadata>)。所有搜尋雜訊都保留在磁碟上。
| Type | 一行意圖 |
|---|---|
bgm | 背景音樂（HeyGen 目錄，超過 10,000 首曲目） |
sfx | 音效（內建 19 個音效庫 + 目錄） |
image | 照片、背景（HeyGen 資產搜尋，超過 75,000 個向量） |
icon | 圖示、符號（透明背景） |
logo | 官方品牌標誌（依序查詢：svgl → simple-icons → GitHub 大頭貼 → favicon；絕不重繪） |
voice | TTS 配音（HeyGen 免費使用路徑；可選本地 Kokoro） |
grade | 已測量的校正候選；廣泛的潤色/風格化處理遵循 Media Treatments |
lut | 使用者提供或明確選擇的可重複使用、已驗證的 .cube 檔案 |
在重新解析之前，先使用 --candidates 列出可重複使用的候選項，自行判斷合適與否 — 重複使用規則、所有標誌、匯入（--from）與採用，請參閱 references/resolve.md。
將廣泛的視覺回饋視為媒體意圖
當使用者明確要求修正、潤色、風格化、遮蓋、強調或揭露攝影媒體時，請閱讀 references/media-treatments.md，即使他們沒有提及色彩分級或效果。檢查實際的 <img>/<video>，選擇一個主要意圖，然後使用確定性持久化和驗證。使用相符的配方作為可選的測試起點，或檢查 hyperframes media-treatment --capabilities --json，然後使用 --capability <id> 請求一個相關的系列/效果，並根據標準控制項組合自訂處理。永遠不要為了一般創作而載入 --all。一個處理可以組合校正、預設集、修飾、相容的著色器效果、支援的關鍵影格和可選的 Registry 覆蓋層。僅新增來源證明的有限調整和相容部分，不要僅僅為了讓結果看起來更複雜而加入效果。使用 hyperframes media-treatment 持久化最終的合併負載。
使用一個逐步升級的工作流程。對於影片，檢查一個標記為早期/中期/晚期的連繫表，而不是分別讀取影格。對於一般校正或潤色，套用一個候選項並檢查一張處理後的連繫表。僅當結果不明確、涉及時間變化、風格化、基於 LUT、HDR/LOG 敏感、涉及隱私或品牌關鍵時，才升級到個別影格或動態草稿證據。
對於一般校正或潤色，請持久化最終處理的預設集/調整 JSON。
不要僅僅為了編碼曝光度、陰影、對比度或色溫而生成 .cube LUT。僅當使用者提供了 LUT，或者所選的處理明確擁有一個 LUT 時，才使用它。resolve --type grade --for ... --analyze 是測量證據，並非允許用生成的 LUT 取代所選的處理。不要使用 CSS/SVG 覆蓋層重新建立支援的暗角、顆粒、模糊、像素化、顏色或處理效果；這會繞過 Studio 的控制項和標準的預覽/渲染著色器路徑。
主動出擊 — 執行媒體機會掃描
人類通常無法判斷哪些媒體能提升作品。你可以。當你建構或審查一個組合時，執行一次有根據的掃描，然後詢問一次 — 不要默默地添加，也不要逐個資產地嘮叨。
僅在存在具體信號時才提出機會：
| 檢測到的信號 | 提供的建議 |
|---|---|
| 螢幕上的文字 / 沒有配音的腳本 | TTS 配音（音訊引擎） |
表情符號或一個被設為圖示樣式的 <div> | 解析真實的 icon |
| 看起來是佔位符、很小或像被放大過的圖像 | 一個更好的 image（和/或放大 — 請參閱 references/operations.md） |
| 生硬的場景切換 / 沒有聲音的過渡 | 過渡音效 sfx |
| 一段長度超過約 10 秒且沒有背景音樂的片段 | bgm |
| 看起來曝光不足/過度或有色偏的素材 | 一個修正性的分級（使用 hyperframes media-treatment --selector '#hero' --analyze --json 檢查它） |
| 感覺視覺上平淡或離題的攝影媒體 | 一個特定的、符合來源的預設集或自訂處理，並指明預期的目標 |
| 一個有意義的媒體入場/揭示但感覺靜態 | 一個支援的安全影格處理動畫；除非請求也證明需要某個預設集，否則保留顏色 |
保持這項功能為幫助而非干擾的規則：有根據，而非泛泛而談（無信號 → 無建議）；有主見且具體（提出帶有預設值的具體修正 — 人類批准 全部 / 部分 / 無）；每個專案一次（一次整合的請求；尊重「保持原樣」）；提出建議，永不默默變更（尤其是色彩分級：提出建議並預覽 — 一個灰色世界的「校正」會毀掉故意的日落或霓虹燈效果）。
查閱位置 — 僅讀取任務所需的檔案
| 任務 | 請閱讀 |
|---|---|
| resolve / reuse / adopt / ingest、標誌、級聯、清單 | references/resolve.md |
色彩分級、LUT、智慧分級（--for）、分級比較 | references/grading.md |
| 配音 / TTS、音樂、音效、字幕、逐字稿（音訊引擎） | references/audio.md |
| 裁切 / 重構 / 變形既有媒體、精確的誤差擴散、HEVC | references/operations.md |
| 感知來源的創意處理、即時效果、覆蓋層、揭示 | references/media-treatments.md |
安裝 + 認證、提供者表格、RAM 階梯、--local-only、--provider | references/setup-providers.md |
| 已記住的偏好 + 凍結的配方（使用者記憶） | references/memory.md |
| 所有權矩陣、使用統計、遙測、隱私（維護者面向） | references/meta.md |