Veyra-NRVideo 功能取舍指南:从 Magpie 调研清单到可落地的 NR、补帧与诊断设计

原创2026-11-15 18:28:471,873 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra-NRVideo 功能取舍指南:从 Magpie 调研清单到可落地的 NR、补帧与诊断设计

这篇技术指南以仓库中的 Magpie 功能调研清单为骨架,逐条拆解“哪些能力值得引入 Veyra、哪些必须暂缓、哪些看似可用但会误导用户”,并用当前源码与配置印证每一项判断的落地形态。读完后你能理解 Veyra 的 NR 参数分层(模型参数 / 变化量 / 画面调控)、SR 与 NR 尺寸解耦的 ResolutionPlan 设计、对比查看与性能面板的数据来源,以及为什么要坚持“受控预设”而不是“任意特效链”。

1. 这份清单解决什么问题

原调研(docs/history/reports/MAGPIE_FEATURE_BACKLOG_2026-09-07.md)的出发点是:面对 Magpie 这类屏幕增强工具不断堆叠 AI 能力,Veyra 应该抄什么、不该抄什么。它的结论不是“再加更多 AI 名字”,而是四件更朴素的事:

  1. 可调参数:让用户真的能调,而不是只给一个开关键;
  2. 保留底图的低分辨率 NR:NR 在低分辨率算,但变化量回填到高分辨率底图;
  3. 正确的补帧节奏:先把真正的 2X 修对,再谈 3X/4X;
  4. 能解释性能的界面:把“卡在哪一步”变成可读数字。

同时它明确划了两条红线:第一,在现有许可证边界下,“搬过来”指的是独立实现相同的用户价值,不复制 Magpie 的 GPL 源码、shader、UI 实现或二进制;第二,“已纳入”只表示进入方案范围,不代表软件里已经存在这些按钮。

配套的详细实现合同写在 修复执行方案,后文引用它的第 6、8 节时均指该文件。

1.1 评分怎么读

清单使用两套 1–5 分刻度,理解这两套刻度是读懂后续表格的前提:

维度 含义
难度 1/5 局部配置或少量 UI
难度 2/5 单模块功能
难度 3/5 多个模块与 GPU 资源协同
难度 4/5 核心管线 / 时序 / 颜色改造
难度 5/5 新算法后端、重大接口或长期兼容性成本
需要 5/5 当前产品能否正常使用或差异化的关键
需要 4/5 明显改善使用
需要 3/5 特定素材有价值
需要 2/5 受众较窄
需要 1/5 与当前目标不匹配

两条附加约定很重要:“界面容易加”不代表底层容易接;评分基于现有工程,不包含“获准复制代码”的假设。

2. 已纳入方案的七项:A1–A7

编号 Magpie 相关能力 Veyra 要做的版本 难度 需要 状态
A1 DLSSNR 模型参数 实际绑定强度、局部明暗/结构;实验参数单独标注并验证 3/5 5/5 已纳入
A2 NR 变化量调节 总变化、暗化、亮化、色彩与明度变化;不能冒称语义材质控制 3/5 5/5 已纳入
A3 NR 输入缩放与变化回填 解开 SR4K 与 NR4K,保留 4K 底图;原生 NR 可选 4/5 5/5 已纳入
A4 FG 与输出节奏管理 先修真 2X,再把 3X/4X 接到显示和导出;按本地 SDK 验证 5/5 5/5 已纳入
A5 实时参数交互 Desired/Applied、拖动合并、帧边界应用,不重新打开视频 4/5 5/5 已纳入
A6 中文、参数分组、快捷操作 完整汉化、分组说明、逐项默认恢复、可靠全屏输入 2/5 5/5 已纳入
A7 真实/输出 FPS 分开 源、生成、提交、可测显示四层统计和硬件限制提示 3/5 5/5 已纳入

下面的小节把每一项对应到当前仓库的真实实现位置,便于判断“方案是否已经在代码里留下了骨架”。

2.1 A1 + A2:NR 参数为什么要分成三层

在 Veyra 里,NR 的参数不是一坨混杂字段,而是三层结构,全部定义在 EnhancementSettings.h:

struct NrSettings {
    float intensity=1,tone=1,structure=1,skin=-1;
    int32_t style=0,autoMask=0,uiCorrection=0;
    bool performance=true;
};
  • intensity(模型强度)、tone(局部明暗)、structure(局部结构)对应清单里的“基础模型区”。它们是送进模型 Evaluate 的参数,不等于“与原图做简单混合”。
  • skin(肤质结构,默认 -1 表示未指定)、style(风格,0–2)、autoMask、uiCorrection 对应“实验折叠区”。清单要求“只有真实适配和证据支持后才标可用”,代码里的验证规则恰好体现了这一点——skin 只接受 -1 或 0–2,style 只接受 0–2,越界即判为 "invalid experimental parameter"。

变化量由另一个结构承担:

struct ResidualSettings {
    float total=1,darken=1,brighten=1,color=1,luminance=1;
    NrCorrectionSettings correction{};
};

这五个浮点数就是清单中“变化量区”的完整映射,其语义可以在 NrResidualComposite.hlsl 里逐行验证:

float3 rawDelta=delta;
if(darken!=1||brighten!=1)delta=min(delta,0)*darken+max(delta,0)*brighten;
if(color!=1||luminance!=1){float dy=dot(delta,float3(0.2126,0.7152,0.0722));delta=dy*luminance+(delta-dy)*color;}
delta*=total*(1-protection);

这段代码给出了三个可以直接对用户解释的事实:

  1. total==0 时直接输出底图(if(total==0||protection>=1){outputTex[id.xy]=base;return;})。这就是清单里“总变化 = 0 看底图”的实现依据。
  2. 暗化/亮化是分别作用在负/正残差上的,darken 只压负向变化、brighten 只放大正向变化——所以它“能近似满足‘少加点阴影、保留些增亮’,但不是获得了真实阴影图”。
  3. luminance 与 color 是把残差拆成亮度分量与色度分量后分别缩放,因此它控制的是“相对原图改变了多少”,而不是无条件“更鲜艳/更亮”。

