Veyra-NRVideo 工程实录解读:从实时录制、补帧节奏到卡死诊断的落地方法

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

Veyra-NRVideo 工程实录解读:从实时录制、补帧节奏到卡死诊断的落地方法

Veyra-NRVideo 的 WORKLOG 历史记录 是一份跨度近一个月、超过一万行的工程流水账。它不是功能列表,而是一份"每条结论都带证据边界"的施工记录:每条条目都写明分支起点、存档标签、构建步数与耗时、回归组数、实机验证数字,以及明确【未验证】的部分。本文以该文档为主体骨架,把其中最具工程复用价值的三条主线——实时录制处理后画面、补帧前的重复帧与内容节奏处理、音频预读与引擎卡死诊断——拆解成可复用的设计说明,并用仓库源码对每条结论做实现层面的印证。读完之后,你应当能看懂 Veyra-NRVideo 这类 GPU 实时增强管线在"为什么不卡播放"这个问题上的具体取舍,也能理解这份记录为什么大量篇幅在写"没验证什么"。

一、这份 WORKLOG 的记述规范:为什么它值得当技术文档读

打开 WORKLOG 会发现条目结构高度固定,以 2026-10-20 的实时录制条目为例,一段记录通常包含七个部分:

  1. 需求与授权边界:用户要求什么、在哪个分支实施、起点提交、存档标签;
  2. 实现路径:新增哪个类、复用哪条既有链路、哪些配置项被扩展;
  3. 构建:CMake 目标、构建目录、并行度、编译步数与失败步数、增量重建耗时;
  4. 回归:哪些测试套件、多少项通过、是否有 0 失败;
  5. 功能验证:用哪个验收脚本、真实运行多久、产出文件的实际参数;
  6. 测试包:ZIP 字节数、SHA256、manifest 文件数、冷启动退出码;
  7. 未做与未验:明确列出没有合并 main、没有推送、没有发布,以及哪些硬件/场景尚未实测。

这种结构的价值在于:它把"通过"限定在可复现的量化证据上。例如同一份文档里多次出现这样的表述——"编译不等于运行通过""提交 FPS 只表示软件 Present,不是物理屏幕 FPS""本机 5070 结果不代表其他显卡"。这些约束在阅读时应当作为解析规则:凡是记录里带限定词的结论,就不能当成无条件事实使用。

文档内部的路径引用也多以"方案 / 执行记录 / 报告"三件套形式出现,例如实时录制对应 docs/history/plans/SCREEN_RECORDING_PLAN_2026-10-20.md(方案)与 SCREEN_RECORDING_EXECUTION_2026-10-20.md(执行记录),内容节奏对应 CONTENT_CADENCE_2026-10-11.md 与 CONTENT_CADENCE_EXACT_2026-10-12.md,音频预读对应 AUDIO_READ_AHEAD_2026-10-11.md。读者可以按"WORKLOG 找结论 → 报告看数据 → 源码看实现"的顺序逐层深入。

二、实时录制:在呈现命令列表里把"处理后的画面"编码掉

2.1 需求与实现轮廓

2026-10-20 条目的需求是:录制处理后的画面(即经过 NR/SR/补帧等增强链之后的最终图像),设置页可配置保存位置与码率,专业模式截图按钮旁增加带 3 秒倒计时的录制按钮。

实现没有另起一条捕获链路,而是新增 LiveRecorder(LiveRecorder.h、LiveRecorder.cpp),复用产品已有的导出编码器:NVIDIA 走 NVENC,其他厂商走 Media Foundation MFT。它挂在呈现链上的方式由 PresentCapture.h 定义:

class PresentCapture {
public:
    struct Frame {
        ID3D12Resource* texture=nullptr; // graph output; COMMON on entry, must be left in COMMON
        DXGI_FORMAT format=DXGI_FORMAT_UNKNOWN;
        uint32_t width=0,height=0;
        uint32_t hdrMode=0;              // 0 SDR, 1 scRGB (linear BT.709), 2 HDR10 (PQ BT.2020)
        float ditherStep=0;              // graph output dither step (RgbToNv12 reserved.y)
        bool generated=false;
    };
    virtual bool record(ID3D12GraphicsCommandList* list,const Frame& frame)=0;
    virtual void submitted(ID3D12Fence* fence,uint64_t value)=0;
    virtual void discarded()=0;
};

