Communitygithub.com

remotion-sfx

音效配製執行技能:選源/試聽板/入庫/Cue 掛載/驗收。觸發詞:音效、SFX、Whoosh、音效庫、試聽。請在裝配進行到配聲步驟時呼叫。

remotion-sfx 是什麼?

這是一個專為 Remotion 影片專案設計的音效配製執行技能,目標是讓 AI 助手(如 Claude Code、Cursor 等)能夠有系統地完成從音效選源、試聽、入庫、Cue 掛載到定量驗收的完整管線。技能的核心在於強制規範化流程,避免 AI 猜測音色導致聽感不一致或需重複渲染。它支援在剪映本地快取、Remotion 內建音效庫、Mixkit 等免費商用來源中篩選候選音效,並要求一定透過「試聽板」讓用戶親自選定編號,禁止 AI 直接指派。掛載時遵循「A-G 事件對音色表」自動對應畫面事件(如證據卡顯影對玻璃音、小件入場對短亮 Tick),並內建多重審計規則(密度、單音色占比、Stamp 次數上限)來保證整體聽感克制且不吵雜。最終驗收以用戶耳朵為準,但提供 `ffmpeg` 量測作為輔助。這套技能大幅降低了音效重製機率,讓音效配製從反覆猜測變成可預測、可重複的工業化流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jincheng2026/jc-remotion-skills/tree/main/skills/remotion-sfx

在你喜歡的 AI 中提問

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

說明文件

配音效(可執行管線)

