Veyra-NRVideo 完整便携测试包实战:VFG 2X–8X 档位、AMD NR 实验运行时与无损瘦身的验收路径
Veyra-NRVideo 完整便携测试包实战:VFG 2X–8X 档位、AMD NR 实验运行时与无损瘦身的验收路径
这份指南以 Veyra 2.0.2 本地完整测试包(2.0.2-slim-20261004)的使用说明为骨架,讲清楚三件事:怎么正确解压并运行这个无需安装 Python / SDK 的便携包;包内 VFG 补帧与 AMD NR(lmxxf)两条实验路径各自的真实能力边界;以及"去掉未用 NPP + 换无损压缩"带来的体积变化到底减少了什么、没有减少什么。读完你能独立完成一次可核验的本地测试,并知道哪些结论有证据、哪些仍是未验项。
一、这个包是什么,不是什么
原文档 RUNTIME_SIZE_USER_GUIDE_2026-10-04.md 给出的定位非常明确:这是一个本地实验测试候选,没有 merge main、没有 push、没有 GitHub Release。许可证与逐文件 manifest 随包提供,交付目录中的 DELIVERY.md / DELIVERY.json 是最终完整包大小、SHA、验证结果与源码存档索引。
因此阅读本文时请先建立两个预期:
- 包是完整可运行载荷,解压即用,不需要安装 Python、OpenCV 或开发 SDK;但它不是正式发布版本,也不构成对任何硬件的通用兼容性承诺。
- 包内的"瘦身"是打包与依赖层面的裁剪,不是模型量化、不是精度降级、不是功能删减。对应验收记录见 RUNTIME_SIZE_ACCEPTANCE_2026-10-04.md。
本轮同时带上了若干修复:Xbox 音频/重连、导出码率编辑、RTSS 兼容背景与 NVIDIA App 误检测修复、AMD NR、VFG 全部 2X–8X / 低中高质量档位,以及极简窗口右侧像素缺口修复。历史 2.0.2 版本号并未作为正式新发布升级。
二、获取与解压:先分清 7z 与 ZIP
包提供两个载荷完全相同的归档:
| 产物 | 压缩方式 | 大小 | SHA256 |
|---|---|---|---|
首选 .7z |
LZMA2,256 MiB 字典 | 523,327,604 bytes(499.08 MiB) | dcb38d16f59d9578b66d1f759092c2d5dd5c95606c3411c863cd5eb5fea5d94f |
备用 .zip |
deflate level 9 | 943,265,095 bytes(899.57 MiB) | 40b44bfea5d358fa94cc9cb6bbd303e11c18cc861471847c2bed9086bd3c4b98 |
关键操作约束(原文档第 4–5 行,务必照做):
- 解压到一个新目录,不要在原测试包目录里直接覆盖文件;旧包保留作回退。
- 7z 必须用支持 LZMA2 的解压软件完整解压后再运行;不能只把压缩包里的 EXE 拖出来直接双击——那样运行时找不到同目录的 DLL、QML 与 shader 资源。
- ZIP 与 7z 功能与载荷相同,选任意一个即可;7z 只是更小的下载体积。
关于 7z 字典,验收记录里有一句容易被误读的说明:32 MiB 字典的 7z 是 728,771,789 bytes,256 MiB 字典进一步省下 205,444,185 bytes(28.19%);大字典之所以有效,是因为两份 NR DLL 按 1 MiB 对齐后有 146,966,128 / 165,840,496 bytes(88.62%)内容相同,跨文件复用压缩窗口。解压时会额外占用约 256 MiB 的字典内存,运行时的显存/内存不因此变化。这也是为什么 ZIP 备用包要保留。
三、跑起来之前:目录结构与启动顺序
解压后得到形如 Veyra-2.0.2-slim-20261004-win64-portable 的目录,入口是目录根下的 veyra_qml_ui.exe。从打包脚本 runtime-size-stage.py 与验收记录可以确认包内几个关键位置:
runtime/nvidia-vfg/:VFG 运行时 DLL,本包只保留五个(见第五节)。runtime/amd-nr/:AMD NR(lmxxf)运行时、权重与 HIP 内核资产,含amd-nr-local-manifest.json。runtime_local/amd/fidelityfx/、runtime_local/intel/experimental/:AMD FidelityFX 与 Intel XeSS 的独立运行时,由打包校验白名单单独放行。shaders/:QML 播放链路需要的着色器。package-manifest.json:逐文件 size + sha256 清单,是自查的第一手依据。LOCAL-TEST-PACKAGE.md:即本文所依据的用户指南副本。
打包脚本对载荷做了严格白名单:禁止出现 logs、captures、qml-tests、.git、third_party_local 目录,禁止携带用户数据(user-data / qml-preferences / last-applied / presets.v1),只允许一个可执行文件 veyra_qml_ui.exe,也不允许任何 qt6test / qmltooling 测试开发依赖。校验逻辑在 package-qml-release.py。这解释了一个常见现象:你在测试目录里累积的日志、预设不会被打进包,也不会污染下一轮测试。
启动建议顺序:
- 解压 → 2. 校验
package-manifest.json与文件实际 size/SHA(可选但推荐)→ 3. 双击veyra_qml_ui.exe→ 4. 先在专业页或节点页确认后端枚举正常 → 5. 再切到 VFG / AMD NR 等实验后端做短测。
四、VFG 补帧:2X–8X、三档质量与"提交 FPS 不是屏幕 FPS"
原文档对 VFG 的描述集中在三点:专业列表用"补帧"选择 NVIDIA VFG,节点模式同源,默认中档;仅 RTX 40/50 范围,本机仅 5070 短测;高档 8X 开销大,预览可能按预算降档/跳帧,离线导出完整处理;提交 FPS 不是物理屏幕 FPS。
这三点在源码里都能找到对应实现。初始化入口是 VfgBackend::initialize,签名同时接收 multiplier 与 quality,随后在 VfgBackend.cpp 中由图描述 desc_.fgMultiplier / desc_.vfgQuality 透传:
if(!vfgBackend_->initialize(context_,desc_.runtimeAbsPath,workW_,workH_,outputFormat(),
desc_.fgMultiplier,desc_.vfgQuality,
desc_.vfgAsyncSubmission,desc_.vfgFastFallback))return false;
质量档在设置层被定义为 0–5 共六个取值,并且在 EnhancementSettings.h 中用 vfgMixedQuality() 区分纯档与混合档:
inline constexpr uint32_t kVfgQualityCount=6;
constexpr bool vfgMixedQuality(uint32_t quality){return quality>=3&&quality<kVfgQualityCount;}
按头文件注释,混合档会在同一条 CUDA 流上再加载第二个 effect / 第二个模型,用于同一帧对里不同子帧采用不同模型。这与用户侧"低 / 中 / 高质量"三档的界面语义是两套粒度:界面面向人,vfgQuality 面向执行器。理解这一点,才不会把"低中高"直接映射成内部 0/1/2 而不解。
"预览可能按预算降档/跳帧"对应的机制是 vfgFastFallback:在 4K 下第二个(更快的)模型约需 1.9 GB,与已选模型相当,因此代码要求显存预算至少多出 4.3 GB 才尝试加载,否则直接跳过并记录日志:
const bool fastFits=context.videoMemoryInfo(memoryBudget,memoryUsage)&&
memoryBudget>memoryUsage+(uint64_t(4300)<<20);
if(fastFallback&&!p.mixed&&quality>0&&!fastFits)
log::info("vfg",std::format("fast model not loaded: budgetMB={} usageMB={}",...));
加载失败也只降级为"选定模型跑每一对帧",不会让整条链失效,注释写得很清楚:Without it the chosen model runs every pair, so a failure here costs nothing else. 这就是"预览降档"的工程实现,而离线导出走同步路径、逐帧处理,因此不丢源帧。
还有一条与档位相关的设置是 vfgAutoRegulate(界面名"VFG 自动调控"):仅对实时 2X 生效,当选定模型赶不上刷新或超出预算时,用下一档更快的模型跑该帧对;默认关闭,属于 shell 级偏好(EnhancementSettings.h)。
最后强调原文档那句提醒:界面显示的提交 FPS 是编码/提交速率,不等于物理显示器刷新率,也不等于端到端延迟。验收范围内"物理显示节奏/端到端延迟"被明确列为未验项。
五、AMD NR:RX 9000 · lmxxf(实验) 的真实边界
原文档对 AMD NR 的表述是全篇最需要逐句对照的部分:
RX9000 的 NR 版本显示"RX 9000 · lmxxf(实验)",资产位于
runtime/amd-nr。NVIDIA 显卡继续显示三个 NVIDIA NR 版本;AMD 模型不会在 5070 上获得运行支持。AMD 内部最高 1080p 预算,不支持 HDR/超预算原生 4K NR 导出。需要 AMD 驱动自身的 HIP 运行支持。资源/ABI 已校验,RX9000 推理和长稳仍需实卡反馈。
逐条落到代码:
(1)1080p 预算。lmxxf 后端对输入格式与像素预算做硬性拒绝,见 LmxxfNrBackend.cpp:
if (!admits(uint32_t(desc.Width), desc.Height) || desc.Format != DXGI_FORMAT_R16G16B16A16_FLOAT) {
error_ = "lmxxf NR needs linear RGBA16F, height <=1080 and <=1920x1080 pixels (width <=2560)";
即:线性 RGBA16F、高度 ≤1080、总像素 ≤1920×1080,宽度上限 2560。协议层同样约束,见 Rdna3NrProtocol.h:
constexpr bool validExtent(uint32_t w,uint32_t h){return w&&h&&w<=2560&&h<=1080&&uint64_t(w)*h<=1920ull*1080;}
所以"内部最高 1080p 预算"不是产品页上的软限制,而是入口处的校验;超预算的原生 4K NR 导出会被明确拒绝,而不是悄悄降质跑。
(2)需要 AMD 驱动自身的 HIP 运行支持。lmxxf 运行时通过 amdhip64_7.dll 这类 HIP 库执行内核,而不是 CUDA。这意味着在一台 NVIDIA 卡机器上,资产即使被复制过去也没有可用的执行后端;包内因此保留三个 NVIDIA NR 版本供 NVIDIA 卡使用,AMD 模型不会在 5070 上"获得运行支持"。
(3)崩溃防护走子进程预检。这是文档没展开、但源码里很关键的一层:AmdHipPreflight.h 记录了一次真实故障——RX 9060 XT(gfx1200,驱动 32.0.32015.12012,amdhip64_7.dll 10.0.3683.0)上首次 hipStreamCreate 时 HIP 内部线程空指针读取,导致整个播放器崩溃(2.1.2 与 2.1.3 共 14 次)。因此 HIP 只在子进程(--amd-hip-preflight)先完成同一串首调用后才进入主进程:D3D12 设备、父进程的 GPU 调度优先级类、hipInit、按 LUID 选设备、hipSetDevice、hipStreamCreate,以及一次在该流上清零的小分配。子进程崩溃不会带走播放器;当前调度类失败时依次尝试 High、Normal,全部失败则拒绝 AMD NR 并给出失败步骤,而不是崩溃。
(4)ABI 与布局已验证,推理未验。验收脚本 runtime-size-amd-audit.py 用 ctypes 加载 LmxxfNrRuntime.dll,断言 LmxxfNrGetApi(1, &api)==0、api.abi==1、api.size==144(16 个函数指针 + 2 个 uint32),只调用 QueryCapabilities、Create、Destroy,刻意不调用 PrepareSession、不执行 HIP:
# The upstream Create function validates assets but does not dereference the
# device/queue until PrepareSession. Do not call PrepareSession or execute HIP.
同脚本校验 186 个权重、62 个 .hsaco HIP 内核,以及 amd-nr-local-manifest.json 的逐文件 size/SHA(上游 78f5487...)。这就是"资源/ABI 已校验,实卡推理仍需反馈"的确切含义:caps 里的 hip 为 0,本机没有 RX 9000,因此不能声称 AMD 画质、性能或稳定性通过验收。
六、瘦身做了什么:九个 NPP DLL 与"不动的字节"
这是本轮最容易被误解的部分。原文档第 16–17 行写:
VFG 仅去掉当前路径未用 NPP,不改插件/质量档;AMD 生产表/权重/两种 HIP 架构保留原字节。无损压缩只减少传输大小;模型解压后仍占原空间。
VFG 侧。运行目录从 497,894,432 bytes(474.83 MiB)降到 210,788,400 bytes(201.02 MiB),移除九个未使用的 NPP DLL,共 287,106,032 bytes(273.81 MiB,57.7%)。保留的五个文件是:
cudart64_12.dll
NVCVImage.dll
nvngxruntime.dll
NVVideoEffects.dll
nvVFXVideoFrameGeneration.dll
这个五元组在代码里是显式常量,见 VfgBackend.cpp:
// VFG consumes our encoded shared CUDA buffers directly. Create/Init wrap
// these pixels without NvCVImage_Transfer or other NPP conversion effects.
// Keep the original core/plugin/CUDA bytes; unrelated SDK image-processing
// DLLs are not dependencies of this path (native 8/10-bit tests cover it).
const std::array<const wchar_t*,5> dependencies={L"cudart64_12.dll",L"NVCVImage.dll",
L"nvngxruntime.dll",L"NVVideoEffects.dll",L"nvVFXVideoFrameGeneration.dll"};
判断"不需要 NPP"的依据不是猜测,而是三点证据链:PE import / delay-import 表里没有 NPP;实际进程模块枚举只看到这五个组件;720p 与 3840×2160 各 463 项 native 检查(RGBA8 / RGB10A2、三质量、2X–8X、七张输出互不相同、切镜 identity、参数拒绝、设备存活)全部通过。模块枚举脚本见 runtime-size-modules.py,它只对自有测试子进程调用 EnumProcessModulesEx,不会枚举用户进程。
需要特别说明的边界:207 MB 的 VFG 插件本身是必要运行组件,没有拆 PE、没有量化模型;全部 2X–8X 与三档质量均保留。84 KB 的小型 nvngxruntime 也没有为了多省几十 KB 而裁掉。
AMD NR 侧。615,032,656 bytes(586.54 MiB)原件不变,186 权重、2 个映射表、62 个 HIP 内核及原有回退全部保留。两个大表不要手痒删除:
noise.f32(201,326,592 bytes):模型输入噪声表;normalized-output.f32(33,554,432 bytes):时域采样 reciprocal 表。
上游生产路径实际读取它们,删掉会直接破坏运行。验收还发现仅有两对 7 KB 的 shader 完全重复,但它们的别名是既有路径合同,为几 KB 去改上游加载不划算,因此保留。默认 skip blocks 也不能作为删权重的依据——其他设置/回退仍可能用到,本机无 RX 9000 无法证明安全。
七、无损压缩的语义:只减传输,不减还原体积
原文档第 26–29 行给了小样本对照:450,593,392 bytes 的样本(AMD 两大表 + 一权重 + VFG 插件),ZIP9 为 277,853,065 bytes,7z LZMA2/32 MiB 为 166,108,485 bytes,比同样本 ZIP 小 40.2%。并明确提醒:样本不能冒充完整包大小。
完整包的真实数字在上一节的表里:原完整 VFG ZIP 1,151,602,649 bytes(1098.25 MiB)→ 首选 7z 499.08 MiB,传输体积减少 54.56%。这句话的正确解读是:裁掉未用依赖 + 换无损压缩格式共同作用的结果,不能说"AMD 模型本身缩小了 54.56%"。
三个必须记住的语义点:
- 7z 只减传输大小,AMD 解压后的资源量没有减少;
- 每个文件还原后必须匹配原 SHA 与 size,归档脚本 runtime-size-archive.py 会先建 ZIP,再建 solid LZMA2 的 7z,然后把 7z 完整解压到
verify/目录并逐行比对 manifest; - 不引入运行时自解压、不下载依赖、不裁剪显卡架构、不降低精度。
归档脚本的校验强度值得一读(去掉适配路径后的核心逻辑):
for row in manifest['files']:
p=app/row['path']
assert p.is_file() and not p.is_symlink()
assert p.stat().st_size==row['size'] and pkg.digest(p)==row['sha256'], row['path']
除 SHA 外还断言非符号链接、名称集合与 manifest 完全一致(多一个文件也失败)。另有一轮 runtime-size-dense-archive.py 评估更激进的密集字典方案,其审计结果在交付里只作 comparisonOnly 参照,不参与最终首选判定。
八、验收证据与自查清单
原文档第 27–29、23 行指向交付目录的 DELIVERY.md / DELIVERY.json。生成这两个文件的是 runtime-size-delivery.py,它不是"把数字写进报告",而是一串断言式汇总:归档 SHA 与大小必须等于选中的压缩方式结果、clean-smoke 必须两条结果、native 归档检查必须 pass、720p 与 4K 两次 native 必须 returncode 0、导出必须 21 条全部 exit 0、UI 包测 4 条中前 3 条 0 退出、源码隔离项全真、源码归档 commit 之后的产品代码改动必须为空。
自查时可以照这个顺序核对包与证据:
| 核查项 | 位置 | 期望 |
|---|---|---|
| 文件完整性 | package-manifest.json |
每个文件 size/SHA 与清单一致 |
| 应用身份 | veyra_qml_ui.exe |
88597f61c8d01105533927859726815aaf3c67034e71bddf17852fb13c341bfc |
| 归档身份 | .7z / .zip |
与第二节 SHA 表一致 |
| VFG 依赖集合 | runtime/nvidia-vfg/ |
只有五个 DLL,vfg-runtime-manifest.json 标记 vfgOnlyDependencySet |
| AMD 资产 | runtime/amd-nr/ |
186 权重 / 62 .hsaco,逐文件 SHA 通过 |
| 交付索引 | DELIVERY.json |
localOnly:true、releaseReady:false、amdInferenceVerified:false 等标记如实 |
注意交付记录中的自限标记:hardware 为 RTX5070 / 616.56,而 rtx40Verified、xboxHardwareVerified、amdInferenceVerified、hdrPrChanges 均为 false。这些字段的存在本身就是这个项目"不把短测通过外推"的证据。
九、HDR / Dolby Vision 为什么不在这个包里
原文档第 19–21 行说明:本轮 HDR/Dolby Vision PR #13/#14 仅审查,没有实施或并入,方案在 docs/HDR_DOVI_PR_REVIEW_2026-10-04.md(仓库内实际路径为 HDR_DOVI_PR_REVIEW_2026-10-04.md)。计划中的三件事是:输入自动识别、处理区唯一 HDR 效果卡、输出状态与显示校准。
实施顺序也有明确前置:先修 P5 的精确颜色/亮度统计与 reset,再做预设/worker 兼容与 UI,取得参考与实机证据后按用户批准范围合并。交付脚本里对应字段是 hdrPrProductChanges:false 与 hdrPlan 指向该评审文档——这说明包里没有任何 HDR 色度相关改动,遇到 HDR 相关问题不要往这个包上归因。
十、未验清单与复现位置
原文档最后一节是全文价值密度最高的部分,请完整保留其含义:
未验项包括:RX 9000 实际推理 / 颜色 / 性能 / 长稳;Xbox 真机有声 / 长稳;RTX 40 实卡与 616.92 驱动;HDR 色度;实显示器 DPI 移动;物理显示节奏 / 端到端延迟;VFG 影片画质 A/B 与长稳。软件短测通过不外推这些项目。原高倍率 High 预览预算/跳帧行为保留,离线导出不丢源帧。
复现方式(来自验收记录):运行 python -B scripts/acceptance/runtime-size-*.py;本轮所有 build/tests/logs/tmp/test-packages/verify/archives 落在 E:/项目/Veyra/<用途>/runtime-size-20261004。这些路径是原作者机器的绝对路径,脚本中同样写死为 BASE=Path('E:/项目/Veyra'),在你的机器上复现前需要先改这一行,否则 stage/archive/delivery 会找不到目录。
还有两条容易被忽略的边界:
- 模型 / DLL / SDK 不进源码 Git。
runtime-size-archive.py的source分支会断言仓库索引中不存在.dll/.exe/.onnx/.f32/.hsaco/.csr等运行载荷,再git archive生成源码 ZIP;固定来源与许可证原样保留,但完整第三方源码公开发布审计不在本地交付范围。 - 清理本轮中间压缩包与测试副本的操作曾被自动审批策略拒绝(仅返回
blocked by policy)。命令未执行、未重试、未绕过,副本保留在 E 盘 task 目录,不影响交付与核验。这也是为什么报告里不会出现"已删除"这样的表述。
十一、常见问题速查
双击 EXE 报缺少 DLL / QML 模块:几乎都是没解压就运行,或从 7z 里把 EXE 拖出来单独跑。完整解压到新目录后从根目录启动。
7z 解压报错或校验不过:换用支持 LZMA2 的工具并确认磁盘剩余空间足够(解压后载荷约 2 GB 量级,另加字典内存);也可直接用 ZIP 备用包,两者载荷一致。
VFG 8X 高质量预览卡顿:属于预期。高档 8X 开销大,预览可能按预算降档/跳帧;离线导出仍逐帧完整处理。可先切回中档确认基线,再打开"VFG 自动调控"观察实时 2X 是否更稳。
VFG 初始化失败并提示 compute capability:日志中会明确写出 Windows VFG requires SM86 (experimental), Ada or Blackwell(VfgBackend.cpp),同时会校验 CUDA 与 D3D12 的 LUID 一致(不一致时报 CUDA/D3D12 adapter LUID mismatch)。多显卡机器上要确认渲染与 VFG 落在同一块卡。
AMD NR 选项出现了但启用后失败:这是设计内的拒绝路径。先看日志中是否有 HIP 预检失败的步骤名(调度类 / hipInit / 设备 LUID / hipStreamCreate / 分配),再确认分辨率是否超出 1080p 预算、格式是否为线性 RGBA16F、以及是否是 AMD 显卡 + 对应驱动。NVIDIA 卡上不会获得 lmxxf 运行支持。
导出中途缺 cudart64_12.dll:验收里专门测过这一例——记录 LoadLibrary 失败、exit 1、不产生最终文件。这是正确的拒绝行为,不是"导出成功但文件为空"。
想确认包有没有被改过:比对 package-manifest.json 的逐文件 SHA,以及 DELIVERY.json 里的 appSha256 与归档 SHA。任何不匹配都意味着载荷不是这次交付的原始字节。
整篇文档的核心可以压缩成一句话:这个包的"小"来自删掉当前路径不加载的九个 NPP DLL 与换用 LZMA2 无损压缩,而模型、权重、HIP 内核、质量档位与 2X–8X 能力全部保持原字节;它的"可信"来自 runtime-size-*.py 这一整套断言式验收与 DELIVERY.json 里那些如实写着 false 的未验字段。按第二节的姿势解压、按第三节的顺序启动、按第八节的清单核对,你就能复现出一份可被他人复核的测试结论。