Veyra-NRVideo 补帧叠加源时间戳闪黑的证据化定位:九点 GPU 像素探针、现场诊断包与判读树

原创2026-11-15 09:48:431,631 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra-NRVideo 补帧叠加源时间戳闪黑的证据化定位:九点 GPU 像素探针、现场诊断包与判读树

本文以 FG_SOURCE_FLASH_REPORT_2026-10-08.md 为骨架,完整还原一次“补帧开启 + 采用源时间戳”整幅黑闪的现场排查过程:包括原始证据的量化口径、被排除的假设、本机验证矩阵、可交付现场运行的诊断包,以及双阶段九点像素探针的实现细节。读完你可以掌握一套可复用的方法:在不改动产品算法的前提下,用有界 GPU 取样把“输入已黑”“缓冲区已黑”“像素正常但屏幕黑”三种情形分开,并为后续修复建立可验证的证据链。

一、结论先行:整幅黑闪已被确认,但根因尚未锁定

报告的立场非常明确,且这句话本身就是整套方法的边界声明:

整幅黑闪已由录像确认;根因尚未锁定,未提交产品修复。 不应由 60→30 有效推断 PTS 错误,也不能由 FPS 或 NGX/Present 成功推断像素正常。

这句话拆成三条工程约束:

  1. 现象成立:手机录像逐帧检视确实存在接近全黑的一帧,且邻帧恢复正常,属于整幅黑闪,不是局部运动残影。
  2. 归因不成立:日志里“源 60 fps → 提交 120 fps”看起来正常,不能反推“像素正确”;同理,NGX/补帧 SDK 返回成功、DXGI Present 返回成功,都不能证明交换链内容非黑。
  3. 修复未发生:这一轮的产出是诊断能力,不是产品补丁。报告明确写了“未提交产品修复”,后续的兼容候选见 FG_FLASH_FIX_REPORT_2026-10-09.md,并且那里同样声明“根因尚未确认,不能写已根治”。

这一轮的排查计划写在 FG_SOURCE_FLASH_PLAN_2026-10-08.md,它把范围限定得很死:只读核对真实日志、录像、共享 graph/presenter、GPU fence 与历史重置;独立诊断程序只添加像素取样,不改变补帧算法、准入、源时间戳或显示策略。

二、原始证据:先把不可辩驳的事实固定下来

报告给出的两份原始证据都带长度与 SHA256,这是后续所有推断的地基:

证据 规模/规格 SHA256
veyra-qml(41).log 42,664,677 字节、141,315 行 4714f8ee048f12965bd8ccd8c546191c5659cc7d40f40702d816faf670bd7d96
手机录像 ebdc538711ace23c8edc69c11a57bfc.mp4 612,092 字节、720×1280、30fps、146 帧 9481aaddfe254ad46e8c8a53caf650b9702c4841f7af4846bff5771c09ad5ee6

录像侧的量化结论:

  • 第 104 帧(约 3.467 秒) 与第 129 帧(4.300 秒) 屏幕接近全黑,邻帧即恢复;
  • 这两个黑帧的画面 ROI 平均码值约为 1.97/255 与 2.09/255,而周围正常画面约 89–92/255,量级差距足以排除“局部运动残影”“字幕遮挡”“场景转场”这类解释;
  • 每次只占一张手机录像帧。因此在 30fps 的手机采样下,不能据此声称“屏幕黑了 33ms”——录像的采样间隔大于事件时长,只能说事件落在该采样窗口内;
  • 视频创建时间在 06:24:11Z 附近,当时应用正在使用 DLSS 2X / transport 并且有全屏切换;但手机时钟与电脑时钟未校准,不能硬对齐两个事件。

现场环境(用于判断“本机验证能否代表现场”):

项目 现场 本机验证环境
GPU RTX 5090 / 32GB RTX 5070(部分用例 12GB 语境)
驱动 617.42 616.56
采集 Magewell Pro Capture HDMI4K+ 无实卡输入
采集格式 3840×2160 / P010 / PQ / 约 59.94fps 合成 P010/PQ 素材
显示 LG TV SSCR2 约 143.988Hz 日志显示约 320Hz
HDR 面板扫描 有(现场) 无 HDR 面板扫描验收

报告特意补充:现场存在 DLSS、VFG、XeSS 的多次切换,因此不能把全部时段归给 VFG;光流常为 AMD FidelityFX,NR 常为两层 1080p、NVIDIA 原版。这两条信息后来直接决定了两处验证设计的取舍(见第五节与第四节末尾)。

