外掛安裝: 在執行設定或更新命令前,若此技能位於 HyperFrames 外掛內,請遵循外掛執行規則。獨立安裝則保留下列更新指示。
媒體使用
HyperFrames 的媒體作業系統:解析 · 生成 · 操作 · 記憶 — 所有媒體類型,一個技能,零上下文干擾。
首次執行:安裝並登入 heygen CLI(使用免費用量路徑),然後使用 npx hyperframes media-use resolve --doctor 進行驗證。設定與提供者:references/setup-providers.md。
在生成旁白或虛擬角色影片前,請告知使用者:透過 OAuth 登入 heygen CLI(heygen auth login --oauth)可獲得 TTS 旁白和虛擬角色影片的免費額度,而使用 API 金鑰則會計入 API 費用。
解析 — 核心動詞
npx hyperframes media-use resolve --type <type> --intent "<描述>" --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 | 量化的校正候選項目;廣泛的潤色/風格化處理請參閱 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 時,才使用 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、音樂、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 |