定位:幹活的 skill。規則真源在 remotion-assembly/references/audio.md(響度鏈/母帶/停頓/BGM 裁決),衝突以彼為準。 血淚史(勿重蹈):ffmpeg 白雜訊合成 → 否(沙沙廉價感);參考片音軌取樣 → 否(去人聲後單薄)。正解 = 專業音效庫 + 使用者試聽選定(錯題 #21)。

0. 先查定稿庫(多數情況到此為止)

public/sfx/ 在役十音色(2026-07-16 試聽定庫 + 2026-07-21 認可池轉正換源,編號/換源記錄見 audio.md 規則 8;括號內為 §4 事件位): glass 證據卡顯影(A) / pop chip 輕點(B,已換源 fav20 亮脆 tick,頂替被嫌「咔嚓」的舊件) / tick2(B 變體,fav33——同段 B 位連用防重複感) / pop2 名牌落位軟噗(G,已換源 fav14 鈍噗帶體積) / stamp 蓋章重錘(D,全片 ≤1) / rise 數字滾動連滾(C,fav29 重製,BASE_VOL 單獨壓 0.1) / whoosh 清場軟掃(F) / shutter 拍照定格專用 / bright 高亮劃線位(fav02 亮叮——基準片全譜唯一亮族的專職聲) / lowthud 物理撞入·墜落位(fav13 低頻長鳴,入侵拍專用,易過重待段終審校)。舊 pop/pop2 存 spare/prev-*。trans、ding 已於 2026-07-20 使用者試聽裁定棄用(E 位預設留白,正式補源走 §1-2)。備用件在 public/sfx/spare/。認可池 public/sfx/jy-fav/(2026-07-21 使用者剪映收藏 42 段試聽板裁定 19 件可用):fav 編號+雜湊+檔位分組見目錄內 SOURCES.md,全部過了使用者耳朵——B/G/A/E 位換源補源優先從此池取,角色認領在段終審完成;同片在役音色仍按 A-G 表克制(使用者校準:常用音色也就十幾個,音效不能喧賓奪主)。 換影片直接沿用此庫;只有需要新角色/新質感時才走第 1-3 步。

1. 選源(需要新音效時)

優先級:a. 剪映本地快取磁碟庫(使用者指定首選:~/Library/Containers/com.lemon.lvpro/Data/Movies/JianyingPro/User Data/Cache/music/ 等目錄藏有音效庫下載快取,find ... -iname "*.mp3" + ffprobe 時長 ≤5s 篩出音效 + md5 去重;檔案雜湊命名無標題,靠試聽板認領。想擴池:使用者在剪映裡點聽心儀音效即落快取,重跑磁碟庫指令碼即可——這就是「使用者擴庫」的標準動作)→ b. @remotion/sfx(d.ts 即直鏈清單;可用件:whip/whoosh/switch/mouse-click/page-turn/ding/shutter-modern)→ c. Mixkit 免費商用(分類頁 grep assets.mixkit.co/active_storage/sfx/<id>/<id>-preview.mp3)→ d. Pixabay / kenney.nl CC0 → e. 商用包(Artlist/Epidemic)。 版權注意:剪映素材條款名義上限剪映內使用,國內創作者生態通行做法由使用者自行裁量;對外商業分發時優先 b-e。

2. 試聽板(新音效上片前必過,不可跳過)

音效質感 AI 零判斷力,只能篩頻譜硬傷。流程:候選歸一 -3dB → 每條配黑底編號名稱卡(drawtext)渲成小段 → concat 成一條試聽影片交使用者 → 使用者報編號後才准上片。 拼接鐵律(2026-07-16 踩坑):① 每段時長鎖死等長——音訊 apad=whole_dur=2.1,atrim=0:2.1,視訊 -t 2.1,禁用 -shortest(aac priming 使各段時長微差);② 拼接禁用 -c copy,必須整條重新編碼——否則音畫漂移累積,越往後編號和聲音對不上(使用者實測 40+ 號全亂),使用者報的編號全部作廢返工。③ 交付前逐段驗聲(0715-02 事故:4/8 號無聲板交給了使用者當檢測器):拼好的板逐段 ffmpeg -ss <段起> -t <段長> -af volumedetect 驗 max_volume,任一段 <-60dB 即無聲——先 volumedetect 驗該條源檔案(防庫內壞件,如 rise.wav -91dB),再查拼接命令,修好重拼;禁把無聲板交使用者。

音色定位一律靠試聽板,不靠 AI 猜(0715-02 終審沉澱):給畫面事件配哪個音色,由使用者過試聽板指認——AI 對音色零判斷力。0715-02 AI 憑猜給了錯音色 2 次,最後靠試聽板才定位到 stamp。凡新片新配、或舊庫音色與新畫面事件對不上號時,先出試聽板讓使用者認領,禁止 AI 直接指派音色上片。

3. 加工入庫

  • 峰值統一 -3dBFS(volumedetect 測 max → volume=(-3-max)dB),48k 單聲道。
  • 長素材裁頭:impact 類取首 1.0-1.6s + afade out。
  • 連滾合成(數字滾動/批量點亮):選定 tick 裁 40ms + -stream_loop 29 + 音量 ramp volume='0.35+0.65*t/1.2':eval=frame——基準片式「滾動聲」本質是 tick 連擊不是音調 riser。
  • 新角色:sfx-<片名>.ts 的 SfxName 聯合類型 + SfxTrack BASE_VOL 同步加。

4. cue 表掛載:A-G 配聲語法(2026-07-16 頻譜破譯 11 錨點定譜 + 2026-07-21 雙片全量統計升級〔221 實測事件〕;真源=本節 A-G 表 + audio.md 規則 8,定譜證據:assembly/0715-01/分段工坊/音效設計譜.md + docs/基準片配聲譜v2.md)

畫面事件 → 音色對號表(逐 beat 查表取聲,禁止自由發揮):

事件音色庫檔案
A 證據卡/截圖顯影玻璃提示音(短、有音高、介面感;基準片實測顯影聲偏鈍 bright -13.5——勿選最亮檔,亮叮備選 fav02/25/19 上片前須校亮度)glass.wav(剪映 J08,試聽板 106 號)
B chip/小件入場、點陣逐格點亮短亮 tick;批量時 0.15-0.3s 連發pop.wav(2026-07-21 已換源 fav20);同段連用換 tick2.wav 防重複感
C 數字滾動tick 滾奏鋪滿整個滾動期;落定不配重擊(基準片語法)rise.wav(1.5s 版)
D 印章/判詞砸落短悶擊,結實不轟stamp.wav(覺得重換 spare/1143)
E 章節轉場/接管進入長氣流 riser,只在章級trans.wav 2026-07-20 棄用;基準片實測章轉/接管 20 處全配短促切換聲(decay≤0.1s,無氣流長 riser)——補源選 <0.2s 短聲、禁 riser;預設留白維持(0715-02 定稿實踐,本風格使用者裁定);確需時 whoosh 輕檔頂位(vol≤0.5,F 實用值取更低一檔保「退比進輕」),正式補源走 §1-2 試聽
F 清場/退場衰減軟掃,比入場輕一檔(vol ≤0.5;「輕一檔」是本風格克制裁定——基準片實測退場不比入場輕,差異在衰減尾略長,選件重「有衰減尾」甚於音量低)whoosh.wav
G 名牌/徽章/chip 落位軟 poppop2.wav(2026-07-21 已換源 fav14 鈍噗)或 spare/interface-1109

擴充事件位(2026-07-18 泛化壓力測試補,就近歸族不加新音源):hero 大字/結論 lockup 落地 → D 輕檔(vol ≤0.5,不佔 Stamp 重錘配額);時間線卡/圖表載體進場 → A;時間線節點點亮、資料條生長、連線 draw-on → B(批量按連發規矩);判詞小標註/ZeroTag 落位 → B;高亮劃線/劃重點 → bright.wav(專職亮叮,基準片全譜唯一亮族 +3.0);物理撞入/墜落/擠出 → lowthud.wav(輕檔 vol 酌減,易過重);punch-in 變焦 → 中等力度短聲(D 輕檔或 lowthud 輕檔);micro 章降檔——分頁式切出的 <8s 小節,E 轉場只在整組首末各一發,節間用 B 頂替(防轉場聲連發膩;E 位現暫用 whoosh,見 §0)。

認可池對號(2026-07-21 特徵實測分族;主選已於同日轉正落庫,見 §0;聽感終校在段終審):已轉正——pop←fav20、pop2←fav14、tick2←fav33、bright←fav02、lowthud←fav13。仍在池備選:B 備 fav27/24、G 備 fav11/06、A 備 fav25/19(亮叮,若 bright 過亮降檔用)、F 備 fav16(氣聲極輕)、D 輕檔備 fav05、物理備 fav08、E 位候選 fav17/00(預設仍留白)。段終審嫌哪個換哪個,1 分鐘回池換源。完整特徵表在 jy-fav/SOURCES.md。

選聲先問語義家族(2026-07-21 定,防「哪個好聽挑哪個」):亮叮=劃重點/高亮強調,觀衆該看這裡(基準片實測唯一亮族是高亮劃線 +3.0;證據卡顯影實測偏鈍 -13.5 歸鈍短族,配 glass 中檔);乾嗒=小件就位/逐項點亮(推進感);軟噗=身份/結論落定(份量感);低頻=物理動作撞/墜/擠(因果感);氣聲=離場(收拾感)。畫面事件屬於哪個語義家族,就從哪個家族取聲——家族對不上寧可不響。

三條元規則(比音色更重要,v6 翻車根因):① 音色成套——全片一族 UI 系聲音,禁止攝影系/辦公系/大片系混搭;② 音量克制——沒有一發蓋人聲,靠密度不靠響度(基準片雙片實測全片 4-5s/發;「2-3s 一發」是密集段節拍不是全片均值,見配聲譜v2);③ 一事一聲——不疊雙音,同拍兩個事件錯開 ≥0.1s。

hook / 開場配聲通則(問⑩「開場配不配音效」的正條):開場不是「配不配聲」的特例,走的還是「主元素配聲 + A-G 查表」通則——hook 主視覺該出聲就出:打字大字=逐字 tick(B)、hook 重錘數字=C 滾動、證據卡顯影=A、章首/接管進入=E。被否決的只是「無視覺錨點的裝飾性起手音」(whoosh/沙沙開場、為烘托氣氛而配的空拍音)——它不對應任何畫面事件,屬元規則①②之外的純噪聲。判據:開場每一發聲必須掛在一個正在落地的主元素上;掛不上就不配,不為「開頭得有聲」硬塞。

已否決:開場 whoosh 沙沙(裝飾性起手,見上通則)、數字落定重擊、重錘滿片(舊線 ≤2 處/片,2026-07-21 起收緊為咔嚓類全片 ≤1,硬線見 §4.4;基準片雙片實測蓋章 1/2 處,音色畫像=全譜最鈍 bright -18.4+最重 rise 至 30dB,「悶不轟」實錘)、BGM(基準片實測有:連續低頻床、頭中尾恆定、估相對人聲 ≤-15dB——無 BGM 是使用者裁定的本風格差異非基準片語法,翻案時起點參考 -15dB 恆定墊底)、trans 章節 riser 與 ding 收尾(2026-07-20 試聽裁定棄用,見 §0)。

4.4 全片音效審計閘(0715-02 終審沉澱:掛完 cue 必跑,超線回改再渲)

  • 密度:硬下限全片 ≥2.5s/發(事故:1.95s/發被終審打回「太吵」);目標帶 3.5-5s/發(基準片雙片實測 v5=5.0/v6=4.0;0715-02 砍到 3.05s 仍偏密,非終點)。留白也是語法:連續 20-30s 無 cue 屬正常(實測最大留白 28.7s),乾口播段禁補聲湊密度;密度靠 30s 窗對比做波浪(密窗 9-14 發 vs 疏窗 2-3 發),不勻鋪。覆蓋判據優先於密度均值(2026-07-21 0721-01 終審):定稿 42 發 3.02s/發(低於舊目標帶下沿)使用者仍指「不少 MG 缺音效」——密度均值達標≠覆蓋達標;審計以「每個 MG 主元素落地有聲,或顯式留白理由(純口播/接管進入/語義家族對不上)」為準,目標帶 3.5-5 降為防吵參考線,覆蓋需要時低於 3.5 不回改(0721-01 時在役僅 7 音色是覆蓋上限主因;擴庫已落,見下方張力條)。
  • 單音色佔比 ≤35%(事故:pop 114/220=52%,聽感「快門咔嚓連拍」——短 tick 類連發即咔嚓感來源)。基準片乾嗒族實測恰 35%(78/221),此線與實測重合,硬線不放寬。
  • 批量點亮預設「整組首記一發」;0.15-0.3s 連發只用於 ≤4 件的語義 stagger,覆蓋 §4 B 位舊「批量連發」預設。
  • BASE_VOL 基準 ≈0.25(0.2-0.3),重錘上限 0.55——使用者 2026-07-21 裁定「音效基本音量都要 -15dB 左右」:入庫峰值 -3dBFS × 0.25 ≈ 有效峰值 -15dBFS(覆蓋 2026-07-20 的 0.3-0.55;再往前 0.8-1.0 是被裁「太大」的舊版,勿回退)。
  • stamp 蓋章音慎用(0715-02 終審沉澱):使用者把密集 stamp 聽成「拍照咔嚓」——判詞/型名/綠章不必每個都配 stamp,靠視覺留白代替;全片 stamp(含重錘)建議 ≤ 個位數。這與「重錘 ≤2 處/片」疊加:重錘是 stamp 裡的強檔子集,先卡重錘 ≤2,再卡 stamp 音色總數 ≤ 個位數。
  • 咔嚓類音色全片 ≤1(使用者 2026-07-21 0721-01 裁定,收緊上條 stamp≤個位數):使用者對咔嚓(stamp/shutter)聽感極敏感,密集判詞咔嚓 = 拍照連拍、刺耳;全片只留最高潮 1 處重錘 stamp,其餘判詞/結論落定改軟音色(pop2 軟噗 / rise 生長),別每個判詞都蓋章。
  • 標誌性音色(rise 生長音)同樣克制、更防局部扎堆(0721-01 教訓):rise 全片 ≤4-5 處且禁 30s 窗內 ≥2 發(0721-01 首版 rise 10 處、111-122s 扎堆 4 個,被使用者判「同一音效反覆出現」——單音色 22% 沒超 35% 線仍被嫌多,局部扎堆比全片佔比更致命);相鄰生長動畫只挑最標誌的 1 拍配 rise,其餘留白或改 pop。
  • 連續 tick 類音色(rise)BASE_VOL 單獨壓更低:rise 是 ~1.2s 連續 tick,累積響度遠高於單發 pop/pop2,峰值同為 -3dB 時聽感仍更「大」;0721-01 使用者裁定 rise 單獨壓到 0.1(低於常規 0.25 一檔)——連續/持續類音色一律比單發檔再低一檔。
  • MG 配聲覆蓋率 vs 音色庫大小的張力(0721-01 未盡,待擴庫):使用者要「每個 MG 都有聲」但庫僅 7 音色,硬補覆蓋 = 反覆用同幾個音色 → 又吵又重複(正是咔嚓/rise 被嫌多的根源)。覆蓋率與「不吵不重複」在小庫下是矛盾的;根治 = 擴庫。2026-07-21 已落:認可池轉正 3 新角色(tick2/bright/lowthud)+ B/G 換源,在役十音色(§0);還嫌單調再從池裡提(19 件已過使用者耳朵,SOURCES.md 對號表)或使用者再收藏擴池。
  • 審計動作:grep -c 數 cue 總數與逐音色分布,任一超線先砍批量位、再壓佔比;stamp 音色單獨計一次,超個位數即回改。

4.5 自動化閉環(使用者裁定:以後不再逐版調音)

使用者只在兩個點介入,其餘全自動:

  1. 一次性定庫(已在途):磁碟庫/選源 → 試聽總板 → 使用者報編號 → 按 A-G 語法認領角色 → public/sfx/ 永久庫定稿。此後換影片不再選音效。
  2. 段終審:聽段成片整體,報時間點即換(回庫/spare 換源 1 分鐘出新版)。段終審成片一律帶音效交付——cue 自動掛表不依賴視覺先定稿,禁出無音效中間版再重渲(0715-02 教訓:三段渲兩遍空耗一輪渲染)。 中間零人工:裝配每段時按「組件類型 → 事件類型 → A-G 查表」自動派 cue——Chip/點陣格=B、QuoteDoc/ShotCard 顯影=A、Stamp=D、BigNumber 滾動=C、Takeover/章首=E、Exit 清場=F、名牌/徽章=G;cue at 直接取元素 enterAt 換算秒。cue 草稿已指令碼化:node scripts/beat-to-cues.mjs <片名> 從裝配方案表機械生成 sfx-<片名>.ts 草稿(內建 §4.4 預檢報告,超線標紅不自刪),音效員只校不編;指令碼內映射表是本節的抄錄,規則變更以本 SKILL 為準。禁止為單段臨時找新音效(缺角色才走 §1-2 流程補庫)。

5. 定量驗收(段渲後必跑)

  • 每個 cue 點 ffmpeg -ss <t> -t 0.5 -af volumedetect 全頻段峰應顯著高於鄰近純人聲窗;亮質感件另測 highpass=f=8000:≥ 人聲齒音基線 +6dB(該閾值 2026-07-20 起待重新標定——BASE_VOL 降檔後以逐 cue 可聽可辨+使用者終審為準,勿為湊 dB 調回音量,見 audio.md 規則 1)。
  • 可聽事件計數:highpass=f=12000,silencedetect=noise=-25dB 事件數 ≈ cue 數。
  • 廢峰對照:人聲爆破與 BGM 鼓點也會成峰(雙片破譯 360 候選剔廢 39%),響指/拍手等人身收音可達 rise 40dB——聽 cue 點驗收先排除人身收音,勿當音效對標。
  • 最終判據 = 使用者耳朵:段成片交使用者聽,報時間點即回試聽板/備用件換源,1 分鐘出新版。

Individual skills in this repo

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

相關技能