Communitygithub.com

drama-audio-soundstage

短剧工業化管線·第 4 工序:聲音工程與智慧避讓配樂。負責 H3 影片生成後的音訊精修。硬核沉澱:譜減法音訊閘控(消滅風噪/電流床音)、Whisper ASR 純普通話語種漂移攔截、FFmpeg 原生側鏈動態避讓混音(Sidechain Ducking,台詞開口 BGM 瞬降 -14dB,閉嘴揚起)。

drama-audio-soundstage 是什麼?

這項技能專注於短劇製作管線中的第四道工序,負責 H3 生成影片後的音訊精修與商業配樂整合。它提供了一套高度自動化的解決方案,能夠有效去除 H3 音訊中常見的持續性低頻噪音(如電流聲、風噪),並確保所有對白均為高品質普通話,杜絕語種漂移。藉助 FFmpeg 原生側鏈壓縮技術,此技能可實現電影級動態混音:當角色開口說話時,背景音樂會瞬間降低約 -14dB 以確保人聲清晰,對白結束後則平滑回升以維持情緒張力。技能支援 Claude Code、VS Code 及任何能執行 Python/FFmpeg 命令的終端,其核心邏輯封裝於 `audio_gate.py` 與 `cinematic_audio_mixer.py` 腳本中,並透過可調參數提供精細控制。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abserari/drama-production-skills/tree/HEAD/skills/drama-audio-soundstage

在你喜歡的 AI 中提問

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

說明文件

Drama Audio Soundstage (聲音工程與智慧配樂工序)

工序定位:短劇聲音設計與商業配樂工序。 拒絕通用廢話:不解釋什麼是音軌,只沉澱音訊閘控清洗參數、語種漂移攔截閾值與側鏈避讓混音曲線。


1. 運行契約與輸入輸出

  • 輸入:
    1. 第 3 工序輸出的帶原生音訊的影片分鏡:segments/{seg_id}.mp4;
    2. 獨立高品質電影配樂 BGM:assets/bgm/*.wav。
  • 輸出:
    1. 濾除床音後的純淨分鏡:cleaned_segments/{seg_id}.mp4;
    2. 掛載 90s 懸疑商戰配樂與人聲側鏈智慧避讓的成片:[集名]_final_ducked.mp4;
    3. ASR 語種與台詞準確性質檢單。

2. 硬核 SOP:譜減法音訊閘控清洗 (Audio Gate)

現象:H3 生成的音訊往往帶有持續的「嗡嗡」低頻電流聲、假風噪或刺耳環境床音,破壞視聽沉浸感。 目標:徹底濾除持續床音,100% 保全人物對白與短促動作擬音(拔刀聲、拍桌聲、腳步聲)。

2.1 閘控核心參數與物理意義

呼叫 scripts/audio_gate.py 時執行黃金參數組:

  • --bed-q 15:時域滑動窗分位數(設為第 15 百分位),精確識別持續底噪;
  • --alpha-bed 6.0:持續床音扣除強度;
  • --alpha-fx 1.0:瞬態擬音/對白保護因子,越小對白越完整;
  • --fx-snr 4.0:信噪比判定閾值;
  • --quiet-gain 0.03:純靜音幀衰減係數。

命令:

python scripts/audio_gate.py --in segments/seg01.mp4 --out cleaned_segments/seg01.mp4

3. 硬核 SOP:ASR 普通話語種漂移自動化攔截

現象:角色發音漂移為偽英語、含糊亂碼或非中文雜音,嚴重影響交付。

3.1 攔截與判據

落盤後透過輕量 Whisper 執行極速語種校驗:

  1. 提取音軌前 5 秒進行 Language ID 判定;
  2. 通過判據:language == "zh" 且置信度 prob >= 0.85;
  3. 攔截處置:若判定為 en 或其他語種,自動拋出 LanguageDriftError 並將分鏡標記為失敗,觸發換 seed 重跑。

4. 硬核 SOP:影視級側鏈動態避讓混音 (Sidechain Ducking)

禁令(反例):嚴禁無腦將 BGM 鋪在影片底下固定音量!對白會被背景音樂淹沒,毫無商業片層次感。

4.1 FFmpeg 原生 sidechaincompress 黃金曲線

使用人物對白作為側鏈控制訊號,即時動態壓制 BGM:

  • BGM 基礎底音:bgm_volume = 0.35;
  • 閾值 (Threshold):ducking_threshold = 0.06(只要人聲開口,立即觸發下潛);
  • 下潛深度 (Ratio):ducking_ratio = 5.0(台詞說話時,BGM 瞬時下潛約 -14dB,給人聲留出完全清晰的頻段);
  • 起音時間 (Attack):ducking_attack_ms = 80ms(人聲首字開口瞬間平滑下潛,無生硬爆音);
  • 釋放時間 (Release):ducking_release_ms = 400ms(台詞閉嘴後,BGM 在 0.4 秒內絲滑回升,烘托緊張情緒)。

命令:

python scripts/cinematic_audio_mixer.py --input concat_raw.mp4 --output final_ducked.mp4 --bgm assets/bgm/suspense.wav

Individual skills in this repo

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

comfy-h3-render-core

短剧工业化管线·第 3 工序:H3 物理视频渲染与防翻车调度。负责与本地 ComfyUI 服务交互,调度 MiniMax H3 进行 Turbo 8-step 视频生成。硬核沉淀:Windows WDDM 驱动锁防御、潜空间 32 整除铁律、单人发音锁定与全员闭嘴抑制指令装配、首帧 I2V 安全注入、分镜间显存防泄漏。

comfy-h3-video-producer

本地 ComfyUI 剧本转视频自动生产管线(MiniMax H3)。用户给剧本要求用 ComfyUI 出分镜视频,或提到"一采二采/超分/班长套件/CSGlide/工作流生成视频"时使用。覆盖:工作流握手(不写死节点号)、导演调度与段规划、H3 提示词、提交与自动监工、一采双检闸门、收片清床音与拼接、断点续产。

drama-director-staging

短剧工业化管线·第 1 工序:编剧与导演分镜调度。负责将剧情大纲或小说文本转化为符合短剧视听规律的工业级分镜。内置:6 大动态运镜轮换决策树、台词纯中文汉字归一化(数字大写)、短剧快节奏 20~28 字密度调控、单人发言与旁观者闭嘴标注。

drama-finishing-upscaler

短剧工业化管线·第 5 工序:终期成片与 1080p 超分增强。负责全集分镜无损拼接与院线级 1080p 超分辨率放大。硬核沉淀:FFmpeg concat 零损耗直拼、RealESRGAN x2plus GPU 独占 FP16 批量超分(~4.8fps)、原生高质量避让音轨无损混流、ffprobe 工业级物理参数验收。

drama-keyframe-forge

短剧工业化管线·第 2 工序:分镜定帧与资产一致性。负责在视频渲染前,建立全局风格母卡 (Style Bible),并为每个分镜前置生成“场景+人物+道具”三合一的 16:9 高清定帧垫图。彻底根治 T2V 盲跑带来的人脸变形、角色换脸、场景变色与道具软化。

相關技能