Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

用於混合 HyperFrames 合成中已放置的音訊:淡入/淡出、交叉淡化、音軌增益或音量、音量自動化、閃避、對抗旁白的音樂襯底(旁白雕刻)、音軌效果(等化器、壓縮器、限制器、噪音閘、飽和、延遲、殘響、合唱、移相器、位元壓縮)、繪製在音軌音量或任何效果參數上的自動化包絡,或是一個子混音匯流排,可同時為多條音軌承載效果鏈、推子與自動化時鐘(`<hf-audio-group>`)。不適用於尋找或生成音訊(BGM、SFX 或製作旁白請使用 `/media-use`)。不適用於剪輯時間或音軌佈局(請使用 `/hyperframes-core`)。

hyperframes-instruct 是什麼?

此技能專門用於解決 HyperFrames 合成中已放置音訊的混合問題,其核心理念是將混音視為一組「關係」而非單純的效果堆疊。它提供了一個全面的音訊處理工具集,包括淡入/淡出、交叉淡化、音軌增益/音量、音量與效果參數的自動化、旁白雕刻(閃避),以及完整的串聯效果鏈(等化器、動態效果、非線性效果、時間效果)。所有效果都透過 `data-fx-chain`、`data-automation` 和 `data-fx-carve` 這三個屬性,直接掛載在音訊/視訊元素或 `hf-audio-group` 匯流排上,確保預覽與最終渲染使用完全相同的 Web Audio 圖形引擎,實現「所聽即所得」。此技能支援 HyperFrames 平台,並明確與 `/hyperframes-core`(處理剪輯時間與佈局)和 `/media-use`(處理音源獲取與生成)分工。它提供了從症狀診斷(如轟鳴、悶塞、刺耳等)到對應預設解決方案的完整工作流程,並內建了用於旁白雕刻的詳細機制,可針對整個旁白群組而非單一剪輯進行動態頻段閃避,以維持音樂的完整度。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes-audio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

外掛安裝: 在執行設定或刷新命令之前,當此技能屬於 HyperFrames 外掛時,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。

HyperFrames 音訊

混音是一組關係,而不是處理器的堆疊。單獨聽起來都對的兩條音軌,放在一起可能無法入耳,而解決方法幾乎從來不是「把其中一個調小聲」——而是要找出它們在爭奪什麼,然後把它交給需要的那個。這裡的每一個工具都是為了表達其中一種關係而存在。

效果存在於元素上的 data-fx-chain 屬性中,預覽和渲染執行相同的 Web Audio 圖形——在即時上下文中是工作室,在離線上下文中則是它已驅動的瀏覽器內的引擎。每個效果只有一種實作,因此你在拖曳時間軸時聽到的,就是最終會寫入的內容。你永遠不必調整兩次。

剪輯時間仍屬於 /hyperframes-core:音訊/視訊修剪和來源範圍使用 data-start、data-duration 和 data-media-start,而交叉淡化則重疊不同音軌上的剪輯。此技能負責控制已放置音軌的淡入/淡出、交叉淡化包絡、音軌增益/音量、音量和效果自動化、閃避/旁白雕刻,以及效果鏈。/media-use 負責音源取得、生成和預處理。

固定的 data-playback-rate(0.1..10)在影音元素使用相同時間、來源偏移和速率時,對畫面和保持音高的聲音而言是渲染安全的。速度斜坡是 data-automation 中的一個 rate 通道(參見 docs/reference/speed-ramps);它會覆蓋固定值,並在預覽和渲染中保持音高。HyperFrames 不提供自動波形同步或漂移校正。 如需可複製的剪輯/交叉淡化/重定時配方,請使用 /hyperframes-core → references/creator-editing-recipes.md。

三個屬性承載所有資訊,直接放在音訊/視訊元素上——或者,對於前兩個屬性,也可以放在一個 <hf-audio-group> 匯流排上(參見「一個匯流排控制多條音軌」):

