Communitygithub.com

drama-audio-soundstage

短剧工业化管线·第4工序:声音工程与智能避让配乐。负责H3视频生成后的声音精修。硬核沉淀:谱减法音频门控(消灭风噪/电流床音)、Whisper ASR纯普通话语种漂移拦截、FFmpeg原生侧链动态避让混音(Sidechain Ducking,台词开口BGM瞬降-14dB,闭嘴扬起)。

drama-audio-soundstage란 무엇인가요?

Drama Audio Soundstage는 드라마 산업화 파이프라인의 네 번째 공정으로, H3 비디오 생성 후의 사운드 후반 작업을 담당합니다. 이 스킬은 스펙트럼 감산 오디오 게이팅(Audio Gate)을 통해 지속적인 험, 바람 소리, 전류 노이즈 등의 배경 잡음을 제거하고, Whisper ASR을 사용하여 중국어(표준 중국어) 외의 언어 드리프트를 자동으로 차단합니다. 또한 FFmpeg의 네이티브 사이드체인 다이내믹 덕킹(Sidechain Ducking)을 활용하여 대사가 시작되면 BGM을 순간적으로 -14dB까지 낮추고, 대사가 끝나면 부드럽게 원래 볼륨으로 복귀시켜 영화 수준의 오디오 믹싱을 구현합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 호환되며, 구체적인 파라미터와 스크립트를 통해 일관되고 전문적인 사운드 디자인을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abserari/drama-production-skills/tree/HEAD/skills/drama-audio-soundstage

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Drama Audio Soundstage (사운드 엔지니어링 및 지능형 배경 음악 공정)

공정 위치: 드라마 사운드 디자인 및 상업 배경 음악 공정. 일반적인 잡담 배제: 트랙이 무엇인지 설명하지 않고, 오디오 게이팅 클리닝 파라미터, 언어 드리프트 차단 임계값 및 사이드체인 덕킹 믹싱 커브만 집중적으로 다룹니다.


1. 실행 계약 및 입출력

  • 입력:
    1. 3번 공정에서 출력된 원본 오디오가 포함된 비디오 컷: segments/{seg_id}.mp4;
    2. 독립적인 고품질 영화 배경 음악 BGM: assets/bgm/*.wav.
  • 출력:
    1. 배경 잡음이 제거된 순수 컷: cleaned_segments/{seg_id}.mp4;
    2. 90초 서스펜스 비즈니스 배경 음악과 보컬 사이드체인 지능형 회피가 적용된 최종 영상: [에피소드명]_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를 발생시키고 해당 컷을 실패로 표시하여 시드 변경 후 재실행 트리거.

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 盲跑带来的人脸变形、角色换脸、场景变色与道具软化。

관련 스킬