参数取值范围同样有据可查:validate() 要求 total ∈ <a href="https://link.gitcode.com/i/0ed5946b1cb800f84bc4351d55208759" target="_blank">0,5],darken/brighten/color/luminance ∈ [0,2],intensity/tone/structure ∈ [0,1]。前端控件区间与此一致,见 [NrLayerEditor.qml 中的 residualSpecs(total 上限 5,其余上限 2)与 model 分组(tone、structure 上限 1)。

2.2 画面调控:清单没提但必须理解的第四层

原清单在 A2 里强调“不能冒称语义材质控制”。当前实现进一步把“保护类”参数收进 NrCorrectionSettings,并显式区分自动与手动:

struct NrCorrectionSettings {
    bool enabled=false,automatic=true;
    float hue=1,chroma=.75f,highlight=1,compression=.75f,stability=.8f;
    float neutral=0,colorKeep=0,lumaKeep=0,shadow=0,autoAmount=1;
};

其中 validate() 对九个手动量统一要求有限且在 [0,1] 内。更关键的是 usesHistory():

bool usesHistory() const {return enabled&&(automatic?autoAmount>0:stability>0);}

也就是说,画面调控一旦开启并带时域稳定,就会接管时域累积,此时 NR 层自己的“时间域防闪烁”开关让位。UI 里对此有直接提示:画面调控已接管时域稳定;关闭调控后恢复此设置。这正符合清单“不用漂亮标签掩盖未知行为”的要求。

2.3 A3:SR 与 NR 的尺寸为什么要解耦

清单对 A3 的描述是“解开 SR4K 与 NR4K,保留 4K 底图;原生 NR 可选”。仓库中的落点是 ResolutionPlan,见 ResolutionPlan.h:

struct ResolutionPlan {
    Extent source,base,nr,flow,fg,output;
    Extent srInput,srOutput;
    Extent firstSrOutput;
    bool dualSrApplied=false;
    bool srApplied=false;
};

注意这里同时存在 base(SR 之后的底图)、nr(NR 实际计算尺寸)、output(最终输出)三个量。ResolutionPlan::make() 的关键逻辑是:

p.srApplied=sr&&p.srOutput!=p.srInput;p.nr=p.base;
if(nrBeforeSr&&!exporting)p.nr=source;
if(!exporting&&policy!=NrSizePolicy::Native) {
    const double limit=manual?manualHeightBudget:nrHeightLimit(policy);
    ...
    if(scale<1.0)p.nr={...};
}

由此可读出三条工程契约:

  • NR 默认跑在 SR 之后的底图上,但按 NrSizePolicy 缩到更低分辨率计算,输出尺寸不变;
  • 当 nrBeforeSr 成立(低延迟配对,仅预览)时,NR 直接吃源尺寸输入;
  • NrSizePolicy::Native 表示原生 NR,不缩尺寸——性能成本明显更高,这一点在执行方案的对比逻辑里也保留(sameVideoConfiguration 不把尺寸策略差异当作可忽略项)。

尺寸策略的 ID 被刻意冻结,以保证旧预设可读:

策略 枚举值 高度上限(nrHeightLimit)
Realtime 0 1080
Native 1 不限(不缩放)
P480 2 480
P720 3 720
P900 4 900
P1440 5 1440
Auto 6 1080(按负载动态)
Manual 100+percent 手动比例,百分比 25–100

手动比例用“100+百分比”编码在同一个枚举里,注释说明了原因:它要穿过既有的逐层预设、会话与导出共享内存 POD,而不能新增第二个可变字段。这是个很实用的兼容性取舍。

另外,srStageExtents() 与 ResolutionPlan::make() 都会返回 prescaleIneffective / outputIneffective 标记——预缩放没有产生有效缩小、或输出没有真正放大的情况会被报告而不是静默忽略。这直接对应清单“失败要说清”的态度。

2.4 A5:Desired / Applied 与“不重新打开视频”

A5 要求“拖动合并、帧边界应用、不重新打开视频”。仓库给出的机制是 PlayerSnapshot 里的双份设置:

EnhancementSettings desired,applied;bool applying=false;

配合 EnhancementSettings::revision 与 nextRevision_ 递增,形成一条可追踪的更新链。PlayerUiFacade 的注释进一步说明了 UI 侧语义:

// Applied to the engine's desired settings, keeping the facade's copy in
// step so the UI can show the pending value before the engine confirms it.
bool applySettings(const veyra::engine::EnhancementSettings& settings, ...);
// True while the engine has not yet applied what the UI asked for.
bool applying() const;

于是“Desired/Applied”不是口号,而是三件可观察的事:

  1. pendingSettings() 让界面先显示用户拖到的值;
  2. applying() 为真时说明引擎尚未确认,界面可以显示“应用中”;
  3. 引擎侧失败时通过 rejectVideoRequest(attempted, previous) 回滚,并把 rejectedRevision 记录下来——这样旧请求的失败不会覆盖新请求。

rejectVideoRequest 的实现里有一个容易被忽略的细节:它先检查 if(revision!=attempted.revision)return;,即只有当前活动版本正是被拒绝的那一个才回滚。这是并发拖参数时避免“回滚踩掉新值”的必要条件。

至于“不重新打开视频”的判定,落在 sameVideoConfiguration() 与 sameActiveVideoParameters() 的差异上:前者决定是否需要重建图,后者只比较“活动参数是否变了”。源码注释明确列出若干纯 uniform 变化不应触发重建的字段,例如色彩分级参数、抗锯齿阈值、美颜值;而 exportBitrateMbps 与 captureFlipVertical 也被排除在重建之外,因为前者只服务导出任务、后者在采集回调线程逐样本应用。

2.5 A7:四层 FPS 与“硬件限制提示”

A7 要求把“源、生成、提交、可测显示”四层统计分开。数据结构在 FrameMetrics.h:

double validGeneratedFps=0,presentSubmitFps=0,sourceCompletedFps=0,outputCompletedFps=0,xessSdkSubmitFps=0;
double realPresentFps=0,generatedPresentFps=0;

并且专门提供了“不建议自动降档”的提示器 DisplayFgBudget.h:

inline constexpr double kDisplayFgFitTolerance=1.02;
inline constexpr double kDisplayFgFillRatio=0.97;

它的判定顺序值得抄下来作为产品规则:

  1. 输出能塞进刷新率(content × M ≤ 1.02 × refresh):不提示;
  2. 源本身已经填满面板(≥ 0.97 × refresh,例如 60 fps 内容在 60 Hz 屏):建议关掉补帧;
  3. 否则找“能塞下的最大低倍率”;
  4. 一个都塞不下但源比屏慢(60 fps 内容在 100 Hz 屏):Automatic 下仍建议 2X,VSync 下建议关闭。

注释里还写明“倍率始终由用户选择(2026-10-14 决定:不自动降档)”。这正是清单 A4 强调的“不只显示理论倍率”,也是避免“自动帮我改设置”这类隐性行为的护栏。

3. 面向使用者的参数清单(可直接对照界面)

3.1 基础模型区

参数 源码字段 范围 含义与边界
模型强度 intensity 0–1 模型自身处理控制,不是简单混合原图
局部明暗 tone 0–1 控制模型局部明暗变化,不承诺指定某个物体
局部结构 structure 0–1 控制模型局部结构变化
肤质结构 skin -1(未指定)或 0–2 实验项,界面标注“未证实”
风格 style 0–2 实验项,影响自动调控的适配参数
自动遮罩 autoMask 0–1 实验项
画面内 UI 修正 uiCorrection 0–1 标注“未证实”
性能优化版 performance bool SF 下为 B/A 模型,AMD 下为 Small/Original;创建期决定,切换会重建 NR

performance 的行为有明确代码约束:nrRenderPreset() 只在当前运行时是 Ampere 时返回 1 或 2,其余运行时返回 0;nrUsesPerformanceModel() 则把 AMD 也算作“有性能模型选择”。这解释了为什么同一个开关在 NVIDIA 原版运行时是“无效项”——NrModelSettingsTests.cpp 里专门断言了 NVIDIA original ignores the inactive performance option。

3.2 变化量区

参数 字段 范围 实操含义
总变化强度 total 0–5 0 看底图;1 看未额外放大的 NR 变化;>1 额外放大
暗化变化 darken 0–2 只放大/压低负向残差;0 取消这部分变化
亮化变化 brighten 0–2 只放大/压低正向残差;0 取消这部分变化
色彩变化 color 0–2 缩放残差的色度分量
明度变化 luminance 0–2 缩放残差的亮度分量

清单里的两条建议在这里都能落到具体控件措辞上:暗化/亮化的界面提示应写成“增加 NR 带来的暗化/提亮”,而不是“调低画面亮度”;色彩/明度应写成“增加 NR 带来的颜色/明度变化”,而不是“更鲜艳/更亮”。

3.3 质量与性能区

  • NR 实时/原生与实际内部尺寸:由 NrSizePolicy 与 ResolutionPlan::nr 决定;
  • SR 输出目标另外显示:srTarget 独立于 NR 尺寸,srTargetExtent() 负责 1440p / 4K / 5K / 6K / 7K / 8K 的映射;
  • FG 倍率:kFgMultiplierChoices={1,2,3,4,6},VFG 另有 {1,2,3,4,5,6,7,8};XeSS 校验上限 4X,FSR 3.1/4 上限 2X(均见 validate() 的显式错误串);
  • 参数修改保持播放位置;图片调模型参数重算,调变化量尽量只重合成:这依赖“重建 vs 仅 uniform”的分流,即 sameVideoConfiguration() 与 sameActiveVideoParameters()。

4. B1–B5:已选择的五项与它们的实现证据

2026-09-07 用户明确回复“B1–B5 先加上”。下表保留原清单的收益与边界描述,并补上仓库中的对应落点。

编号 功能 收益与边界 难度 需要 仓库落点
B1 原图/处理后对比 同一 PTS、同一底图的瞬时切换与分屏拖杆;生成帧不伪装成同帧原画 2/5 5/5 compareMode / compareBase / compareSplit
B2 各效果性能监测 GPU timestamp 显示 SR/NR/光流/FG/合成,CPU 等待分栏,目标值不冒充实测 3/5 5/5 GpuTimer + FrameMetrics
B3 效果组/配置管理 受控用户预设,整套事务应用;不开放任意颠倒 SR→NR→FG 顺序 2/5 4/5 PresetLibrary / PresetContent
B4 各消费者光流配置 性能/平衡/质量请求,共享一次估算,并显示本机实际采用档位 3/5 4/5 FlowQuality + 共享光流判定
B5 最近错误、复制诊断、打开日志 结构化错误、原因、建议、脱敏复制与本地日志目录;绝不自动上传 2/5 4/5 DiagnosticEvent / diagnosticsReport()

4.1 B1:对比模式的三个字段与“同帧”边界

桥接层暴露了三个属性(QmlPlayerBridge.h):

// 显示: compare 0 增强 1 原画 2 分屏; base false 输入原画 / true 增强前底图;
// split 0..1 of the picture.
Q_PROPERTY(int compareMode READ compareMode WRITE setCompareMode NOTIFY compareChanged)
Q_PROPERTY(bool compareBase READ compareBase WRITE setCompareBase NOTIFY compareChanged)
Q_PROPERTY(double compareSplit READ compareSplit NOTIFY compareChanged)

compareBase 正是原清单反复强调的那个歧义点:“原图”到底是源画面,还是 SR 之后、NR 之前的底图。默认取 false(输入原画),用户可切到 true(增强前底图)。界面文案也照此区分,见 ProDisplayPanel.qml 的 输入原画 / 增强前底图 两项。

这里还有一条必须写进文档的行为约束:对比开启时补帧暂停,关闭对比后恢复。QML 提示文本直接写着“对比时补帧暂停,关闭对比后恢复”。原因就是清单里那句“FG 后不能把 A 时刻原图与 A/B 中间生成帧直接并排称为同帧对照”。

“按住 V 查看原画”是同一机制的快捷入口:setCompareMode 在 holdKeyDown 为真时不向引擎推送新值,只更新内部状态,从而避免按住/松开时反复触发比对切换(见 src/ui/bridge/View.cpp)。

4.2 B2:为什么用 GPU timestamp 而不是“估算”

GpuTimer.h 的设计注释只有一句但信息量很大:

// Timestamp query ring, resolved only after the producing fence is complete.
// No image readback, no CPU waits. Samples carry the identity they measured.

也就是:四槽时间戳查询环 + 围栏完成后才解析 + 不回读图像 + 不阻塞 CPU。每个样本带 FrameIdentity,因此一条耗时数据永远能回答“这是哪一帧、哪个版本、哪个环节”。GpuStage 覆盖了 Color, Sr, Flow, Nr, Residual, Fg1..Fg7, FgBatch, Blit, VideoHdr,以及逐实例的 NrLayer0..3、ColorNode0..5、AaNode0..1、BeautyNode0..5。

一个关键的分账规则写在 FrameMetrics.h 顶部:

// NrLayer*/ColorNode* are per-instance node spans nested inside the stage
// spans above; they are never merged into enhancementProcessingMs.

这正好回应清单“目标值不冒充实测”的诉求:嵌套跨度不参与总增强耗时统计,避免“层层相加得出一个很好看的总数”。

CPU 侧同样分栏,CpuStage 为 Decode, Submit, SlotWait, ReadyWait, DeadlineWait, Present, ...——把“解码慢”“等 GPU”“等截止时间”“提交慢”拆开,才知道该优化哪里。

4.3 B3:预设为什么必须是“受控”的

PresetLibrary 用一个位掩码表达“这个预设包含哪些部分”:

enum class PresetContent : uint32_t {
    None = 0,
    Chain = 1u << 0,           // stages + their parameters
    Color = 1u << 1,           // colour grade
    FrameGeneration = 1u << 2, // multiplier and backend
    Audio = 1u << 3,           // sync mode and offset
    Flow = 1u << 4,            // shared optical flow and content cadence
};

这让“老视频预设只覆盖链,不动色彩/补帧/音频”成为可表达的语义。PresetLibrary::apply() 的实现方式很值得学习:先保存未声明部分的当前值,应用后再还原。

const auto keepColor = settings.color;
const auto keepMultiplier = settings.multiplier;
const auto keepBackend = settings.frameGenerationBackend;
...
if (entry.contents & presetContentMask(PresetContent::Color)) { ... } else { settings.color = keepColor; }

而 PresetFrameGeneration 只携带 multiplier / backend / vfgQuality 三个字段,注释写明“a preset must never smuggle in capture or export fields”——预设不能夹带采集或导出配置。这与清单“存 NR 设置、变化量设置、SR 目标、NR 尺寸策略、FG 倍率与光流档位,不存进程指针/显卡资源/自动换 DLL”完全一致。

至于“不开放任意颠倒 SR→NR→FG 顺序”,代码层面的护栏是执行计划的固定校验:validateFixedExecutionPlan() 在多个测试用例中被作为“必须通过”的前置条件(见 EffectChainTests.cpp),顺序由方案决定,而不是交给用户自由连线。

预设命名也有一条产品纪律:不要未经内容验证就标“最佳画质”,示例名字应当是“我的主机游戏”“老视频”这类描述使用场景的说法。PresetLibrary 的 builtin 字段是只读标记(可复制、不可改名或删除),从机制上防止“内置最佳”被滥用。

4.4 B4:光流档位与“一次估算多处消费”

EnhancementSettings 里有两个相关字段:

enum class FlowQuality { Performance, Balanced, Quality };
FlowQuality flow=FlowQuality::Balanced;
OpticalFlowBackend opticalFlowBackend=OpticalFlowBackend::Nvidia;

“共享一次估算”的判定写在 activeVideoSettings() 的 flowUsed 表达式里:

const bool flowUsed=(nr&&(motionUsesFlow(nrMotion)||usesNrTemporal()))||
    (sr&&(videoSrQuality==0||videoSrQuality==kVideoSrFsr)&&motionUsesFlow(srMotion))||
    (multiplier>1&&motionUsesFlow(fgMotion,frameGenerationBackend));

三处任一需要光流,光流就保持活动;关掉一个效果不会让仍被其他消费者需要的光流失效。注释也点明了例外:“VFG has its own flow”。

这条规则直接支撑清单里的那句“性能/平衡/质量请求,共享一次估算,并显示本机实际采用档位”。注意 Quality 档位不等于“实时默认”:原清单特别提示 Magpie 作者自己也说过高质量档开销很高,因此 Veyra 侧的取舍是提供可量化选择,但不把最高档默认为实时档(默认 Balanced)。

后端选择也有清晰的枚举与命名函数:Nvidia → NVIDIA_NVOF、AmdFidelityFx → AMD_FIDELITYFX_OF、GpuDis → GPU_DIS_FAST。这为“显示实际采用档位”提供了可打印的真实字符串,而不是由 UI 猜。

4.5 B5:诊断中心的数据来源与脱敏边界

DiagnosticEvent.h 定义了一条结构化错误:

struct DiagnosticEvent {
    std::string timestamp,severity;
    std::string fingerprint,component,stage,message,runtimeHash,flowApplied,fallbackReason;
    std::optional<uint64_t> hresult,ngx,nvof,seh;
    pipeline::ResolutionPlan resolution;
    pipeline::FrameIdentity identity;
    uint64_t batch=0,occurrenceCount=1;
    uint32_t subframe=0;
};

这条结构自带“原因”与“回退理由”字段(fallbackReason、flowApplied),并且带 resolution 计划快照——排查时不用再问“当时是什么尺寸策略”。DiagnosticHistory 用 fingerprint 去重并累加 occurrenceCount,容量 64,避免同一个错误刷满日志。

面向用户的复制功能在 QmlPlayerBridge::diagnosticsReport() 中实现,注释写得很克制:

// Engine-reported values only. A diagnostic that guesses is worse than none.

它输出的都是引擎已测得的字段:状态、源尺寸/旋转/标称帧率、提交 FPS(未测量时明确写“未测量”)、晚点当前/P95、调度等待 P95、处理 CPU P95、呈现 CPU P95、已处理/生成帧数、NR 求值/NVOF 执行次数,以及采集接收/丢弃/速率、后端告警、色彩与 Video HDR 状态。

copyDiagnostics() 只做一件事——把上述文本放进剪贴板;openLogFolder() 打开本地日志目录(目录由 runtime::logsDirectory() 提供,见 RuntimePaths.h)。没有任何自动上传路径,这与清单“绝不自动上传”的要求一致。

5. B6–B8:候选,而非承诺

编号 功能 收益与边界 难度 需要 建议
B6 可设置工具栏快捷键 NR 快速开关、按住看原图、打开参数、固定控制条;F11/Esc 等基础全屏键已在范围 2/5 3/5 按习惯选
B7 参数窗位置/尺寸记忆 多显示器与窗口变小时不挡主画面;恢复时防止弹窗落到屏幕外 2/5 3/5 有余量再选
B8 效果截图 在已有图片保存上增加“同帧原图+增强图+参数说明”成对保存;必须由用户主动保存 2/5 3/5 制作演示素材时选

三项都不进入本次原子任务。B8 的边界尤其值得强调:不能后台录采集画面,保存动作必须由用户主动触发。仓库侧已有 savedFramePath 字段,注释说明“只有编码器完成后才设置,实际扩展名可能不同于请求(HDR 截图是 JXR)”,这说明成对保存要复用的正是这条已存在的保存通道,而不是新开一条偷偷截图的路径。

6. C1–C7:看起来很香但成本更高的七项

编号 公开能力 能解决什么 难度 需要 结论
C1 RTX Video VSR / 降噪 为低码率、压缩严重的老视频提供另一条增强路线 4/5 3/5 候选,需独立 SDK/格式/许可核对与 A/B;不混成 DLSS5
C2 XeSS FG 为颜色输入场景多一个插帧后端 5/5 3/5 暂缓,先修现有 DLSSG
C3 Lanczos / FSR 空间缩放 不使用时间历史的轻量缩放/适量锐化 2/5 3/5 可选,不是当前必需
C4 FSR2/3/4、XeSS SR 多硬件、多算法路线 5/5 2/5 暂缓,每后端单独审计
C5 AMD optical flow NVOF 之外的可替换估算后端 4/5 2/5 暂缓,先把现有数据契约用对
C6 多效果自由组合 任意特效链/效果生态 5/5 1/5 不建议
C7 通用窗口捕获/缩放 对任意软件做桌面增强 4/5 1/5 不建议本轮做

清单给出的两条判据至今仍然成立:第一,“XeSS FG 可能更适合”只能作为待验证假设,不能因为评论区推荐就把刚写好的 DLSSG 删掉;第二,公开仓库声明的可用后端不等于获得了分发其第三方 SDK/runtime 的权利。

关于 C4/C5 的现实约束,还可以从配置层看到证据:当前 SR 质量编码里已经包含 kVideoSrFsr=5(AMD FSR 上采样,标注为“vendor neutral; verified on an NVIDIA adapter”),而 RTX Video SR 被拆成三族:standard(1–4)、high bitrate(16–19)、streaming(21/23,且 21/23 需要 Ampere 或更新)。这说明“多算法路线”不是加个下拉框,而是每族模型都要各自处理尺寸、压缩清理强度与回退语义——正好是 C4 给出 5/5 难度的原因。

7. 五条“不要误认为 Magpie 已提供”的清单

项目 核对结果 对 Veyra 的决定
深度估算 0.6.5 发布说明明确移除了深度组件 本轮不新增深度推理;未来独立研究不受影响
HDR、VRR 开关 0.6.5 明确暂缓,0.6.6 帧同步文档也未把 VRR 当已启用功能 不列入当前 SDR 修复承诺;4K 不是 HDR 的同义词
更高光流质量就一定更好 作者也提示高质量档开销很高,缺本机相对质量数据 只提供可量化选择,不把最高档默认为实时档
反射/阴影精确控制 参数文档描述的是处理造成的增亮/压暗差异,不是语义分割 界面叫“亮化/暗化变化”,不宣传提取材质/灯光通道
Front Edge Sync = 低延迟万能方案 它控制提交节奏,可能增加等待,且目标 FPS 不是实测 借鉴有界调度,不机械照搬源程序限帧前提
DLL 更换包 / NGX OTA 系统脚本 发布页确实有相关附件与系统级操作说明 不采用、不下载、不运行;不改 DLL 身份、驱动或系统 NGX 设置

这张表里最容易被忽略的是最后一条。仓库里的 NrRuntime 迁移逻辑体现的是同一套克制立场:

// Lecram and the older RTX40 community DLL are no longer packaged. Explicit
// NVIDIA-original and AMD choices survive migration; no DLL hash loading lock.
constexpr NrRuntime currentNrRuntime(NrRuntime runtime) {
    return runtime == NrRuntime::Original || runtime == NrRuntime::Community ? NrRuntime::Ampere : runtime;
}

也就是说:旧 ID 保持可解码,新构建把已退役的运行时分流到当前可用槽位,但没有开启“按哈希加载任意 DLL”的口子。nrRuntimeName() 返回的是明确的组件名与版本(如 NVIDIA-original-RTX50-310.8.0、community-SF-RTX20-RTX50),这既是可追溯性,也是“不改 DLL 身份”这条纪律的代码表达。

8. 与 Magpie 无关但值得做的两项

清单第 6 节明确标注这两项“不声称 Magpie 已有”,且尚未选定:

编号 功能 难度 需要 为什么
V1 采集模式解释与音频对齐面板 3/5 5/5 明确 MJPEG/YUY2、USB 实际能力、源 FPS、HDMI/麦克风来源与音频偏移;不得自动改用户设备
V2 导出任务队列与参数快照 3/5 4/5 老视频/AI 视频批处理是区别于屏幕增强工具的价值;任务固定参数、进度/失败可恢复

这两项之所以值得写进同一份清单,是因为它们对应 Veyra 与“屏幕增强工具”的分野:入口是采集卡、媒体与导出,不是给任意窗口套后处理。

仓库中已经存在支撑 V1 的字段与语义:CaptureAudioIngress 把采集音频入口策略分成三档——

enum class CaptureAudioIngress { Auto, PcmOnly, BitstreamPreferred };

对应中文名分别为“自动(优先 PCM,必要时位流解码)”“强制线性 PCM”“位流优先(Dolby/DTS 直通解码)”,并且 validate() 会校验枚举范围。注释解释了这三档为何存在:Dolby/DTS 直通协商依赖设备与主机,“让采集卡自己决定”在实践中并不可靠。同时它明确标注 requires a reconnect to take effect,因为媒体类型是在建图时协商的——这正是 V1 需要的“讲清楚为什么必须重连”。

音频偏移也有明确边界:audioOffsetMs 被限制在 [-250, 250] 毫秒,audioSync 分 Automatic / Manual / Off。rejectVideoRequest() 里还专门保护了音频同步与偏移:回滚其它视频参数时,不会顺手把用户刚调好的音画对齐也一起回滚。

V2 的“参数快照”在代码里已有雏形:ExportFeaturePolicy.h 的 freezeExportSettings() 会把导出尺寸策略固定下来(Auto 在导出时变 P1440,AMD 输入上限 1080p),并明确“Auto timing is preview-only”。注释同时给出了一条重要约束:规范化不能把损坏的设置事务变成看起来有效的设置,所以计数越界时直接原样返回、交给调用方校验。

9. 范围结论与实施边界

当前已确定的范围是 A1–A7 + B1–B5。新 AI 后端、任意插件链与通用窗口捕获不加入。

理由清单里说得很直接:先把现有算法真正显示好、调得动、看得懂,才有一个能用的产品;扩充算法名单会增加兼容性与调试面,不能替代对当前 SR4K 与 FG 故障的修复。

B6–B8、C1–C7、V1–V2 继续留在候选表,不进入本次原子任务,也不挤占“五分钟测试”预算。后续若再选,必须另行更新范围。

最后需要保留原文档的这句边界声明:本轮没有改代码、没有运行测试、没有替换运行时。本文援引的源码、shader、QML 与测试路径用于说明“方案在仓库中对应的机制与既有实现”,并不表示清单中每一项都已作为成品按钮交付。判断某个功能是否真的可用,正确顺序是:先看 EnhancementSettings::validate() 是否接受这组参数 → 再看 sameVideoConfiguration() 是否需要重建 → 最后看界面是否把它暴露给用户。

登录后查看全文
Veyra-NRVideo