Communitygithub.com

umangkaushik17-bit/基礎色彩平衡與膚色保護

標準化曝光值、中和白平衡色偏、保護膚色IRE範圍,並使用OpenCV虛擬示波器和Premiere Pro Lumetri基本校正來比對B-roll片段與A-roll主鏡頭。在套用任何創意LUT或風格調色前觸發此技能。

基礎色彩平衡與膚色保護 是什麼?

這是一個專為Premiere Pro調色流程設計的AI輔助技能,其核心目標是在套用任何創意風格或LUT之前,先完成鏡頭的基礎色彩平衡與匹配。它透過OpenCV虛擬示波器腳本,從影片片段中匯出代表幀,並分析亮度IRE分佈、RGB偏移、膚色指標與環境飽和度等數據,自動計算出數學上合理的Pass 1基礎校正參數(曝光、色溫、對比等)。 此技能特別適用於處理Log/Flat素材、曝光不足的片段、室內鎢絲燈或室外藍色色偏等情況。它首先使用虛擬示波器腳本排除黑邊(letterbox/pillarbox)對黑點與中間調的干擾,並輸出包含活躍區域、亮度IRE、RGB Parade色偏、膚色IRE(55-70 IRE)以及環境飽和度的JSON報告。 在Pass 1階段,它會為每個片段套用基礎的Lumetri Color效果,確保高光安全(當p99_white > 94.0時,曝光值不超過0)。Pass 2階段則透過`match_delta_to_hero`參數,將所有B-roll片段與指定的A-roll主鏡頭進行曝光、色溫、色調、對比、高光、陰影與飽和度的差異比對,使所有片段在進入創意調色(Track V4)之前,擁有統一且協調的基調。 此技能支援Premiere Pro工作流程,並整合在一個提供Python腳本與JSON數據交換的框架中,適合希望透過數據驅動方式加速前期色彩校正的剪輯師或調色師。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umangkaushik17-bit/ReferenceEditTemplate/tree/HEAD/.agents/skills/balancing-primary-color-and-skins

在你喜歡的 AI 中提問

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

說明文件

基礎色彩平衡與片段匹配技能

何時使用此技能

  • 在Premiere Pro中套用任何創意風格或藝術調色之前。
  • 當A-roll談話頭片段與B-roll切出畫面的光線、曝光或色溫不匹配時。
  • 當原始素材看起來灰濛濛(Log/Flat)、曝光不足,或帶有室內鎢絲燈/室外藍色色偏時。

步驟1:執行虛擬示波器遙測(僅限活動畫面)

  1. 從時間軸上的每個片段匯出代表性幀(或直接指向02_analysis/clip_frames/中的片段幀資料夾),然後執行:
    python .agents/skills/balancing-primary-color-and-skins/scripts/virtual_scopes.py --frames_dir 02_analysis/clip_frames --output 02_analysis/color_telemetry.json --match_to <hero_clip_stem>
    
  2. 預設情況下(auto_crop_active=True),extract_active_region會自動移除靜態的黑邊(信箱/立柱/窗盒)條,然後再計算IRE百分位數,這樣黑邊就不會將p01_black或p50_mid拉低到零。僅在檢查明確的全幀遮罩板時傳遞--no_crop_active。
  3. 閱讀02_analysis/color_telemetry.json:
    • active_region:經驗證的裁剪邊界框 [x, y, w, h] 與 full_size 的比較。
    • luma_ire:p01_black、p25_shadow、p50_mid、p75_high、p99_white、dynamic_range。
    • rgb_parade_cast:中性中間調中的 r_bias、g_bias、b_bias。
    • skin_metrics:skin_detected、skin_luma_ire(55-70 IRE)、YCrCb偏移。
    • environment_metrics:mean_saturation_pct、green_fraction、sky_blue_fraction、warm_fraction。
    • recommended_primary_lumetri:數學推導出的Pass 1值(當 p99_white > 94.0 時,強制執行高光安全 exposure <= 0)。

步驟2:套用Pass 1基礎標準化(軌道V1和V2)

在套用任何全局軌道 V4 創意調色之前,透過基礎的 Lumetri Color 效果,對每個片段套用其 recommended_primary_lumetri 基準值。

步驟3:Pass 2鏡頭間比對(match_delta_to_hero)

使用 --match_to <hero_clip> 指定主要的A-roll主鏡頭,並對所有切出畫面和多條面板套用 match_delta_to_hero(包括 exposure_delta、temperature_delta、tint_delta、contrast_delta、highlights_delta、shadows_delta、saturation_delta),使所有片段在進行 V4 軌道樣式設定之前,擁有統一的曝光、色溫和綠色植物飽和度。

相關技能