用途
Reference Look Calibration 是一个面向 Blender 的参考图视觉校准技能，用于在几何体与 UV 已锁定后，将最终渲染效果与提供的原始/参考图像进行匹配。它属于 look-dev 的最终阶段，负责材质、灯光、相机裁切、发光/辉光、色彩管理以及光环/HUD 风格的校准，不负责修正形状、UV 或相机取景错误。
主要能力
该技能通过脚本 scripts/look_fit_report.py 生成量化对比指标，包括：
- 物体/亮部掩码 IoU 与包围盒范围；
- 针对发光/强调资产配置的色相带掩码 IoU；
- 物体掩码下的 HSV 与 BGR 均值/标准差；
- 亮度 p95 与均值；
- 饱和度均值；
- 色相漂移。
校准按固定顺序进行：
- 相机裁切/正交缩放——在调色前必须使物体范围匹配；
- 世界/背景暗度；
- 基础材质色相/明度/饱和度；
- 发光强度与辉光颜色；
- 光环/HUD 环颜色与厚度；
- 色彩管理/曝光/伽马；
- 最终渲染叠加与指标。
使用方式
该技能依赖 MCP 后端。在首次调用 Blender 之前，需要阅读 ../text-to-blender/references/mcp-backends.md。官方建议优先使用官方 MCP 处理共享能力，并在整个任务中保持所选后端不变。配方中的工具名称属于客户端/旧版示例，需通过上述参考文档及其 agent-host 指南进行映射。
输入包括：已接受的几何体/UV 匹配报告、参考/原始图像、产品预览渲染图，以及可选的掩码叠加与多视图匹配报告。
输出包括：validation/look_fit_report.json、look 叠加图，以及更新后的材质/灯光/渲染设置。
适用场景
适用于基于参考图的 look-dev、灯光/材质/颜色校准、原始图像视觉匹配、辉光/光环/HUD 匹配、HSV/亮度/掩码匹配报告，以及几何体与 UV 锁定后的最终外观调整。
限制与硬性规则
- 不得在几何体/UV 匹配门通过之前调整灯光；
- 除非用户明确要求，不得将强调/辉光色相偏离源参考图；
- 不得用泛光、雾或过曝掩盖不匹配的几何体；
- 必须在校准前后记录 look 指标。
该技能消费 validation/multiview_fit_report*.json 与产品预览图，产出 validation/look_fit_report.json、look 叠加图以及更新后的材质/灯光/渲染设置。