关键设计写在头文件注释里:VideoPresenter 在自己的呈现命令列表内调用 record(),转换到 NV12/P010 只是 GPU 上一次 compute pass,CPU 侧没有任何等待;随后 submitted() 给出该命令列表提交的 fence 点,于是图在复用纹理前等待的 consumer fence 天然覆盖了录制命令,"没有任何第二条队列会碰图里的纹理"。discarded() 处理呈现失败、命令列表未提交的情况——此时不能有帧被算作已编码。

2.2 参数全集:RecordingSettings

录制行为的全部可配置项集中在一个结构体里,这也是设置页与 QML 桥接的字段来源:

字段 类型 语义 默认值
directory std::wstring 输出目录,不存在时自动创建 —
bitrateMbps uint32_t 码率(Mbps);0 表示按画面尺寸与帧率自动 0
hevc bool 是否 HEVC;HDR 录制恒为 HEVC 10-bit false(H.264)
fpsLimit uint32_t 录制帧率上限;0 表示每个呈现帧都录 0
audio bool 是否录制播放器实际播放的声音 true
microphone bool 是否录制麦克风 false
microphoneId std::wstring 麦克风端点 ID;空表示默认录音设备 空
microphoneTrack bool 麦克风单独成轨,而非混入声音轨 false
replaySeconds uint32_t 仅即时回放录制器:缓冲区保留时长 60
replayMemoryBytes uint64_t 仅即时回放录制器:内存上限;0 表示取物理内存的 1/8,夹在 512 MB~4 GB 0

对照 WORKLOG 中"码率 8/16/20/40/80、帧率、H.264/HEVC"的设置页描述,可以看到 UI 暴露的是这组字段的一个受控子集:设置页在 SettingsPage.qml 里通过 veyra.setPreference("recordBitrateMbps", …) 与 veyra.setPreference("recordFps", …) 写入偏好,桥接层再转成 RecordingSettings。桥接侧的属性与可调用方法在 QmlPlayerBridge.h 中集中声明,包括 recording、recordingState、recordingDirectory、recordingBitrateMbps、recordingFpsLimit、recordingHevc、recordingAudio、recordingMicrophone 等只读属性,以及 startRecording() / stopRecording() / toggleRecording() / chooseRecordingDirectory() / openRecordingDirectory() / saveReplay() 等 Q_INVOKABLE 方法。

2.3 不卡播放的三道闸门

"录制磁盘慢只丢帧计数不卡播放"是这条功能最核心的工程目标,实现上有三道互相独立的闸门:

  1. GPU 侧固定槽位:LiveRecorder.cpp 中 constexpr unsigned kSlots=6;,六个槽位通过原子状态位 compare_exchange_strong 抢占(slots[i].state 0→1)。一帧若发现所有槽位仍在编码,就被跳过并计入 dropped,而不是等待。
  2. 写入侧有界队列:容器写入在独立线程进行,队列上限 240 个包、高水位 160;磁盘跟不上时同样只累积丢帧计数。
  3. 排空超时分级:EncoderConfig 增加了可配置排空超时,录制用 2 秒,导出保持原有 10 秒——录制是"能收就收",导出是"必须完整"。

RecordingStatus 把这些内部状态完整暴露给界面,字段语义值得逐条看:active 表示录制中或等待首帧;failed 表示上一次录制因错误停止;finishing 表示文件仍在后台收尾;dropped 是"编码器或磁盘忙而被跳过的呈现帧数";files 是本次录制写出的文件数(切换输出尺寸或 HDR 模式会续写 -2、-3 新文件);started / saved 是单调计数器,供界面判断状态变化而不必轮询文本。

2.4 声音、麦克风与即时回放

声音走的是 RecordingAudioTap.h 定义的 tap 机制:RecordingAudioSink::renderedPcm() 在音频所有者线程上"复制后立即返回,绝不阻塞",抓取的是播放器真正送到端点的 PCM(在音量与静音之前),并用 playoutUs 标注它到达端点的时间。多个录制器可以同时挂接(录制 + 即时回放),没有监听者时渲染器只读一个原子标志。录音为 AAC 48 kHz 立体声,空洞补静音、时钟漂移用重采样吸收,因此音轨既连续又与画面同步。

