Veyra-NRVideo 功能取舍指南:从 Magpie 调研清单到可落地的 NR、补帧与诊断设计
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 名字”,而是四件更朴素的事:
- 可调参数:让用户真的能调,而不是只给一个开关键;
- 保留底图的低分辨率 NR:NR 在低分辨率算,但变化量回填到高分辨率底图;
- 正确的补帧节奏:先把真正的 2X 修对,再谈 3X/4X;
- 能解释性能的界面:把“卡在哪一步”变成可读数字。
同时它明确划了两条红线:第一,在现有许可证边界下,“搬过来”指的是独立实现相同的用户价值,不复制 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);
这段代码给出了三个可以直接对用户解释的事实:
total==0时直接输出底图(if(total==0||protection>=1){outputTex[id.xy]=base;return;})。这就是清单里“总变化 = 0 看底图”的实现依据。- 暗化/亮化是分别作用在负/正残差上的,
darken只压负向变化、brighten只放大正向变化——所以它“能近似满足‘少加点阴影、保留些增亮’,但不是获得了真实阴影图”。 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”不是口号,而是三件可观察的事:
pendingSettings()让界面先显示用户拖到的值;applying()为真时说明引擎尚未确认,界面可以显示“应用中”;- 引擎侧失败时通过
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;
它的判定顺序值得抄下来作为产品规则:
- 输出能塞进刷新率(
content × M ≤ 1.02 × refresh):不提示; - 源本身已经填满面板(
≥ 0.97 × refresh,例如 60 fps 内容在 60 Hz 屏):建议关掉补帧; - 否则找“能塞下的最大低倍率”;
- 一个都塞不下但源比屏慢(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() 是否需要重建 → 最后看界面是否把它暴露给用户。