ComfyUI-DLSS5-Ox：实验性自定义节点，在 ComfyUI 内接入 DLSS 5 神经渲染 NGX 接口

ComfyUI-DLSS5-Ox 是非官方实验性自定义节点包，把英伟达DLSS 5 神经渲染（NGX feature 18）集成进 ComfyUI。采用进程内 D3D12/NGX 桥接，实现零 PCIe CUDA 互操作路径、单帧预览能力；不启动额外子进程，不读写临时图片文件。

• GitHub：https://github.com/orex2121/ComfyUI-DLSS5-orex
• 网盘下载：https://pan.quark.cn/s/5575ad4ddf38

节点放置在分类 experimental → DLSS 5 NR，一共两个节点：

• 🕹️ DLSS 5 (OreX)：图像序列节点，接收IMAGE批次，输出增强后的IMAGE批次
• 🎬 DLSS 5 Video (OreX)：视频流节点，接收VIDEO输入，输出增强VIDEO，保留原始帧率、音频、元数据

⚠️ 重要警告：项目基于未公开、预发布的英伟达接口开发，不属于英伟达、Comfy Org官方项目，没有官方支持。驱动、nvngx_dlssnr.dll版本变更都可能改变运行行为，原生运行时故障有可能直接造成ComfyUI进程崩溃。

DLSS 5神经渲染是什么

DLSS 5神经渲染（NGX feature 18）属于图像视频神经增强技术。依靠神经网络对素材重加工：补充微细节、清理纹理、平衡光影色调，消除各类伪影；区别于简单重采样与普通锐化。

在AI图像/视频工作流里，它放在生成模型之后作为后处理环节，可以改善AI生成常见缺陷：塑料质感皮肤、微小烧入噪声、涂抹丢失细节，让画面更贴近真实拍摄效果。

注意：神经渲染只做素材增强，不能凭空创造新内容。最终效果取决于原图素材、NGX运行时版本、显卡与驱动组合。

核心功能亮点

• 双节点覆盖图像批次与完整视频流，共用同一套逐帧渲染管线
• 完全重写D3D12桥接层，优化ComfyUI与nvngx_dlssnr.dll之间通信，降低资源开销
• GPU适配：主力面向RTX 50、RTX40；RTX30、RTX20也可运行，速度相对更低
• 进程内原生D3D12桥接，无外部子进程、无磁盘读写往返
• 零PCIe CUDA互操作：张量在显存内完成传递，像素不离开VRAM
• 近乎实时视频处理：RTX5090处理90秒视频约耗时120秒；支持chunk_frames分块，降低峰值显存占用，长视频也能稳定处理
• 透明故障回退：GPU互操作失败时，自动切换CPU暂存路径继续工作
• 内置PTX转换内核，运行时加载nvcuda.dll，无需安装完整CUDA工具包
• 最大支持8K输出，放大倍率1x（原生DLAA）至3x（Ultra Performance）
• 丰富可调参数：渲染风格、整体强度、色调、细节结构、皮肤专项控制、自动蒙版
• 时间历史管理：自动检测场景切换重置历史，支持场景变化阈值、预热帧设置
• 分块内存优化：chunk_frames拆分长序列，时间记忆跨块保持连续，峰值显存大幅下降
• 单帧预览功能：单独处理指定帧并在画布预览，无需完整运行整条工作流
• GPU开关控制，每个控件自带英/俄双语悬浮提示

快速安装

推荐下载预构建发布包，无需编译工具链。

1. 进入项目Releases页面，下载最新 ComfyUI-DLSS5-Ox-vX.Y.Z-windows-x64.zip
2. 将压缩包内 ComfyUI-DLSS5-Ox 文件夹解压到

ComfyUI/custom_nodes/ComfyUI-DLSS5-Ox

3. 自行准备合法可用的神经渲染运行时，放入目录

ComfyUI-DLSS5-Ox/runtime/nvngx_dlssnr.dll