屬性承載內容
data-fx-chain效果,依訊號順序排列
data-automation此音軌音量或其效果參數上的包絡
data-fx-carve雕刻本身的設定,以便可以重新推導

內建的效果系列有:增益、等化器(高通、低通、峰值、高低架)、壓縮器、限制器、噪音閘、飽和、延遲、殘響、合唱、移相器和位元壓縮。

每個效果的確切 JSON 格式,以及通道必須滿足的規則:references/attributes.md。 每個效果及其參數、範圍和單位:references/fx-registry.md。 如何處理一個你無法聽到的檔案並找出問題所在:references/diagnosis.md。 預設、命名任務和單旋鈕設定檔,以及症狀對照表:references/presets.md —— 在手工建立效果鏈之前請先閱讀,因為其中一個預設或命名任務通常已經指出了問題。

各部件如何協同工作

兩種編寫界面寫入這些屬性;兩種執行環境透過相同的建構器讀取它們。正是這個共享的中間層確保預測即渲染。

flowchart TB
  voice["語音音軌<br/>媒體檔案"]
  bed["音樂襯底<br/>媒體檔案"]

  subgraph AUTHOR["編寫 — 唯一寫入屬性的東西"]
    panel["工作室<br/>旁白雕刻控制"]
    script["scripts/carve.mjs<br/>偵測配對"]
    analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
    panel --> analysis
    script --> analysis
  end

  voice --> analysis
  bed --> analysis

  subgraph ATTRS["寫入襯底元素上的屬性"]
    carveAttr["data-fx-carve<br/>來源 · 強度"]
    chainAttr["data-fx-chain<br/>峰值濾波器 xN + 增益,標記為 fromCarve"]
    autoAttr["data-automation<br/>每個雕刻參數一個通道"]
  end

  analysis --> carveAttr
  analysis --> chainAttr
  analysis --> autoAttr

  subgraph SHARED["同一套實作,兩邊都讀取"]
    build["audioFxGraph.ts · buildFxChain"]
    sched["audioFxAutomation.ts · scheduleChainAutomation"]
  end

  chainAttr --> build
  autoAttr --> sched

  build --> preview["預覽<br/>即時 AudioContext<br/>attachElementFxChain"]
  sched --> preview
  build --> render["渲染<br/>在無頭瀏覽器中的 OfflineAudioContext<br/>applyAudioFxChain"]
  sched --> render

  preview --> heard["拖曳時聽到的內容"]
  render --> wav["處理後的 WAV<br/>+ chainTailSeconds 讓混音讓殘響通過"]
  wav --> mix["引擎 · audioMixer<br/>音量通道在此處烘焙到 PCM 中,而非在圖形中"]
  mix --> out["最終渲染混音"]

  edit["播放中編輯屬性"] -.->|MutationObserver| preview

雕刻本身的設定從不於播放時讀取——它產生的效果鏈和通道才是實際播放的內容。data-fx-carve 的存在是為了可以更改現有雕刻的強度,而無需從濾波器中反推回去。

在經過雕刻的襯底內部,訊號先通過衰減部分,然後是電平匹配,再來是你自己構建的效果——這就是為什麼你添加的限制器仍然能作為最終的保護上限:

flowchart LR
  src["解碼後的襯底"] --> p1["峰值濾波器<br/>400 Hz"]
  p1 --> p2["峰值濾波器<br/>1 kHz"]
  p2 --> p3["峰值濾波器<br/>1.6 kHz"]
  p3 --> g["增益<br/>電平匹配"]
  g --> hand["你自己的效果<br/>例如限制器"]
  hand --> dest["音軌增益,然後輸出"]

  l1["通道 fx.n1.gain"] -.->|"語音在該頻段的<br/>音量包絡"| p1
  l4["通道 fx.n4.gain"] -.->|"襯底整體<br/>閃避的程度"| g

首先,找出問題所在

下面的表格從「聽起來轟鳴」開始——這預設已經有人聽過並指出了問題。如果交給你的是一個檔案並要求「修好它」,你沒有這樣的描述,也無法聽到,所以你必須進行測量。一條規則貫穿所有情況:

無法診斷單一未知聲音的絕對頻譜。 共振峰有 ±10 dB,基頻範圍在 85–255 Hz,句子在結尾時會衰減 5–6 dB。這些單獨看起來都像是缺陷,而它們每一個都是說話者本身的特徵。

所以要比較,而且要與同一個檔案內部的東西進行比較:如果存在的話,比較乾淨的原始檔,否則比較靜音段落——任何在間隙中可聽到的聲音都是疊加進去的,而間隙的頻譜代表的是通道而非語音。與發表的平均頻譜或合成的對照語音進行比較是行不通的:兩個說話者之間的差異比大部分缺陷都大,而這份指南背後的評估中兩個錯誤答案正是來自這種比較。

當沒有原始檔也沒有可用的靜音時,靜態的 tonal 缺陷確實是無法確定的。請說明情況並提供符合條件的讀數,而不是選擇一個讀數並據此建立效果鏈。

命令、陷阱和實用配方:references/diagnosis.md。在診斷一個無人描述過的檔案之前,請先閱讀此文件。

從症狀開始

一旦你知道了頻段和類型,就可以說出音訊的問題。大多數糟糕的音訊都屬於以下一兩種情況,每種都有內建的解決方案:

聽起來像請使用
底下有嗡嗡聲或低頻噪聲rumble-cut,或 80 Hz 的 highpass
轟鳴、聲音厚重Tame Boominess 任務(200 Hz)
悶塞、像隔著紙板Reduce Mud 任務(250 Hz)
難以聽清字詞Add Clarity 任務(3 kHz),或雕刻襯底
刺耳、令人疲勞Soften Harshness 任務(3.2 kHz)
某些字詞比其他大聲很多對壓縮器使用 Evenness,或 Even Out Levels
句子之間的房間噪音room-gate
語音和音樂衝突旁白雕刻 — 不是對兩者使用等化器
聽起來很乾、沒有空間感room-tight 或 room-natural
就是感覺「業餘」voice-clean,它按順序組合了上述四種效果

完整目錄、每個預設包含的內容、頻段詞彙,以及刻意不涵蓋的內容(去噝聲、降噪、音色匹配):references/presets.md。

在增加之前先衰減,在濾波之後再做電平匹配,在電平匹配之後再處理關係,最後處理特性和保護上限。每個步驟都會改變下一步聽到的內容——在高通濾波器之前設定的壓縮器,會把精力浪費在處理隆隆聲上。

根據問題選擇效果系列,而非名稱

濾波器(highpass、lowpass、peaking、lowshelf、highshelf)決定一條音軌被允許佔據哪些頻率。這是處理兩個來源衝突時的首選工具,因為衝突發生在頻段上:襯底和語音都想佔據 1–3 kHz,而從襯底中移除這個頻段,對襯底的破壞遠小於把整個音軌調小對混音的破壞。對語音使用高通濾波器是處理隆隆聲的標準方法;低通濾波器則用於刻意讓聲音變暗或模糊。

動態效果(gain、compressor、limiter、gate)決定音軌電平隨時間變化的方式。壓縮縮小了響亮和安靜之間的差距,讓安靜的部分得以提升。限制器是一個保護上限——它不塑造任何東西,只保證沒有訊號能超過它。噪音閘會移除低於門檻的訊號,這就是你如何靜音句子之間的房間噪音。gain 是一個簡單的電平級,當音軌需要讓路時,自動化通道可以操作它。

非線性效果(saturate、bitcrush)改變波形的形狀,從而增加原本不存在的諧波。當音軌需要個性或質感而非修正時使用它——並記住它是有創造性的:它能使單薄的來源變得更豐滿,而不是更乾淨。

時間效果(delay、reverb、chorus、phaser)將音軌置於一個空間中或賦予它寬度。這些是最容易搞砸混音的效果,因為殘響的尾音或失諧的複製品會佔據語音所需的相同空間。將它們用於那些應該處於_後面_的元素,並將濕聲比例保持在比單獨聽起來更低的水平。

