基础色彩平衡与镜头匹配技能 是做什么的？
何时使用此技能
- 在 Premiere Pro 中应用任何创意风格或美学色调之前。
- 当 A 卷人物讲述镜头与 B 卷过渡镜头的光照、曝光或色温不匹配时。
- 当原始素材看起来发灰（Log/Flat）、曝光不足或带有室内钨丝灯/室外蓝色色偏时。
步骤 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> - 默认情况下（
auto_crop_active=True），extract_active_region自动剥离静态黑边（遮幅、左右黑边、窗口黑边），然后再计算 IRE 百分位，这样黑边就不会将p01_black或p50_mid拉到零。仅当检查显式全帧遮罩板时，才传递--no_crop_active。 - 读取
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 卷英雄镜头，并跨过渡镜头和多画面面板应用 match_delta_to_hero（exposure_delta、temperature_delta、tint_delta、contrast_delta、highlights_delta、shadows_delta、saturation_delta），以便所有片段在 V4 轨道风格化之前共享统一的曝光、色温和植被绿色饱和度。