三、日志与代码核对:哪些假设被证伪或降级

3.1 18 条 ERROR 与黑闪无因果关系

日志中共 18 条 ERROR,构成是 17 次 QML 几何操作失败 + 1 次配置保存失败;没有 NGX / FG / Present / device-lost 错误。报告的处理方式是“关联性未证实”,既不说错误导致黑闪,也不说错误无关——只记录事实与缺失。

3.2 稳定段的计数口径:有丢帧,但没有“完全正常”

最后 DLSS/transport 稳定段约 927 秒、924 个 FPS 样本,中位源 60 / 提交 120;55,399 个有效 FG、invalid=0、providerDisabled=0;同时存在 72 次新增生成前跳过、11 次过期。报告据此否定了两种极端说法:

  • 不能因为 invalid=0、providerDisabled=0 就说“完全没有丢帧”;
  • 也不会因为 72 次跳过就说“补帧整体失效”。

并且只有一次场景边界以及开段设置重建,没有反复 reset 的证据。“这些计数没有包含逐帧像素”是报告反复强调的关键——计数器描述的是调度结果,不是图像内容。相关计数在界面上也可直接读到(有效生成 / 无效 / 已呈现 / 过期),见 TelemetryWindow.cpp。

3.3 60→30 的作用边界:缓解不等于证明

报告的表述是:60→30 保留真实 PTS 并减半源工作量、扩大每对帧处理窗口;它缓解故障,但不能单独证明源 PTS 有错。

这条判断在源码里可以找到对应的实现事实。设置项在旧版设置面板中的名称是“采集60→30fps处理(PS5 30帧)”,与“采用源时间戳”“自动剔除重复帧”等并列于内容节奏下拉框,见 SettingsWindow.cpp。引擎侧的分支逻辑见 EngineController.cpp:

const bool halfRate=isCapture&&options.settings.content==ContentRate::Capture60To30&&
    CaptureHalfRate::supported(activeSource->info().averageFps);
...
}else if(halfRate&&!rereadCached){
    // 60->30: every second sample by timestamp, original PTS, a steady 30.
    const auto interval=liveSourceInterval100ns(pipeline::Rational::unknown(),activeSource->info().averageFps);
    const auto* upload=pipeline::captureUploadFrame(frame);
    const uint64_t* picture=upload&&upload->pictureValid?&upload->pictureId:nullptr;
    const auto shifts=captureSampler.shifts();
    if(!pkt.pts.isUnknown()&&!captureSampler.accept(pkt.pts.to100ns(),interval,false,picture)){
        std::lock_guard lock(mutex_);++snapshot_.captureRateSkipped;continue;
    }
    ...
    pkt.duration={interval*2,10000000};
}

采样器本身在 CaptureHalfRate.h:

// Explicit 60/59.94 transport -> 30/29.97 sampling before any GPU work.
// Keeps original PTS. It does not claim to detect unique pictures or repair
// irregular game cadence. Quarter-slot tolerance absorbs timestamp jitter.
class CaptureHalfRate {
public:
    static constexpr unsigned kSecondCopies=3;
    static bool supported(double fps){return std::isfinite(fps)&&fps>=59&&fps<=61;}
    bool accept(int64_t pts,int64_t transportInterval,bool boundary,const uint64_t* picture=nullptr){
        ...
        if(pts+transportInterval/4<next_){
            if(!shift_||!picture||repeat)return false;
            shift_=false;secondCopies_=0;next_=pts+transportInterval*2;++shifts_;return true;
        }
        ...
    }
};

三个细节值得注意,它们决定了“为什么 60→30 能缓解却无法证明 PTS 有错”:

  1. supported() 只接受 59–61 fps,所以 30fps 源、18fps 源、120fps 源都不会被切成一半。单元测试把这条契约固定下来:check(!CaptureHalfRate::supported(30)&&!CaptureHalfRate::supported(18)&&!CaptureHalfRate::supported(120)&&CaptureHalfRate::supported(59.94), ...),见 LivePresentationTimingTests.cpp。
  2. PTS 未被改写,只改 duration(乘 2);隔帧取样是“按时间戳取每第二张”,不做整幅像素比较。
  3. 允许一次网格平移(kSecondCopies=3):当 30fps 游戏在 60Hz 采集下每张画面重复两次、且每个第二次采样恰好落在第二份副本上时,连续 3 次重复后会额外接收下一张(第一份副本)并把网格从它重新起算。这是后来(2026-10-27)加入的相位修正,注释里写得很清楚:没有 picture number 时行为不变。

