Veyra-NRVideo 运行包瘦身实战:VFG/AMD NR 依赖审计、无损重压缩与完整本地测试包

原创2026-11-14 20:09:081,657 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra-NRVideo 运行包瘦身实战:VFG/AMD NR 依赖审计、无损重压缩与完整本地测试包

在分发 Veyra-NRVideo 这类同时携带 NVIDIA VFG(Video Frame Generation)、AMD lmxxf NR 模型与 HIP kernel 的 Windows 视频播放器时,便携包体积会迅速膨胀到 1 GiB 以上,而其中相当一部分是当前代码路径根本不会加载的通用图像处理库。本文以仓库内的施工计划 RUNTIME_SIZE_PLAN_2026-10-04.md 为骨架,逐条拆解这次"只裁剪可证明不使用的文件"的瘦身工程:如何用 PE import/delay-import 审计锁定真实依赖闭包、如何证明 AMD 权重与 kernel 一个字节都不能删、如何用无损压缩把传输体积降 54.56%,以及配套的 fresh build、463×2 项 native 检查、21 组真实 NVENC 导出和独立解压哈希校验。读完后你将掌握一套可复用的"运行时体量收窄"方法论,而不是一次性的删文件操作。

一、任务目标与六条硬约束

原计划文档用六段编号任务界定了本轮工作的边界,它本质上是一份裁剪授权书 + 验证清单,而不是功能开发需求。核心有两句话:"用户追加授权尽量瘦身,以稳定性为先",以及 "没有收益或验证不充分时保留文件"。把文档中的六条任务展开,得到的工程约束如下:

序号 任务原文要点 落地含义
1 按文件/压缩后贡献度统计;检查原始 DLL 的 import/delay-import 与实际运行依赖闭包、上游代码对 AMD 权重/kernel 的读取 先量化再动手,且必须同时看"静态导入表"和"运行期模块表"两类证据
2 只裁剪可以证明不使用的文件;VFG 必要接点限定 src/pipeline/VfgBackend.cpp 的依赖加载 改动面被机器可验证地限制在单一文件的依赖数组内
3 能力需要的 runtime 保留原字节身份;新产物仅在 E 盘各用途目录;不引入运行时自解压/联网补模型 保留 SHA/签名;压缩只影响传输,不影响运行时加载
4 fresh/incremental 构建测试目标;裁剪候选测试 2X–8X×三档、8/10bit、重建/热切换/缺失依赖与真实 worker 导出 必须用真实 GPU 路径跑矩阵,不能只做"能启动"冒烟
5 完整测试包带现有修复,生成 manifest/来源/对应源码与新的交付说明;验证独立解压/Windows 最小 PATH 交付物要能在无 SDK、无 Python 的干净机器上自证
6 完成 WORKLOG、瘦身数据与 HDR PR 审批方案、源码存档;停止本轮子进程 HDR 相关工作只出方案,不得顺手合并

这份计划的典型价值在于:它把"能不能删"从主观判断变成了可证伪的命题——要么有导入表/运行期模块表的双重证据,要么保留。

二、基线、分支与开工存档

任何裁剪都必须先固化"干净起点",否则事后无法区分"变瘦了"和"坏了"。计划文档记录了三重保护:

  • 基线提交 fc2ca7163e986f97e53dcab51ffe1ac77bb0615a,已包含极简黑边修复与 PR 审查结果;
  • 独占分支 codex/runtime-size-20261004,开工 tag checkpoint/pre-runtime-size-20261004;
  • 完整 bundle 存档于 E:/项目/Veyra/archives/runtime-size-20261004/source-before.bundle,已 verify 成功,SHA256 为 6d2b64b471cb84effd84670a07f3079b5f71f630940926338052099e4cbfd694。

对应的验收报告 RUNTIME_SIZE_ACCEPTANCE_2026-10-04.md 追加了一条更严格的说明:本轮只修改 VFG 依赖加载与本地打包/验证脚本,未改模型、HIP 内核、HDR 算法或功能档位。这条约束后来由脚本强制校验——runtime-size-archive.py 的 source 分支会断言"基准提交之后改动的文件必须全部位于 docs/ 或 scripts/acceptance/runtime-size- 前缀下",否则直接失败:

changed = subprocess.check_output(['git','diff','--name-only',manifest['baseCommit'],commit],cwd=ROOT).decode().splitlines()
assert all(p.startswith(('docs/','scripts/acceptance/runtime-size-')) for p in changed),'Product source changed after package build'

也就是说,"产品代码零改动"不是口头承诺,而是打包流水线里的一道断言。

三、第一步:把"体量"拆成可比较的数字

3.1 双维度统计:原始字节 + 压缩后贡献度

裸文件大小会严重误导判断:一个 200 MB 的 FP32 表可能在 ZIP 里压到 90 MB,而一个 207 MB 的插件可能几乎压不动。runtime-size-audit.py 因此对归档内 runtime/nvidia-vfg/ 与 runtime/amd-nr/ 两个目录分别统计 file_size 与 compress_size,并列出压缩后体积最大的 15 个条目:

for kind in ('runtime/nvidia-vfg/','runtime/amd-nr/'):
    files=[i for i in z.infolist() if '/'+kind in i.filename and not i.is_dir()]
    stats.append({'kind':kind,'files':len(files),
                  'rawBytes':sum(i.file_size for i in files),
                  'compressedBytes':sum(i.compress_size for i in files),
                  'largestCompressed':[...sorted(files,key=lambda i:i.compress_size,reverse=True)[:15]]})

这一步直接决定后续压缩策略:如果某目录的压缩后占比远高于原始占比,说明它是"可压的权重类数据",值得上大字典;如果几乎不可压,说明是已压缩的 PE/加密资源,只能靠裁剪解决。

3.2 PE 导入表 + 延迟导入表 + 运行期模块表三重印证

判定"某个 DLL 没被使用",最弱的证据是文件名看着不像;中等证据是导入表里没有;最强证据是导入表、延迟导入表和真实进程模块列表三者一致为空。审计脚本用 pefile 只解析 IMAGE_DIRECTORY_ENTRY_IMPORT 与 IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT,并附带一次对原始字节的 *.dll 字符串扫描,作为"有没有硬编码名字"的旁证:

pe = pefile.PE(str(p), fast_load=True)
pe.parse_data_directories(directories=[pefile.DIRECTORY_ENTRY['IMAGE_DIRECTORY_ENTRY_IMPORT'],
                                       pefile.DIRECTORY_ENTRY['IMAGE_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',[])]
names  = sorted(set(x.decode() for x in re.findall(rb'[A-Za-z0-9_-]{3,}\.dll', raw)))

对照的真实加载点就在产品代码里。src/pipeline/VfgBackend.cpp 的初始化段落给出了确定的五个依赖,且注释明确写了为什么不需要 NPP:

const fs::path runtime=runtimeDirectory(root);
// 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"};

这段注释是本轮瘦身的技术根据:Veyra 走的是"D3D12 共享纹理 → CUDA external memory 映射 → 直接把编码好的 buffer 交给 NvCVImage/NvVFX"路径,绕开了 NvCVImage_Transfer 等 NPP 转换效果,所以 NPP 系列 DLL 不在闭包内。运行期证据也一致:两进程观测显示只从精简运行目录加载了这五个组件,没有任何 NPP 文件(见验收报告"当前真实检查"一节)。

值得注意的是 nvngxruntime.dll 只有约 84 KB,计划文档第 2 条原则("只裁剪可以证明不使用的文件")在这里被反向应用:能证明无用才删,不能因为小就留着——同时也不能因为小就懒得多留一个依赖。验收报告明确写了"小型 nvngxruntime 保留,未为 84KB 扩大裁剪",即保留它是为了维持原字节身份,而不是因为它占空间。

3.3 第一个可删结论与量级

九个未使用的 NPP DLL 合计 287,106,032 bytes(273.81 MiB),占 VFG 运行目录的 57.7%。VFG 目录从 497,894,432 bytes(474.83 MiB)降到 210,788,400 bytes(201.02 MiB)。保留的五个文件中,207 MB 的 VFG 插件是必要运行组件——不拆 PE、不量化模型、不裁剪 2X–8X 与三档质量。

四、第二步:AMD NR 为什么"一个字节都不能删"

这是本轮最有教育意义的部分。直觉上,186 个权重文件加上 62 个 HIP 内核,似乎总能找出"某些档位用不到"的;但计划文档第 2 条明确要求:"AMD 若无法在无实卡条件证明可删,则保留必要权重/kernel,不以量化、重编内核、改模型换大小。"

审计脚本对三个关键资产名做了源码级反查:

for term in ('normalized-output.f32','noise.f32','noise.f16'):
    r = subprocess.run(['rg','-n','-F',term,str(source)],stdout=subprocess.PIPE,stderr=subprocess.PIPE)

结论是这两个大表都在上游生产路径上被真实读取,删掉即破坏运行:

资产 大小(bytes) 作用 处置
noise.f32 201,326,592 模型输入噪声表 必须保留
normalized-output.f32 33,554,432 时域采样 reciprocal 表 必须保留
HIP 内核 62 个 .hsaco 两种 RX9000 架构的 kernel 原字节保留
权重 186 个 .f16/.f32 完整档位推理参数 原字节保留

脚本还会用 SHA256 + size 二元组做重复载荷检测,但只报告大于 1 KiB 的重复项,避免把空文件/占位符误判成可合并资产。实际只发现两对 7 KB 的 shader 完全重复;验收报告的处置是"它们的别名是现有路径合同,保留,不为几KB改上游加载"。

另一条常被误用的理由是"默认 skip blocks 用不到那些权重"。计划文档直接否定了这种推断:其他设置与回退路径仍可能使用,而本机没有 RX9000 实卡,无法证明安全。这条边界非常关键——没有硬件就无法完成的证明,不能降级成"看起来没用"。

产品代码侧的对应证据在 src/pipeline/LmxxfNrBackend.cpp:open() 要求 vendor == 0x1002、目录为绝对路径,并在 LoadLibraryExW 之后依次验证 VeyraLmxxfModelMode、VeyraLmxxfModelAssetsReady、VeyraLmxxfControlsCompatible 三个导出,资产缺失时宁可报错也不静默回退:

const auto assets = directory / L"assets";
if (!assetsReady(assets.c_str())) {
    error_ = "AMD NR Small model assets are incomplete; refusing silent fallback to the original model";
    log::error("amd-nr", error_); close(); return false;
}

这解释了为什么"删资产换体积"在架构上不可行:运行时会把资产不完整当成硬错误,而不是降级。

4.1 ABI / 布局校验:不跑推理也能验证结构

没有 RX9000 无法验证画质与性能,但可以验证二进制契约。runtime-size-amd-audit.py 用 ctypes 复刻了 144 字节的 API 表结构、Caps 与 CreateInfo,只调用 LmxxfNrGetApi → QueryCapabilities → Create → Destroy,并显式跳过 PrepareSession 与任何 HIP 执行:

api=Api(); api.size=ctypes.sizeof(api)
assert get(1,ctypes.byref(api))==0 and api.abi==1
...
# The upstream Create function validates assets but does not dereference the
# device/queue until PrepareSession. Do not call PrepareSession or execute HIP.
info.device=info.queue=1; info.assets=str((amd/'assets').resolve())

结果记录为 filesVerified、weights=186、hipModules=62、apiBytes、abi=1、caps、moduleLayoutPassed=True、inferenceVerified=False。这是一种值得复制的"分级验证"写法:把"能证明的"和"不能证明的"分成两个布尔量并存档,避免下游误读。

五、第三步:原字节身份与产物目录隔离

计划第 3 条约束包含三层意思:

  1. 能力需要的 runtime 保留原字节身份——五个 VFG DLL 与全部 AMD 资产,SHA/签名/字节不变;
  2. 新产物只在 E 盘 runtime-size-20261004 各用途目录——build/、tmp/、logs/、tests/、test-packages/、verify/、archives/ 物理分离,互不覆盖;
  3. 可评估 ZIP/LZMA2 等压缩并标注解压兼容性,不引入运行时自解压/联网补模型——压缩是传输层手段,运行期依赖集合不变。

构建脚本 runtime-size-build.py 把这条约束落到了环境变量上:TEMP、TMP、CUDA_CACHE_PATH 全部指向任务专属目录,避免污染系统盘与共享缓存:

env.update(VSLANG='1033', TASK_ROOT=str(ROOT), TASK_BUILD=str(BUILD), TASK_TMP=str(TMP),
           TEMP=str(TMP), TMP=str(TMP),
           TASK_CMAKE='C:/Program Files (x86)/.../CMake/bin/cmake.exe')

它同时从既有的 CMakeCache.txt 中提取 VEYRA_*、CMAKE_PREFIX_PATH 等键,生成 dependencies.cmake 并用 -C 预加载,从而实现"不新增依赖路径的 fresh 构建"——依赖复用既有产品配置,只有 CUDA driver 头文件指向外部的 deps/nvidia-vfx-audit-20260921/...。这也是"fresh build"能做到不碰网络与 SDK 安装器的原因。

六、第四步:构建与测试矩阵

6.1 构建目标

runtime-size-build.py 默认目标为四个:veyra_qml_ui(主程序)、veyra_vfg_gpu_tests(native 矩阵)、veyra_vfg_export_probe(真实导出探针)、veyra_vfg_settings_tests(设置合同)。脚本对目标名做了白名单校验(t.replace('_','').isalnum()),并把日志以 open('x') 独占模式写入,防止覆盖历史证据。实际结果:fresh build 481 步,QML、native VFG、NVENC probe、settings 全部 exit 0,已有的 C4244 警告未被掩盖。

6.2 测试覆盖(以验收报告为准)

维度 规模 关键断言
native 720p 463 checks / 0 failures RGBA8 与 RGB10A2、三质量、2X–8X、七张输出互异、切镜 identity、参数拒绝、设备存活
native 3840×2160 463 checks / 0 failures 同上,验证 4K 预算下行为一致
settings 331 checks / 0 failures 保存/恢复与原枚举合同保持
真实 NVENC 导出 21 组全部通过 720p30 的 D3D12 HEVC,16–64 帧、60–240 fps、时长/音轨准确
高负载组合 通过 2K30 AVI + 原生 4K NR + 最高 SR4K + VFG8,24→192 / 60→480 fps,含取消与缺失 runtime
负向用例 通过(预期失败) 单独缺失 cudart64_12.dll 时记录 LoadLibrary 失败、exit 1、且不产生最终文件
GUI 交互 通过 热切换、list↔node、DLSS6↔VFG8、seek、resize、暂停恢复、预设与重启

其中"缺失依赖"用例的判据很值得借鉴:正确拒绝与成功导出必须区分开。脚本 runtime-size-export-tests.py 在正向用例里同时断言 backend=NVIDIA-VFG、日志含 nvenc、且不出现 [ERROR]|device removed|not alive|substituting;反过来,缺库用例要求进程以非 0 退出并且木有输出文件——把"崩溃"伪装成"通过"是最常见的验收陷阱。

runtime-size-export-tests.py 里还有两处工程细节值得抄走:把 PATH 收窄到 System32、Windows、Wbem 三个目录,确保不会意外命中开发机上的 SDK 库;以及把 VEYRA_VFG_RUNTIME 显式指向精简后的运行目录,使"到底加载了哪一份 runtime"变成可复现的输入而非环境偶然。

6.3 worker 冻结与异步合同

验收报告记录了一条只能靠真实并发才能发现的合同:独立 High8 worker 在父进程改为 Low2 之后,仍输出 64 帧 / 240 fps,日志证实冻结质量 = 2。这对应 src/pipeline/VfgBackend.cpp 的 Job 结构——质量与倍率作为任务字段随队列传递,而不是在 worker 里重新读取全局设置:

struct Job {unsigned parity,sub,multiplier;bool reset;uint64_t revision,value;bool fast;};
std::deque<Job> jobs;

同一文件还提供了仅测试用的旁路开关(VEYRA_TEST_VFG_AUTO_SHOT_CHANGE、VEYRA_TEST_VFG_DELAY_MS、VEYRA_TEST_VFG_GPU_PROFILE),让"同 EXE 的 A/B 对比"和"模拟慢 GPU"成为可能——这类测试钩子是能否在不改产品代码的前提下完成深度验证的关键。

七、第五步:完整测试包与交付索引

7.1 组包:白名单式拷贝

runtime-size-stage.py 用显式 KEEP 集合定义保留项,其余 runtime/nvidia-vfg/* 全部进入 omitted 列表:

KEEP={'cudart64_12.dll','NVCVImage.dll','nvngxruntime.dll','NVVideoEffects.dll','nvVFXVideoFrameGeneration.dll'}
...
for row in old['files']:
    rel=Path(row['path']); source=OLD/rel
    assert source.stat().st_size==row['size'] and digest(source)==row['sha256'].lower(), rel
    if rel.as_posix().startswith('runtime/nvidia-vfg/') and rel.name not in KEEP:
        omitted.append(row); continue

注意循环开头的断言:每一个被拷贝的文件都先与原 manifest 的 size/SHA256 比对,所以"新包里剩下的东西仍是原件"是被逐个证明的,而不是靠目录级信任。随后 vfg-runtime-manifest.json 的 files 数组被同步裁剪,并写入 vfgOnlyDependencySet=True、omittedSdkLibraries、dependencyAudit 三个字段,让包本身携带"为什么少"的说明。

finalize 分支负责产物自证:先断言工作区干净(git status --porcelain 为空),再遍历全部文件计算 SHA256,并硬性拒绝开发残留类型:

assert p.suffix.lower() not in {'.pyd','.pdb','.lib','.whl','.addon64'}, rel

最终产物是 2076 个载荷 + manifest;原候选包为 2077 个载荷。文档、CURRENT_STATUS.md 与用户指南被一并放入 docs/,且用户指南的副本同时落到包根 LOCAL-TEST-PACKAGE.md,方便解压后第一眼看到。

7.2 交付索引:把结论写成机器可读数据

runtime-size-delivery.py 的 index 分支把散落在各日志里的结论逐项断言后合并成 DELIVERY.json,任一断言失败就不产出交付物:

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)
isolation=read('source-isolation.json'); assert all(isolation.values())

DELIVERY.json 的关键字段包括 localOnly: true、releaseReady: false、branch、compiledCodeCommit、appSha256、primary/zipFallback 两个产物、primaryReductionPercent、vfgRawBefore/After、amdRawBefore/After、amdInferenceVerified: false、xboxHardwareVerified: false、hdrPrChanges: false。把未验项写成显式 false 而不是省略,是这份交付物最值得学习的设计。

八、压缩策略:ZIP9 与两种字典的 7z

计划第 3 条允许"评估 ZIP/LZMA2 等压缩并标注解压兼容性"。这里测了三档,样本是 450,593,392 bytes 的四个大文件(AMD 两大表 + 一个权重 + VFG 插件):

方式 测量值(bytes) 说明
ZIP9 277,853,065 基线
7z LZMA2 / 32 MiB 字典 166,108,485 比同样本 ZIP 小 40.2%
7z LZMA2 / 256 MiB 字典 进一步省 205,444,185(相对 32 MiB 字典省 28.19%) 依赖跨文件大块复用

大字典的收益来源被量化得很清楚:两份 NR DLL 在 1 MiB 对齐 chunk 层面有 146,966,128 / 165,840,496 bytes 相同(88.62%),因此 256 MiB 字典能跨文件复用这些共享块。实现上不合并、不 patch、不省略任何运行 DLL——只让压缩器看见更多历史数据。

最终完整包(相同载荷、2076 个文件):

产物 bytes MiB 说明
首选 7z / LZMA2 256 MiB 字典 523,327,604 499.08 相对原 VFG ZIP 减少 54.56%
备用 ZIP / deflate9 943,265,095 899.57 兼容性回退
对照 7z / 32 MiB 字典 728,771,789 — 低内存解压可选

三个必须同时说清的限定:

  1. 54.56% 是**"裁未用依赖 + 换无损压缩格式"的合计效果**,不能表述为"AMD 模型缩小了 54.56%"。AMD 目录瘦身前后都是 615,032,656 bytes。
  2. 7z 只是减少传输体积;解压后每个文件必须匹配原 SHA,模型仍占原空间。
  3. 256 MiB 字典在解压时额外需要约 256 MiB 字典内存加解码缓冲,运行期的显存/内存不受影响;这也是保留 ZIP 备用与记录 32 MiB 对照值的原因。

计划文档中"7z 可用支持 LZMA2 的解压软件完整解压;不能仅运行压缩包里拖出的 EXE"这条用户提示,正是上述机制的直白表达(见 RUNTIME_SIZE_USER_GUIDE_2026-10-04.md)。

九、独立验证:干净环境自证

runtime-size-clean-smoke.py 是最能体现"交付物要能自证"的脚本。它只接受位于 verify/runtime-size-20261004/ 下的解压目录(app.relative_to(...) 失败即抛错),先按 manifest 全量校验哈希,再依次做三件事:

  1. native UI 复跑:调用 runtime-size-ui.py 在解压出的包内跑真实 VFG 界面与 worker;
  2. 六页 × 两渲染器:注入一个临时 QML Loader,遍历 home / pro / node / exp / set / min 六个页面,分别在 GPU(VEYRA_UI_RHI=d3d12)与软件(--obs-game-capture)下截图,断言背景像素 alpha == 255 且 max(rgb) < 160——用像素值证明背景没有被渲染成透明或白屏;
  3. 哈希不变性:运行结束后再次 verifyFiles(),确认"运行"没有偷偷改包内文件。

同时它把 PATH 收窄到三个系统目录、清空 QT_QPA_PLATFORM/QT_QUICK_BACKEND/VEYRA_VFG_RUNTIME 等可能被继承的变量,模拟"Windows 最小 PATH、没有开发 SDK"的机器。验收报告记录的结果是:最终 2076 载荷 + manifest 独立解压 SHA 全部通过,官方 7-Zip 26.03 CRC/兼容性通过,运行前后所有载荷哈希一致。

极简窗口的边缘回归另有专门脚本 runtime-size-edge-tests.py:它用 ffmpeg 合成 1280×720 的纯青色视频作为测试素材,把 DPI 感知设为 -4(Per Monitor V2),实测分数 DPR 下的客户区覆盖与合成后边缘像素,结果 6 例通过、右/底 native gap 为 0。这与计划第 5 条"页面与黑边"验收项对应,详细记录见 MINIMAL_EDGE_ACCEPTANCE_2026-10-04.md。

十、第六步:文档、源码存档与"不扩大范围"

计划第 6 条要求"完成 WORKLOG、瘦身数据与 HDR PR 审批方案、源码存档;按用户要求关机;不杀其他用户应用来跑测试,不代发消息"。本轮的做法可以概括为三条纪律:

  • 产品代码与文档分离:产品代码存档于 2df6dd729b9fe7d32ed41753ab3422e5cc7eda0c / checkpoint/runtime-size-code-20261004,构建包内的 package-manifest.json 记录 baseCommit,而 sourceArchiveCommit 允许比它新(仅多出报告与验收脚本),并在 DELIVERY.json 中显式标注 productCodeEqual: true;
  • 源码 ZIP 不含运行时:runtime-size-archive.py 的 source 分支断言仓库中不存在 .dll/.exe/.lib/.pdb/.whl/.f16/.f32/.i32/.onnx/.hsaco/.cso/.ptx/.addon64,用 git archive 出包后再 testzip(),并注明"不冒充完整第三方公开源码审计";
  • HDR 只出方案:HDR/Dolby Vision PR #13/#14 本轮仅审查。PR #13 修正 P5 offset、完整曲线与 MMR;PR #14 先补构建依赖,再改亮度统计的 range/array/延迟/reset;后续需先解决预设版本与 worker ABI,统一"输入格式—HDR 处理卡—实际输出/显示校准",取得参考与实机证据后按用户批准范围合并。方案文档为 HDR_DOVI_PR_REVIEW_2026-10-04.md。

隔离审计 runtime-size-isolation.py 进一步证明"没碰不该碰的东西":桌面工作区的 git status --porcelain --branch、git diff --binary、git diff --cached --binary 与开工快照逐字节相等,11 个未跟踪源码哈希一致,main 仍为 66cd3e5,原 2077 个载荷哈希全部未变。这类"证明自己没做什么"的审计,在涉及用户工作区的多任务并行场景里比"证明自己做了什么"更难也更重要。

还有一条如实记录的失败:清理中间压缩包与测试副本的单条 PowerShell 命令被自动审批拒绝(仅返回 blocked by policy),脚本没有重试也没有绕过,副本保留在 E 盘任务目录,报告中明确写"不能报告它们已删除"。这种对"未完成动作"的显式声明,正是技术文档可信度的来源。

十一、结果汇总与适用边界

11.1 体量结果

部分 原运行目录 新运行目录 处理
VFG 497,894,432 B(474.83 MiB) 210,788,400 B(201.02 MiB) 移除九个未用 NPP DLL,共 287,106,032 B(57.7%)
AMD NR 615,032,656 B(586.54 MiB) 同原件 186 权重、2 映射、62 HIP 内核及回退保留
完整包(7z) 1,151,602,649 B(原 VFG ZIP) 523,327,604 B(499.08 MiB) 传输体积 −54.56%

应用本体 SHA256:88597f61c8d01105533927859726815aaf3c67034e71bddf17852fb13c341bfc。这是本地实验测试候选:未 merge main、未 push、未发布 GitHub Release,releaseReady 显式置为 false。

11.2 明确未验证的项目

验收报告把边界写得非常具体,值得完整继承:RX9000 的实际推理/颜色/性能/长稳、Xbox 真机有声与长稳、RTX 40 实卡、驱动 616.92(实测环境为 RTX 5070 / 616.56)、HDR 色度、实显示器 DPI 移动、物理显示节奏与端到端延迟、VFG 影片画质 A/B 与长稳。软件短测通过不外推到这些项目;AMD 侧 caps.hip=0、inferenceVerified: false,因此不能称"AMD 画质/性能/稳定性验收"。

此外,用户指南还写清了能力边界:VFG 仅限 RTX 40/50 范围,高档 8X 开销大、预览可能按预算降档或跳帧,而离线导出完整处理;提交 FPS 不是物理屏幕 FPS;AMD 内部最高 1080p 预算,不支持 HDR 或超预算原生 4K NR 导出,且需要 AMD 驱动自身的 HIP 运行支持。

十二、复现路径

所有验收脚本都位于 scripts/acceptance/,按能力分为六组,可单独运行(脚本内 BASE 指向本地 E:/项目/Veyra 任务根,需按实际环境调整):

脚本 职责
runtime-size-audit.py 只读依赖/资产审计:PE import、延迟导入、DLL 字符串、压缩贡献度、AMD 重复载荷与上游引用
runtime-size-amd-audit.py AMD manifest 逐文件哈希、186 权重 / 62 模块计数、144 字节 ABI 与 caps 校验(不跑 HIP)
runtime-size-build.py fresh 构建:复用既有 VEYRA_* 缓存键,隔离 TEMP/TMP/CUDA 缓存
runtime-size-native-tests.py / runtime-size-export-tests.py native 矩阵与 21 组真实 NVENC 导出
runtime-size-stage.py / runtime-size-archive.py 白名单组包、manifest、ZIP/7z 双格式归档与解压后哈希校验
runtime-size-clean-smoke.py / runtime-size-isolation.py 解压包自证(六页 × 两渲染器)与"未触碰用户工作区"隔离审计

计划文档给出的统一入口是最小化的:python -B scripts/acceptance/runtime-size-*.py,具体命令与结果记录在 WORKLOG;所有 build/tests/logs/tmp/test-packages/verify/archives 均落在 E:/项目/Veyra/<用途>/runtime-size-20261004,模型、DLL、SDK 不进源码 Git,固定来源与许可证原样保留。

十三、可复用的方法论小结

把这份计划与它的验收报告抽象出来,得到一套适用于任何"带大模型/大 SDK 的桌面应用瘦身"的流程:

  1. 先量化再动手,且同时看原始字节与压缩后贡献度;
  2. 依赖判定要三重证据:静态导入表、延迟导入表、运行期实际模块列表,缺一不可裁剪;
  3. 改动面用断言锁死,例如"基准提交后只允许改 docs 与验收脚本";
  4. 区分"能证明"与"不能证明",把后者写成 false 字段而不是删掉不提;
  5. 负向用例与正向用例同等重要,缺库必须 exit 非 0 且不产出文件;
  6. 交付物必须能自证:独立解压后逐文件哈希、最小 PATH、运行前后哈希一致;
  7. 压缩是传输层手段,绝不引入运行时自解压或联网补依赖;
  8. 证明"没做什么":工作区变更、main 提交、原有载荷哈希的隔离审计。

这套做法的价值不在于省下了 273.81 MiB,而在于它把"删文件"变成了一件可以被复核、被反驳、被交接的工程事实——任何后来者只要重跑 runtime-size-*.py,就能独立判断这份瘦身是否仍然成立。

登录后查看全文
Veyra-NRVideo