TheAutomatic / dlss-5-amd-project

**中文** | English | Español
# OptScaler(NR) 1.13.0-alpha8
**特别感谢**：各位用户的测试与反馈意见。
在 **OptiScaler** 上接入 **AMD 神经网络渲染**（DLSS5 on AMD），让 **纯 DLSS / XeSS 游戏** 在 AMD 显卡上跑神经网络降噪；超分辨率仍然由 **FFX/FSR** 完成。
本项目 fork 自 MatheusGViana / dlss-5-amd-project 及上游社区。在上游成熟方案的基础上持续深度研发与维护。
**项目主页：github.com/TheAutomatic/dlss-5-amd-project**
## 更新日志
UI升级、NR强度及人脸保护等多重更新，详见 Release 页
---
## 目录
- 1. 巨人的肩膀
- 2. 安装指南 (Installation Guide)
 - ├─► ⚡ 极速简易安装教程
 - ├─► 完整详细安装说明与高级选项
 - └─► 可选：3倍及以上多帧生成 (XeFG/DLSSG)
- 3. 三后端架构与历史性能实测
- 4. 游戏内设置与控制
- 5. 排错、日志定位与卸载
- 6. 署名与许可 (Attributions & Licenses)
---
## 1. 巨人的肩膀
本项目并非凭空产生，而是建立在开源图形社区众多先驱者的卓越成果之上：
| 上游与先驱 | 他们做了什么 | 本项目额外做了什么 |
|---|---|---|
| **OptiScaler** | 通用超分辨率代理框架（支持 DLSS / FFX / XeSS 输入输出） | 作为整体安装与运行主体，提供通用注入、Hook 与配置界面 |
| **Dagherbou / OptiScaler_DLSSNR** → **wilsjo2 / PreSR-Multipass** | 首次把 DLSS 神经渲染接进 OptiScaler，并提出在超分前运行多 pass 的 Pre-SR 架构 | 继承其 OptiScaler 代码基底与 Pre-SR 调度管线 |
| **MatheusGViana / dlss-5-amd-project** | 将 Pre-SR 接到 AMD 运行时：游戏 DLSS 输入 → AMD NR → FFX 超分；引入 RenoDX 的 OkLab 与双分支色调映射改善高光偏色 | 在此基础上首创**多槽调度（Multi-slot）**，消除了单槽空等 **8.7 ms/帧** 的 GPU 挂起；适配 0.3.1；补全新等待 D3D12 状态冻结/恢复；增强 XBOX PC 兼容性。**桥接开销实测仅 0.01～0.03 ms** 量级 |
| **danielblnc / DLSS-NR-on-AMD** | AMD 神经渲染运行时本体（0.3.0–0.6.0） | **不改动其核心**，按规范接口调用；并针对 0.3.1+ 的 1 像素 Draw 等待补齐状态保护，确保在 DLSS/XeSS 游戏上安全运行 |
| **lmxxf / dlss5-on-amd-9070xt-porting** | 包含 71 块网络的 AMD HIP 开源神经渲染算力核心 | **接入 OptiScaler 通用代理框架以兼容更多纯 DLSS / XeSS 游戏**；实现主队列同帧同步执行；开发标准版本化 C-ABI 独立运行时（`LmxxfNrRuntime` 并反哺合并至上游）；增加动态色彩/细节无级滑条等 |
| **Mochizuki / DLSSNR-AMD** | 纯开源 Vulkan / RDNA4 神经渲染网络核心与 SPIR-V 着色器体系 | 深度接入多后端架构并重构生命周期安全：解决跨 API 在无关游戏队列上的死等卡顿与显存泄漏；整合着色器取消机制与 26.9.2+ 驱动修复（由 @MatheusFerreiraS 提供） |
使用 danielblnc 0.6.0 的 RX 6000（RDNA2）显卡需要安装 AMD HIP 7.2 runtime。
---
## 2. 安装指南 (Installation Guide)
### ⚡ 极速简易安装教程（三后端通用）
1. **下载解压**：从 Release 页 下载本项目最新 zip 压缩包，解压至任意非中文路径。
2. **收集必备外部文件**（复制到与 `Setup.bat` 同一文件夹下，即 **1 个文件夹 + 1 个 DLL + 1 个 EXE**）：
 - `nvngx_dlssnr.dll`（NVIDIA 原生降噪动态库，支持 310.9.16 或 310.8.0 版本；310.9.16 支持小模型与双模型，310.8.0 仅支持老模型）；
 - `native-game-tiled-assets` 文件夹（lmxxf 权重目录，解压后包含权重文件）；
 - `dlssnr_on_amd_setup.exe`（Danielblnc 所需的安装/提取程序）。
 > 💡 **提示**：若计划使用 **Mochizuki** 后端，请提前在微软商店（Microsoft Store）搜索并安装 **Python 3.10+**。提取模型支持 `both`、`small`、`original` 三种选择。新小模型暂不支持 INT4，等待上游适配。
3. **运行安装器并选择游戏**：
 - 双击运行 `Setup.bat`，在弹出的窗口中选择**游戏的实际主程序运行目录**（注意：必须是游戏 exe 实际执行的所在目录，例如虚幻引擎游戏通常为 `...\ \Binaries\Win64\`，而非平台 Launcher 或外层快捷方式目录）；
 - 按交互提示选择代理 DLL（通常可选 `dxgi.dll`，无法使用时可尝试 `winmm.dll` 或其他注入方式）与后端进行安装。若检测到旧版本，推荐输入 **Y** 自动卸载后安装（避免新旧文件与配置冲突），亦可输入 **N** 直接覆盖安装；
 - 安装结束前会提示是否安装 **DLSS 伪装增强 (OptiPatcher)**：对于部分在游戏设置中无法直接开启 DLSS 的游戏，可按提示安装并自动启用。
4. **注：升级安装时无需执行步骤 2**：
 - 如果你曾经在目标游戏中安装过本项目及对应后端权重，后续升级新版本时无需执行步骤 2，安装工具将自动识别并带回安装工具所在文件夹。
---
### 完整详细安装说明与高级选项
 📖 点击展开：完整详细安装说明与高级选项（文件清单、各后端独立准备、卸载机制与手动部署） 
 📦 点击展开：压缩包内文件清单 
| 文件/目录 | 作用 |
|---|---|
| `OptiScaler.dll` | 本项目主体（安装时会自动重命名为你选择的代理名称） |
| `OptiScaler.ini` | 核心配置文件（包含 `[DlssNr]` 三后端切换与参数选项） |
| `OptiScaler\` | 核心依赖库（FFX / XeSS / Agili