Veyra 运行包瘦身实战:VFG NPP 依赖裁剪与 AMD NR 无损压缩验收

原创2026-11-15 16:53:051,877 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra 运行包瘦身实战:VFG NPP 依赖裁剪与 AMD NR 无损压缩验收

本篇技术指南基于 Veyra 2026-10-04 的 runtime-size 验收报告,完整还原一次“运行目录瘦身”工程:如何证明 NVIDIA VFG(Video Frame Generation)运行包里九个 NPP DLL 可以安全删除、AMD NR 的 186 个权重与 62 个 HIP 内核为何一个都不能少,以及最终如何用 LZMA2 无损压缩把完整传输包从 1098.25 MiB 压到 499.08 MiB。读完后你将掌握一套可复制的依赖审计方法(PE import 分析 + 进程模块观测 + 全量 SHA 校验),以及“裁剪依赖 + 更换压缩格式”两步走降体积的完整验收流程。

一、背景、基线与变更范围

本轮工作发生在分支 codex/runtime-size-20261004,基线 commit 为 fc2ca716,遵循“先存档/方案、后施工”的流程。变更范围被严格限定为:只修改 VFG 依赖加载与本地打包/验证脚本,没有触碰模型、HIP 内核、HDR 算法或功能档位;同时包含极简窗口像素缺口修复。HDR/DV 的 PR #13/#14 当时仍等待审批,未合并 main、未推送、未发布。

范围控制不是靠口头约定,而是靠脚本断言。runtime-size-control.py 在每个打包脚本开头被强制调用:

BASE='fc2ca7163e986f97e53dcab51ffe1ac77bb0615a'
def git(*args):return subprocess.check_output(['git',*args],cwd=ROOT,stderr=subprocess.PIPE).decode().strip()
assert git('branch','--show-current')=='codex/runtime-size-20261004'
assert git('rev-parse','checkpoint/pre-runtime-size-20261004^{commit}')==BASE
paths=set(git('diff','--name-only',BASE).splitlines())|set(git('ls-files','--others','--exclude-standard').splitlines())
extra={p for p in paths if p not in {'AGENTS.md','src/pipeline/VfgBackend.cpp'} and not p.startswith(('docs/','scripts/acceptance/runtime-size-'))}
binary={p for p in paths if Path(p).suffix.lower() in {'.dll','.exe','.lib','.pdb','.zip','.7z','.whl','.f16','.f32','.i32','.bin','.onnx','.hsaco','.cso','.ptx','.addon64'}}
assert not extra|binary,'Runtime scope violation: '+str(extra|binary)

它断言:工作区相对基线的全部差异只能落在 AGENTS.md、src/pipeline/VfgBackend.cpp、docs/ 和 scripts/acceptance/runtime-size-* 内,且不允许任何二进制文件(.dll、.f32、.hsaco、.onnx 等)进入源码树——这就是验收报告中“没有改模型、HIP 内核、HDR 算法”的可执行证明。

二、瘦身结果总览:VFG 减 57.7%,AMD 原样保留

验收给出的核心数据表如下(字节级精度):

部分 原运行目录 新运行目录 处理
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%)
AMD NR 615,032,656 bytes(586.54 MiB) 同原件 186 权重、2 映射、62 HIP 内核及原有回退保留

为什么 VFG 的 NPP DLL 可以删

原 VFG 包把通用 CUDA/NPP 图像处理库整体打进了运行目录,但 Veyra 的 VFG 后端并不走这条路。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"};

后端启动时只 LoadLibrary 五个 DLL:cudart64_12.dll、NVCVImage.dll、nvngxruntime.dll、NVVideoEffects.dll、nvVFXVideoFrameGeneration.dll,然后分别绑定 NvVFX_* 与 NvCVImage_* 的公开 C API。它通过 D3D12 共享句柄导入已编码的 CUDA buffer(cuImportExternalMemory + 共享 ID3D12Fence 做同步),不经过 NvCVImage_Transfer 或任何 NPP 转换效果。运行目录的解析逻辑同样只依赖这三个关键文件:

bool VfgBackend::runtimeAvailable(const std::wstring& root){
    const auto directory=runtimeDirectory(root);
    return !directory.empty()&&regularFile(fs::path(directory)/L"NVVideoEffects.dll")&&
        regularFile(fs::path(directory)/L"NVCVImage.dll")&&
        regularFile(fs::path(directory)/L"nvVFXVideoFrameGeneration.dll");
}

(VfgBackend.cpp)

