media-use
HyperFrames 的媒體作業系統：解析 · 生成 · 操作 · 記憶 — 所有媒體類型，一個技能，零上下文干擾。
首次執行：安裝並登入 heygen CLI（免費使用路徑），然後使用 node <SKILL_DIR>/scripts/resolve.mjs --doctor 驗證。設定與提供者：references/setup-providers.md。
解析 — 核心動詞
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
回傳一行：resolved <id> → <path> (<type>, <metadata>)。所有搜尋雜訊都保留在磁碟上。
| 類型 | 單行意圖 |
|---|---|
bgm | 背景音樂（HeyGen 目錄，10k+ 曲目） |
sfx | 音效（內建 19 個檔案庫 + 目錄） |
image | 照片、背景（HeyGen 素材搜尋，75k+ 向量） |
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 旁白（音訊引擎） |
Emoji 或一個樣式化為圖示的 <div> | 解析真實的 icon |
| 一個佔位符、很小或看起來像放大的圖片 | 更好的 image（和/或放大 — 請參閱 references/operations.md） |
| 硬場景切換 / 沒有聲音的轉場 | 轉場 sfx |
| 一段超過 ~10 秒且沒有音樂背景的片段 | bgm |
| 看起來曝光不足/過度或有色偏的素材 | 一個校正性的色彩分級（使用 hyperframes media-treatment --selector '#hero' --analyze --json 檢查） |
| 感覺視覺上平淡或離題的照片素材 | 一個特定的、適合來源的預設或自訂處理，並指名預期目標 |
| 一個感覺靜態的有意義的媒體引入/揭示 | 一個支援的、安全的處理動畫；除非請求也證明使用預設是合理的，否則保留顏色 |
讓這成為幫助而非惱人提示的規則：有根據，非通用（沒有訊號 → 沒有建議）；有主見且具體（提出帶有預設選擇的具體修復 — 使用者核准 全部 / 部分 / 無）；每個專案一次（整合成一個請求；尊重「保持原樣」）；提出，絕不默默修改（尤其是色彩分級：提議並預覽 — 灰色的「校正」會毀掉有意的日落或霓虹燈效果）。
在哪裡查看 — 只讀取你任務所需的檔案
| 任務 | 讀取 |
|---|---|
| 解析 / 重複使用 / 採用 / 引入、標誌、級聯、庫存 | references/resolve.md |
色彩分級、LUT、智慧分級（--for）、分級比較 | references/grading.md |
| 旁白 / TTS、音樂、SFX、字幕、轉錄（音訊引擎） | 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 |