Communitygithub.com

drama-finishing-upscaler

短剧工业化管线·第5工序:终期成片与1080p超分增强。负责全集分镜无损拼接与院线级1080p超分辨率放大。

drama-finishing-upscaler とは?

このスキルは、短尺ドラマ(短劇)の工業化パイプラインにおける最終工程(第5工程)を担い、全エピソードのショットを無劣化で結合し、1080p超解像度アップスケールを実施します。FFmpeg concatを使用したゼロロスストリームコピー結合、RealESRGAN x2plusモデルによるGPU専有FP16バッチ超解像(~4.8fps)、ffprobeによる工業レベル物理パラメータ検収を標準装備。Claude Code、Cursor、CodexなどAIエージェントと連携し、最終納品用の高品質ビデオファイル(原画商業版、1080p版)と検収レポートを自動生成します。このスキルは、超解像の原理説明ではなく、実践的な結合構文、VRAM最適化、音声保護(サイドチェインダッキング済み音声を完全維持)といった具体的なノウハウを提供し、短劇制作の最終品質を担保します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abserari/drama-production-skills/tree/HEAD/skills/drama-finishing-upscaler

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Drama Finishing Upscaler(終期成片と1080p超分工序)

工程位置づけ:短尺ドラマの最終納品と画質向上工程。 一般的な説明は一切排除:超解像度の説明は行わず、マルチセグメント無劣化結合構文、RealESRGANのVRAMバッチ処理最適化、最終ファイルの物理検収基準 のみを集約。


1. 実行契約と入出力

  • 入力:
    1. 第4工程が出力した8つのクリーニング済みショット:cleaned_segments/seg01.mp4 〜 seg08.mp4;
    2. または、サイドチェインダッキング済みBGMを含む最終オリジナルファイル:[エピソード名]_final_ducked.mp4。
  • 出力:
    1. [エピソード名]_原画商業版.mp4(832×480 ネイティブ高精細納品用完成ファイル);
    2. [エピソード名]_1080p.mp4(1920×1080 映画級超解像度最終ファイル);
    3. delivery_report.json:物理パラメータ検収台帳。

2. 実践SOP:ショットストリーム無劣化結合(Zero-Loss Concat)

絶対ルール:ショット結合時に再エンコード(Re-encoding)を絶対に行わない!再エンコードは原画のシャープネスを損ない、追加の音声劣化を招く。

2.1 FFmpeg concat ゼロロスシームレス結合

一時的な結合インデックスリストを生成し、ストリームコピーを実行:

# 1. 自動生成された順序付きインデックスリスト
file 'cleaned_segments/seg01.mp4'
file 'cleaned_segments/seg02.mp4'
...
file 'cleaned_segments/seg08.mp4'

# 2. ゼロオーバーヘッドストリームコピー結合を実行
ffmpeg -y -f concat -safe 0 -i concat_list.txt -c copy concat_raw.mp4
  • 所要時間:全8セグメントの結合はわずか 0.2秒、全てのフレームのオリジナル画素と音声同期を無劣化で保持。

3. 実践SOP:RealESRGAN 1080p 専有超解像度高速化

VRAM分離ポリシー:1080p超解像実行前に、ComfyUIのGPU VRAM占有を必ず解放し、RealESRGANが16GB VRAMを専有できるようにする。これにより最高のスループット速度が達成される。

3.1 産業グレード超解像推論と音声トラック多重化

scripts/upscale_video.py を呼び出し:

  • モデル:RealESRGAN_x2plus.pth;
  • 精度とデバイス:CUDA + FP16 半精度;
  • バッチサイズ:batch_size = 4(RTX 4080専有モードで、フレームレートは ~4.8 frame/s で安定、全エピソード1400フレームは約4.5分);
  • 音声保護メカニズム: 超解像前にffmpegで元ビデオの音声トラックを無劣化抽出(audio.m4a)、フレーム推論完了後に libx264 -crf 18 -c:a copy で多重化合成、90秒のサイドチェインインテリジェントダッキングBGMとクリーンな台詞を100%完全保持。

コマンド:

python scripts/upscale_video.py --input raw_video.mp4 --output final_1080p.mp4 --model RealESRGAN_x2plus.pth --width 1920 --height 1080

4. 実践SOP:最終ファイル物理パラメータ二重検収

ファイル生成後、必ず ffprobe を使用して自動化検収テストを実行:

  • 解像度厳格達成:幅1920、高さ1080(1080p未満は不合格と判定);
  • フレームレート厳格一致:24.0 fps 標準映画フレームレート;
  • 再生時間厳格一致:8セグメント × 175 フレーム = 58.33s 〜 58.35s;
  • 音声トラック完全:独立したステレオ音声ストリーム(AAC、サンプルレート44.1kHz/48kHz)を含む。

5. 専用ツールスクリプト

  • 単一ファイル1080p超解像:python scripts/upscale_video.py --input in.mp4 --output out.mp4
  • 全エピソードバッチ超解像スケジューリング:python scripts/run_episodes_1_to_8_upscale.py

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-audio-soundstage

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

drama-director-staging

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

drama-keyframe-forge

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

関連スキル