4. 重启ComfyUI，在节点分类找到DLSS5 NR节点。

注意：不要下载GitHub源码包，源码包不包含预编译原生桥接文件；项目不提供、不分发英伟达专有二进制文件。

桥接组件自动寻找_nvngx.dll，优先读取本地runtime目录，其次系统DLL搜索路径，还能自动识别英伟达驱动存储内对应文件，一般无需手动复制。

开发者编译（修改桥接源码才需要）

预编译桥接文件已经内置，仅修改底层D3D12桥代码才需要重新构建。仅需Visual Studio 2022生成工具，不需要CUDA工具包、NGX SDK头文件。

powershell -ExecutionPolicy Bypass -File bridge\build_bridge.ps1

基础使用方法

图像增强

1. 添加 DLSS 5 (OreX)，IMAGE输入接入上游生成节点
2. 设置upscaling_mode，按需调整强度、结构、色调等参数
3. 入队执行，节点输出增强后的图像批次

视频增强

1. 添加 DLSS 5 Video (OreX)，接入VIDEO输入
2. 参数面板和图像节点完全一致
3. 提交队列，节点自动拆帧处理，完成后重新封装视频，保留原始音轨与元数据
4. 长视频保持chunk_frames=64，0代表一次性完整加载全部帧

单帧预览调试

1. change_frame填入要预览的帧序号（0为首帧）
2. 点击节点画布上Preview按钮，单独渲染这一帧并展示结果
3. Hide按钮关闭预览。预览只测试参数，不会写入最终输出文件。

底层工作流程

ComfyUI IMAGE / VIDEO
    -> Python/ctypes
    -> dlss5nr_bridge.dll
    -> D3D12 + NGX
    -> nvngx_dlssnr.dll (feature 18)
    -> ComfyUI IMAGE / VIDEO

CUDA/D3D12内存互操作模式：显存内完成张量转换与DLSS NR运算，像素全程不出VRAM。
互操作失效时自动降级CPU路径：张量拷贝到CPU内存完成转换，再送入D3D12管线，处理完成后写回Torch张量，全程不产生临时文件、不启动子进程。

节点参数说明

两个节点共用一套参数配置：

系统要求

常见故障排查

1. 原生桥接缺失：下载的是GitHub源码包，不是预构建发布ZIP，重新下载Release资产。
2. 找不到nvngx_dlssnr.dll：将dll放到runtime/nvngx_dlssnr.dll。项目不提供该专有二进制文件。
3. 无法加载_nvngx.dll：执行PowerShell脚本检索驱动内dll，复制到runtime目录作为本地覆盖。

Get-ChildItem "$env:SystemRoot\System32\DriverStore\FileRepository" -Filter _nvngx.dll -Recurse -ErrorAction SilentlyContinue |
  Sort-Object LastWriteTime -Descending |
  Select-Object FullName, LastWriteTime, Length

4. 0xBAD00001：当前显卡、驱动、运行时组合不支持DLSS5 NGX Feature18。
5. 0xBAD00002：NGX神经渲染实例调用失败，使用原版发布包，提交完整日志排查。
6. 画面偏色、红蓝通道颠倒：节点会自动识别通道顺序，持续异常请提交错误日志。
7. 超出边界报错：输出最大支持8K，降低放大倍率或原图分辨率。

项目限制

• 非官方实验项目，依赖未公开预发布NGX接口，稳定性无保障；
• 仅支持Windows，用户必须自行准备nvngx_dlssnr.dll；
• 画质、显卡兼容性取决于NGX运行时版本与驱动；
• 1x模式仅做神经渲染增强，不是DLSS超分；
• dlss_model_preset参数保留，但当前版本不会改变输出效果；
• 驱动/NGX运行时崩溃可能直接导致ComfyUI程序退出；
• 预览模式时间历史全新初始化，只能用来调试参数，不能代表完整视频时序效果。