MFGAdaUnlock-RenoDx 验证与排障指南：从“只显示2x“到“3x/4x画面冻结“的4个常见问题速解-开发者社区

【免费下载链接】MFGAdaUnlock-RenoDx

DLSS MFG on Ada — unlocks 3x/4x/6x frame generation on RTX 40-series cards and corrects the temporal midpoint. In-memory only.

项目地址：https://gitcode.com/gh_mirrors/mf/MFGAdaUnlock-RenoDx

点击查看免费下载

MFGAdaUnlock-RenoDx 是一款基于 ReShade/RenoDX 的 MFG Unlock 插件，能让 RTX 40 系列显卡解锁 DLSS 多帧生成（3x/4x/6x）并修正插值时间中点，全部修改仅发生在内存中。本文是一份 MFGAdaUnlock-RenoDx 验证与排障指南：教你在 MFG Unlock 面板逐项验证插件是否真正生效，并快速定位"游戏菜单只显示 2x""切到 3x/4x 画面直接冻结"等 4 个最常见问题的根因与解决步骤。

一、MFG Unlock 面板验证：6 项检查清单

验证插件是否正常工作，最可靠的方式是打开游戏内 ReShade 覆盖层 →Add-ons标签页 → 打开MFG Unlock面板。在游戏内已开启 DLSS 帧生成的前提下，逐项确认以下内容（详见 README.md 的 Verifying Operation 一节）：

#	检查项	期望状态
1	渲染器（Renderer）	已检测到（Direct3D 12 或 Vulkan experimental）
2	DLSS-G Provider	已找到，架构门控已重写（Architecture gates:Active）
3	时间修正（Temporal fix）	Blackwell framework active 或 Midpoint fallback active
4	`slDLSSGSetOptions`/`slDLSSGGetState`	已被拦截（intercepted）
5	DLSS-G 运行时状态	OK
6	`slDLSSGGetState`遥测	正在无错误采样`numFramesActuallyPresented`

其中第 3 项"Temporal fix"决定画面质量走向：如果它显示为Pending，说明插值修正没有打上去，生成的帧会全部停在时间中点——帧数上去了，但画面只是重复而非新运动。面板源码位于 addon.cpp，其开头的头注释完整说明了三道架构门控与补丁逻辑。

💡 面板底部会提示"证据是分层（layered）的"：请求被接受、驱动报告的活动倍率、provider 输出确认，是三种不同级别的证据，分别观察，不要混为一谈。

二、看懂验证状态分层：为什么"Pending"不是失败

MFGAdaUnlock-RenoDx 用一个明确的验证状态机来区分"到底生效到哪一步"，定义在 validation_status.hpp：

kWaitingForGameRequest → kNativeRequestObserved → kRequestAccepted → kDriverMultiplierActive → kProviderOutputConfirmed

RequestAccepted：插件把倍率请求发给了 Streamline 并获接受，但还没有实时证据；
DriverMultiplierActive：驱动侧报告了 2x 以上的活动倍率；
ProviderOutputConfirmed：slDLSSGGetState中numFramesActuallyPresented > 1，即确认有真实生成帧呈现——这是最高级别的确认。

注意一个常见误解：numFramesActuallyPresented是自游戏上一次状态查询以来的呈现计数，不是直接的倍率读数。它大于 1 说明生成帧确实在呈现，但精确倍率需要用 NVAPI 只读快照或外部呈现追踪（FrameView / PresentMon）交叉印证。

三、问题一：游戏里"只显示 2x"或只有 Automatic

这是最高频的排障场景：3x/4x 选项根本不出现，或强制倍率后无效。

排查步骤（按顺序执行）：

重启游戏后，在图形菜单到达前把 Frame Generation 关一次再开一次。插件只等待游戏自己提交的slDLSSGSetOptions调用——游戏菜单没打开过帧生成选项，插件就收不到请求，面板会显示"pending the next enabled slDLSSGSetOptions call"。切换开关会强制大多数游戏重新提交一次。
确认nvngx_dlssg.dll版本。在 ReShade 日志里检查实际加载的 DLL 完整路径和版本号。仍停留在 DLSS 3 时代 3.5.x 旧 snippet 的游戏里根本没有多帧生成代码，需要替换为较新的 310.x 版本（替换前先备份游戏自带 DLL）。
确认 Streamline 运行时选对了文件。如果游戏目录里放了新 DLL 但日志显示加载的是别的版本（例如 NVIDIA OTA 缓存路径ProgramData\NVIDIA\NGX\models\...），说明驱动/NVIDIA App 覆盖项生效了。此时在面板选择Prefer local runtime - disable OTA，若提示策略没到达slInit，再勾选Enable early addon loading for next restart，然后完整重启游戏。
确认面板中 Provider 与 hooks 为 active。如果 DLSS-G provider 都没找到，多半是第 2、3 步的 DLL/运行时问题。

相关设置项（写入ReShade.ini的[RenoDX.MFGUnlock]段）：ForceMultiplier=0表示尊重游戏自己的选择，设为 2–6 才是绝对覆盖；RuntimeSelectionMode控制 OTA 策略。详见 README.md 的 Settings 表格。

四、问题二：3x/4x 画面冻结或节奏不可用

面板显示 3x/4x 已生效，但一进游戏画面就卡死或帧节奏（frame pacing）彻底坏掉——这是第二高频问题。

解决步骤：

