Veyra-NRVideo 2.0.9 深度解析:SF 310.9.16 NR 性能模型、HDR 曲线调节与播放兼容修复
Veyra-NRVideo 2.0.9 深度解析:SF 310.9.16 NR 性能模型、HDR 曲线调节与播放兼容修复
本篇围绕 Veyra 2.0.9 的发布说明展开,逐项拆解四个技术主题:NVIDIA NR 运行库从旧 SF-v2 切换到社区兼容的 SF 310.9.16 后的“性能模型 A/B”契约、PR44 引入的 HDR 静态曲线与稀疏统计、长片字幕的 PGS 缓存预算修复,以及网络播放、去隔行、VRR 与游戏热键等兼容性改动。读完后你可以准确判断每个改动的适用前提、参数取值范围与源码落点,并知道哪些结论来自实测、哪些仍属于有边界的待验证项。
说明:2.0.9 是一份历史版本发布记录,当前仓库的版本号已经继续向前迭代,但本篇涉及的多数实现文件(NR 架构策略、HDR 调节、字幕预算、热键、VRR 探测、去隔行模块)仍保留在仓库中,因此源码引用对理解该版本行为依然有效。原始发布材料见 RELEASE_NOTES_2.0.9、BUILD_2.0.9 与 RELEASE_2.0.9_CHANGE_INDEX。
版本定位:2.0.8 之后整合了什么
2.0.9 的定位不是一次架构重写,而是把 2.0.8 以来若干已完成分支收敛进同一个可交付包:NR 运行库换成新版 SF 310.9.16、合并贡献者 PR44 的 HDR 显示调节、修复 issues 41/42/43/45,以及字幕缓存与游戏穿透快捷键的用户补丁。既有能力(VFG 混合档、XeSS 边缘神盾、低延迟链路、采集与串流)保持不变。
按发布说明与变更索引的说法,AMD 专有组件与模型保持原件,只有 NVIDIA NR 的运行库被替换;这正是理解后续“为什么 A/B 开关只对 NVIDIA 生效”的前提。
下载、升级与“原样晋升”的打包策略
两个交付包分别是 NVIDIA 与 AMD 便携包(发布说明中的下载链接指向项目的 Release 页面,此处不再重复外部地址)。升级方式很简单:
- 把 ZIP 完整解压到一个可写的全新目录;
- 运行
veyra_qml_ui.exe; - 旧版本目录保留,便于回退。
值得注意的是发布流程的特殊之处:两个已经完成测试的 ZIP 原样晋升,只改外部文件名为正式发布名,包内仍保留 2.0.9-test 文件夹与清单标志,而 Windows 文件版本已是 2.0.9.0。发布说明明确解释了动机——保留实际已验字节,不冒称重新编译过正式 EXE。构建文档补充了这一点:正式发布 EXE 使用 -DVEYRA_DISPLAY_VERSION=2.0.9-test 与 -DVEYRA_ENABLE_DEINTERLACE=ON 构建,EXE 的 SHA256 为 7add56b9651d6b629433419fb0d2d9d077057d9a77595ebeabbf4d5fb3b80f80。
这种策略有一个直接可观测的副作用:包内版本字符串与文件名不一致。排查问题时以文件版本 2.0.9.0 和 PE 资源为准,不要用目录名判断。
一、SF 310.9.16 NR:默认性能模型与旧模型开关
1.1 默认行为:RTX 20–50 走兼容构建,模型 B 默认开启
发布说明给出的默认规则很明确:
- RTX 20–50 默认选择 SF 310.9.16 兼容构建;
- 每层界面新增“启用性能优化版”开关,默认开启,使用内置模型 B;
- 关闭该开关,则使用同一 DLL 中的旧模型 A;
- 不需要用户自己来回替换 DLL;
- NVIDIA 原版继续保留,选择它时该开关置灰;AMD 不显示此开关。
这条“默认选择”在源码里是一个纯函数策略,见 NrArchitecturePolicy.h:
constexpr bool preferSfNr(uint32_t vendorId, std::wstring_view description) {
return vendorId == 0x10DE && (description.find(L"RTX 20") != description.npos ||
description.find(L"RTX 30") != description.npos || description.find(L"RTX 40") != description.npos ||
description.find(L"RTX 50") != description.npos);
}
注释写得很克制:这只是“全新 UI 的默认值”,从预设或会话恢复出来的显式选择优先;未知或专业卡的适配器不会按 PCI 范围去猜。对应测试在 RepairPresetTests.cpp 中覆盖了 RTX 20/30/40/50 与反例(非 NVIDIA vendor、未知描述)。
1.2 A/B 是创建期参数,不是逐帧 uniform
“性能优化版”开关最容易误解的地方是它的生效时机。它映射到 NR 创建时的 I32 参数,而不是每帧更新的 uniform。源码在 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.
bool operator==(const NrSettings&) const = default;
};
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;
}
要点提炼:
| 运行库 | performance=true | performance=false | 传入值 |
|---|---|---|---|
| SF(Ampere 槽) | 模型 B | 模型 A | 2 / 1 |
| NVIDIA 原版 | 忽略 | 忽略 | 0 |
| AMD(lmxxf) | Small | Original | 不设 NGX preset,走自身选择 |
注意 nrRenderPreset 对 NVIDIA 原版恒返回 0——这与发布说明“选择 NVIDIA 原版时该开关置灰”一致,也解释了为什么改这个开关不会影响原版路径。发布说明还强调“新开关不用 0 自动选择”,即不会退回到让运行库自行判断模型的旧行为。
1.3 界面落点
开关本身在 QML 层,见 NrLayerEditor.qml:
objectName: "nr-performance-row"
label: qsTr("启用性能优化版")
...
VSwitch {
objectName: "nr-performance"
checked: editor.layerData.performance ?? true
onToggled: checked => editor.edited(editor.layerData.index, "performance", checked ? 1 : 0)
}
checked 的默认回退是 true,与“默认开启”一致;列表视图与节点视图共用同一个 NrLayerEditor,因此复制/复位、预设、列表/节点各自会话、继续上次以及导出都携带同一份模型设置——这一点在发布说明里被单独强调,测试也验证了“导出快照保留每层模型”。
1.4 什么时候会重建,什么时候不会
这是实用价值最高的部分:调整模型设置并不总是打断播放。
- 活动 NR 切 A/B 需要重建,可能造成短暂停顿;
- 效果关闭(
nr=false)或该层被旁路时,调整无效的模型设置不会重建,播放不中断; - NVIDIA 原版下编辑该开关同样不触发重建(因为它被忽略)。
这些行为由 requiresGraphRebuild 与 sameActiveVideoParameters 判定,单元测试逐条覆盖,见 NrModelSettingsTests.cpp:包括“活动 SF 模型变化触发重建”“NVIDIA 原版忽略无效开关”“AMD 模型变化重建但不设 NGX preset”“关闭 NR 后编辑不打扰播放”“第二层活动层变化重建”“旁路层仅保存不重建”“导出快照保留每层模型”。
1.5 架构改写策略:为什么新运行库不能沿用旧 hack
旧方案里存在一个“把 Ampere 架构号改写成 Blackwell 槽位”的技巧,用来让某些构建在不支持的架构上跑起来。这个策略对新 SF 家族是危险的,因为新运行库会自己根据真实架构选择 FP16 路线。源码注释把这个历史讲清楚了(NrArchitecturePolicy.h):
constexpr bool nrRuntimeNeedsAmpereRewrite(uint32_t fileVersionMs, uint32_t fileVersionLs) {
const uint32_t major=fileVersionMs>>16, minor=fileVersionMs&0xFFFFu, build=fileVersionLs>>16;
const bool sfLegacy=major==310u&&minor==8u&&build>=2u;
const bool sf310916=fileVersionMs==((310u<<16)|9u)&&fileVersionLs==(16u<<16);
return !(sfLegacy||sf310916);
}
即:310.8.2 及之后的 SF 家族、以及 310.9.16 兼容构建都不需要改写;未知版本保留历史策略,而不是把所有未来版本都当成兼容。版本号来自已加载 DLL 的 VS_FIXEDFILEINFO,所以判定是“按实际文件身份”而非按文件名。
同时,rewriteNrAmpereArchitecture 只在查询成功且确实选中的 Ampere 适配器上生效,其他 GPU 与驱动失败保留原结果——这是防止一处改写污染其它路径的设计。
1.6 本机实测:45.49% 的 NR GPU 耗时下降意味着什么
发布说明给出的实测条件是:RTX 5070 12GB、驱动 616.56、GTA6 原 4K 视频、单层 NR、强度 1/风格 0,调控/SR/FG/HDR/调色全关,GPU 优先级一致;同一个 2.0.8 EXE 只更换 SF 槽文件,按旧/新/新/旧顺序比较相同的 8–21 秒内容区间。
| 内部 NR 尺寸 | 旧 SF-v2 NR GPU 均值 | 新 SF310.9.16 默认模型 | NR GPU 耗时下降 |
|---|---|---|---|
| 1920×1080 | 5.87296 ms | 3.20118 ms | 45.49% |
| 原生 3840×2160(补充) | 约 21.29 ms | 约 11.79 ms | 约 44.6% |
1080 档对应整条增强链的 GPU 阶段约 7.1681 → 4.4958 ms。原始报告 NR_SF_310916_REPORT_2026-10-17 补充了一个重要细节:首轮尺寸夹具误把“原生 4K”当成 1080 档,复核后单独列出真正的 1080 数据,不把 4K 结果伪装成 1080 收益。
必须明确的边界(发布说明自己写了):
- 新旧模型画面可能不同,这不是“同画质提速”的等价对比;
- 这是特定内容、特定设置的 GPU 阶段耗时,不等于全型号 FPS、屏幕端到端延迟或万能画质提升;
- 作者兼容构建面向 20–50,但本轮本机只实际验证 5070,20/30/40 仍需对应实卡反馈。
1.7 缓存、预热与旧选择的迁移
发布说明提到预热、近期图缓存和自动 NR 尺寸池都已适配新 SF,缓存区分“实际 DLL 与模型”,并保留预算与退出释放规则。报告中的验证方式是“50 次近期缓存开关和 90 帧自动尺寸池与重建参考逐帧 SHA 一致”,属于可复现的等价性检查,而不是主观观感。
迁移规则同样明确:新 NVIDIA 包删除 Lecram 与旧 SF-v2 文件;旧 0/1 选择迁移到新版 SF;明确保存的“NVIDIA 原版/AMD”选择保留。报告把它们写成保留项 1:可见的 NVIDIA NR 只有 SF310.9.16 与 NVIDIA 原版,旧 0/1 枚举仅用于读取并迁移到 SF,显式原版 3 / AMD 4 保留。
二、HDR 显示调节:PR44 整合与性能适配
2.1 五张卡片与两套选档体系
显示页被重排为五张卡片:读数、快捷选档、基础调节、精确参数、记忆与自动化。切换选档界面本身不改画面;换预设不覆盖强度与显示器峰值——这条约束是让“选预设”和“调力度”互不干扰的关键。
实现上存在两套并行的选档体系,都在 HdrOutputTuning.h 中定义为编译期常量表:
- 七个传统一键预设(
kHdrTuningPresets):同时设置曲线与 HDR10 元数据; - 内容 × 环境二轴组合(
kHdrContentPresets):内容轴描述片子长什么样,环境轴只移动中灰参考。
七预设的原始参数如下(字段顺序:启用 / 提亮 EV×100 / 影响上限 nits / 中灰 nits / 高光起点 nits / 滚降百分比 / 硬上限 nits):
| 预设 id | 启用 | 暗部提亮 | 影响范围 | 中灰 | 高光起点 | 滚降 | 硬上限 |
|---|---|---|---|---|---|---|---|
| standard | 否 | 0 | 10 | 203 | 0 | 100 | 0 |
| darkLift | 是 | 50 | 35 | 225 | 0 | 100 | 0 |
| highlightGuard | 是 | 0 | 10 | 203 | 450 | 120 | 1000 |
| darkAndBright | 是 | 50 | 35 | 220 | 450 | 120 | 1000 |
| brightRoom | 是 | 30 | 30 | 250 | 0 | 100 | 0 |
| darkRoom | 是 | 40 | 35 | 185 | 600 | 130 | 800 |
| punch | 是 | 0 | 10 | 175 | 450 | 110 | 1200 |
代码里还有一个容易被忽视的细节:注释声明这些表是故意静态的——没有任何参数跟随画面内容变化,因此画面不会“呼吸”。这正是与逐帧自适应方案的分水岭。
2.2 精确参数的取值范围(源码级)
HdrCurveSettings::valid() 给出了完整校验边界,可直接作为填写参数的参考:
| 参数 | 含义 | 取值范围 | 默认 |
|---|---|---|---|
shadowLiftEv100 |
暗部提亮,单位 1/100 EV | -200..200 | 0 |
shadowRangeNits |
提亮影响上限(nits) | 1..100 | 10 |
midGrayNits |
中灰参考(nits,BT.2408 的 203 为中性) | 100..500 | 203 |
highlightStartNits |
高光滚降起点(nits) | 0 或 100..2000 | 0 |
rollOffPercent |
滚降强度,越大越软 | 10..200 | 100 |
peakCapNits |
硬上限(nits) | 0 或 100..4000 | 0 |
strengthPercent |
单旋钮强度 | 0..200 | 100 |
displayPeakNits |
显示器峰值(0 = 询问系统) | 0 或 100..10000 | 0 |
元数据侧(HdrMetadataSettings::valid())的上限是 DXGI 的 16 位 MaxCLL/MaxFALL 范围约束:masteringPeakNits 取 0 或 100..10000,maxCllNits / maxFallNits 取 0 或 1..10000,masteringMinNitsX10000 以 0.0001 nit 为单位(默认 50,即 0.005 nit),上限 1000000。
非法参数会被拒绝,而不是被悄悄夹到边界——这一点与发布说明中“非法参数拒绝”的修复项对应。
2.3 两步求解:显示器峰值缩放,然后强度插值
resolveHdrTuning 是整条链的核心,因为它把“预设 + 强度 + 显示器峰值”解析成真正下发的数值。顺序不能颠倒:
- 先按显示器峰值缩放:预设的高光数字是按 1000 nits 显示器写的,按
displayPeakNits / 1000缩放,并夹到各字段的合法区间。600 nits 显示器会更早开始滚降、上限更低;2000 nits 显示器则能用上被预设“扔掉”的亮度。 - 再套用强度旋钮:凡是有中性值的字段都向中性值插值(提亮与范围 → 0,中灰 → 203,滚降 → 100),而高光起点是反向的(起点越低效果越强,所以除以 k)。硬上限属于保护值,不跟随旋钮。
以下两条性质直接决定 UI 手感:
- 强度为 0 且曲线启用时,曲线被彻底淡出(
enabled=false); hdrPresetMatches在比较时刻意忽略强度与显示器峰值,只比较基线。所以移动旋钮或改显示器峰值,你不会掉到“自定义”状态;只有编辑基线滑块才会。
2.4 推荐档位是纯函数,可以单独验证
发布说明说“可记忆影片/显示设备,按片源容器元数据和系统显示信息给出推荐;首次自动选档默认关,已保存影片选择优先”,并且明确“推荐不是逐帧识别剧情,也不替代屏幕校准”。
recommendHdrTuning 只吃四个数:masteringPeakNits、maxCllNits、maxFallNits、displayPeakNits,全部来自容器元数据。核心判断:
- 完全没有元数据(屏幕捕获、部分流)→ 直接返回
no-metadata,不猜; MaxFALL/MaxCLL ≤ 0.20(长时间暗场 + 少量高光)→ 暗场提亮类;- 母带峰值 < 600 nits(窄动态旧片)→
punch; - 内容峰值远超显示器能力、或
MaxCLL ≥ 4000、或比值 ≥ 0.45 →highlightGuard; - 其余 →
standard。
注释特意说明判断顺序的理由:暗片即便上限低也仍需提亮,而上限低更适合“加冲击力”而不是“保护高光”——老转制根本没有极端高光可保护。这套逻辑之所以能被引用,是因为它是纯函数并且被单元测试覆盖,见 HdrOutputTuningTests.cpp。
2.5 读数卡与稀疏 GPU 统计:为什么不是零开销
发布说明写得非常精确:读数卡展开且曲线生效时最多每 250ms 统计一次,只异步读回 20 字节计数;隐藏即停止;无正常播放像素回读、无额外提交、无逐帧 CPU 等待;保留 33ms/250ms 的界面节奏。
20 字节这个数字可以在着色器里对上:统计探针是 64×36 的稀疏采样,输出 5 个 uint 槽位(总数、上限以上、滚降内、提亮内、峰值),见 HdrCurveCoverage.hlsl。而“曲线图和元数据使用相同实际解析参数”是可验证的设计约束——HdrOutputTuning.h 里的 hdrCurveLuminance 明确声明自己是 shaders/PresentBlit.hlsl 中 HdrCurveLuminance 的逐行移植,注释要求两边必须同步,包括所有默认无操作的分支。
同一文件还解释了一个实际踩过的坑:覆盖探针渲染进 swapchain 的 10-bit UNORM,只能承载 PQ 码值,若直接写线性 nits,则 1.0(=80 nits)以上会被全部压平,任何周期都统计不出高光桶;因此保留编码在 GPU 侧、再在 CPU 侧用 pqCodeToNits 解码,从而保住 0..10000 nits 全范围。
发布说明对此的措辞很谨慎:“未宣称零开销或无测量依据的性能百分比”。这与 2.0.9 整体的证据风格一致。
2.6 记忆、防抖与状态机修复
- 记忆维度:影片按片源容器元数据、显示设备按系统显示信息;
- 上限:最多 60 部影片 / 32 台显示器;
- 保存防抖:400ms;
- 兼容旧环境 ID(环境轴改名后仍有映射,见
hdrAxesCurve中对bright/dark旧 id 的处理)。
修复项包括:黑帧零读数、过期统计清理、自定义预设与未知亮度状态、非法参数拒绝、“已应用”只在设置被接受后才上报,以及打开片源时提前记忆、停止/切源漏保存、清除后立即重建。原始验收记录见 PR44_HDR_DISPLAY_REPORT_2026-10-16,发布说明也保留了贡献者 georgeg911 的原提交与来源。
三、长片字幕:从 64MiB 固定预算到 4GiB 按需上限
3.1 问题本质
共享 PGS 位图缓存原来使用 64MiB 预算。对长片、多轨、后段字幕密集的素材,预算会在播放后半段被耗尽,导致后段字幕无法定位或显示。修复方式是把默认预算抬高到 4GiB,同时修掉 64 位乘法与严格范围检查,并保留坏数据、尺寸、数量、取消防护。
源码把这条“不是预分配”的语义写进了常量注释,见 SubtitleCacheBudget.h:
// A ceiling on compressed cue storage, not an allocation/reservation of 4 GiB.
inline constexpr uint64_t kDefaultSubtitleCacheBytes = 4096ull * 1024ull * 1024ull;
inline uint64_t subtitleCacheBudgetBytes(std::string_view mib) {
if (mib.empty()) return kDefaultSubtitleCacheBytes;
uint64_t value = 0;
const auto parsed = std::from_chars(mib.data(), mib.data() + mib.size(), value);
if (parsed.ec != std::errc{} || parsed.ptr != mib.data() + mib.size() || value < 1 || value > 65536)
return kDefaultSubtitleCacheBytes;
return value * 1024ull * 1024ull;
}
三个工程细节值得记录:
- 这是压缩 cue 存储的上限,不预分配 4GiB,也不占同等显存;
- 配置单位是 MiB 字符串,合法区间 1..65536,解析失败或越界静默回落到默认值(而不是夹到边界或崩溃);
- 上限可配置意味着用户可以自行下调,但发布说明未宣称所有用户影片都逐一验证过。
消费点在 Subtitles.cpp:size_t(subtitleCacheBudgetBytes(cacheSetting ? ... )),说明预算是一个运行期参数而非硬编码常量。
3.2 验证样本与残留边界
发布说明给出的复现样本是:五轨、200 条、75MiB 实际压缩 PGS。旧预算下后段截断可复现,新预算下五轨后段均可定位并显示;同时 PGS/SUP/VobSub/DVB/文本与异步加载继续回归。回归代码在 SubtitleCacheTests.cpp。
另外发布说明提到“拒绝日志限频,避免坏字幕刷屏”——这类防护在故障素材上比收益更明显。
四、游戏画面对齐与可自定义穿透快捷键
4.1 对齐:按真实可见边界,而不是按窗口矩形
屏幕捕获的游戏模式改为按原窗口真实可见边界或显示器区域对齐,并修正鼠标位置;处理了 Qt 缩放与物理取整。行为约定:
- 窗口化游戏保持原位置/尺寸,其余区域留黑;
- 想铺满显示器请用无边框全屏;
- 普通电影与专业播放条的既有布局不受影响;
- 窗口跟随沿用 250ms 几何缓存,没有新增视频帧缓存。
这最后一条是性能红线:对齐逻辑只处理几何,不允许顺手多缓存一帧。
4.2 热键:默认 Home / Ctrl+Alt+Home,独立消息线程
设置→快捷键可自定义两个动作:“游戏模式:调整画面”和“游戏模式:退出鼠标穿透”,默认分别是 Home 与 Ctrl+Alt+Home,支持冲突检查、保存/重启与还原,提示同步显示实际键位。
实现见 GameHotkeys.h,几个关键设计点值得逐条说明:
- 修饰键限定:只接受 Ctrl/Alt/Shift,Win 被保留(
gameKey遇到 Win 修饰直接返回空),这与变更索引中“保持不支持的 Win 修饰键对快捷键校验可见”的提交呼应; - 键位打包:五个 12-bit 槽位(vk 8 位 + mods 4 位)打包进一个
uint64_t,槽位依次是面板、退出、截图、录制、保存回放;配置更新用原子整体替换,避免读到半新半旧的组合; - 独立消息线程:
SetWindowsHookExW(WH_KEYBOARD_LL, ...)跑在专用线程,用MsgWaitForMultipleObjects带QS_ALLINPUT保持泵活;这是修复“钩子消息泵在有待处理输入时睡死”的直接结果; - 左右修饰键配对:
VK_LCONTROL/VK_RCONTROL、VK_LMENU/VK_RMENU、VK_LSHIFT/VK_RSHIFT、VK_LWIN/VK_RWIN都参与状态计算,避免右手 Ctrl 触发不了左手绑定的组合; - 长按/重复抑制:
repeat与claimed_双状态保证一次按下只产生一个动作;claimed在抬起时清除; - 作用域限定:除“退出穿透”外,其他动作只在画面拥有按键(
panelOwned)时生效,保证 Veyra 在前台时不会把同一个键响应两次,也不抢其它程序的键; - 撤销安全:
stop()递增epoch_,投递前校验epoch一致,旧事件自动失效;投递失败记录GetLastError便于诊断; - 不注入:文件头注释明确“No input injection into games”。
模块状态与失效路径也有明确交代:start() 前先 stop(),非窗口句柄直接失败,钩子安装失败通过 promise 同步返回。
4.3 边界
发布说明与英文部分都写明:独占、反作弊、提权游戏,以及跨屏混合 DPI 仍需实机验证,不保证封锁所有游戏的 Raw Input 按键。全屏切换的输入接管时序也做了修复——先完成激活再把输入交给游戏,解决重入时的焦点错误。
五、播放与兼容修复
5.1 #42 网络播放:Ctrl+U 与截止策略
首页与来源菜单新增“播放地址”,快捷键 Ctrl+U,支持 HTTP/HTTPS/RTSP 直接媒体地址,以及把单个地址拖入,共享原有的 FFmpeg/音频/增强链。
协议识别是显式的,见 NetworkInput.h:解析冒号前的 scheme 并转小写,仅 http/https/rtsp 视为网络媒体输入,且冒号位置超过 5 视为不是 scheme(排除盘符误判)。
发布说明中的“网络操作 5 秒截止、可取消”反映的是当时实现:打开、探测、读取共用一个 5 秒期限。当前仓库的实现已经演进为分段截止,且注释直接记录了这次演进的动因:“旧版把同一个 5 秒限制同时用于 open、probe 与每次 read,导致慢服务器或 Wi‑Fi 抖动被报为来源失败”。现在的常量是:连接 40000ms(其中死连接由 rw_timeout 15s 切断)、探测 30000ms、点播单次读/seek 20000ms、直播单次读 10000ms,同时保留 owner 取消标志立即中止阻塞调用。引用这段历史时请注意版本差异,不要把它当成 2.0.9 的行为。
其它约束:
- 直播暂停后重连继续,避免旧连接积压;
- 不支持任意网页/网页登录内容;能否拖动由媒体与服务器 Range 能力决定;
- 隐私处理:标题只显示主机,URL 中的账号/token 不进入最近文件、播放列表与配置;
- 不伪造“直播离线导出”。
5.2 #41 自动去隔行:软解 bwdif、硬解 GPU
设置→播放中新增保存开关,默认开,下次打开文件生效;仅处理解码器标记为隔行的文件/网络视频,逐行素材旁路;模块不可用时开关明确置灰。
界面文案与可用性判定在 SettingsPage.qml:veyra.deinterlaceAvailable 为假时显示“当前软件包未包含去隔行组件”并禁用开关。状态回显在 EngineController.cpp,格式形如 去隔行:GPU/兼容软解 · 50.000i → 50.000p。
实现是可选 LGPL FFmpeg 过滤模块,见 FFmpegDeinterlacer.h:available()、open()、push()、receive()、close()。运行期按像素格式选择滤镜(FFmpegDeinterlacer.cpp):
- 软解帧 →
bwdif,参数mode=send_field:parity=auto:deint=interlaced; - D3D12 硬件帧 →
deinterlace_d3d12,参数method=default:mode=field:deint=interlaced,路径标记d3d12-video-processor; - 日志明确打印
fieldRate=true与gpuPixelReadbacks=0——场率翻倍且 GPU 像素零回读。
available() 同时要求 avfilter_get_by_name("deinterlace_d3d12") 与 ("bwdif") 都成功,任一缺失即视为不可用(FFmpegDeinterlacer.cpp)。
PTS 处理是这个模块最容易出问题的地方,源码做了两件事:入队时为每帧记录 pts、duration 与 fields(按 AV_FRAME_FLAG_INTERLACED 取 2 或 1);receive 时把输入时基重标到输出时基,并把 duration 按场数均分,第二场加上偏移。缓冲区上限 32 帧,超限返回 ENOBUFS;AVERROR_EOF 但仍有未消费时钟时返回 AVERROR_INVALIDDATA,避免悄悄丢场。这正好对应发布说明中的“保留真实场 PTS,修正可见尺寸、输出 fence/参考生命周期、EOF 尾场和 seek 重置”。
5.3 集成构建:不要被 CMake 缓存骗了
发布说明记录了一个很典型的构建陷阱:复用 CMake 缓存时,旧 FFmpeg 头文件优先,选项虽然打开却被静默编成 stub,功能表面存在、实际什么都不做。修复后的做法是显式核验前缀,缺头文件直接构建失败,见 CMakeLists.txt:
option(VEYRA_ENABLE_DEINTERLACE "Enable optional LGPL FFmpeg deinterlacing module" ON)
...
if(VEYRA_ENABLE_DEINTERLACE)
if(NOT EXISTS "${VEYRA_FFMPEG_ROOT}/include/libavfilter/avfilter.h")
message(FATAL_ERROR "Deinterlacing requires the filter prefix; run scripts/ffmpeg/build-deinterlace-module.py and set VEYRA_FFMPEG_ROOT to its prefix (or explicitly disable VEYRA_ENABLE_DEINTERLACE).")
endif()
target_compile_definitions(veyra_media PRIVATE VEYRA_ENABLE_DEINTERLACE=1)
endif()
源码里也保留了编译期开关:available()、open()、push()、receive() 都包在 #ifdef VEYRA_HAS_AVFILTER_HEADERS 内,未定义时分别返回 false / AVERROR(ENOSYS)。构建材料见 BUILD_DEINTERLACE_2026-10-16,独立模块 avfilter-12.dll 的 SHA256 为 a1b1db7d702f23fb2851b6733071c815da2f753995a7f7490768ab05e3c00a4d(248832 bytes),LGPL 补丁、构建信息与许可证齐全,原 patched FFmpeg 五 DLL / dav1d 保留。
5.4 #45 VRR:区分“可请求”和“驱动实际活动”
这是一个典型的“不要伪报状态”的修复。发布说明要求:不因 possible/requested/activity 为 false 就断定用户没开 G-SYNC;未收到真实活动状态时说明“等待确认”,不伪报已启用,也不改驱动控制面板。
源码把状态建模为两级判断(NvidiaVrr.h):
constexpr bool vrrPresentationAvailable(const VrrState& s){
return s.enabled||s.inVrrMode||s.possible||s.requested
||(s.capsKnown&&s.supportsVrr&&s.currentlyCapable);
}
// 0 unknown, 1 unsupported, 2 supported but unavailable in the applied mode,
// 3 presentation may request VRR (activation unconfirmed), 4 driver reports active.
constexpr unsigned vrrLevel(const VrrState& s){
if(!s.known)return 0;
if(s.enabled||s.inVrrMode)return 4;
if(vrrPresentationAvailable(s))return 3;
if(s.supportsVrr||s.currentlyCapable)return 2;
return 1;
}
也就是说:驱动明确报告活动才给 4(可宣称已启用);通用显示器能力说“当前应用模式支持 VRR”时给 3(可以请求呈现,但激活未确认);支持但当前模式不可用给 2;不支持给 1;未答复给 0。注释点名了 #45 的具体情形:G-SYNC Compatible 可能把 GetVRRInfo 的标志全部报 0,而通用能力查询说当前模式支持 VRR。
实现只加载 System32 下的 nvapi64.dll 并在进程生命周期内 pin 住,不分发 SDK 头或运行库;VEYRA_TEST_VRR_LEVEL=0..4 提供测试注入,用于在没有 VRR 显示器的机器上验证 UI 与呈现规则。
5.5 #43 英文专业界面与 NVOF/2060 修复
- #43:右侧参数栏底部说明完整换行,底栏按内容增高、上方列表可滚动,重置按钮保持可见;补充了窄/宽窗口及 OBS 软件界面验证。
- RTX 2060 等待样本:NVOF 初始化资源注册补齐输入/输出 fence 及部分失败回滚同步,不占逐帧 fence、不新增逐帧 CPU 等待;NR 初始化/执行失败明确显示失败原因,不再无限“等待样本”或沿用旧耗时。发布说明同时强调:2060 用户现场恢复仍需反馈,不能只凭 5070 通过就断言唯一根因已解决。相关记录见 NR2060_SYNC_REPORT_2026-10-16。
六、验证范围与组件身份
6.1 自动化与人工验证清单
| 项目 | 结果 |
|---|---|
| 构建目标 | 52 个通过(745 构建输入) |
| 回归进程 | 17 个通过(模型设置/迁移/预设/会话/导出快照) |
| Qt Quick 测试 | 77 项通过 |
| 翻译 | 2424 条,缺译/占位符错误 0 |
| 真实播放 | GTA 4K/1080 NR 覆盖 A/B/原版/两层、列表/节点、风格 2 强度 5 自动调控、XeSS 2X/DLSS 2X |
| 持久化 | 重启后列表/节点/混合预设恢复通过 |
| 缓存与池 | 预热、50 次近期缓存开关、90 帧自动尺寸池与重建参考逐帧 SHA 一致 |
| 导出 | A/B 两个独立 worker 各完成原生 4K/30fps/6 帧,独立解码复核 |
| 去隔行 | 1080i 软/硬解尾场与 seek 通过 |
| 包级冒烟 | 两个最终 ZIP 解压后 D3D12/OBS 软件界面共四场 4K 基础播放通过 |
一个重要的免责声明:AMD 包在 NVIDIA 机器上能启动,不等于 AMD 增强已通过实卡验收。
6.2 组件身份
| 组件 | 版本/大小 | 签名 | SHA256 |
|---|---|---|---|
| 新 SF 运行库 | 310.9.16.0 / 276162560 bytes | NotSigned(community experimental) | CDFA6C1EC784867182164C7836F324F087B5C9F374D0C9FE46F54999FEABF3ED |
| NVIDIA 原版运行库 | 310.8.0.0 / 165840496 bytes | Valid | E16BCF15E16E13F527491CDF7845B2FE6521A738D8F7C9C721866A8496E1FC8E |
去隔行模块 avfilter-12.dll |
248832 bytes | — | a1b1db7d702f23fb2851b6733071c815da2f753995a7f7490768ab05e3c00a4d |
| 发布 EXE | PE 2.0.9.0 | — | 7add56b9651d6b629433419fb0d2d9d077057d9a77595ebeabbf4d5fb3b80f80 |
发布包摘要:
| 发布文件 | SHA256 |
|---|---|
| NVIDIA ZIP | 6618461d722428aff65e8eee1847cd673aaa02d6c00beab87b7e661b97e0f843 |
| AMD ZIP | e9224fb7f546253e351d2262168a8cedd3c80319f68379392699ecb439c6cc83 |
新 SF 原件与作者发布的 compat-fp16-310.9.16-cuda13.4.3 压缩包解出文件完整匹配,但发布说明明确不把 NotSigned 冒充 NVIDIA 有效签名,也不把运行库审计清单当成“锁死用户不得替换 DLL”。
七、未被宣称修复的部分
按发布说明原文,以下事项在 2.0.9 中没有被声明为已解决或已普遍验证,升级前应有预期:
- NVIDIA 长期显存增长未因换模型宣称根治;
- RTX 20/30/40 的收益需对应实卡反馈(本轮只实测 5070);
- AMD/Intel 实卡增强、真实 VRR 收益、跨屏/实体投影、光学延迟,均按各自证据单独验证;
- 独占/反作弊/提权游戏与混合 DPI 下的输入接管;
- NVIDIA 原版运行库路径不受本版 NR 性能改动影响,选择它就意味着放弃这次的速度变化。
延伸阅读与仓库导航
- 发布说明:RELEASE_NOTES_2.0.9
- 构建与对应源码:BUILD_2.0.9、BUILD_DEINTERLACE_2026-10-16
- 变更覆盖:RELEASE_2.0.9_CHANGE_INDEX
- 实测与验收:NR_SF_310916_REPORT_2026-10-17、PR44_HDR_DISPLAY_REPORT_2026-10-16、FAN_SUBTITLE_PASSTHROUGH_REPORT_2026-10-16、ISSUES_41_45_REPORT_2026-10-16、NR2060_SYNC_REPORT_2026-10-16
- 核心源码:NrArchitecturePolicy.h、EnhancementSettings.h、HdrOutputTuning.h、SubtitleCacheBudget.h、GameHotkeys.h、NvidiaVrr.h、FFmpegDeinterlacer.cpp、NetworkInput.h、HdrCurveCoverage.hlsl
- 回归用例:NrModelSettingsTests.cpp、HdrOutputTuningTests.cpp、RepairPresetTests.cpp、SubtitleCacheTests.cpp
- 第三方与许可:THIRD_PARTY_NOTICES.md