即时回放(#103)用同一个 LiveRecorder,构造时传 replay=true,编码结果不进磁盘而进内存缓冲(ReplayBuffer.h)。缓冲按 GOP 整段从队首丢弃(实时编码器的 GOP 为 2 秒),所以一次保存得到的剪辑一定从关键帧开始,长度等于所选时长再加至多一个 GOP。saveReplay() 在自己的线程上把当时缓冲的内容写成新的 MP4,缓冲区 meanwhile 继续填充。

文件容器是分片 MP4(fragmented MP4),这直接对应注释里的"崩溃也能保住已经写入的部分"。

2.5 验收是怎么做的

功能验证脚本 screen-recording-control.py 的流程可以当作"如何验证一条 GPU 录制链路"的模板:

  1. 复制已打包的便携版到私有目录,不改动用例依赖;
  2. 用 ffmpeg 生成一段 20 秒、1280×720、30fps 的合成测试片(testsrc2),不触碰用户素材;
  3. 通过 Loader 把 screen-recording-ui.qml 注入staging 副本的 Main.qml,并在 finally 中恢复原始字节;
  4. 以 --page pro --size 1280x800 --data-dir <私有目录> --exit-after 120000 启动真实程序,由测试 QML 走真实生产 bridge:设置 recordDir 偏好 → startRecording() → 录制约 25 个 200ms tick → stopRecording() → 断言 recordingState 中 frames > 0、failed 为假、path 非空;
  5. 用 ffprobe -count_frames 核对产出文件的编码、分辨率、帧数与时长。

环境变量也被严格隔离:所有 VEYRA_*、QT_*、QSG_* 前缀被剔除后重建,TEMP/TMP 指向任务私有目录,并关闭 QML 磁盘缓存。WORKLOG 记录的实测结果是:录制 5.2 秒得到 160 帧、丢帧 0 的 H.264 1280×720 MP4,文件 9,966,597 字节,ffprobe 时长 5.249 秒,界面通知"录制已结束"。

2.6 两个只在冷启动暴露的 QML 错误

这一条目里最有教学价值的部分,是回归全绿之后仍然存在的缺陷。QML 冒烟测试 105 项通过、数据迁移 PASS、i18n 0 失败、UI 契约 PASS——但冷启动抓到了两个真实错误:

  • 录制控件放在头部 RowLayout 里却使用了 anchors,应改为 Layout.alignment;
  • easing.type: Theme.spring 把线性缓动值当成了枚举,应改为 easing: Theme.spring。

修正后重新打包,冷启动日志无 QML 错误。这条记录确立了一个方法论:QML 组件能被单测实例化,不等于它在真实布局容器里能正确加载。同类证据在同一份文档的其它条目里反复出现(如"稳定器容差滑条用了 VSlider 不存在的 stepSize,导致新界面整体加载失败、所有页面白屏"),因此对 QML 改动,冷启动日志检查应当与组件测试并列为必过项。

三、内容节奏:先去掉重复帧,再谈补帧

3.1 问题定义

锁 30 或 40 fps 的游戏经 60 Hz 采集会产生重复画面。如果直接对这些样本做帧生成,插值会跨过一对"一模一样的帧",或者在盲目采样漏掉真实帧的地方跨过一个双倍步长——结果就是鬼影或抖动。文档里旧方案的问题被写得很具体:原来的 60→30 处理在 40 帧内容上误删真实帧,761 帧里丢了 189 帧,且在 58 Hz 下完全不起作用。

3.2 从采样点到整幅画面比较

ContentDedup.h 记录了一次重要的自我修正。第一版用 64×36 个采样点、8 级门限判断重复,结果"一个从静止位置观看的运行中 HDR 游戏丢掉了大部分真实画面(60 帧里只保留 6–16 帧,2026-10-12 现场日志)"。现在改为:采集回调(CPU 帧则由引擎)把整幅画面的每个分量与最后一张新画面比较,比较实现位于 PictureCompare.h;落在采集噪声带内、仅少数孤立分量不同的样本仍保留自己的画面编号。

用"画面编号"而不是"像素"还带来一个副作用好处:如果某个样本的画面引擎从未读到(mailbox 覆盖),编号仍然有效,不会把两张不同画面误判为同一张。

3.3 内容时间戳:夹在采样窗口内

保留下来的帧需要一个新的"内容时间戳",规则是相位锁定的夹取:画面在上一次采样之后、且不晚于本次采样时发生变化,因此预测时间被夹进这个窗口(content = std::clamp(predicted, lo + 1, hi))。对规律内容(58 Hz 里的 30 帧、60 Hz 里的 40 帧)会得到均匀间隔、且永不超过采样时间的时间戳;卡顿与可变帧率则保留自己的采样时刻。

周期估计用最小二乘:对最近 48 个保留下来的帧做"采样时刻对帧序号"的斜率拟合,并扣除传输网格量化误差。代码里给了量化误差的量级——n 帧上的斜率误差约为"槽位/n^1.5",在 58 Hz 下约 0.05 ms。连续两次预测落空即判定帧率变化,重新学习。

3.4 静止画面按内容节奏保持

如果画面在卡顿之后持续相同(暂停的游戏、菜单),实现不会退化成"每 150–250 ms 一帧",而是按内容节奏的栅格保持——40 fps 内容在 60 Hz 下保持 33/17 ms 的交替间隔,且不慢于 15 fps(std::max(cadence, transport*2) 与 666667 = 66.67 ms 上界共同约束)。这样做的目的是让保留帧率,连同 NR 与帧生成的 GPU 工作量,保持稳定。

Stats 结构把判定过程完全暴露:observed/kept/repeats/held/blind/regular/irregular 七个计数,加上 maxShiftMs(最大采样到内容的修正量)。

3.5 与 60→30 的区别

文档特别强调:60->30 是另一条路——朴素的"每两个样本取一个"(CaptureHalfRate.h),它与内容去重不是同一件事。对没有 CPU 画面的硬解串流,仍按时间戳减半处理,因为此时无法做整幅比较(picture == nullptr 分支:++stats_.blind,全部保留,边界事件重新锚定节奏)。

3.6 实测结论

用 GTA6 渲染素材回放:30→60/58、40 帧放 60 Hz 的新版本0 丢失、0 重复,内容间隔 99.6–100% 落在 ±1 ms 内;旧 60→30 方案在 40 帧内容上丢 189/761 帧,且在 58 Hz 下不起作用。回归 15 组全部通过。同一条目也写明边界:不改默认内容节奏、不改 NR/SR/FG 模型、不改运行库与用户配置。

四、音频预读:一次"主时钟停摆"的定位与修复

4.1 症状与证据链

2026-10-11 的 logs(16) 条目描述了一个非常典型的误判陷阱:用户报告 2.0.6、RTX 3060 Ti、4K HDR 电影开补帧时间歇卡顿。最初怀疑方向是设置或拖动,但证据否定了这个假设:

  • 20 次停顿,每次 0.25–0.59 秒,与设置/拖动无关;
  • 停顿位置在呈现背压;
  • 同时音频时钟停止推进、音频线程摘要迟到,而视频读包正常;
  • 补帧关闭时同样出现。

由此定位到根因:音频线程在喂 22 ms 声卡缓冲的同时自己读文件,而读文件要越过交错的 4K 视频包;慢读时声卡断粮 → 主时钟停住 → 视频随之停住。这条因果链解释了为什么"关掉补帧也卡"。

4.2 修复与开关

修复在 WasapiAudioSink.cpp 的 AudioPipeline 中增加读包线程:稳定播放时预读本音轨的包,使用 2.5 秒有界队列;拖动、起播、声卡恢复时暂停预读,并按原方式同步读取。同时补上 avformat 中断回调,避免慢 IO 无法取消。

诊断计数器按秒输出在 audio-continuity 摘要里:underruns、pcmMs、queuedPacketMs、maxReadMs、maxLoopMs。对照实验也留了开关,符合这份文档一贯的风格:

  • VEYRA_TEST_AUDIO_DIRECT_READ=1 恢复旧读法;
  • VEYRA_TEST_AUDIO_READ_STALL_MS / _EVERY_MS 注入慢读。

4.3 量化结果

同一份 EXE 做 A/B,每 700 ms 注入一次 300 ms 慢读:

场景 旧读法 新读法
5 秒音频实际推进 3.84 秒 5.009 / 5.009 秒
停顿次数 297 ms 一次停顿 0
真实播放器(NR + XeSS 补帧 + 慢读)音频时钟倍率 0.727× 1.000×
≥150 ms 引擎停顿 4 次 0 次

音频 7 组与播放器 9 组回归通过。这个条目示范了如何用"注入故障 + 同 EXE 对照 + 明确开关"把一次主观体感的卡顿变成可复现的数字。

五、补帧侧的排队预算与过载恢复

5.1 混合档位:两种模型交替

2026-10-11 的 VFG 混合档条目(报告见 VFG_MIXED_TIERS_2026-10-11.md)实现三档"高+中 / 高+低 / 中+低":VfgBackend 在混合档加载第二个 NvVFX 实例(同一条 CUDA 流),每对原帧中间那张子帧用前一档,其余用后一档。镜头切换判断改由新着色器 shaders/VfgShotChange.hlsl 在 GPU 上每对 A/B 判一次,与 CPU 侧 SceneCadenceAnalyzer 使用相同指标与阈值;切换时通过 predication 显示 B。SDK 自带检测关闭,VEYRA_TEST_VFG_AUTO_SHOT_CHANGE=1 可恢复旧行为。vfgQuality 取值扩展到 0–5。

验证数据:veyra_vfg_settings_tests 683 项全过;veyra_vfg_gpu_tests 1280×720 async 在 D3D12 调试层下 2425 项全过,三种混合档的每张子帧与对应单模型输出逐位相同,12 种组合下未声明硬切换时子帧都等于 B(误差 0),切换计数恰好 2。播放器同 EXE A/B 中:4X 每次 Run 3.66→3.24 ms,中+低整组 p95 12.6→6.9 ms、GPU 60%→45%;8X 提交帧率 210→228(仅换检测)→240(中+低,GPU 64%,拒绝/跳过/降档/过期全部为 0)。条目同样写明未验证:各档实际观感(混合档在细纹理上可能有"呼吸"感)、其他显卡、采集卡与 60fps 片源、HDR 实际播放。

5.2 降档后的排队成本:一个纯函数

当 VFG 因过载降档到 2X 时,一次 evaluate 只做一次插值而不是请求的 M-1 次,但排队计费若仍按完整倍率算,会持续高估成本。这段逻辑被抽成一个可单测的纯函数(VfgQueueBudget.h):

inline std::optional<double> vfgQueuedGroupCost(std::optional<double> full,
        std::optional<double> base,std::optional<double> first,bool reduced,
        unsigned evaluations,bool warmingHistory){
    const auto valid=[](std::optional<double> value){return value&&std::isfinite(*value)&&*value>=0;};
    if(!reduced||evaluations!=1||warmingHistory||!valid(full)||!valid(base)||!valid(first)||*full<*base)return full;
    return std::min(*full,*base+*first);
}

语义很克制:只有"确实降档、恰好一次 evaluate、历史已暖、三个测量值都有效且完整成本不小于基础成本"时才改用 base+first,并且只会降低、不会抬高;任何条件不满足就退回完整估算。

5.3 过载估计的恢复边界

更棘手的是恢复。如果一个严重超载的完整组只在测量窗口里跑过"负担得起的 2X 组",它可能显得免费,从而永远错误地被放行。VfgOverloadEstimate.h 用两条规则封住这个漏洞:

  1. 保留的估计不是新鲜的 GPU 采样,因此 severeTotal() 只有在"当前首张插值不慢于历史首张的 80%"时才给出严重超载判定,避免用旧关系硬套新情况;
  2. 允许一次有界、低频的完整探测:probeInterval = 300000000(30 秒,100 ns 单位),并且必须在 allowProbe() 中先预约再提交,防止多个在途帧对同时重试。

reset() 会在源、历史或设置变化时丢弃这层关系。WORKLOG 里对应的失败记录也被如实保留:首版没有低频重新评估,被对抗式复查指出"后续插帧一次性变慢而首帧没有变化,保留比例可能长期锁住恢复",于是补上了 30 秒最多一次的完整重新测量。

六、卡死诊断:把"无日志停住"变成可命名的阻塞调用

6.1 现场证据

2026-10-10 的 logs(15) 条目开场就是最有说服力的一段:12 次卡死全部是引擎线程无日志停住,而采集/音频照常;其中 10 次界面线程同时停住(两个出画面线程互锁);关闭时进程不退出。全部发生在 HDR 输出 + NGX(DLSS 补帧 / RTX HDR)条件下;"实时"和"高"优先级都会卡,因此优先级方案被放弃。

还有一条与外部叠加层相关的观察:nvspcap64.dll 即使浮窗关着也会被驱动加载,所以"模块存在"不能作为浮窗开启的信号;可靠信号是 NVIDIA Overlay.exe。

6.2 两层兜底

EngineWatchdog.h 的设计把这类问题的可观测性写进了类职责:

  • 引擎所有者线程在播放循环每次迭代顶部调用 beat();离开循环时 disarm();
  • 停滞时记录阻塞位置(调用栈按模块 + 偏移与最近导出名)并在日志旁写一个小的 minidump,于是下一次反馈能直接点名阻塞的调用;
  • stage() 暴露"最后完成的循环阶段"(字符串字面量,由 CpuStallTrace 写入),避免额外分配;
  • hung() 供关闭流程查询,使其不去无限等待一个不会返回的线程。

WORKLOG 给出的具体参数是:8 秒无进展记录调用栈、小转储与提示,10 秒复查;退出时最多等引擎 20 秒(已判定卡死时 3 秒)后结束进程。监控软件兼容策略在"自动"模式下,启动时若检测到 NVIDIA 信息浮窗或游戏加加,就让界面走软件绘制;运行中出现则提示重启。

6.3 验证方式

测试用模拟而非复现:模拟 12 秒阻塞与永久阻塞,模拟游戏加加在启动前或中途出现,均按预期动作;浮窗开启时自动切软件界面 + DLSS 2X 120 fps 通过;回归 13 组全部通过。条目同时声明:不改 GPU 优先级默认值、不改运行库、驱动与用户配置。

七、相邻主线:采集格式、HDR 对齐与厂商 SDK 接入的证据边界

WORKLOG 的另外几条主线同样体现"边界优先"的写法,值得单独一提,因为它们展示了同一套方法论在不同层的应用。

采集格式拆成三个下拉。2026-10-11 条目把首页采集卡对话框的一条合并格式列表拆成分辨率 / 帧率 / 像素格式三个下拉,三者共同决定原来的 captureFormatKey;后两项只列出当前选择下设备真实枚举到的组合,逐行/隔行属于不同帧率,同名像素格式(场序不同)仍可分别选择。连接、继续上次、Blackmagic 驱动页回选都保存并恢复这一条格式键。验证方式是直接编译单测:g++ -std=c++20 -I include tests/unit/CaptureFormatSelectionTests.cpp → failures=0,并明确说明"本环境不是 Windows,未跑 VS2022/Qt 构建,未生成 Win64 包"。相关实现位于 CaptureCardSource.cpp。

Elgato HDR 红色溢出与 RGB 黑屏。定位方式是对照固定源码:与 Nitlink 4f8a723、OBS libdshowcapture c13d4b7 逐段比较后确认,1.x 的修复 be3e2e6 仍在 2.0 中,但只覆盖"4K60 Pro MK.2 + P010";其它型号未关卡内色调映射,8 位格式下 OBS 会打开色调映射而 Veyra 不管,Nitlink 对 MK.2 以外的卡按"亮度有限、色度全范围"解 HDR P010。修改包括 isElgatoDevice、属性 722 覆盖全部 Elgato 名称、8 位格式请求打开卡内色调映射并在关闭时恢复、ColorDescription::fullRangeChroma 与着色器范围模式 2。验证数据:capture-color 270/270(Elgato 13 项),全范围色度解码与换算码值误差 1.7%,旧解码红色高 27%。条目紧接着写明"无 Elgato 实卡;真实颜色与 RGB 黑屏需反馈者日志确认"。

Avermedia 5.1 厂商图(PR63/PR64)。这两条是"厂商 SDK 接入"的典型样本:公开厂商头固定归档、ABI 为 12 字节 AUDIO_SAMPLE_INFO 按值回调、non-PCM arming、STA/150 ms 初始等待/有限恢复、格式切换与回调生命周期、载波有界、FFmpeg padding/reset。实测数据也很具体:AC3/EAC3 首包 1536 采样、原 parser 需要第二包,聚合 6 帧 9216 全部保留;文档同时提醒这个 32 ms 是 48 kHz 解码阶段的等待差异,不是屏幕/整体延迟实测。报告见 PR63_AVERMEDIA_AUDIO_REPORT_2026-10-18.md 与 PR64_AVERMEDIA_REPORT_2026-10-19.md。

全屏输入。这一条的验证方式尤其值得借用:不是看 Qt 的请求值,而是看系统真实状态——"系统 GetCursorInfo 在实际视频区域隐藏 false/showing 恢复 true,不能只看 Qt 请求值";真实点击证明专业模式播放/暂停两态全屏无误切换。报告见 FULLSCREEN_INPUT_REPORT_2026-10-18.md。

八、怎么读这份记录的"未验证"清单

散落在各条目的未验证声明,实际上是这份文档最有信息量的部分。把它们归类,能得到一张清晰的能力地图:

  • 硬件维度:RX 9000 HIP 推理、RTX 40/30 实卡、616.92 驱动、5090 现场闪黑、Blackmagic/Avermedia 实卡长稳;
  • 信号维度:VRR 主机经采集卡的补帧("本机 60 Hz 卡通过不能替代反馈者 VRR 主机实测")、真实 HDR 色度、物理显示端到端延迟;
  • 测量口径:提交 FPS ≠ 屏幕 FPS ≠ 物理延迟;--native 的 NR 耗时是 GPU 处理耗时而非呈现延迟;4K 为输出缓冲不等于 4K 源 NR 性能;
  • 环境维度:Linux/Wine 下的对象编译与真实 MSVC 端到端不可互替;
  • 副作用维度:混合档在细纹理上的"呼吸"感需要人眼判断。

对应地,文档里反复出现的"不做"清单也构成一组工程纪律:不把 identity fixture 的通过当作结果正确(因此专门加入"非恒等 GPU marker"填补缺口);不把只编译当作通过;不把 grep 旧日志里的 PASS 当证据;不为通过门禁而降低阈值或删除失败测试。1c 条目就是一个正面例子:用 CPU 反例证明"每 8 帧抽查无法保证未检查帧",于是拒绝把方案接入产品,并保留反例证据——"没有产品改动需 revert"。

九、把这份实录当方法论文档使用

如果要复用到自己的实时 GPU 管线项目,可以从这份 WORKLOG 里直接取出五条可操作的实践:

  1. 在呈现命令列表内完成"额外输出"。把录制/回放实现成 PresentCapture 这样的窄接口(record/submitted/discarded),让既有 consumer fence 天然覆盖新工作,避免第二条队列碰图纹理。
  2. 用固定槽位 + 有界队列 + 分级排空超时把"慢"转成"丢"。kSlots=6、240 包队列/160 高水位、录制 2 秒 vs 导出 10 秒,三处阈值各自独立、可观测(dropped 计数)。
  3. 把判定逻辑抽成纯函数或纯头文件类再单测。vfgQueuedGroupCost()、ContentDedup、VfgOverloadEstimate 都是可在无 GPU 环境用单元测试覆盖的形态;GPU 侧只负责喂测量值。
  4. 每个修复都配一个可切换的旧行为开关 + 一个故障注入口。VEYRA_TEST_AUDIO_DIRECT_READ、VEYRA_TEST_AUDIO_READ_STALL_MS、VEYRA_TEST_VFG_AUTO_SHOT_CHANGE、VEYRA_TEST_CONTENT_DEDUP_LEGACY 让 A/B 可以在同一个 EXE 上做,避免版本差异污染结论。
  5. 把"未验证"写进同一条记录。它不是免责声明,而是下一次测试的输入——文档里绝大多数后续条目正是从上一轮"未验"清单里挑出来的。

结语

WORKLOG_before_maintenance_2026-10-27.md 的价值不在它记录了多少功能,而在它把"什么算证据"这件事重复了一万行。实时录制的三层不阻塞设计、内容去重的从采样点到整幅比较的自我否定、音频预读的注入式 A/B、VFG 降档计费的纯函数化与 30 秒探测上界、看门狗把"无日志停住"变成可命名的调用栈——这些都能在 include/veyra/engine 与 src/engine 中读到对应实现,其中 LiveRecorder、ContentDedup、EngineWatchdog、VfgQueueBudget、VfgOverloadEstimate 是最值得先读的五个文件。想继续深入某条主线时,按条目里给出的"方案 / 执行记录 / 报告"三件套路径检索 docs/history/plans 与 docs/history/reports,配合 scripts/acceptance 下的验收脚本即可复现整套验证流程。

登录后查看全文
Veyra-NRVideo