Veyra-NRVideo 集成 SF 310.9.16 双模型 NR 运行库:模型契约验证、A/B 性能实测与 2.0.9 回归体系

原创2026-11-15 22:33:412,324 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra-NRVideo 集成 SF 310.9.16 双模型 NR 运行库:模型契约验证、A/B 性能实测与 2.0.9 回归体系

本文以 Veyra-NRVideo 2.0.9 本地测试包接入 SF(ShortFuse 兼容构建)310.9.16 双模型 NR 运行库的完整过程为主线,拆解其中的模型契约验证方法、创建期(create-time)参数与图重建语义、每层模型设置的持久化路径,以及围绕 GPU 阶段耗时与回归回执建立的证据体系。读完后你可以掌握三件事:如何用可控探针证明一个未公开 I32 参数的真实含义而不是靠预设名猜测;如何在一个多层视频增强图中安全地做“换模型即重建”的改造;以及如何组织一份可以自证边界的本地测试报告。

说明:本文所有结论来自仓库文档 SF 310.9.16 / 2.0.9 本地测试记录、配套的接入计划与2.0.9 构建记录,以及当前仓库内的源码与测试。文中的 E:/项目/Veyra/... 路径是当时测试机的本地回执目录,不属于仓库内容;仓库内可复现的部分是代码、测试与文档。

一、本轮改动到底“改了哪一层”

这次集成不是新增一个效果器,而是替换一个已有的第三方推理运行库,并顺带改变了它的模型选择方式。理解这一点,才能理解后面所有的限制条件。

原文档给出的基线非常明确:main b571a44,工作分支 codex/nr-sf-310916-20261017,用户提供 DLL 并授权“打开新旧模型开关”与“2.0.9 本地测试包”,未授权 main 合并或公开发布。同一轮里还整合了 NR2060、粉丝字幕/鼠标穿透、issues41–45 等已完成分支,同时要求保留原分支、原工作树、历史包和真实用户配置。

因此本轮改动的层次是:

层次 变化 未变化
运行库身份 新增 SF 310.9.16 作为 RTX20–50 默认 NR 槽 NVIDIA 原版 310.8.0 保留在 nr-original
模型选择 新增每层 performance 布尔开关,映射为创建期 I32 hint 1 或 2 NR 强度、残差、调控等既有参数语义不变
图生命周期 模型变化纳入图重建判定 UI 33ms/250ms 刷新频率未提高
缓存 缓存键加入实际运行库路径与模型设置 既有显存预算、队列上限、退出释放规则保留

一个容易忽略的细节是:Lecram 与旧 SF-v2 在新包中被删除,但旧的运行时枚举 ID 仍然必须可解码——否则用户的历史预设、会话和导出旁档会在升级后全部失效。这直接决定了第 3 节的迁移设计。

二、来源与模型契约:先证明参数,再动产品

2.1 运行库身份与授权边界

原文档记录的身份信息是整套证据的锚点:

  • 文件版本 310.9.16.0
  • 大小 276162560 字节
  • 签名状态 NotSigned
  • SHA256 CDFA6C1EC784867182164C7836F324F087B5C9F374D0C9FE46F54999FEABF3ED

来源声明对照的是作者 2026-10-17 00:07(台北时间)的 compat-fp16-310.9.16-cuda13.4.3 公告;作者 RAR 解出的 DLL 与用户文件完整 SHA 匹配。文档特别强调了一条纪律:不把 NotSigned 冒充 NVIDIA 有效签名。仓库的 THIRD_PARTY_NOTICES.md 同样写明:该运行库与翻译缓存保留各自权利,本地暂存与清单审计不授予再分发权,也不改变正式 Release 白名单。

作者说明该构建兼容 SM75/86/89 并保留原 SM120 路径,但本机只在 RTX5070 上实际验证。这条限制在后文“未验收项”里会再次出现——它意味着不能把单卡结论外推到整个 RTX20–50 区间。

2.2 用可控探针确定 DLSSNR.Hint.Render.Preset 的真实含义

参数名在仓库里是集中管理的常量,见 include/veyra/ngx/DlssNrParameters.h:

constexpr const char* kHintRenderPreset = "DLSSNR.Hint.Render.Preset";

它的注释明确写着这是创建参数(setI32),而不是每帧 uniform。原文档描述的验证方法是本轮最有价值的方法论:不根据预设名称猜,而是用同一份输入、同一套资源,只改 hint 值做 A/B。

