用途
该技能用于 Blender 5.x 的合成器（Compositor）工作，目标是从 Cycles/Eevee 渲染结果生成最终成品画面（beauty composite），并完成调色、辉光、暗角等后期处理，以及渲染通道的重组与交付输出。
主要能力
- 辉光/泛光（bloom、glow）：在 Blender 5.x 中，EEVEE 内置 bloom 开关已在 4.2 移除，5.0 起合成器迁移到 scene.compositing_node_group，bloom 由合成器 Glare 节点实现，其类型为菜单输入插槽。
- 调色（color grade）：曝光、色彩平衡（AgX 感知）、lift/gamma/gain、饱和度等。
- 渲染通道重组：支持 Beauty/Combined、DiffCol/DiffDir/DiffInd、GlossDir/GlossCol、Volume、Cryptomatte Object/Material、Mist 等通道。
- 暗角（vignette）、镜头畸变（subtle）、眩光（fog glow/streaks）等效果。
- 输出：OUT_Beauty_[Shot]，可选 OUT_Alpha、OUT_CryptoID；归档优先 EXR，审阅用 PNG/JPEG。
使用方式
工作流：启用所需通道 → 渲染多层 EXR（或所需通道）→ 合成器节点图 → 调色 → 特效（glare/fog glow）→ 输出查看器 + File Output → 校验曝光。
脚本 scripts/comp_grade.py 可在 Blender 5.2 LTS 上通过官方 Blender MCP 测试，使用 execute_blender_code 运行（或无头运行，参见 blender-mcp-workflow 技能）；运行前请阅读脚本头部了解每个参数。当用户自行在 Blender 中粘贴代码时，应提供带该脚本绝对路径和其 ARGS 的简短 runpy 调用，不要内联或重写脚本。
调用示例：
import runpy
result = runpy.run_path("<skill_dir>/scripts/comp_grade.py", init_globals={"ARGS": {...}})["result"]
ARGS 参数：preset、vignette（0-1）、warmth（-1..1，暖/冷高光）、posterize（每通道颜色步数）。例如“subtle vignette with warm highlights”为 {"preset": "clean", "vignette": 0.35, "warmth": 0.4}。
脚本依赖的 Blender 5.2 合成器事实：节点设置是输入插槽（Color Balance Type、Blur Size 为二维向量、Ellipse Mask Size）；没有 MixRGB 节点，应使用 ShaderNodeMix 且 data_type = "RGBA"（其 Factor 插槽为 NodeSocketFloatFactor）。
适用场景
- 从 Cycles/Eevee 生成最终 beauty 合成。
- 调色、眩光、暗角、细微色差处理。
- 通道重组（diffuse、glossy、volume、cryptomatte）。
- 镜头交付板（shot delivery plates）。
限制与约束
必须：在视图变换感知管线（AgX）上调色；保持创意特效在节点图中可逆；记录曝光/外观设置。
禁止：为 Blender 5.2 之前的版本编写代码或片段，或添加版本回退——该插件面向 5.2+，旧分支会教用户已不存在的 API；压暗黑场以掩盖灯光问题；对每个亮像素过度眩光；将多层文件仅扁平化为 JPEG 作为唯一归档。
参考指南：references/pass-stack.md（通道栈）、references/grade-presets.md（调色预设）、references/delivery-outputs.md（交付输出），按需加载。