也就是说,现场“关闭补帧或 60→30 时不闪”这个观察,最稳妥的解释是负载与处理窗口变化改变了时序,而不是“源时间戳被证实有错”。报告在计划文档第 4 条里也把这条写成了硬约束:不从录像推断物理时长,不硬对齐日志时间。

与之相邻但语义完全不同的一条路径是 content dedup(自动/30/50/60fps 内容节奏),它按整幅画面的 picture number 判重,明确与 60→30 分开实现,见 ContentDedup.h:

// ... The content modes (auto / 30 / 50 / 60 fps) drop a sample here when its
// picture repeats the last kept one; "60->30" is the plain every-second-sample
// CaptureHalfRate, not this.

这条区分很关键:把两者混为一谈,就会把“重复画面剔除”的缺陷误记到“60→30 缓解了黑闪”的账上。

3.4 逐项核对过的可疑路径

报告列出的核对清单覆盖了补帧链路最容易出竞争与提前复用的几处:

  • 有界作业(bounded jobs);
  • 纹理的奇偶复用(parity reuse);
  • 生成帧的 warmup / validity;
  • producer / consumer fence;
  • present slot;
  • HDR 生命周期。

结论是:没有找到能够据现有日志定罪的资源竞争,也没有“跳过生成帧就清黑”的路径。这不是“代码没问题”的结论,而是“以现有日志的证据强度无法定罪”的结论——所以下一步必须补像素级证据。

3.5 版本二分:差异不在呈现层

正式 2.0.6 → 当前 main 的产品差异集中在 VFG 预算;未改 DLSS / XeSS graph、VideoPresenter 或 PresentSink。因此“当前没有版本二分证据证明哪个改动引入黑闪”。这一条直接决定了后续诊断包的构造方式:不改产品库,只在外部加取样。

四、本机验证矩阵:在确定非黑的输入上,能否复现黑样本

本机(RTX 5070 / 616.56)采用“复用已构建产品库 + 外部 VideoPresenter 副本加取样”的方式。前提条件写得很克制:原生诊断没有实卡输入,也没有 HDR 面板扫描验收;样本统计不作为性能验收,因为诊断窗口、额外 GPU 拷贝、debug layer 及过期策略都会影响负载。

原生用例 原帧样本 生成帧样本 九点全黑
HDR4K、FG关 480 0 0
HDR4K、DLSS2X、NVOF、源60 794 673 0
HDR4K、DLSS2X、NVOF、隔帧30 294 293 0
HDR4K、DLSS2X、AMD光流、静止60 647 441 0
同上+两层 Lecram NR1080 477 219 0
同上+两层 NVIDIA 原版 NR1080 628 242 0

六组均 exit 0、GPU 错误 0、运行组件前后 SHA 保持不变。报告特意留下两条“诚实记录”:

  • 早期两层用例误用了枚举 0(Lecram),没有冒充 NVIDIA 原版;修正为 NvidiaOriginal=3 后单独补做最后一组。这个枚举在源码中可以核对,见 EnhancementSettings.h:enum class NrRuntime { Original = 0, Community = 1, Ampere = 2, NvidiaOriginal = 3, LmxxfAmd = 4 };,且 NvidiaOriginal 对应运行组件 NVIDIA-original-RTX50-310.8.0。用错枚举意味着测的不是“NVIDIA 原版 NR”,这属于会污染结论的失误,所以必须显式记录。
  • 初次缺少 EXE 旁 shaders 导致初始化失败,保留但不计通过。诊断构建复用产品静态库时,shader 目录不会自动跟着走,这是最容易在“看起来跑起来了”的阶段制造假结论的坑。

五、GUI 最终诊断与 PowerShell 入口:把正例也测出来

原生矩阵只能说明“合成素材上不出黑样本”。要交付现场,还需要一个能采样真实 GUI 呈现路径的诊断 EXE。最终 GUI 诊断 EXE 的 SHA256 为:

4c38d320585ff545dac231910fe7f64b71a2930af5e164f6c40fb32fce9804a1

