Communitygithub.com

drama-finishing-upscaler

Kurzdrama-Industrialisierungspipeline · Schritt 5: Endfertigung und 1080p-Upscaling. Zuständig für verlustfreies Zusammenfügen aller Szenen und kinoreifes 1080p-Upscaling.

Was ist drama-finishing-upscaler?

Dieses Skill ist speziell für die finale Auslieferung und Qualitätssteigerung von Kurzdramen konzipiert. Es führt einen verlustfreien, nahtlosen Zusammenschnitt mehrerer gesäuberter Szenensegmente mittels FFmpeg Concat durch, ohne eine erneute verlustbehaftete Kodierung zu erzwingen, was die originäre Schärfe und Synchronität von Bild und Ton bewahrt. Anschließend wird ein GPU-exklusives, FP16-beschleunigtes Batch-Upscaling mit RealESRGAN x2plus auf die kinoreife 1920×1080 Auflösung durchgeführt, wobei die Verarbeitungsgeschwindigkeit bei etwa 4,8 fps liegt. Die Audiospur, einschließlich intelligent geduckter Hintergrundmusik, wird während des gesamten Prozesses durch vorheriges Extrahieren und späteres fehlerfreies Muxen zu 100% intakt gehalten. Zum Abschluss erstellt das Tool einen automatisierten `delivery_report.json`, der die physikalischen Parameter des endgültigen Videos (Auflösung, Bildrate, Dauer, Audio-Stream-Integrität) mit ffprobe validiert. Das Skill ist für die Nutzung mit FFmpeg, Python-Skripten und dem RealESRGAN-Modell optimiert.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Drama Finishing Upscaler (终期成片与 1080p 超分工序)

工序定位:短剧最终交付与画质增强工序。 拒绝通用废话:不解释什么是超分辨率,只沉淀多段无损拼接语法、RealESRGAN 显存批处理加速与终片物理验收指标。


1. 运行契约与输入输出

  • 输入:
    1. 第 4 工序输出的 8 段已清洗分镜:cleaned_segments/seg01.mp4 ~ seg08.mp4;
    2. 或已完成侧链避让配乐的原画终片:[集名]_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 独占超分辨率加速

显存隔离准则:在执行 1080p 超分前,必须先释放 ComfyUI 的 GPU 显存占用,让 RealESRGAN 独占 16GB 显存,吞吐速度可达最高。

3.1 工业级超分推理与音轨混流

调用 scripts/upscale_video.py:

  • 模型:RealESRGAN_x2plus.pth;
  • 精度与设备:CUDA + FP16 半精度;
  • 批大小 (Batch Size):batch_size = 4(在 RTX 4080 独占模式下,帧率稳定在 ~4.8 frame/s,整集 1400 帧仅需约 4.5 分钟);
  • 音频保护机制: 超分前先用 ffmpeg 无损抽取原视频音轨(audio.m4a),帧推理完毕后使用 libx264 -crf 18 -c:a copy 混流合成,100% 完整保留 90s 侧链智能避让配乐与纯净台词。

命令:

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

Verwandte Skills