media-use
HyperFrames 的媒體作業系統:resolve · generate · operate · remember — 所有媒體類型,單一技能,零上下文噪音。
首次執行:安裝並登入 heygen CLI(免費使用路徑),然後使用 npx hyperframes media-use resolve --doctor 驗證。設定與提供者:references/setup-providers.md。
Resolve — 唯一的動詞
npx hyperframes media-use resolve --type <type> --intent "<描述>" --project <目錄>
回傳一行結果:resolved <id> → <路徑> (<類型>, <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 語音旁白(音訊引擎) |
Emoji 或一個被設定為圖示樣式的 <div> | 解析真正的 icon |
| 圖片是佔位符、解析度低或看起來有放大痕跡 | 一張更好的 image(及/或放大——請參閱 references/operations.md) |
| 生硬的場景切換 / 沒有音效的轉場 | 過場 sfx |
| 一段超過約 10 秒且無背景音樂的片段 | bgm |
| 看起來曝光不足/過曝或有色偏的鏡頭 | 一個校正性的 grade(使用 hyperframes media-treatment --selector '#hero' --analyze --json 檢查它) |
| 看起來視覺上平淡或離題的照片媒體 | 一個具體的、來源合適的預設或自訂處理方案,並指明預期的目標 |
| 一個有意義的媒體進場/揭曉,但感覺靜態不動 | 一個受支援的、安全無跳幀的處理動畫;保留顏色,除非該請求也證明了預設的合理性 |
讓這項功能成為助力而非干擾的規則:基於具體信號,而非泛泛而談(沒有信號 → 不建議);有主見且具體(提出具體的修正方案並附上預設選擇——由人類批准 全部 / 部分 / 無);每個專案一次(一次性整合請求;尊重「保持不變」);提出方案,絕不默默修改(特別是色彩處理:提出預覽——一個灰階世界的「校正」會毀掉刻意為之的日落或霓虹燈效果)。
到哪裡查閱——只需閱讀任務所需的文件
| 任務 | 查閱 |
|---|---|
| resolve / reuse / adopt / ingest、旗標、級聯、庫存清單 | references/resolve.md |
色彩校正、LUT、智慧 grade(--for)、grade 比較 | 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 |