三条用例的结果:

  1. GTA6 原片 + NR1080 + VFG4:203 张原帧、608 张生成帧,两处取样全非黑,正常退出。
  2. DLSS2X / 源60 + 已知黑场输入:480 原帧 / 479 生成帧,准确检测到 13 张黑原帧 / 12 张黑生成帧,呈现输入与 buffer 一致;exit 0、无 ERROR。
  3. 最终 Windows PowerShell 5.1 入口 + 已知黑场 + VFG4:449 原帧 / 1345 生成帧,检测到 13 / 36 张黑帧;exit 0、forcedStop=false;原配置源文件 SHA 保持,自动证据 ZIP 的 CRC 通过且不含 profile。

第 2、3 条是本轮最有价值的工程产出:探针被正例证明“看得见黑”。没有这一步,“全非黑”就无法区分“确实没黑”和“探针根本没工作”。报告也把这一点写成了明确边界:

已知黑场是故意生成的测试素材,不是现场故障复现。最终取样器能检测黑图,仍不代表现场 bug 已修复。

失败记录同样被完整保留,因为它们是可复现的坑:

  • 首次 PowerShell 5.1 入口取得像素但 ExitCode 为 null,不记为退出码验收通过;保留原收据后,改为先保持 Process.Handle 存活,再另做独立用例并通过。这一修复就固化在脚本里:

    $process = Start-Process -FilePath $diagnostic -ArgumentList $quoted -WorkingDirectory $app -PassThru -WindowStyle Normal `
        -RedirectStandardOutput (Join-Path $output 'console.log') -RedirectStandardError (Join-Path $output 'stderr.log')
    # Keep the process handle open before exit. Windows PowerShell 5.1 can
    # otherwise return a null ExitCode after a manual WaitForExit call.
    $null = $process.Handle
    

    见 start-fg-flash-diagnostic.ps1。

  • QML 测试注入第一次因 CRLF 匹配失败,尚未写文件/启动进程,保留失败记录后修正。

  • 探针只支持 R8G8B8A8_UNORM 与 R10G10B10A2_UNORM;不支持时会置 failed 并报告 “no pixel CSV written … (supported RGBA8/RGB10 only)”。

六、现场诊断包:把 ZIP 放到原版旁边,复现 15–20 秒就够了

报告交付的现场件是 Veyra-2.0.6-black-flash-diagnostic.zip(位于交付目录 .../test-packages/fg-source-flash-20261008/)。它的设计原则是只追加、不改原物:只加入命名不同的诊断 EXE 与入口,并包含完整对应基础源码及诊断补充源码/许可证;没有新增或替换 DLL/模型,因此它“不是正式修复版”。

操作步骤完整保留如下:

  1. 关闭现有播放器,将 ZIP 顶层文件放在原 2.0.6 NVIDIA 便携版根目录(与 veyra_qml_ui.exe 同级)。不覆盖原 EXE。
  2. 双击 Start-Flash-Diagnostic.cmd。启动器将当前链/界面配置复制到独立 profile,只修改副本。
  3. 使用原采集源、同一补帧后端/倍率及“采用源时间戳”。在原来容易黑闪的静止场景复现 15–20 秒,看到黑闪后关闭诊断播放器。
  4. 程序最多 90 秒自动退出;取样最多 10000 次提交,120fps 约 83 秒,高倍率更早到上限。需要正常关闭才会保存取样;将 logs/flash-diagnostic-时间.zip 交回分析。

这几条限制都能在脚本里找到对应实现,值得逐条对上:

报告中的说法 脚本/源码位置
必须放在原 2.0.6 根目录同级 启动前校验 veyra-flash-diagnostic.exe、qt.conf、Qt6Core.dll、qml/Veyra/Main.qml 四个文件同时存在
只改副本、不改用户配置 复制 chain-session.v1、chain-session.v1.vfg、qml-preferences.v1.json、ui-session.v1、presets.v1、node-anchors.json 到 private-profile,并记录每个文件的 SHA256
最多 90 秒 [ValidateRange(15,90)][int]$DurationSeconds = 90,最终传成 --exit-after <ms>
拒绝覆盖证据 输出目录已存在则抛错 Output directory already exists; refusing to overwrite evidence.
交回件不含配置 Compress-Archive 只收集 .log/.csv/.json,且校验 copiedSourceProfileFilesUnchanged

--exit-after 是 QML 主程序自身的参数(--exit-after <ms> 到时自动退出,0 表示一直运行),见 main.cpp。因此 15–20 秒的现场复现与 90 秒的兜底上限是同一套机制,不依赖外部杀进程;forcedStop=true(超时强杀)在收据里会显式记录为 124。

另外一个容易被忽略的细节:脚本在 finally 里恢复 TEMP、TMP、CUDA_CACHE_PATH、VEYRA_LOG_FILE、VEYRA_FLASH_PROBE_DIR、QML_DISABLE_DISK_CACHE 六个环境变量,并把临时目录与 CUDA 缓存都重定向到输出目录内的 tmp。这样做既隔离了运行环境,也避免诊断过程污染用户既有缓存。

七、双阶段九点像素探针的实现细节

这是整份报告最“硬”的部分,也是最值得复用的诊断技术。核心思想:在同一次呈现命令里,把“进入 presenter 的最终纹理”和“Draw 之后的交换链 buffer”各采 9 个点,CPU 只在收尾 fence 完成后读取一次。

7.1 有界的 GPU 读回缓冲

FlashPixelProbe.h 里定义了全部容量常量:

inline constexpr unsigned capacity=20000, points=9, stride=512;
inline Microsoft::WRL::ComPtr<ID3D12Resource> readback;
...
rd.Width=uint64_t(capacity)*points*stride;rd.Height=1;rd.DepthOrArraySize=1;rd.MipLevels=1;...

算一下实际占用:20000 × 9 × 512 = 92,160,000 字节 ≈ 87.9 MiB。这与报告里“约 88MiB 有界 readback,不是持续增长的图像存储”完全对应。容量语义也很清楚:一条现场记录包含“源纹理 + 交换链”两条 entry,所以 FieldPixelProbe 先做

if(flashProbe::entries.size()+2>flashProbe::capacity){flashProbe::overflow=true;return;}

也就是最多约 10000 次呈现提交,与报告“取样最多 10000 次提交”一致;超限不是丢数据而是置 overflow=true 并在 dump 时让 ok=false,避免把“采到一半”的结果当成完整证据。

7.2 九个取样点与码值判黑

取样位置按 1/4、1/2、3/4 取整,避开边框与 UI 遮挡区:

for(unsigned y=0;y<3;++y)for(unsigned x=0;x<3;++x){
    const unsigned xx=unsigned(d.Width)*(x+1)/4,yy=d.Height*(y+1)/4;
    D3D12_BOX box{xx,yy,0,xx+1,yy+1,1};
    D3D12_TEXTURE_COPY_LOCATION dst{};dst.pResource=readback.Get();
    dst.Type=D3D12_TEXTURE_COPY_TYPE_PLACED_FOOTPRINT;
    dst.PlacedFootprint.Offset=(uint64_t(entries.size())*points+y*3+x)*stride;
    dst.PlacedFootprint.Footprint={d.Format,1,1,1,256};list->CopyTextureRegion(&dst,0,0,0,&src,&box);
}

每点用 512 字节槽位、rowPitch=256,即相邻样本之间留出填充,避免单像素拷贝与相邻槽位共享缓存行造成相互干扰。

格式只接受两种:R10G10B10A2_UNORM(HDR10 主路径)与 R8G8B8A8_UNORM(SDR 路径);其它格式直接 failed=true。解码与判黑都在 10bit 尺度上统一:

if(e.format==DXGI_FORMAT_R10G10B10A2_UNORM){uint32_t v=0;std::memcpy(&v,p,4);rgb={v&1023,(v>>10)&1023,(v>>20)&1023};}
else rgb={unsigned(p[0])*1023/255,unsigned(p[1])*1023/255,unsigned(p[2])*1023/255};
unsigned localMax=0;for(auto v:rgb){lo=std::min(lo,v);hi=std::max(hi,v);localMax=std::max(localMax,v);mean+=v;}
black+=localMax<=5;

判黑门限是 localMax<=5(10bit 全量程约 1023),单帧判定则是“9 点全黑”才计入 blackReal / blackGenerated。这解释了为什么手机录像里 ROI 均值 1.97/255、2.09/255 的画面会被视为“接近全黑/黑”:换算到 10bit 大约是个位数码值。

7.3 状态屏障:探针必须“可逆且不留痕”

取样前把资源从 COMMON 转到 COPY_SOURCE,取完立刻换回来:

b.Transition.StateBefore=D3D12_RESOURCE_STATE_COMMON;
b.Transition.StateAfter=D3D12_RESOURCE_STATE_COPY_SOURCE;
list->ResourceBarrier(1,&b);
... 九次 CopyTextureRegion ...
std::swap(b.Transition.StateBefore,b.Transition.StateAfter);list->ResourceBarrier(1,&b);

这里有一个隐含前提需要点明:它假定取样时目标资源处于 COMMON。诊断副本是在 VideoPresenter::present() 完成 Draw、并把 barrier 换回 COMMON 之后再插入取样的,所以成立;换成别的插入点就可能引入状态不一致。报告里“取样会带来额外命令和屏障,现场阴性也不能彻底排除时序竞争”这句话,说的就是这类副作用。

7.4 双阶段:把“输入黑”与“buffer 黑”分开

FieldPixelProbe.h 每次调用记录两条 entry,并用一个 Event 把它们绑成一对:

inline void record(ID3D12Device* device,ID3D12GraphicsCommandList* list,ID3D12Resource* source,ID3D12Resource* buffer,bool generated,uint64_t frame,unsigned slot,uint64_t epoch,uint64_t revision,int64_t pts,unsigned backBuffer){
    if(flashProbe::entries.size()+2>flashProbe::capacity){flashProbe::overflow=true;return;}
    const size_t begin=flashProbe::entries.size();
    flashProbe::record(device,list,source,generated,frame,slot,epoch,revision,pts,"present-input");
    flashProbe::record(device,list,buffer,generated,frame,slot,epoch,revision,pts,"present");
    if(flashProbe::entries.size()==begin+2)events.push_back({begin,begin+1,frame,epoch,revision,0,pts,wall100ns(),0,backBuffer});
}

两个阶段在产品的呈现函数里正好对应两个已存在的句柄,见 VideoPresenter.cpp:

auto* source=generated?graph.generatedFrameResource(slot):graph.videoFrameResource(slot);
auto* bb=sink_.currentBackBuffer(&backBufferIndex);if(!bb)return false;
auto* renderTarget=copyBeforePresent_?compositeTarget_.Get():bb;

也就是说,source 是补帧链路交付的最终增强原帧或生成帧纹理,bb 是 DXGI 交换链当前 back buffer。于是“同一帧、同一命令列表、两个阶段”构成了一条可以直接三分的判读链:源纹理黑 → 问题在上游(graph / provider / 交接);源正常而 buffer 黑 → 问题在 blit / 描述符 / 资源复用;两者都正常而现场屏幕仍闪黑 → 方向转向提交后的窗口、遮罩、合成、驱动与显示路径。

7.5 CPU 只读一次:fence 在收尾等,不在每帧等

submitted() 记录提交 fence 值,finish() 只在收尾等待:

inline void submitted(ID3D12Fence* fence,uint64_t value){
    if(flashProbe::entries.size()==submittedEntries)return;
    submittedEntries=flashProbe::entries.size();lastFence=fence;lastValue=value;
    if(!events.empty())events.back().fence=value;
}
...
// Close already drains the private presenter queue. Shared-queue paths use
// their submitted fence; wait only here, never in the per-frame loop.
if(lastFence&&lastFence->GetCompletedValue()<lastValue){
    HANDLE event=CreateEventW(nullptr,FALSE,FALSE,nullptr);
    const HRESULT hr=event?lastFence->SetEventOnCompletion(lastValue,event):E_FAIL;
    const DWORD waited=SUCCEEDED(hr)?WaitForSingleObject(event,10000):WAIT_FAILED;
    ...
}
// If recording was followed by a failed submit, exclude the unsubmitted tail.
flashProbe::entries.resize(submittedEntries);

resize(submittedEntries) 这一行很关键:如果最后一次记录之后提交流程失败,尾部 entry 从未真正提交,读回内容是未定义数据,必须裁掉,否则会污染统计。

7.6 两张 CSV:像素与事件分离

dump() 输出的像素表字段为:

ordinal,source,generated,slot,format,minCode,maxCode,meanCode,blackPoints,epoch,revision,pts100ns,unix100ns,stage

事件表字段为:

sourceOrdinal,bufferOrdinal,frame,epoch,revision,pts100ns,recordUnix100ns,presentEndUnix100ns,backBuffer,submitFence,presentOk

这套字段设计对应报告的承诺:“CSV 保留码值、帧 ID、PTS、wall time、epoch/revision、buffer index、fence 及 Present 结果,不包含整幅抓帧。”像素表回答“是不是黑”,事件表回答“哪一帧、什么时候、用哪个 buffer、Present 成功没有”。epoch 与 revision 来自 FrameBatch.h 的 FrameIdentity,是区分“同一设置段内”与“重建之后”的基础;报告用“不止一次 epoch/revision”来判断是否发生了反复重建,正是靠这两个字段。

输出目录由环境变量覆盖,缺省回落到产品日志目录(RuntimePaths.cpp 的 applicationRoot()/logs):

const auto dir=length&&length<32768?std::filesystem::path(overridePath):veyra::runtime::logsDirectory();

诊断启动器设置的 VEYRA_FLASH_PROBE_DIR 就是这里读取的覆盖点,从而把证据固定到独立输出目录而不是污染用户 logs。

八、判读树:现场拿到 CSV 之后怎么走

报告给出了完整的三岔判读,这是整个诊断包的使用说明书:

观测 结论方向 下一步
present-input 阶段即黑 输入已黑 查 graph / provider / 交接(补帧 SDK 输出、NR/SR 链路、fence 交接)
输入正常、present 阶段 buffer 黑 呈现层写黑 查 blit、描述符堆、资源复用、ClearRenderTargetView 与 barrier
两阶段都正常、现场屏幕仍闪黑 提交之后的问题 查窗口、遮罩、合成、驱动与显示路径

报告对第三种情形加了一句非常重要的限制:

像素正常而屏幕黑闪只能把方向移到后续呈现/窗口/合成/驱动/显示,不能直接宣布电视或驱动有问题。

同时它也承认探针的三个盲区:

  1. 正常电影黑场同样会被检测,需要与相邻原帧及现场时点区分;
  2. XeSS 在代理 swapchain 内部生成的帧不在此 probe 覆盖范围——这正是“现场存在 XeSS 切换,不能把全部时段归给 VFG”的技术原因;
  3. 取样本身改变时序(额外命令与屏障),现场阴性不能彻底排除时序竞争。

因此报告给出的下一步唯一关键证据是:实际闪黑那次的双阶段像素及事件 CSV。

九、复现命令与证据保全

报告把外部脚本与产物路径都写进了正文,便于逐条复算(这些目录位于任务工作区,不在本仓库内,此处保留原路径形式):

外部脚本目录 .../reports/fg-source-flash-20261008:

脚本 作用
analyze-log.py 日志分析,产出分析 JSON
segment-log.py 按进程/设置 revision/后端/内容节奏分段
analyze-video.py 手机录像逐帧亮度分析,输出亮度 CSV 与检视图片
build-probe.py 用原有 Ninja 编译/链接 argv 构建原生诊断(只给外部 VideoPresenter 副本加取样)
run-probe.py 运行原生诊断用例矩阵
build-field.py 重链接实际 GUI
run-field.py 隔离 GUI 用例

原生末组的实际命令(报告中直接给出):

python reports/.../run-probe.py hdr-dlss-amd-static-original-nr2 dlss transport hdr 2 20 3840 2160 amd static

参数含义可从命名与上下文对应:用例名、补帧后端 dlss、内容节奏 transport、hdr、倍率 2、时长 20 秒、3840×2160、光流 amd、内容 static(静止场景)。

GUI 末组使用:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/diagnostics/start-fg-flash-diagnostic.ps1

并明确指定 E 盘共享 app、private 配置源、独立输出、15 秒及已知黑场源;完整参数在收据 / WORKLOG 中。

证据保全的口径:

  • 实际编译/链接 argv 与产品库 SHA 见 logs/.../build-receipt.json 与 field-build/receipt.json;
  • 每组实际参数 / EXE SHA / 退出码见对应 receipt.json,汇总在 reports/.../test-summary.json;
  • 手机视频解码使用本机 FFmpeg 8.1.1 作离线检视,未替换产品带 PS5 补丁的 FFmpeg 9.0.1(这一点很重要:诊断不能顺手改掉被诊断对象的依赖);
  • 全部 GPU 用例串行、无竞争/压力程序;没有改驱动、用户配置或其它工作树;
  • main 仍为 dbfceab,产品源码无改动,不合并/推送/发布/关机;
  • 保全和新增占用以本轮 preservation-check.json、delivery.json 及 storage.json 最终收据为准。

诊断源码本身在仓库内可查阅:scripts/diagnostics/fg-flash/README.md 明确了“诊断专用、不链接进正常产品或其 CMake 目标”,并记录了基产品提交 71723e0249a17764696796fd204a6eb69d6da276 与最终 GUI SHA256。

十、这一轮的结论如何被后续工作继承

报告本身没有提出修复,但它产出的两条线索被后续工作直接继承:

线索一:诊断环境差异足以解释“诊断版不闪”。 后续 FG_FLASH_FIX_REPORT_2026-10-09.md 把这一点展开为三条非单变量差异:每次呈现多出 18 次单像素 GPU 拷贝与额外屏障;EXE 改名(veyra_qml_ui.exe → veyra-flash-diagnostic.exe)可能避开 NVIDIA App、RTSS 等程序级配置;私有配置与 QML_DISABLE_DISK_CACHE=1 改变了运行环境。结论是:“诊断不闪”不等于“已经定位”。

线索二:最终 GPU 访问方式值得替换。 由此产生了 HDR 最终合成纹理的兼容候选,实现就在 VideoPresenter.cpp:

// Field 2026-10-09: HDR application FG flashes on an RTX5090 while the
// pixel-copy diagnostic does not. This is a compatibility candidate, not
// proof of a driver defect. Compose separately and copy the actual final
// image to DXGI; never retain the diagnostic's CPU readback or add sleeps.
copyEligible_=ctx.adapter().isNvidia&&graph.hdr10Output()&&graph.fgEnabled()&&bool(presentationQueue_);

它与本报告的判断一脉相承:只改最终呈现访问方式(先画到独立合成纹理,再 CopyResource 到交换链,最后回到 PRESENT),不改源时间戳、倍率、丢帧/过期规则、光流/NR/FG 算法或 VSync;分配失败记 HRESULT 并回退原路径;正常链路没有像素回读、额外 CPU fence 等待或睡眠。发布侧的口径也很克制——RELEASE_NOTES_2.0.7.md 写明新开关默认关闭、可立即保存、可能增加显存带宽/纹理开销、切换会短暂停顿,且“现场闪黑根因未最终确认,不宣称默认已全部修好”。

十一、未验证边界清单(必须与结论一起引用)

报告最后一节列出了明确的未测范围,引用本报告结论时应一并带上:

  • 原生 VFG / HDR 全矩阵未验;
  • XeSS 内部生成帧未被探针覆盖;
  • 现场实卡输入、全屏、VRR、长时间稳定均未验;
  • 本机无 HDR 面板扫描验收,且本机显示器约 320Hz,与现场 5090 / 617.42 / LG 143.988Hz 不同;
  • 手机录像 30fps 采样无法量化黑闪物理时长,手机与电脑时钟未校准;
  • 样本统计不作为性能验收,因为诊断窗口、额外 GPU 拷贝、debug layer 与过期策略都会改变负载;
  • 已知黑场正例只证明“探针能检测黑图”,不代表现场 bug 已修复。

这套“结论 + 边界”并列的写法,是这份报告最值得学习的地方:它把“我们确知什么”“我们排除了什么”“我们还没测什么”三件事分开表述,使后续任何人接手时都不会把推断当成事实。

十二、可复用的方法论要点

把这轮排查压缩成可迁移的实践清单:

  1. 先固定证据再谈归因:日志与录像都要有字节数、行数/帧数、分辨率、SHA256。没有这些,后续所有分析都不可复算。
  2. 区分“调度成功”与“像素正确”:invalid=0、providerDisabled=0、Present 返回成功,都是调度层事实,不能替代图像内容证据。
  3. 正例与阴性同等重要:只有先用已知黑场证明探针能检测,0 张全黑 才有意义。
  4. 取样必须有界:固定容量 + overflow 标记 + 收尾一次读回,避免诊断本身把显存或时序拖垮。
  5. 诊断不得改动被测对象:只追加命名不同的 EXE 与入口、只改配置副本、不替换 DLL/模型、不替换产品 FFmpeg。
  6. 记录失败本身:误用 NR 枚举、缺 shader 目录、PowerShell 5.1 的 ExitCode=null、CRLF 匹配失败——这些都写进了报告,因为它们决定了哪些数据“不能算通过”。
  7. 把“未测”写进结论:这是让一份排查报告在后续修复阶段仍然可信的唯一方式。

从源码结构看,这套方法论与产品自身的设计也是对齐的:呈现层用 FrameIdentity{epoch, settingsRevision, sourceFrameId} 划分“同一设置段”,用 producer/consumer fence 与租约(FrameLease,见 FrameBatch.h)保证资源不被提前复用,而诊断 CSV 恰好把这些字段原样导出——于是现场交回的一张 CSV,就能和产品内部的身份模型、fence 语义、buffer index 一一对上,不需要再靠“复述现象”来描述故障。

登录后查看全文
Veyra-NRVideo