探针按 0/1/2/2/1 的顺序执行,每次都是相同的 1920×1080 合成输入,10 次预热后取 20 次 Evaluate 的中位数:

hint 实测 GPU 中位数 判定
0 3.15546 ms 自动选择(本机结果与 2 一致)
1 5.53274 ms 旧模型 A
2 3.15997 ms 性能模型 B
2(重复) 3.16160 ms 重复性验证
1(重复) 5.54086 ms 重复性验证

判定条件不止耗时:150 次推理全部成功、每张输出有 2073600 像素有效结果、GPU ERROR/CORRUPTION 计数为 0。同时保留两次回访(2→2、1→1)用于确认结果稳定,而不是单次采样。

这段逻辑在仓库中有对应的可执行探针 tests/perf/NrModelPresetExperiment.cpp,其序列与判据一致:

const int32_t presets[]={0,1,2,2,1};
// ... 前 10 帧预热, 之后 20 帧计入统计
auto pixels=f.read(s.ring);
for(size_t i=0;i<pixels.size();i+=4){
    changed+=pixels[i]!=17||pixels[i+1]!=23||pixels[i+2]!=29;
    nonBlack+=pixels[i]+pixels[i+1]+pixels[i+2]>15;
}

注意它的通过条件是“改变像素超过半数且非黑像素超过半数”,这正是为了避免原文档在“失败夹具”一节里记录过的坑:用黑场画面当证据。探针文件头部的注释也写明了原则——“不要从预设名或未处理的黑色图像推断枚举含义”。

由此得到两条产品决策,并写入代码:

  1. 新开关不使用 0 自动选择,产品显式传 1 或 2;
  2. 原版运行库仍传 0,AMD 不改参数。

三、运行时枚举、迁移与参数映射

3.1 枚举设计:保留已退役 ID

include/veyra/engine/EnhancementSettings.h 保留了完整的 ID 空间:

// Keep retired 0/1 IDs decodable; new builds migrate them to the SF slot.
// 3 remains the explicitly selected NVIDIA original, 4 the AMD backend.
enum class NrRuntime { Original = 0, Community = 1, Ampere = 2, NvidiaOriginal = 3, LmxxfAmd = 4 };

constexpr NrRuntime currentNrRuntime(NrRuntime runtime) {
    return runtime == NrRuntime::Original || runtime == NrRuntime::Community ? NrRuntime::Ampere : runtime;
}

设计意图很清楚:0 与 1 是已退役的 Lecram / 旧社区 40 系槽位,读取时归一到 SF 槽;3(NVIDIA 原版)与 4(AMD 后端)作为用户的显式选择必须存活。正因为做了“读取时归一”,迁移不需要一次性改写磁盘上的所有预设文件,也就不会因为半途失败而留下混合状态。

同时 Ampere 这个枚举名是历史遗留(内部名仍写作 community-SF-RTX20-RTX50),它与“Ampere 架构”不是同一概念。阅读日志时要注意这一点,例如 nr-ampere 标签现在指向 SF 运行库。

3.2 创建期参数映射的三种情形

参数映射被收敛为两个小函数,见 include/veyra/engine/EnhancementSettings.h:

struct NrSettings {
    float intensity=1,tone=1,structure=1,skin=-1;
    int32_t style=0,autoMask=0,uiCorrection=0;
    bool performance=true; // SF: B/A; AMD 0.44: Small/Original. Create-time model choice.
};

// Create-time I32 contract, verified against both embedded models in the
// user-provided 310.9.16 runtime. Original/AMD keep their previous parameters.
constexpr int32_t nrRenderPreset(NrRuntime runtime,const NrSettings& model) {
    return currentNrRuntime(runtime)==NrRuntime::Ampere ? (model.performance?2:1) : 0;
}

constexpr bool nrUsesPerformanceModel(NrRuntime runtime) {
    return currentNrRuntime(runtime)==NrRuntime::Ampere || runtime==NrRuntime::LmxxfAmd;
}

constexpr int32_t nrModelSelection(NrRuntime runtime,const NrSettings& model) {
    return nrUsesPerformanceModel(runtime) ? (model.performance?2:1) : 0;
}