“PE import/delay-import 与实际进程模块检查一致”是删除决策的三层证据:静态 import 表、delay-import 表,以及测试运行时子进程实际加载的模块列表。runtime-size-audit.py 用 pefile 逐个解析 runtime/nvidia-vfg/ 下每个 DLL 的两个目录项并留档:

pe.parse_data_directories(directories=[pefile.DIRECTORY_ENTRY['IMAGE_DIRECTORY_ENTRY_IMPORT'],pefile.DIRECTORY_ENTRY_DELAY_IMPORT])
direct=[x.dll.decode() for x in getattr(pe,'DIRECTORY_ENTRY_IMPORT',[])]
delay=[x.dll.decode() for x in getattr(pe,'DIRECTORY_ENTRY_DELAY_IMPORT',[])]

运行时侧则由 runtime-size-native-tests.py 以 0.25 秒间隔轮询子进程模块列表,断言“加载了 nvVFXVideoFrameGeneration.dll 且没有任何 npp* 模块”:

assert not any(Path(p).name.lower().startswith('npp') for p in loaded),'Unexpected NPP module in native test'
assert any(Path(p).name.lower()=='nvvfxvideoframegeneration.dll' for p in loaded),'No VFG plugin observed'

为什么 AMD NR 一个字节都不能删

AMD 部分结论完全相反——原样保留,理由逐项有依据:

  • noise.f32(201,326,592 bytes)是模型输入噪声表,normalized-output.f32(33,554,432 bytes)是时域采样 reciprocal 表。runtime-size-audit.py 用 rg 在上游源码(lmxxf-nr-20261003/src)中对 noise.f32、normalized-output.f32、noise.f16 逐一检索引用并落盘,确认上游生产路径实际读取,删除会破坏运行。
  • 审计只发现两对 7KB shader 完全重复(按 (sha256, bytes) 分组、n>1024 过滤),但它们的文件名别名是现有路径合同,保留,不为几 KB 改动上游加载逻辑。
  • 默认 skip blocks 也不能据此删权重:其他设置/回退仍可能使用这些权重,而本机没有 RX9000,无法证明安全。
  • 明确不引入运行时自解压、下载依赖、裁剪显卡架构或降低精度。

后续版本的打包脚本把“AMD 资产必须完整”固化为硬断言,例如 amd-runtime-audit 逐文件核对 manifest 的 size/SHA256,并断言 len(weights)==186 and len(kernels)==62,再通过真实 C ABI 验证运行时 DLL:LmxxfNrGetApi(1, &api) 返回 0、api.size==144(144 bytes C ABI)、api.abi==1,QueryCapabilities 显示 caps.hip=0(本机无 RX9000),因此不执行 HIP 推理,报告明确不能称 AMD 画质/性能/稳定性验收。

stage 脚本 把保留清单写成了显式集合,并生成带审计字段的 vfg-runtime-manifest.json:

KEEP={'cudart64_12.dll','NVCVImage.dll','nvngxruntime.dll','NVVideoEffects.dll','nvVFXVideoFrameGeneration.dll'}
...
vfg.update(vfgOnlyDependencySet=True,omittedSdkLibraries=[r['path'].split('/')[-1] for r in omitted],dependencyAudit='docs/RUNTIME_SIZE_ACCEPTANCE_2026-10-04.md')

五个保留文件的原 SHA/签名/字节不变;小型 nvngxruntime 保留,未为 84KB 扩大裁剪范围;207MB 的 VFG 插件是必要运行组件,不拆 PE、不量化模型,全部 2X–8X 倍率与三种质量档位保留。

三、当前真实检查:481 步构建与全量功能回归

实际验收机器为 RTX5070 / 驱动 616.56(不是反馈者的 616.92);所有 child 进程的 TEMP/TMP/CUDA cache 均落在 E 盘,VFG/native/export/UI child 的 PATH 被限制为纯 Windows 系统目录——无 SDK 路径、无 NPP 文件。这一“干净 PATH”设计本身就是隔离性证据:子进程不可能从别处补加载被删的 DLL。