先保持 "Force legacy software flip pacing" 关闭。当前版本的 Streamline 原生 pacing 就是正常路径，不需要任何内存补丁；pacing_policy.hpp 中IsReady()的逻辑也表明：只有显式请求 legacy 软件回退时才需要打 flip-metering 补丁。
如果冻结恰好发生在高倍率（3x/4x），勾选 "Force legacy software flip pacing on next restart (compatibility)"（对应设置项ForceFlipMeteringOff=1），它会强制 Streamline 走旧版软件 pacing 回退。该选项每次会话只生效一次，勾选后必须完整重启游戏。
用 FrameView 或 PresentMon 测量最终呈现节奏，不要只看基于 Present 的应用内覆盖层曲线——普通 Present 计数可能不代表 DLSS-G 最终上屏的帧时序。

⚠️ 重启规则：本插件几乎所有选项（倍率、质量模式、pacing、运行时选择）都是"保存于下一次重启"，改动后必须完整退出并重新启动游戏，游戏内热加载不会生效。

五、问题三：3x/4x 已显示，但生成帧未被确认

菜单里选了 4x，面板也不报错，但就是不确定"生成帧真的在跑吗"。

确认步骤：

查看面板中slDLSSGGetState的结果与 DLSS-G 状态行，确认状态为 OK；
观察遥测中numFramesActuallyPresented是否超过 1——这是生成帧真实呈现的直接证据（验证状态机会据此进入ProviderOutputConfirmed）；
在改动强制倍率之前，先排查 Streamline / NGX 日志中的错误。被运行时拒绝的固定倍率会显示"The runtime rejected the addon's fixed request"并回落到游戏原值；倍率决策逻辑在 force_policy.hpp，面板会分开显示游戏请求、插件固定请求和最终生效的下游请求三者。
用外部工具复核：NVAPI 只读快照能看到驱动报告的 FG 倍率与独立翻转（iFlip）状态；PresentMon 的 Displayed FPS 能给出最终上屏帧率。

六、问题四：addon 不显示 / Dynamic MFG 不识别

addon 不出现在 ReShade 中：

确认 ReShade 安装时勾选了完整 addon 支持（本插件是.addon64，不是 effect）；
确认renodx-mfgunlock.addon64放在该游戏实际使用的 addon 目录（通常在游戏可执行文件同目录）；
在 ReShade 日志中查找 addon 加载或 API 版本错误。

Dynamic MFG 不识别或忽略目标帧率：

面板必须同时观察到：DLSS-G 310.9.1 + Streamline 2.14.1 + D3D12 + 驱动 ≥ 595.41，且运行时报告bIsDynamicMFGSupported = true。DLL 放在游戏目录旁不等于被 Streamline 选中，务必核对日志里的实际加载路径；
修改插件设置后，把游戏的 Frame Generation 关一次再开，等待下一次成功的slDLSSGSetOptions调用（面板会把改动标记为 pending）；
如果 VSync 开启，数字目标（如 100 FPS）会被 Streamline 有意忽略、改跟随显示器刷新率；自定义 Dynamic 目标需关闭 VSync；
检查 NVIDIA App 全局与按游戏的 DLSS 覆盖项、NVPI 中残留的 Frame Generation/NGX override，改完后应用配置并完整重启；
Dynamic 目前仅支持 D3D12，Vulkan 下不可用（固定倍率 MFG 仍可正常使用）。

手动安装 310.9.1 + 2.14.1 完整清单见 README.md 的 "Required installation and override checklist"。

七、进阶：用诊断工具采集证据

仓库自带一套只读诊断工具（独立的renodx-mfgdiagnostics.addon64），用于对比不同游戏/运行时配置下 Streamline 实际看到的资源、常量与状态，不修改任何游戏文件。使用要点（完整说明见 mfgdiagnostics/README.md）：

把诊断 addon 与主插件并存放置，打开MFG HDR Diagnostics面板，勾选Enable observation hooks后重启游戏；
按场景录制：先抓 HDR OFF/ON 的 2x，再抓 3x/4x，每次 10 秒自动停止，导出 JSON 到%TEMP%\MFGUnlock-HDR-Diagnostics；
做节奏/性能对比时移除诊断 addon 并重启（观察钩子本身有开销），然后用配套脚本采集 45 秒 PresentMon 数据：

.\Capture-STALKER2-FramePacing.ps1 -Case addon-4x -Run 1 .\Analyze-PresentMon.ps1 # 分析显示间隔分布与离群点

脚本与说明位于 Capture-STALKER2-FramePacing.ps1 和 Analyze-PresentMon.ps1。每个 case 建议重复 3 次（-Run 1/2/3），保持存档、镜头路线、分辨率、限帧、HDR、驱动与运行时 DLL 完全一致，再下结论。

八、排障前的两个通用提醒

首次启动编译卡顿：安装或更新插件后，第一次启动可能触发 DLSS-G 内核编译，出现短暂卡顿与节奏不均——完整重启一次游戏再评估性能与画质。个别游戏（如 Monster Hunter Wilds）需等shader.cache2编译完成后重启才有稳定帧节奏。
图像伪影（拖影/闪烁/边缘伪影）先做 A/B：先完全移除插件、用原生 2x 重启对比——伪影仍在，说明是游戏自身 DLSS-G 集成的问题，插件无法重建游戏缺失或错误的运动向量、深度、曝光或相机矩阵。再依次尝试：质量模式回到Native、HDR 类问题换Automatic Guard + UI Composition (HDR compatibility)、"Prefer full Blackwell framework kernels" 开/关对比。完整设置与默认值见 README.md，版本行为差异可对照 docs/releases/1.4.2.md 与 docs/releases/1.4.1.md。

按这份清单从上到下走一遍，绝大多数"只显示 2x"和"3x/4x 冻结"问题都能定位到具体环节。记住核心原则：面板看分层证据，日志看实际加载路径，节奏看外部工具，改完配置必重启。