用途：为 Godot 3D 项目提供真实感光照与阴影、全局光照（GI）的专家级实现模式与性能约束，覆盖室外、室内、移动端与静态烘焙等场景。
主要能力：DirectionalLight3D 阴影级联（SHADOW_PARALLEL_4_SPLITS、split 距离、blend_splits）；OmniLight3D 二次衰减与范围控制；SpotLight3D 投影器（projector cookie）；VoxelGI、SDFGI、LightmapGI 与 ReflectionProbe 的选型与配置；体积雾与光柱；昼夜循环；光照预算与阴影图集优化；阴影 bias 调优；伪 GI 反弹光。
使用方式：按“黄金路径”表选择脚本，实现前必须先阅读对应脚本，不要同时加载同类脚本。室外 Forward+ 用 shadow_cascade_tuner.gd + sdfgi_probe_manager.gd；室内封闭几何用 light_probe_manager.gd + lighting_manager.gd + ReflectionProbe；移动端/兼容渲染器用 fake_gi_bounce.gd + light_lod_optimizer.gd；静态烘焙用 lightmap_bake_helper.gd；天空/环境混合用 environment_blender.gd；体积雾用 volumetric_fx.gd（局部密度加 volumetric_fog_zones.gd）。
关键限制：VoxelGI 必须设置贴合场景的 extents；阴影灯数量受限（Directional 1–2、Omni 3–5、Spot 2–4）；omni_range 不宜过大；薄墙会导致 VoxelGI 漏光；LightmapGI 为烘焙，不适用于全动态场景；SDFGI 仅限 Forward+；LightmapGI 烘焙需启用 OIDN 或 JNLM 降噪；隐藏 Light 节点不影响烘焙，需将 Bake Mode 设为 Disabled；ReflectionProbe 建议 Update Once。
适用场景：Godot 3D 游戏或应用的室外大场景、室内封闭空间、移动端性能受限项目、静态/混合烘焙、昼夜与大气效果。
暂未提供：具体版本兼容范围、安装命令与收费信息。