验收项与结果:

  • fresh build 481 步:QML、native VFG、NVENC probe、settings 目标,exit 0;已有 C4244 警告未掩盖。
  • native 720p 与 3840×2160,各 463 checks / 0 failures:覆盖 RGBA8/RGB10A2 双格式、三种质量、2X–8X 倍率、七张输出互不相同、切镜 identity、参数拒绝、设备存活、debug errors 检查。两个进程观测只从精简运行目录加载五个 VFG 组件,无 NPP。
  • settings 331 checks / 0 failures,保存/恢复与原枚举合同保持一致。
  • 720p30 的 21 种真实 D3D12 NVENC HEVC 导出全部通过,覆盖 16–64 帧、60–240fps,时长/音轨准确。
  • 2K30 AVI + 原生 4K NR + 最高 SR4K + VFG8:24→192 / 60→480fps、取消、缺失全部 runtime 场景通过。
  • 单独缺 cudart 的真实导出:记录 LoadLibrary 失败、exit 1、无最终文件——这是正确的拒绝行为,而不是成功导出(对应 VfgBackend.cpp 中 LoadLibrary failed path=... 的错误日志路径)。
  • GUI 热切换:list↔node、DLSS6↔VFG8、seek、resize、暂停恢复、预设与重启、缺库基础播放恢复全部通过;独立 High8 worker 在父进程改 Low2 后仍输出 64 帧/240fps,日志证实冻结质量=2。
  • AMD 原 529 记录:逐文件哈希、真实 C ABI 144 bytes / ABI 1、62 模块布局验证通过;caps.hip=0(本机没有 RX9000)。
  • 极简新 EXE 的 6 例分数 DPR 回归通过,右/底 native gap 0。

clean smoke 脚本 展示了“干净环境”是怎么执行的:把 PATH 压到 System32 + Windir + Wbem、弹出 VEYRA_VFG_RUNTIME/VEYRA_UI_RHI 等一切覆盖变量、把 TEMP/TMP/VEYRA_LOG_FILE 全部指到 E 盘任务目录,然后在 GPU(VEYRA_UI_RHI=d3d12)与软件(--obs-game-capture)两种渲染器下各走一遍 home/pro/node/exp/set/min 六页,逐页截图断言背景 alpha==255 且正常退出:

env['PATH']=os.pathsep.join((env['WINDIR']+'/System32',env['WINDIR'],env['WINDIR']+'/System32/Wbem'))
args=['.\\veyra_qml_ui.exe','--size','1280x720','--reduced-motion','--data-dir',str(verify/(mode+'-profile')),'--exit-after','27000']

最终 2076 载荷 + manifest 独立解压 SHA 通过,官方 7-Zip 26.03 CRC/兼容性通过;Windows-only PATH 下包内 VFG 真实 run/restore/missing 与 High8 worker 通过;GPU/软件各六页背景 alpha 255 和正常退出通过;运行前后所有载荷哈希一致。当前应用 SHA256 为 88597f61c8d01105533927859726815aaf3c67034e71bddf17852fb13c341bfc。

四、无损压缩:从 32MiB 字典到 256MiB 字典

裁剪之后是压缩格式的对比实验。无损样本 450,593,392 bytes(AMD 两大表/一权重/VFG 插件)的实测:

  • ZIP9(deflate level 9):277,853,065 bytes;
  • 7z LZMA2 / 32MiB 字典:166,108,485 bytes,比同样本 ZIP 小 40.2%。

样本结论不能冒充完整包大小,因此对完整包分别用 archive 脚本(ZIP deflate9 + 7z LZMA2/32MiB)与 dense archive 脚本(7z LZMA2/256MiB 字典)重新打包。两者的共同验收纪律是:打包前断言 git status --porcelain 干净(先提交再打包)、逐文件比对 manifest 的 size/SHA256、打包后独立解压到新目录并对每个载荷文件重新哈希,与 package-manifest.json 逐条比对。

最终完整包交付:

产物 bytes MiB SHA256
首选 7z / LZMA2 256MiB 字典 523,327,604 499.08 dcb38d16f59d9578b66d1f759092c2d5dd5c95606c3411c863cd5eb5fea5d94f
备用 ZIP / deflate9 943,265,095 899.57 40b44bfea5d358fa94cc9cb6bbd303e11c18cc861471847c2bed9086bd3c4b98

关键数字链条:原完整 VFG ZIP 1,151,602,649 bytes / 1098.25 MiB → 首选 7z 499.08 MiB,传输体积减少 54.56%。必须强调验收报告的措辞纪律:这是“裁掉未用依赖 + 更换无损压缩格式”的综合结果,不能说 AMD 模型本身缩小了 54.56%。256MiB 字典相对 32MiB 字典(728,771,789 bytes)进一步省了 205,444,185 bytes(28.19%)。