效果鏈是串聯的:每個效果處理前一個效果產生的結果。因此,修正性濾波要放在前面,個性效果在中間,限制器最後,這樣它才能真正起到保護上限的作用。

旁白雕刻

它解決的問題。 語音下方的音樂襯底會讓語音難以聽清。本能反應是讓整個襯底閃避,這有效,但代價是襯底失去了所有存在感——音樂在整個旁白期間都顯得很軟弱。但語音並不需要整個頻譜。它只需要它實際佔據的那幾個頻段。雕刻只移除那些頻段,讓襯底保留其低頻和高頻,因此在語音仍然清晰可辨的同時,音樂依然是音樂。

這是一種關係,而非一種效果。 設定存在於_襯底_上——也就是被處理的音軌——它們指定要監聽的語音,就像側鏈壓縮器一樣:你選擇會變小聲的音軌,並指定什麼讓它變小聲。絕對不要將雕刻放在語音音軌上。 語音對抗自身的雕刻是一個錯誤,而非微妙的混音選擇。

所有語音,而非其中一個。 sources 是一個列表,因為一個襯底通常會貫穿整個片段——一個旁白、一個訪談回答、第二位主持人。它們在測量任何東西之前,會先疊加在襯底自己的時鐘上(mixCarveSources),因此一次分析就能涵蓋所有語音:頻段來自所有存在的語音,而包絡則在任何語音發生的地方升起。那些在襯底播放時從不播放的語音則被排除在外;它們無法遮蔽它。

針對多於一個剪輯 ID 的雕刻是錯誤的。請將剪輯分組,然後對組進行雕刻。 這是一個不變量,而非建議。逐一命名剪輯必須完全正確,並且只在下一次編輯前保持正確——後續新增的第四個旁白剪輯將在雕刻的感知範圍外播放,導致襯底無法在它下方靜音地閃避。改為命名組,則可以在分析時解析成員資格,因此稍後加入組的剪輯無需修改 sources 就能被涵蓋:

<!-- 將旁白分組,然後針對該組雕刻襯底 -->
<audio id="vo-intro" data-audio-group="voiceover" …></audio>
<audio id="vo-middle" data-audio-group="voiceover" …></audio>
<audio id="vo-outro" data-audio-group="voiceover" …></audio>

<audio id="music" data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.8}' …></audio>

一個 sources 列表如果命名了兩個或以上的純剪輯 ID 而非一個組,會被 audio_carve_ungrouped_sources 檢查規則捕捉到——它仍然有效,但這是在新增剪輯時會悄然失效的版本。

讓雕刻組保持為語音組:不要包含襯底、SFX 或音樂。 sources 中的組 ID 會在_每次_分析時解析為所有_當前_成員,因此你命名的組就是你之後會得到的組——而不是在撰寫雕刻時被測量的那些音軌。有兩種情況會造成問題:

  • 襯底處於自己的來源組中。 它把自己當作語音來處理,並針對自己的內容進行雕刻——「絕不雕刻音軌自身」的規則會在下次重新分析時體現。
  • 一個 SFX 或音樂剪輯在語音組中。 它在下次分析時進入側鏈,襯底開始對一個嗖聲進行閃避,儘管當初撰寫屬性的那次執行從未測量過它。

這兩種情況在雕刻撰寫的當下都是不可見的:分析將它檢測到的語音相加,並且不會透過組解析進行往返,因此第一次傳遞是真正正確的,只有下一次才是錯誤的。所以,為每個角色指定自己的組——music 給襯底,voiceover 給旁白,sfx 給效果音——並確保 sources 中命名的組只包含語音。

當 carve.mjs 看到上述任一情況時,它會拒絕寫入組形式,改為記錄剪輯 ID,並在 stderr 上輸出是哪個成員阻止了它。然後 audio_carve_ungrouped_sources 規則會指向這個安排。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

sandeshrajbhandari/hyperframes-instruct

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

相關技能