nova ai实时预览黑屏是gpu加速链路未建立所致，需依次验证nvidia驱动与cuda版本匹配性（仅支持cuda 12.1–12.3）、显式设置nova_use_cuda=1环境变量、确认cyborg服务中nvidia设备已注册并绑定device profile，同时禁用geforce experience覆盖、nvidia透明度效果及windows hdr。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Nova AI实时预览黑屏时，画面完全无响应但后台服务仍在运行，说明GPU加速链路未正确建立或资源未被识别，需从驱动、服务配置、环境变量三方面逐层排查。
确认NVIDIA驱动与CUDA环境就绪
打开命令提示符（管理员权限），依次执行：
nvidia-smi → 查看驱动版本与GPU状态；若报“NVIDIA-SMI has failed”，说明驱动未安装或损坏，必须重装。
nvcc -V → 验证CUDA编译器是否可用；若提示“不是内部或外部命令”，则CUDA未安装或PATH未配置。
【CUDA版本必须与Nova AI要求严格匹配】——Nova AI 2.4.x仅支持CUDA 12.1～12.3，高版本（如12.4）会导致预览初始化失败并黑屏，低版本（如11.8）则无法调用新API。
启用Nova AI的GPU加速开关
启动Nova AI前，必须设置环境变量强制启用GPU后端：
Windows：在启动脚本或快捷方式目标中添加 set NOVA_USE_CUDA=1 → 启动程序。
Linux/macOS：在终端中执行 export NOVA_USE_CUDA=1 && ./nova-ai-launcher。
该变量不可写入系统级环境变量，必须在每次启动Nova AI的同一shell会话中显式声明，否则进程默认回退至CPU渲染，导致预览黑屏且无日志报错。
检查Cyborg加速器服务注册状态
Nova AI依赖OpenStack Cyborg服务管理物理GPU设备，若未注册，预览将无法分配vGPU资源：
第一步：执行 openstack accelerator device-list → 确认输出中存在状态为available的device，且type字段含nvidia。
第二步：若为空，需手动注册设备配置文件（device profile）：
openstack accelerator device-profile-create --name nova-ai-gpu-dp --spec "resources:VGPU=1" --spec "trait:CUSTOM_NVIDIA_TESLA_V100=required"
第三步：为Nova AI实例绑定该profile：
openstack flavor set --property "accelerator:device_profile=nova-ai-gpu-dp" ai-gpu-flavor
注意：flavor名称ai-gpu-flavor需已存在且关联了足够内存与vCPU，否则实例创建阶段即失败，预览不会启动。
禁用冲突的图形覆盖层
方法一：关闭NVIDIA GeForce Experience中的In-Game Overlay（游戏内覆盖），该功能会劫持DirectX/OpenGL上下文，导致Nova AI预览帧缓冲区被清空。
方法二：在NVIDIA控制面板→管理3D设置→全局设置→“透明度效果”设为“关闭”，避免UI合成器干扰Nova AI的自绘渲染管线。
方法三：若使用Windows HDR模式，必须在系统设置→系统→显示→HDR中关闭HDR，Nova AI当前不兼容HDR色彩空间转换，开启后必现黑屏。
