用途
color-grading 是一套调色工作流技能，用来指导 AI 或用户以专业调色师的方式对视频或图像片段进行色彩校正与风格化。核心原则是“先读示波器，再动手”，按归一化、一级校正、镜头匹配、二级校正、风格化、确认的顺序推进，避免跳过基础步骤直接套用风格导致偏色被固化。
主要能力
- 示波器检查：通过
inspect_color读取片段的亮度范围、白平衡偏移、色彩区域分布、饱和度、12 段色相直方图等数据。可指定帧（atFrame）或原始媒体（mediaRef），并支持传入参考片段（reference）以获取差距和可操作提示。 - 调色应用：通过
apply_color将参数合并到当前调色上（仅修改传入的参数），支持重置（reset:true）。参数涵盖：- 色调：曝光（−3…3 EV）、对比度（0.5–1.5）、高光、阴影、黑点、白点（−1…1）。
- 白平衡：色温（2000–11000 K，越高越暖）、色调（−100…100，正数偏绿，负数偏品红）。
- 饱和度：饱和度（0–2）、自然饱和度（−1…1，保护肤色）。
- 色轮：阴影/中间调/高光的色相（0–360°）与强度（0–1）、各区域亮度调整。
- 曲线：主曲线、红/绿/蓝曲线（[[x,y],…] 0–1），主曲线保留色度。
- 色相曲线：
hueCurves.targets[]按目标色相（约 ±22° 选择性）调整色相偏移、饱和度缩放、亮度偏移。 - LUT：
.cube文件绝对路径与强度（0–1）。
- 镜头匹配：先完整调好一个主镜头，然后对每个其他镜头调用
inspect_color(clipId, reference: <主镜头>)，读取差距和提示（如“比参考暖 → 降低色温”），反复调整至差距缩小。 - 胶片风格配方：资料提供 Kodak 2383、Kodak 2389、Fuji Eterna/3513、Kodak Portra、漂白旁路、青橙色调、复古褪色等预设参数，可应用于已归一化的片段，再根据镜头微调。需注意这些配方是近似风格特征，而非精确胶片科学；如有真实
.cube文件，优先使用lut:{path,strength:0.85}。
使用方式
工作流步骤：
inspect_color(clipId)读取示波器数据，检查亮度黑/白点、白平衡偏移、色彩区域和色相直方图。- 归一化：用曝光调整整体亮度，色温校正暖冷偏移，色调校正绿/品红偏移，再次检查使平衡接近零。
- 一级校正：设置黑/白点，用对比度、高光、阴影塑造过渡，调整饱和度或自然饱和度。
- 镜头匹配（如需要）：调好主镜头后，逐个镜头与参考比较并数值化缩小差距。
- 二级校正：通过
hueCurves.targets调整特定色相（如加深天空不影响肤色）。 - 风格化：使用色轮分离色调、主曲线胶片趾部、LUT 或手工构建胶片风格。
- 再次
inspect_color确认黑/白点接近 0/1 且无明显裁切，白平衡中性（除非有意调色），肤色位于橙色区域。
适用场景
- 视频或图像片段的专业色彩校正与风格化。
- 多镜头素材的色调匹配，确保一致性。
- 模拟胶片风格（如 Kodak、Fuji 等）或创建青橙色调等流行风格。
- 需要基于示波器数据而非仅靠预览进行客观调色的工作流。
限制
- 资料未说明该技能的具体平台依赖、安装方式或收费模式。
apply_color仅适用于视频和图像片段（clipIds必需）。- 胶片风格配方为近似效果，不能替代真实 LUT 的精确性。
- 曲线点为分段线性，范围外被钳制为平坦，需包含接近 [0,0]/[1,1] 的端点，除非有意裁切。
- 调色变更返回时间线增量（包括更新后的颜色），建议基于增量修补，而非每次调整后重读整个时间线。
- 预览可能不可靠，应以示波器数据为准进行平衡判断。