综合集成与裁剪构建

集成范例覆盖什么

examples/xge_3d_integration 用纯公开 API 把下列能力组合运行，十五项异步资源全部完成后开始计帧：

• 模型、共享材质与静态实例、分块高度场、太阳与聚光阴影、天空、两种骨架的六类外部动作、预算加载与真实 XUI 界面。
• 应用侧导出静态三角形、过滤可行走表面、地面射线查询写回位置；验证创建/移动/删除与 1e9 全局坐标下的原点重定位——这些应用数据与规则不进 XGE。

可裁剪构建档位

档位	能力	实测体积（2026-10，x64 -O2）
core	窗口、输入、资源、GPU 底座	672,176 B
3d	三维 + 底座（关 2D/文本/音频/XUI）	873,737 B
full-dev	全部能力含三维	8,466,461 B

3D 相比 core 只增加约 201 KB。八个 XGE3D_ENABLE_* 子模块（MODEL/LIGHTING/SHADOW/IBL/ANIMATION/TERRAIN/ASYNC/FOG）可单独关闭验证依赖收敛；65 个 XUI_ENABLE_* 控件开关同理，依赖表在 tools/features.json，冲突由编译器报错。库与消费者必须同配置——构建产物自带完整 xge_build_config.h 强制对齐。增量编译实测：新增一个异步 TU 0.59 s，热构建约 0.14 s。

下一步

3D 篇到此收官。公开接口、所有权与限制的权威文本在仓库 docs/3D.md；交付实测在 docs/3D_RELEASE.md；配置细节在 docs/BUILD_PROFILES.md。祝渲染愉快。