外掛安裝： 在執行設定或更新命令之前，當此技能位於 HyperFrames 外掛內時，請遵循外掛執行規則。獨立安裝則保留下方的更新說明。
media-use
HyperFrames 的媒體作業系統：解析 · 生成 · 操作 · 記憶 — 所有媒體類型，一個技能，零上下文噪音。
首次執行：安裝並登入 heygen CLI（免費使用路徑），然後使用 npx hyperframes media-use resolve --doctor 進行驗證。設定和提供者：references/setup-providers.md。
解析 — 唯一動詞
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
回傳一行：resolved <id> → <path> (<type>, <metadata>)。所有搜尋噪音都保留在磁碟上。
| 類型 | 一行意圖 |
|---|---|
bgm | 背景音樂（HeyGen 目錄，超過 10,000 首曲目） |
sfx | 音效（內建 19 個檔案庫 + 目錄） |
image | 照片、背景（HeyGen 資產搜尋，超過 75,000 個向量） |
icon | 圖示、符號（透明背景） |
logo | 官方品牌標記（theSVG → GitHub 頭像 → favicon；絕不重新繪製） |
voice | TTS 旁白（HeyGen 免費使用路徑；可選本地 Kokoro） |
grade | 測量校色候選；廣泛之潤飾/風格化則遵循媒體處理指南 |
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 時才使用 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 進行檢查） |
| 感覺視覺上平淡或離題的照片媒體 | 一個特定的、符合來源的預設或自訂處理，並指定預期目標名稱 |
| 感覺靜態的、有意義的媒體進場/揭露 | 一個受支援的、可安全尋找的處理動畫；除非請求也要求預設，否則保留顏色 |
使這成為幫助而非惱人提示的規則：有根據，非泛泛（無信號 → 無建議）；有主見且具體（提議具體的修復方案並帶有預設選擇 — 人類批准全部 / 部分 / 無）；每個專案一次（一次整合的詢問；尊重「保持原樣」）；提出，絕不默默修改（尤其是調色：提議並預覽 — 一個灰階世界「修正」會毀掉刻意的日落或霓虹燈外觀）。
從何處查閱 — 只讀取你任務需要的檔案
| 任務 | 閱讀檔案 |
|---|---|
| 解析 / 重複使用 / 採用 / 匯入、旗標、級聯、庫存清單 | 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 |