三种情形一目了然:

  • SF 槽:performance=true → hint 2(模型 B);false → hint 1(模型 A)。默认 true,即新用户默认拿到性能模型 B。
  • NVIDIA 原版:始终 hint 0,performance 开关对图没有任何影响。
  • AMD(lmxxf):同样传 0,但 performance 有语义——0.44 运行库下开启用 Small 模型、关闭用原模型;AMD 侧通过重建 worker 生效,而不是通过 NGX 预设参数。

nrRenderPreset 与 nrModelSelection 的区别值得注意:前者是真正发给运行库的参数,后者是用于比较“模型选择是否变化”的抽象键。分开两者的原因在下一节。

3.3 UI 侧的写入校验

QML 的开关控件在 qml/Veyra/NrLayerEditor.qml,它按运行库切换提示文案,并在不支持时降透明度、禁用:

VRow {
    objectName: "nr-performance-row"
    label: qsTr("启用性能优化版")
    hint: editor.amdNr ? qsTr("开启使用 Small 模型;关闭使用原模型。每层独立选择,切换会重建 NR,画面可能有所不同。")
                       : qsTr("开启使用新版模型 B;关闭使用旧版模型 A。切换会重建 NR,画面可能有所不同。")
    enabled: (editor.layerData.runtime === 2 || editor.amdNr) && Support.available(veyra, "nr" + editor.layerData.runtime)
    opacity: enabled ? 1 : 0.4
    VSwitch { objectName: "nr-performance"; checked: editor.layerData.performance ?? true
              onToggled: checked => editor.edited(editor.layerData.index, "performance", checked ? 1 : 0) }
}

桥接层对非法写入直接拒绝,见 src/ui/bridge/Chain.cpp:

else if(key=="performance"&&value<=1&&engine::nrUsesPerformanceModel(n.runtime))n.model.performance=value!=0;

也就是说,在原版运行库下即便有脚本强行写 performance,也会落到 else return false 分支从而不改变状态——这正好解释了原文档 visual209.json 中“原版性能模型行禁用并降至 0.4 透明度”的验收点,它是 UI 与桥接双层一致的结果。

四、“换模型 = 重建”,而且必须是创建期

4.1 为什么不能当普通 uniform 更新

DLSSNR.Hint.Render.Preset 是在 createNrFeature 创建 feature 时传入的,见 src/pipeline/EnhanceGraph.cpp:

bool EnhanceGraph::createNrFeature(NrInstance& layer) {
    Status st=Status::Ok;const uint32_t nrW=layer.width(),nrH=layer.height();
    namespace p=ngx::dlssnr;ngx::ParameterBlock pb(ngxParams_);
    pb.setU32(p::kWidth,nrW);pb.setU32(p::kHeight,nrH);
    // ...
    const auto preset=engine::nrRenderPreset(desc_.nrRuntime,layer.model);
    pb.setI32(p::kHintRenderPreset,preset);pb.setU32(p::kStdWidth,nrW);pb.setU32(p::kStdHeight,nrH);
    log::info("nr-model",std::format("runtime={} preset={} performance={} internal={}x{}",
        engine::nrRuntimeName(engine::currentNrRuntime(desc_.nrRuntime)),preset,
        engine::currentNrRuntime(desc_.nrRuntime)==engine::NrRuntime::Ampere&&layer.model.performance,nrW,nrH));
    // ...
}

创建之后没有对应的“更新 preset”路径,这在结构上就否定了把它当 uniform 参数处理的可能。原文档因此把这条写成硬约束:A/B 是创建期切换,活动 NR 必须重建,禁止伪装成普通 uniform 更新。日志行 nr-model 就是排查这类问题时最直接的证据,它会打印实际 runtime、preset 值以及最终内部分辨率。

4.2 重建判定的位置:拓扑比较

真正决定“要不要重建”的是 sameNrTopology 与 requiresGraphRebuild。拓扑定义见 include/veyra/engine/EnhancementSettings.h,它对平铺路径和每层路径都做了模型比较:

bool sameNrTopology(const EnhancementSettings& other) const {
    if(nrLayerCount!=other.nrLayerCount)return false;
    if(nrModelSelection(nrRuntime,model)!=nrModelSelection(other.nrRuntime,other.model))return false;
    // ...
    for(uint32_t i=0;i<nrLayerCount&&i<nrLayers.size();++i){
        const auto& a=nrLayers[i]; const auto& b=other.nrLayers[i];
        if(a.enabled!=b.enabled||a.temporal!=b.temporal||a.usesTemporal()!=b.usesTemporal()||
           a.residual.correction.enabled!=b.residual.correction.enabled||a.runtime!=b.runtime||
           a.lowLatencyPairing!=b.lowLatencyPairing||a.sizePolicy!=b.sizePolicy||
           nrModelSelection(a.runtime,a.model)!=nrModelSelection(b.runtime,b.model))return false;
    }
    return true;
}

调用点在 src/engine/EffectChain.cpp,注释把“为什么排除滑块”讲得很清楚:

bool requiresGraphRebuild(const EnhancementSettings& savedPrevious, const EnhancementSettings& savedNext) {
    const auto previous=savedPrevious.activeVideoSettings();const auto next=savedNext.activeVideoSettings();
    if(!previous.sameNrTopology(next))return true;
    // Everything the graph allocates or branches on. Live uniform parameters
    // (NR model/residual sliders, colour values, protection rectangles, audio,
    // export bitrate) are deliberately absent: applySettings() handles them.

这里有两个设计要点。第一,比较用的是 activeVideoSettings(),即先过滤掉被旁路/关闭的层,所以关闭 NR、旁路层、原版、AMD 的无效模型编辑都不会触发重建。第二,AMD 走 nrModelSelection 抽象键而非 NGX preset(两者都返回 1/2 或 0),使得“模型变了要重建”这条规则对两种后端统一成立,但发出去的参数各自正确——这正是 3.2 节拆两个函数的原因。

4.3 单元测试如何锁住这些规则

上述行为不是靠人工点界面确认的,而是由 tests/unit/NrModelSettingsTests.cpp 固化:

EnhancementSettings s;s.nr=true;
check(s.nrRuntime==NrRuntime::Ampere&&s.model.performance&&nrRenderPreset(s.nrRuntime,s.model)==2,"fresh NVIDIA settings select SF preset B");
auto a=s;a.model.performance=false;
check(nrRenderPreset(a.nrRuntime,a.model)==1&&requiresGraphRebuild(s,a),"active SF model change rebuilds NR");

auto original=s;original.nrRuntime=NrRuntime::NvidiaOriginal;auto edited=original;edited.model.performance=false;
check(nrRenderPreset(runtime,edited.model)==0&&!requiresGraphRebuild(original,edited)&&
    original.sameActiveVideoParameters(edited),"NVIDIA original ignores the inactive performance option");

auto amd=s;amd.nrRuntime=NrRuntime::LmxxfAmd;
auto amdOriginal=amd;amdOriginal.model.performance=false;
check(nrRenderPreset(amd.nrRuntime,amd.model)==0&&requiresGraphRebuild(amd,amdOriginal)&&
    !amd.sameActiveVideoParameters(amdOriginal),"AMD model changes rebuild without setting an NGX preset");

四组断言分别覆盖:默认值、活动 SF 换模型要重建、原版静默忽略、AMD 重建但不发 NGX 预设。再加上两层场景(第二个活动层改模型要重建、被旁路层只保存不重建)与导出快照场景,这套测试基本把“哪些改动会打断播放”的边界画死了。

五、保留行为:每层独立保存,全链路一致

原文档“保留的行为”一节列了五条,这里逐条对应到实现。

5.1 版本选择与默认值

可见选项固定为三个:SF 310.9.16、NVIDIA 原版、AMD。列表与节点的选项由 src/ui/bridge/Hardware.cpp 生成,可用性来自运行库文件是否存在:

for (const auto& entry : std::initializer_list<std::pair<int, QString>>{
        {2, "RTX 20–50 · SF 310.9.16"}, {3, tr("RTX 50 · NVIDIA 原版")},
        {4, effectGpu().rx7000?tr("RX 7000 · RedDuke(实验)"):tr("RX 9000 · lmxxf(实验)")}}) {
    const auto cap = caps.value("nr" + QString::number(entry.first)).toMap();
    choices << QVariantMap{{"id", QString::number(entry.first)}, {"label", entry.second},
                           {"disabled", !cap.value("available").toBool()}, {"note", cap.value("reason")}};
}

能力位 nr2/nr3 直接探测 nr-ampere/nvngx_dlssnr.dll 与 nr-original/nvngx_dlssnr.dll,见 src/ui/bridge/Hardware.cpp;图侧加载同一路径,见 src/pipeline/EnhanceGraph.cpp。不支持的版本保留但置灰,这与早期的“隐藏不可用项”做法不同,好处是用户能看见自己的历史选择。

5.2 开关默认开、按层保存

NrSettings::performance 默认 true。它被放在 NrLayerSettings::model 里,因此天然是每层独立;kMaxNrInstances = 4(见 include/veyra/engine/EnhancementSettings.h),即最多 4 层各自持有一个模型选择。

5.3 复制、复位、预设、会话、导出携带同一设置

  • 复制/复位:NrLayerEditor.qml 提供“复制此层 / 恢复默认 / 删除此层”,复制的是整层结构,模型开关随层走。
  • 预设库:PresetLibrary.cpp 检测是否存在非默认 NR 模型设置并据此提升 schema 版本,见 src/engine/PresetLibrary.cpp 与 src/engine/PresetStore.cpp。测试把版本号写死成断言:VEYRA_PRESETS 32(平铺存储)与库 schema 13、会话 schema 8。
  • 导出:模型设置经 desc.nrLayersModel 传给图,见 include/veyra/engine/GraphDescription.h;图侧按索引取用,见 src/pipeline/EnhanceGraph.cpp。原文档记录的导出回执显示:A/B 分别启动导出 worker,原生 3840×2160、20–20.2 秒各 6 帧成功,worker 确实使用 hint 1/2,两输出 SHA 不同。

测试对这条链路的要求是“逐字节级”的:

check(sessions.save(*session)&&bytes(sessionPath)==sessionRollback,"detached editor model opts into session 8 and preserves old file");

即:新增字段写入后,只要值没变,序列化出的文件必须与旧文件完全相同。这比“能读回来”更严格,避免存量文件在无意间被改写。

5.4 预热、近期缓存与自动 NR 池的适配

缓存键是这轮改造里最容易被忽略的细节。见 include/veyra/engine/RecentGraphCache.h:

struct Key {
    EnhancementSettings settings;
    // ...
    std::wstring runtime;
    uint64_t nrFileBytes=0;int64_t nrFileTimestamp=0;
    bool operator==(const Key&)const=default;
};
// ...
auto module=std::filesystem::path(desc.runtimeAbsPath);
if(currentNrRuntime(desc.nrRuntime)==NrRuntime::Ampere)module/=L"nr-ampere";
else if(currentNrRuntime(desc.nrRuntime)==NrRuntime::NvidiaOriginal)module/=L"nr-original";
module/=L"nvngx_dlssnr.dll";std::error_code error;
result.nrFileBytes=std::filesystem::file_size(module,error);

settings 整体参与比较(其中含每层模型),再加上实际运行库文件的字节数与修改时间。这与原文档“缓存键使用实际 SF 文件路径及模型设置”完全对应:用户自己换了 DLL,缓存也会失效,不会拿旧图复用。

准入与预算规则同样被保留:eligible() 限定为“只有 NR、单层、无 SR/FG/HDR/调色、无时域稳定”的最小图;fits() 要求进程显存占用低于动态 WDDM 预算的三分之一,并留出 1.5 倍余量:

return bytes&&budget>usage&&usage<budget/3&&bytes<=UINT64_MAX/3&&(budget-usage)>bytes+bytes/2;

自动尺寸池的准入更窄,见 src/pipeline/EnhanceGraph.cpp:除了一串开关条件,还要求 deviceId==0x2f04(特定适配器)、workW_==1920&&workH_==1080、层数上限 8。文档里那句“原先特定 Lecram 双层 + DLSS 自动 COMPUTE 实验的准入未扩大到新运行库”,指的就是这条路径没有被顺手放宽。

这里要提醒一个测量陷阱,它写在原文档里也值得重复:自动尺寸池是实验路径,产品入口不会请求它,其 90 帧/5 尺寸的复用测试证明的是“池与独立重建逐帧相等”,不能当成常规播放路径的性能证据。

六、本机性能证据:只描述 GPU 阶段,不外推

6.1 测试条件

  • 硬件:RTX5070 / 驱动 616.56
  • 素材:用户 GTA6 原始 4K 视频
  • 软件:同一 2.0.8 EXE,2.0.8 与 2.0.9 共用同一测量链
  • 设置:单层 NR、总变化 1、风格 0、自动调控关,SR/FG/HDR/调色全部关闭
  • 顺序:旧/新/新/旧,每次约 29 秒,比较相同 8–21 秒内容区间

文档特意记录了一次测量纠错:首轮把 sizePolicy=1 当成 1080,实际是原生 4K,因此该列被单列、不作为 1080 数据使用。这种“把错误数据留在报告里并标注原因”的做法,比悄悄删掉更有价值。

6.2 结果

实际内部尺寸 旧 SF-v2 NR GPU 均值 新 310.9.16 默认模型 NR 耗时下降
1920×1080(已纠正配置) 5.87296 ms 3.20118 ms 45.49%
原生 3840×2160(补充测量) 约 21.29 ms 约 11.79 ms 约 44.6%

1080 档对应整条增强链约 7.1681 → 4.4958 ms。

原文档对这批数据的边界写得很克制,这里必须原样保留其含义:

  • 只描述本次源/设置下的 GPU 阶段;
  • 不是整机 FPS、画质、屏幕延迟或全型号性能保证;
  • 合成探针计时与实际视频计时不能混为同一场基准——3.15546ms 是 1920×1080 合成输入的探针中位数,3.20118ms 是真实 4K 视频降到 1080 内部推理的实测均值,两者数值接近但来源不同;
  • 直接 A/B 回执(direct1080.json、direct.json、model-hints.json)保存在当时的回执目录中,报告文字不替代回执。

6.3 画质对照的有限结论

同一暂停帧的 UI 对照给出两条结论:SF 模型 A 与保留的 NVIDIA 原版输出在该帧全 RGB 像素相等;A/B 输出存在差异。文档立刻加了限定——“这是该测试帧的结果,不是所有内容画质等价承诺”。这类限定正是技术文档与营销文案的分界线。

七、构建与回归:52 目标 / 745 输入以及六份回执

7.1 构建身份

最终产品提交 0ac9d39,52 个目标 / 745 个构建输入通过;EXE SHA256 7add56b9651d6b629433419fb0d2d9d077057d9a77595ebeabbf4d5fb3b80f80,显示 2.0.9-test,PE 版本 2.0.9.0;最终增量构建 22.7 秒。构建命令、依赖与逐文件 SHA 位于当时日志目录的 receipt.json;此后仅文档与 WORKLOG 变化,产品输入仍与回执一致。

这个“输入清单 + 逐文件 SHA + 产物 SHA”的组合,使得事后可以判断某个测试包是否由某棵树构建——而不是依赖时间戳或口头说明。

7.2 六份回执分别证明了什么

回执 已完成的实际检查
checks209.json 17 个测试进程通过:模型设置/重建条件、预设/会话/导出快照、运行库切换、链/事务/HDR 调节/迁移/几何、266 修复契约、322 字幕契约、原生游戏快捷键;Qt Quick 77 通过 0 失败;2424 条翻译全语言缺失/占位符错误 0;UI 合同 384 布局通过,设置事务 GPU 错误 0
ui209.json 真实 GTA4K 输入 / 1080 NR,英文专业模式:原图、模型 B/A、NVIDIA 原版、两层 B+A、XeSS 2X、节点风格 2/强度 5/自动调控、DLSS 2X、返回列表,共 9 张非黑 4K 图;无 QML 错误;关闭全部 NR 后编辑模型标记没有 Create/rebuild
restart209.json 独立进程重开:列表 B/A、模型 A 与混合预设、独立节点 A/风格 2/强度 5/调控均恢复;再返回列表仍保持;OBS 软件 UI 无错误
reuse209.json 8 个顺序测试通过:预热开/关输出相等;50 次开关的近期缓存与每次重建逐帧 SHA 一致、24 次命中、退出释放;自动 NR 池 90 帧/5 尺寸及 reset 与独立重建参考逐帧相等;1080i 软解 bwdif / 硬解 GPU 各 40 场含 EOF 和 seek 全通过,GPU 错误 0
export209.json、export-decode209.json A/B 分别启动协议 9 导出 worker,原生 3840×2160、20–20.2 秒各 6 帧成功,worker 确实使用 hint 1/2;独立 ffprobe 解码核对 4K/30fps/6 帧及颜色标记;两输出 SHA 不同,无导出错误
visual209.json 英文窄窗软件 UI 独立复核,原版性能模型行禁用并降至 0.4 透明度,文案完整换行;私有 QA 的 Main.qml 最终恢复源码原字节

reuse209.json 里的“逐帧 SHA 一致”是这套回归里最强的一条:它把“缓存命中会不会导致画面不同”变成了可判定的等式,而不是主观观察。ui209.json 里的“关闭全部 NR 后编辑模型标记没有 Create/rebuild”则直接验证了 4.2 节的旁路规则。

7.3 集成中发现并修复的构建问题

这是原文档里对工程实践最有借鉴意义的一节。问题现象:复用 CMake 缓存时,旧 FFMPEG_INCLUDE_DIRS 排在新去隔行前缀之前,导致即使启用去隔行选项,__has_include 仍静默把相关代码编译成 stub;真实 1080i 软/硬解测试才暴露问题。

修复方式是 0ac9d39 把已核验的 FFmpeg 前缀头文件明确置前,并去掉静默头文件探测,缺头文件时构建直接失败。对应代码见 CMakeLists.txt:

if(VEYRA_ENABLE_DEINTERLACE)
  if(NOT EXISTS "${VEYRA_FFMPEG_ROOT}/include/libavfilter/avfilter.h")
    message(FATAL_ERROR "Deinterlacing requires the filter prefix; ...")
  endif()
  target_compile_definitions(veyra_media PRIVATE VEYRA_ENABLE_DEINTERLACE=1)
  # A reused build tree may retain FFMPEG_INCLUDE_DIRS from the pre-filter
  # prefix. Compile against the prefix whose filter headers we just checked.
  target_include_directories(veyra_media BEFORE PRIVATE "${VEYRA_FFMPEG_ROOT}/include")
endif()

关键的 BEFORE 与 FATAL_ERROR 一起,把“静默降级”变成了“显式失败”。旧 FFmpeg DLL 没有被更换,最终软/硬两条路径含 EOF/seek 均通过。

7.4 失败夹具与证据保留

原文档在这一节记录了七类真实踩坑,值得逐条对照:

  1. 六个回归进程退出码 0 但图片复核撞上 GTA 片头黑场——退出码不能替代像素检查;改为 seek 到 20 秒自然场景重测。
  2. UI 夹具只改 nodeMode 未切 page/建立节点导致超时——夹具必须操作真实页面与有效节点。
  3. 2.0.9 模型测试初编译错用 PresetLibrary 私有 API——改用公开 put/load。
  4. 保存夹具错误启用未声明的备用层——改为按有效层数构造。
  5. Qt 夹具忘记展开卡片导致新项失败——补真实展开后 77 项通过。
  6. 脚本请求未构建 HDR 目标——启动前中止并纠正清单。
  7. UI 夹具曾只关闭选中层——改用 setAllNrEnabled(false) 再验证无效参数编辑。
  8. 截图异步保存被立即退出取消——增加“保存完成后退出”的等待。
  9. 导出夹具误调用非 invokable 路径 setter、再误写 JS 属性,弹文件选择框引发重入;重试时残留测试注入造成重复 id——只终止本轮私有 QA 父子进程、恢复 Main.qml、改用现有 --export-out 并先推进测试阶段。
  10. D3D12 单个离屏 QML 元素的抓图不是有效界面证据——改软件后端完整窗口内容抓图;透明背景初次抓图需显式绘制背景。

这十条的共同结论写在文档最后一句:不将夹具失败冒充产品修复,原失败日志、图与回执全部保留。对任何做 GPU + UI 混合回归的团队,这几乎是一份检查表。

八、本地交付与边界

8.1 封包与冷启动

封包命令为:

py -3.11 -X utf8 -B -I E:/项目/Veyra/tmp/nr-sf-310916-20261017/package209.py seal

随后同脚本执行 cold。输出为 E:/项目/Veyra/test-packages/nr-sf-310916-20261017 下的 NVIDIA / AMD 两个便携 ZIP、应用对应源码及三个依赖源码档;每包带逐文件 manifest、运行时身份与许可。封包逐文件校验与解压后两后端各一次冷启动的实际状态,分别以同级 DELIVERY.json、cold-start.json 和 reports 中的 package.json 为准——文档明确要求不以报告正文代替这些回执。

这条纪律同样体现在 docs/history/releases/BUILD_2.0.9.md 中:正式发布是把已交付的 2.0.9-test ZIP 原样晋升、只改外名,并同时给出应用源、去隔行模块 FFmpeg 源、既有 slices256/dav1d/zlib FFmpeg 源与依赖重链接材料的 SHA256。

8.2 封包前的独立审计

  • 82 个旧工作树、94 个旧分支、509 个未提交文件完全保持;
  • main 仍为 b571a44;
  • 745 个输入 / 52 个 EXE / 1522 个共享运行文件 SHA 一致;
  • 候选运行库与用户原始 DLL 一致;
  • QA 无残留进程。

最终归档审计见 reports 中的 final.json 与 archives 中的 source-after.bundle。文档明确写:没有推进 main、没有推送、没有公开发布。

8.3 明确未验收的部分

这一节是本报告可信度的核心,也应被视为使用该测试包时的风险清单:

  • RTX20/30/40 与 AMD 实卡未在本轮完成验收;作者虽声明 SM75/86/89 兼容,本机仅 RTX5070 实际验证。
  • 长期显存增长未验收——运行复用的短测不能替代长期泄漏验收。
  • 屏幕端延迟未验收。
  • 文档明确写道:NV 长期显存问题没有借本轮换模型宣称已根治。

九、可复现的核查路径

如果你要在当前仓库里验证本文提到的每一条,建议按以下顺序:

  1. 看结论与边界:docs/history/reports/NR_SF_310916_REPORT_2026-10-17.md、docs/history/plans/NR_SF_310916_PLAN_2026-10-17.md、docs/history/releases/BUILD_2.0.9.md。
  2. 看契约:include/veyra/engine/EnhancementSettings.h、include/veyra/ngx/DlssNrParameters.h。
  3. 看图重建:src/engine/EffectChain.cpp、src/pipeline/EnhanceGraph.cpp。
  4. 看缓存与预算:include/veyra/engine/RecentGraphCache.h。
  5. 跑模型设置回归:目标 veyra_nr_model_settings_tests(见 CMakeLists.txt),用例在 tests/unit/NrModelSettingsTests.cpp。
  6. 跑参数探针:目标 veyra_nr_model_preset_experiment(见 CMakeLists.txt),源码 tests/perf/NrModelPresetExperiment.cpp。
  7. 看 UI 与桥接一致性:qml/Veyra/NrLayerEditor.qml、src/ui/bridge/Chain.cpp、src/ui/bridge/Hardware.cpp。

需要强调的前置条件:

  • 该运行库为 NotSigned 的社区兼容构建,仅限本轮授权的本地测试范围,不构成再分发许可;
  • 探针与复用测试的数值来自 RTX5070 单卡单机,跨型号不可直接套用;
  • 工具侧的探针(如 tools/nr_harness/main.cpp)仍固定传 kHintRenderPreset=0,产品图才走 1/2 映射,两者用途不同,不要相互推断。

十、这套做法可以复用到哪类改动

把这次集成抽象一下,它给出的是一套“替换黑盒运行库并新增可控旋钮”的通用流程:

  1. 先固定身份:版本、大小、签名状态、SHA256 四项齐全,并记录来源声明的具体 tag;
  2. 再验证语义:用同一输入、预热 + 中位数、重复回访、像素有效性、GPU 错误计数五项约束的探针,确定每个新参数的取值含义,明确拒绝“自动值”进入产品路径;
  3. 然后设计迁移:新 ID 与退役 ID 并存,读取时归一,写入时保留用户显式选择;
  4. 接着处理生命周期:凡是创建期参数,就必须进入拓扑比较与重建判定,并单独验证“关闭/旁路时不重建”;
  5. 同步所有持久化出口:预设、库、会话、节点草稿、导出快照、缓存键,一个都不能漏,且要求“值未变则文件字节不变”;
  6. 最后用回执说话:每项验收对应一份 JSON,错误数据留档并标注原因,未验收项显式列出。

Veyra-NRVideo 在这次改动中没有把“换了新模型、快了 45%”当作结论,而是把结论限定在“RTX5070 + 驱动 616.56 + 该源该设置 + GPU 阶段”,并同时交出 0 GPU 错误、逐帧 SHA 相等、独立进程重启恢复、导出 worker 真实使用 hint 1/2 这些可复核的事实。对于需要长期维护的视频增强工具,这种证据密度比任何单点性能数字都更有工程价值。

登录后查看全文
Veyra-NRVideo