ComfyUI-DLSS5-Enhancer 是一个将英伟达DLSS 5 神经渲染能力引入 ComfyUI 的节点包，专为视频帧与图像批次的材质重建设计。它并非传统锐化或放大滤镜，而是通过原生 D3D12 进程调用 ReShade + RenoDX 附加组件及 NGX feature 18，对解码帧进行真正的神经渲染——恢复皮肤次表面散射、发丝透射、织物结构等生成式模型常丢失的物理响应。支持 1x（DLAA）至 3x 放大，运动向量由密集光流估计，场景切换自动重置历史。仅支持 Windows 平台及 RTX 30/40/50 系列显卡。

• GitHub：https://github.com/Blueforcer/ComfyUI-DLSS5-Enhancer

核心机制：从游戏到视频的适配差异

在游戏中，DLSS 5 依赖引擎提供的几何、纹理、光照缓冲区与运动向量实现“3D-Guided”重建。视频缺乏这些引导信号，因此本节点包采用以下替代方案：

• 运动向量：通过 OpenCV DIS 光流逐帧估计，分辨率匹配渲染输出
• 历史管理：亮度变化超阈值（默认 0.24）时自动重置时间累积
• Alpha 通道：四通道输入保留原始 alpha，不参与神经重建
• 验证机制：渲染后检查 ReShade 日志确认 feature-18 执行，避免静默回退到普通放大

worker 二进制文件（nvngx.dll）为第三方运行时，不包含在仓库中，需手动安装。

安装与运行时配置

1. 安装节点包

# 在 ComfyUI 便携版根目录执行
git clone https://github.com/Blueforcer/ComfyUI-DLSS5-Enhancer.git ComfyUI\custom_nodes\ComfyUI-DLSS5-Enhancer
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-DLSS5-Enhancer\requirements.txt

2. 安装运行时

python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-DLSS5-Enhancer\install_runtime.py

脚本将下载 DLSS 5 Visual Enhancer v3.0（约 467MB），解压 bin/runtime 与 bin/ffmpeg/bin 至节点目录。必须使用 v3.0，旧版本协议不兼容。

⚠️ 防病毒注意：nvngx.dll 作为可执行文件运行易被 Windows Defender/SmartScreen 拦截。若节点报告 worker 无法启动，请将运行时文件夹加入排除列表。

3. 运行时路径解析优先级

1. DLSS5 Settings 节点 runtime_dir 控件
2. DLSS5_RUNTIME_DIR 环境变量
3. config.json 中记录的路径
4. 节点包内捆绑的 runtime/ 文件夹

ffmpeg/ffprobe 单独解析，缺失时视频节点立即失败而非渲染后报错。

关键参数与推荐设置

DLSS5 Settings 核心控件

⚠️ 实测发现：

• nr_preset 在当前运行时所有选项输出逐位相同，可忽略
• nr_intensity > 1.0 无额外效果，勿盲目调高
• skin_structure_strength 仅在 automatic_mask=on 时生效

场景化起点

节点使用与工作流集成

• DLSS5 Enhance Images：IMAGE→IMAGE，批次按时间顺序输入以启用时间累积。支持取消与进度反馈。
• DLSS5 Enhance Video File：文件→文件，解码/渲染/编码并发流水线处理，保留原始时间戳、章节、元数据。MKV 可流复制音频字幕；MP4/MOV 音频重编码为 AAC 192kbps。
• 验证开关：verify_neural_rendering（默认开）确保神经渲染实际执行，失败时保留已渲染文件但标记错误。

示例工作流：

VHS Load Video → DLSS5 Enhance Images → VHS Video Combine
                      ↑
              DLSS5 Settings

性能、限制与故障排查

性能参考：RTX 5090 + 驱动 610.74，640×360→1280×720（2x Performance）：worker 启动约 4 秒，后续 ~10 FPS。长视频优先用 Video File 节点避免内存爆炸。

已知限制：

• HDR 源自动转 SDR 无色调映射，高光裁剪；建议预处理转 SDR
• 无帧数元数据的容器（MKV/WebM/VFR）触发 ffprobe 全量计数，队列暂显空闲
• 单次渲染仅一个 worker，并行执行会争抢 GPU 导致验证失败
• motion=none 仅适用于连贯序列，不相关图像需分别处理
• 输出上限 7680×4320，超限自动降级或报错
• 仅限 Windows

常见故障速查：

独立验证工具：

python_embeded\python.exe .../selftest.py --frames 5 --mode "2x (Performance)"

快速区分运行时问题与工作流配置问题。