为什么加大字典收益显著?因为两份 NR DLL 在 1MiB 对齐的 chunk 对比中有 146,966,128 / 165,840,496 bytes 相同(88.62%)——大字典的 LZMA2 固实压缩能跨文件复用这些重复块。代价是解压时需要额外约 256MiB 字典内存(dense archive 脚本 中明确记录 decoderMemoryNote):这只影响解压过程的内存,运行显存/内存不因压缩格式变化;因此 ZIP 作为低解压开销的备用始终保留。压缩不合并、不 patch、不省略任何运行 DLL,每个文件解压还原后必须匹配原 SHA——7z 只减传输大小,AMD 解压后的资源量没有减少。

五、交付索引、源码存档与未验边界

交付物按“产品 / 源码 / runtime 分离”原则组织,由 delivery 脚本 生成 DELIVERY.json / DELIVERY.md,并交叉断言各审计 JSON 全部通过后才落盘:

assert digest(primary)==chosen['sha256'] and primary.stat().size==chosen['bytes']
clean=read('clean-smoke/summary.json');assert len(clean['results'])==2
native=read('native-archive-final-v1.json');assert native['status']=='pass'
assert all(read(n+'.json')['returncode']==0 for n in ('native-720-v1','native-4k-v1'))
exports=read('export-all-v1/summary.json');assert len(exports)==21 and all(r['exit']==0 for r in exports)
...
'checks':{'native720':463,'native4k':463,'settings':331,'nvencCombinations':21,...},
'hardware':'RTX5070 / 616.56','amdInferenceVerified':False,'xboxHardwareVerified':False,'rtx40Verified':False

其中 localOnly=True, releaseReady=False 表明这是本地完整测试包而非发布物。产品代码存档在 commit 2df6dd729b9fe7d32ed41753ab3422e5cc7eda0c / checkpoint/runtime-size-code-20261004;源码 ZIP 用 git archive 从该 commit 生成并断言“组包后只允许 docs/ 与 scripts/acceptance/runtime-size-* 变化”(productCodeEqual=True)。包内文档版本是组包前快照,最终报告/交付索引放在包同目录,避免为自身哈希反复改包。桌面 status/working、index patch、11 个未跟踪源码、main 66cd3e5、原 2077 载荷哈希全部复核一致。另外,清理本轮中间压缩包与解压/测试副本的单条 PowerShell 命令被自动审批拒绝(仅提示 blocked by policy),命令未执行、未重试或绕过,副本保留在 E 盘任务目录,验收明确不报告它们已删除——这是该报告值得参考的证据边界写法。

未验项目(明确列出,软件短测不外推):RX9000 实际推理/颜色/性能/长稳、Xbox 真机有声/长稳、RTX40 实卡与驱动 616.92、HDR 色度、实显示器 DPI 移动、物理显示节奏/端到端延迟、VFG 影片画质 AB 与长稳。原高倍率 High 预览预算/跳帧行为保留,离线导出不丢源帧。

复现入口是验收脚本族:

python -B scripts/acceptance/runtime-size-*.py

包括 control(范围断言)、audit(依赖/资产只读审计)、stage(按 KEEP 清单组包)、amd-audit(AMD ABI/布局验证)、native-tests(真 GPU native 检查)、archive / dense-archive(双格式无损打包)、clean-smoke(干净 PATH 六页回归)与 delivery(交付索引)。所有 build/tests/logs/tmp/test-packages/verify/archives 位于执行机的 E:/项目/Veyra/<用途>/runtime-size-20261004 任务目录;模型/DLL/SDK 不进源码 Git,固定来源/许可证原样保留,完整第三方源码公开发布审计不在本地交付范围。

六、可复用的方法论小结

  1. 删除依赖前先做三层证据:静态 PE import/delay-import 审计(pefile)、运行时代码只绑定你真正用到的 API(对照 VfgBackend.cpp 的显式 dependencies 数组)、真实进程加载模块列表观测(0.25 秒轮询 + 负向断言“无 npp”)。三者一致才删。
  2. 保留项同样要给证据:AMD 大表用 rg 检索上游引用、按 SHA 分组找重复、明确写出“本机无 RX9000 无法证明删权重安全”——不确定的东西保留并写进未验清单。
  3. 压缩对比必须在完整包上闭环:样本只用于选格式方向,最终数字以完整包独立解压 + 逐文件 SHA 比对为准;字典大小权衡(解压内存 vs 传输体积)要写进交付说明。
  4. 验收脚本即文档:范围断言(control)、组包(stage)、归档(archive/dense-archive)、隔离冒烟(clean-smoke)、交付索引(delivery)全部可重跑,且每个 JSON 结果被 delivery 索引交叉断言,任何一环失效都会使最终索引失败。
登录后查看全文
Veyra-NRVideo