Veyra-NRVideo 多分支修复整合验收实战:从 `--no-ff` 合并到看门狗、像素与性能守卫

原创2026-11-15 14:07:362,231 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra-NRVideo 多分支修复整合验收实战:从 --no-ff 合并到看门狗、像素与性能守卫

本文以 2026-10-11 的本地整合验收记录为主体,完整还原 Veyra-NRVideo 如何把七个已完成修复分支安全并入本地 main,并在同一轮里完成增量重编、26 项集成回归、软件 UI 像素/裁剪校验、引擎卡死注入诊断与普通调度性能守卫。读完后你将掌握一套可复用的"多分支修复整合 + 证据链闭环"验收方法,并理解为什么"构建通过"绝不能等同于"现场卡死根因已复现"。

一、这次整合到底在解决什么问题

本次任务不是新功能开发,而是一次受用户明确授权的本地 main 整合:把已经在各条 claude/* 分支上完成、但尚未进入主线的修复,一次性合并并验证。它有三个前提约束:

  • 起点固定:main 基线为 5ba186a91e868c28b4b5ec46c9166aa321d90998,隔离工作分支为 codex/merge-claude-fixes-20261011。
  • 完整性优先:六个已完成的 Claude 分支,加上一条已验 UI 的完整 tip,依次用 --no-ff 合入,保证"所有负优化 revert 随完整分支保留",避免按提交挑选导致撤回项被漏掉。
  • 结果可对账:实测候选 9c14ee28a9175aa326fb0aa09c15bfa5808e0f0e 通过功能 merge 3a08ce8cf28de6d0f83c7b025bd4a7f54fe37b27 合入本地 main,并核对完整 Git 树相同;此后只更新四份收尾文档,产品源码与实测输入保持一致。

分支来源与顺序记录在 合并方案 中,最终 main、checkpoint/bundle 与保护核对由 E:/项目/Veyra/reports/merge-claude-fixes-20261011/final.json 确认。注意这是本机路径下的回执文件,不属于仓库内容,仓库中只保留了脚本与文档说明。

为什么必须用 --no-ff 而不是逐条 cherry-pick

方案文档给出了明确理由:每条分支内部都包含"修复 + 撤回早期实验"的成套历史。如果只挑选看起来正确的提交,撤回记录会丢失,被否定的优化会重新出现。--no-ff 完整合并 tip,等于把分支的最终状态语义整体引进主line。

分支 tip 最终范围
claude/vfg-20261010 d3803ab 跳过预算组时保留 VFG 输入历史、测试诊断、负载提示;倍率降档和连续 CUDA 实验已撤回
claude/pipeline-20261010 be834fd Present 统计、重复/失效组配对校准、同步说明;交换链预等实验已撤回
claude/freeze-fix-20261010 d0694d7 NVIDIA 浮窗/游戏加加兼容、引擎无进展诊断、有限等待退出
claude/dedup-cadence-20261011 67574f2 CPU 画面内容去重与有界内容节奏;硬解来源保留原兜底
claude/audio-reader-20261011 87ca1e5 文件音频独立读包、有界队列、读盘阻塞诊断
claude/elgato-hdr-20261011 147e76c Elgato 格式/色调映射和 P010 混合色度范围
codex/ui-smear-handoff-20261011 29e33df 软件图标/虚线裁剪、保持局部更新与 33ms 统计

表中前六条是"六个已完成 Claude 分支",最后一条是"已验 UI 完整 tip",合计七条来源。

二、七项保留修复的逐条拆解

整合记录的第一部分用七条要点概括了保留内容。这一节按源码把它们展开。

2.1 VFG 跳过预算组时保留输入历史与负载提示

VFG(视频帧生成)在预算不足时会"减少每组实际执行的插值次数"。关键问题是:缩减组仍然占用队列,成本估算不能沿用完整组的数值。

VfgQueueBudget.h 用一个纯函数表达该规则:缩减组只执行一次插值,因此排队成本应取 base + 首次插值实测,并与完整估算取最小值,绝不放大:

// A reduced VFG group executes one interpolation, not the requested M-1.
// Its queued work is base + the measured first interpolation. Retain the full
// estimate when measurement/history is unavailable, and never increase it.
if(!reduced||evaluations!=1||warmingHistory||!valid(full)||!valid(base)||!valid(first)||*full<*base)return full;
return std::min(*full,*base+*first);

warmingHistory 为真(历史尚未预热)时直接返回完整估算——这正是记录中"保留输入历史与负载提示"的可执行含义。调用点在 EngineController.cpp 附近,同时把 warmingHistory 写进 live-fg-admission 日志字段,便于事后对账。

2.2 呈现统计与"重复/禁用但已完成计算"的组参与配对节奏校准

记录强调两点:重复组、以及"被禁用但计算已经完成"的组,仍然要参与配对节奏(pair cadence)校准;而"交换链预等"实验保持撤回。校准逻辑落在 LivePairLatency.h:它保存最近 10 秒、最多 64 个"就绪延迟"样本,取 95 分位作为目标,并把每对相位压缩限制在 0.5 ms 以内、且不允许超过既有策略:

const auto target=std::min(legacyDelay,current[index]+5000);
const auto step=std::min<int64_t>(5000,interval/multiplier/8);
selected_=std::clamp(selected_?selected_-step:legacyDelay,target,legacyDelay);

同样重要的是记录中的那句限定:DXGI Present→vblank 统计不是屏幕光学延迟。这是证据边界,不是性能结论。

2.3 NVIDIA 信息浮窗/游戏加加的兼容选择、8 秒无进展栈/小型 dump 与有界退出

这条是本次整合的技术重心,涉及三个文件:PresentationHooks.h、EngineWatchdog.h、EngineController.cpp。

(1)叠加软件检测为什么要"看进程"而不是"看模块"。 PresentationHooks.h 的注释解释得很清楚:nvspcap64.dll 会被驱动加载进每个 D3D 进程,与浮窗是否开启无关;因此必须看 NVIDIA Overlay.exe / NVIDIA Share.exe 是否在运行。RTSS 则要求 RTSS.exe 进程存在且 RTSSSharedMemoryV2 映射头为 'RTSS',因为强制结束的服务端可能留下有效签名。游戏加加按 GamePP* 进程与前缀匹配的注入模块 GPP64.dll、GameTracker64.dll、shade64.dll 双重判断。

(2)看门狗如何判定"无进展"。 阈值硬编码在 EngineWatchdog.cpp:constexpr uint64_t kReportMs = 8000;。监视线程每 250 ms 醒一次,读取 lastBeat;超过 8 秒未打点即进入报告态:

log::error("engine-hang", std::format("owner={} stalledMs={} lastStage={} cpuMs={} stackFrames={} nvidiaOverlay={} rtss={} gamePP={} (playback loop made no progress; capture/audio threads are separate)", ...));

注意日志里带了三个叠加软件布尔值与 lastStage——这让"到底是驱动卡住还是第三方 hook 干扰"有了第一手线索。报告态下还会按 20 秒间隔重采样栈,判断栈是 unchanged 还是 changed。

(3)dump 为什么小。 dump 类型是 MiniDumpWithThreadInfo | MiniDumpWithHandleData | MiniDumpWithUnloadedModules,注释明确"no heap, so the file stays small enough to send with the logs"。文件名形如 veyra-hang-YYYYMMDD-HHMMSS-<pid>.dmp,写入日志目录,并回写一行 minidump written=true file=... bytes=...。

(4)有界退出。 这是现场日志(15)的直接产物。析构体里先置 shutdown_/stop_ 唤醒 worker,然后最多等 20 秒(若看门狗已判定卡死则 3 秒),超时即写日志并 TerminateProcess,而不是无限 join:

if(waited<(watchdog_->hung()?3000.0:20000.0))continue;
veyra::log::error("engine-hang",std::format("shutdown: owner thread still blocked after {:.0f} ms; ending the process instead of waiting",waited));

如果启用了 Remote Play,PS5 只手柄会话还有独立的 8 秒关闭预算。

2.4 CPU 可见采集画面的内容去重与 60→30

这是"看起来像画质问题、实际是节奏问题"的典型。ContentDedup.h 的头部注释把背景、失败教训和边界一次写清:

  • 锁 30/40 fps 的游戏在 60 Hz 采集下会重复画面,帧生成会跨静止帧对插值,或在盲目采样丢帧处跨"双倍步长"插值。
  • 第一版用 64×36 个采样点、8 级门限判断重复,结果运行中的 HDR 游戏在静止机位下丢失了大量真实画面(每秒 60 帧只剩 6–16 帧,现场日志 2026-10-12)。
  • 现版本改为比对"整个画面的每个分量",落在采集噪声带内、仅少数孤立分量超出的样本仍保留画面号(PictureCompare.h)。
  • 没有 CPU 画面(硬解流)时一律保留,stats_.blind 计数,边界事件重新锚定节奏。

节奏时间戳的规则是"钳位锁相":画面在上一采样之后、本采样之前发生变化,预测时间被钳进这个窗口;规则内容(30 in 58 Hz、40 in 60 Hz)得到均匀间隔且永不晚于采样。静止超过一次卡顿的画面(暂停、菜单)按内容节奏保持,从而让 NR 与帧生成的 GPU 工作量保持稳定。

对比之下,"60→30" 是另一套东西:CaptureHalfRate.h 明确"Keeps original PTS. It does not claim to detect unique pictures or repair irregular game cadence."它是显式的 60/59.94 → 30/29.97 隔点采样,用四分之一槽容差吸收抖动;后续加入的相位逻辑在连续 3 个"第二份拷贝"(kSecondCopies=3)后把网格移到下一张的首份拷贝上。

引擎侧的接入点在 EngineController.cpp:dedupActive 与 halfRate 互斥,只有开启去重或 60→30 时才让采集回调做整画面比较(setPictureCompare),并把 captureRateSkipped 作为可观测的跳过计数。

2.5 文件音频独立读包、2.5 秒/4096 包/16MiB 有界队列

三个上限写在 WasapiAudioSink.h:

static constexpr double kReadAheadMs = 2500.0;
static constexpr size_t kReadAheadPackets = 4096, kReadAheadBytes = size_t(16) << 20;

读线程 readerLoop 的等待条件同时受三者约束:queuedMs_<kReadAheadMs && queuedBytes_<kReadAheadBytes && queuedPackets_.size()<kReadAheadPackets。这解释了记录里"稳态端点线程不读盘"——队列满时读线程睡眠,只有解码消费后才继续 av_read_frame。

同时 readPacket 记录了单次读盘耗时上界 maxReadMs_,形成"慢读诊断"。seek 仍然同步清空与预填充:queuedPackets_.clear();queuedMs_=0;queuedBytes_=0; 之后由 owner 重新 seek,读到一半被 seek 打断的包会被丢弃并继续循环,不会把旧位置的数据混进新位置。

2.6 Elgato 8 位卡内色调映射与非 MK.2 P010 混合色度范围

ElgatoHdrControl.h 暴露了接口约定:configure(filter, name, p010, overrideValue, color),其中 p010=true 表示 10 位 HDR 格式。setTonemap 的 strict 参数是本次修复的关键差异:

// strict: a failed or contradicted write fails the connection (MK.2 P010).

实现里,8 位路径以非严格方式请求 hardwareTonemap=1(对齐 OBS 行为),MK.2 的 P010 路径走严格模式:写入失败或回读不一致就拒绝连接,并记录 Tonemap readback disagrees; refusing a mislabeled color contract。这正对应记录中的"手动范围优先,官方控制属性失败边界保留"。

另一条是"非 MK.2 的 P010 混合色度范围"。configure 里 wantHdr 的判定遵循"显式空间优先,auto 只采纳已校验的源 InfoFrame",并且:

// InfoFrame declares EOTF, not YUV encoding or quantization. Preserve
// explicit driver matrix/primaries; only fill their missing defaults.

即 InfoFrame 只声明 EOTF,不能据此覆盖用户显式设置的矩阵/基色,只能补默认值。析构时若原来读到过状态,会尝试把 tonemap 属性写回原值。

2.7 软件 UI 用缓存 SVG Image,整窗重绘与 QuickPrivate 保持撤回

qml/Veyra/VIcon.qml 用 sourceSize 按 Screen.devicePixelRatio 取整并开启 cache: true,把图标变成缓存的栅格 Image,替代原先的 GPU Shape 路径。验收脚本会统计 RasterIcons 与 RasterIconsNotReady 两个指标(见 tests/qml/SoftwareUiDamageProbe.h),未就绪必须为 0。

记录中"整窗重绘和 QuickPrivate 方案保持撤回"在后继的配置校验里被固化成断言:merge-claude-fixes-configure.py 会检查主程序编译命令里不出现 QtQuick/6.8.3:

assert 'QtQuick/6.8.3' not in main.replace('\\', '/')  # No withdrawn QuickPrivate/full-redraw hook.

三、人工复查共同接点发现的退出竞态

自动合并"源码零冲突"并不等于逻辑安全。方案第 3 步要求在共同接点上人工复查:EngineController 的去重/配对/看门狗、EnhanceGraph 的 VFG/输入范围、QmlPlayerBridge 的状态/浮窗、软件 UI 的 clip。

复查发现了一个只在退出时触发的隐患:hangPreviousStatus_ 声明在 watchdog_ 之后,而 C++ 按声明逆序析构,于是 hangPreviousStatus_ 会先被释放,看门狗回调仍可能读取这个字符串。修复方式是在析构体内、所有成员仍存活时显式 watchdog_.reset():

// The watchdog callback reads snapshot_ and hangPreviousStatus_. Detach it
// while all controller members are still alive, before reverse destruction
// reaches hangPreviousStatus_ (declared after watchdog_).
watchdog_.reset();

配套地,EngineWatchdog::~EngineWatchdog() 先持有 notifyMutex 把 notify 置空,再置 stopping 唤醒监视线程,从而保证回调不会在析构中途被调用。

这条修复严格遵循"没有顺手更改其它模型、倍率或调度默认值"的纪律——整合只解决整合暴露的问题。

四、构建:增量闭包重编,而不是 clean 全量重编

整合后的构建由 merge-claude-fixes-build.py 驱动,结论是:50 个变更/头文件依赖闭包对象重新编译,19 个 EXE 重链接,76.6 秒。

脚本的设计值得完整借鉴,它解决的是"如何在不 clean 的前提下仍然可信":

  1. 变更集来源:git diff --name-only <BASE_COMMIT> 加上 git ls-files --others,即已提交与未提交的新增文件都算。
  2. 头文件传递闭包:不依赖旧 ninja 的 depfile,而是自己扫 #include,按 include 路径后缀向上做传递闭包:
affected = set(changed_headers); grew = True
while grew:
    grew = False
    for path, incs in includes.items():
        if path in affected: continue
        if any(any(h.endswith('/' + i.lstrip('./')) or h == i for h in affected) for i in incs):
            affected.add(path); grew = True
  1. 对象级复用带自证:每个 .obj 旁写 .build.json,内容为"完整编译命令行 + 源文件 SHA + 头文件集合 SHA + 依赖键"的哈希与产物 SHA;下次只有在两者都匹配时才 reuse。
  2. 库成员展开:不仅重编 EXE 直接目标,还把链接到的 veyra_* 静态库目标展开为对象集合,避免"库没重编导致新旧对象混链"。
  3. 新增源的处理:EngineWatchdog.cpp 不在旧 CMake 图里,脚本用同库邻居对象的编译参数编译它(added = {...EngineWatchdog.cpp: (source, neighbour)})。
  4. 显式重生成物:QuickSmokeTests 的 MOC、QmlPlayerBridge 的 moc 组、DeckLink 的 MIDL ABI、YuvToLinearRgb 等 shader 的 DXC 编译、i18n/catalog.json 的 RCC 打包、版本资源 RC——全部显式重跑,而不是假定缓存有效。
  5. 测试专用链接选项:给 veyra_qml_ui 加 /DEBUG:FULL(便于 symbolize.py 解析 <a href="https://link.gitcode.com/i/ae34eb113d2541b4f9df70377af01a38" target="_blank">engine-hang] 栈帧),给 veyra_live_presentation_tests 加 /STACK:8388608(wmain 里大量 PlayerSnapshot 局部变量)。后者与 [CMakeLists.txt 的正式定义一致:
add_executable(veyra_live_presentation_tests tests/integration/LivePresentationTests.cpp)
target_link_options(veyra_live_presentation_tests PRIVATE /STACK:8388608)

产物核对结果:GUI SHA256 为 d4e5aa25cf78120c51eb7793165452101b10798bfd67e1c6cdc724f6ba9d078a,仍是本地 2.0.6 开发标识,没有改发布版本。这一点很重要:整合验收与发版是两件事。

五、配置校验:不让"关掉功能"的配置冒充最终能力

merge-claude-fixes-configure.py 不复用旧对象的结论,而是用真实完整 CMake 图重新配置一遍,并逐项断言:

  • 从已接受构建的 CMakeCache.txt 提取全部 VEYRA_* 与 CMAKE_MAKE_PROGRAM、CMAKE_PREFIX_PATH,再补上 PROTOC、SDL3_DIR、LibDataChannel_DIR、Opus_DIR、nlohmann_json_DIR 等被固定的外部工具/包路径。
  • 强制断言 VEYRA_ENABLE_REMOTEPLAY/MOONLIGHT/XBOX == ON,并确认主程序编译命令里带 -DVEYRA_ENABLE_*=1;这对应记录中"QML、PS5、Moonlight、Xbox、DeckLink、Magewell 和现有实验运行接口保留"。
  • 断言 src/engine/EngineWatchdog.cpp.obj 出现在图中、/STACK:8388608 出现在回放测试的链接命令中、QuickPrivate 不存在。
  • 私有滚动 probe 只替换主程序测试驱动:把 apps/veyra-qml/main.cpp 复制到临时文件,注入 installSoftwareUiDamageProbe(window, &bridge),用上一轮产品的链接响应文件重链接,只换掉 main.cpp.obj。因此生产 EXE 不含该驱动,运行时/SDK/用户配置都不被写入。

脚本最后对全部输入做 SHA 复核,并输出 productExeSha256 与 probeExeSha256 两个不同哈希——这本身就是"probe 未污染产品"的证明。

六、26 项集成回归:每一项都对应真实可执行入口

merge-claude-fixes-test.py 用一个 donor 便携包做骨架,逐文件 verify() SHA 后,用本轮新 EXE 覆盖,再逐项跑 26 个用例,全部 exit0。它的判定不是"进程没崩",而是三重条件:

passed = code == 0 and not errors

其中 errors 用正则捕获 FAIL 、FAIL!、passed=0、ReferenceError:、TypeError:、Binding loop、Cannot assign、D3D12 ERROR、D3D12 CORRUPTION。

覆盖范围与记录一一对应:

记录中的表述 脚本用例 实际驱动
效果合同/时间线 chain、timing veyra_effect_chain_tests、veyra_live_timing_tests
HDR/采集颜色 hdr、capture-color veyra_hdr_color_tests、veyra_capture_color_tests
呈现生命周期 lifecycle veyra_present_sink_lifecycle_tests
设置重建及回退 video、rollback、presenter --settings-rebuild、--reset-rollback、veyra_settings_transaction_tests
关闭项编辑的列表/节点两路径 inactive、inactive-node --inactive-effects、--inactive-effects-node
SR 已有回归 sr veyra_sr_quality_tests
数字输入/菜单/组件 slider、menu、components QML quick tests,QSG_RHI_BACKEND=d3d12
VFG GPU vfg-gpu veyra_vfg_gpu_tests ... 1280 720 async
60→30 half-rate 60 fps 素材 + --half-rate
音频抖动/起播跳转/欠速/慢读/旧读法对照/倍速 audio、audio-jitter、audio-startup-seek、audio-underrate、audio-stall、audio-stall-direct、audio-rate --jitter、--startup-seek、--underrate、--read-stall、--read-stall-direct
反复跳转和文件端点 seek-stress、file-endpoint 真实文件回放

测试样本使用"用户 GTA 原视频",内容节奏使用已有测试渲染文件——不替换用户媒体。音频倍速用例现场用 wave 生成 48 kHz/1 声道/16 位、5 秒 440 Hz 正弦波作为 fixture,避免依赖外部素材。

慢读用例为什么能被稳定复现?因为 readPacket 里有一段显式测试钩子:VEYRA_TEST_AUDIO_READ_STALL_MS 与 _EVERY_MS 控制"首次读取只调度、后续读取睡指定毫秒",从而在不改动产品路径的前提下模拟慢盘。

每个用例还隔离了环境:过滤所有 VEYRA_*/QT_*/QSG_* 变量,重设 TEMP、CUDA_CACHE_PATH、QML_DISK_CACHE_PATH,并把 VEYRA_EXPORT_TEST_ARTIFACTS 指向本次输出目录;单例超时 290 秒。

七、软件 UI 像素与裁剪校验:只读"已呈现像素"

merge-claude-fixes-gui.py 的 pixels 分支复用 ui-software-damage-test.py,条件与记录完全一致:生产 Main/ProPage、150% DPI、3 个 NR 层、80 步滚动至 100px。

关键测量口径是"QScreen 只读已呈现像素",即通过 screen.grabWindow 抓屏而非请求重绘,因此 probe 断言里有两条否定条件:

assert not probe['scrolledGrabTriggeredRender'] and not probe['referenceGrabTriggeredRender']
assert abs(probe['scrolledContentY']-probe['referenceContentY']) < 0.1

即抓屏本身不能触发渲染,两张图的滚动位置与内容高度必须一致,否则对照无效。

结果对照:

指标 旧 QML 对照 合并后
残影像素(>10 差值) 1237 0(inspector 与边缘区域)
完整重绘后的头部越界像素 209 0(固定头部变化像素)
OBS/RTSS 兼容选择 — 均 0
图标就绪 — 37 个 Ready,未就绪 0
空闲 3 秒帧数 — 分别 3 / 2 帧,无持续绘制

裁剪校验(clipping())特意复用已采集的 initial.png/reference.png,不再额外渲染或回放:旧软件 Shape 即使在完整重绘下也会把图标画进固定头部,因此断言"旧版该区域计数 > 0、新版 == 0",并记录两张图的 SHA256 以便复核。

报告同时保留了 PNG、逐项 JSON 与人工截图复核。这里有一个必须复述的边界:本轮没有重新执行 OBS 实际采集,也没有做 RTSS 真实注入——兼容路径是按配置选中的,不是通过与第三方软件真实同跑验证的。

八、卡死注入验收:证明机制,不证明根因

watchdog 分支做了两次受控注入,用 Main.qml 里临时挂载的 Loader 加载探针 QML,并通过 VEYRA_TEST_ENGINE_HANG_MS 设定阻塞时长:

用例 注入 报告时刻 栈帧 dump 结果
watchdog-recover 12 秒延迟 8047 ms 10 帧 1 个,1239193 字节 恢复并正常退出(moved again)
watchdog-shutdown 永久阻塞 8172 ms 10 帧 1 个,1245672 字节 关闭后 3015 ms 结束等待并终止本进程

两个进程均 exit0。脚本的断言写法值得注意:

bad = [line for line in h.errors(text) if 'engine-hang' not in line]

即"预期内的 engine-hang 错误要单独校验,而不是把所有错误一起过滤掉"。此外还校验了 owner=\d+ stalledMs=(\d+) .*stackFrames=(\d+) 只能出现一次、stalledMs >= 8000、stackFrames > 0、minidump written=true,以及恢复/有界退出两种语义互斥成立,最后要求总耗时分别 < 40 秒与 < 30 秒。

报告末尾的限定必须原样保留:这证明诊断/恢复/退出机制有效,不证明反馈者的驱动卡死根因。把"注入成功"当成"真实根因已复现",是这类验证最常见的误读。

九、普通调度性能核对:守卫、失败与反序复测

性能核对条件:GTA 原 4K30、NVIDIA 原版 NR 单层内部 1080p / 强度 1 / 风格 0,SR/FG/自动调控全关,实际 GPU 调度 class2。每例 40 秒有效播放、29 个前台一秒样本。NR 数字是一秒 GPU 均值的中位数;CPU 是"进程 CPU 秒/墙钟秒",既不是整机百分比,也不是纯 UI 耗时。

界面 NR 前→后 UI 次/秒 进程 CPU 秒/秒
gpu 5.847270 → 5.862661 ms(+0.26%) 36 → 35 0.262846 → 0.237482
obs 5.850922 → 5.820384 ms(-0.52%) 35 → 36 0.219905 → 0.253086

GPU 对照是"原已验完整包 vs 整合产品";软件对照是同一个整合 EXE,只切换旧/新 VIcon 与 ProPage,专门排查绘制退化。四例视频提交均为 30 fps,不冒充物理屏幕刷新率。

预先登记的短测守卫是:UI 增加 ≤ 3 次/秒、NR 增加 ≤ 3%、CPU 增加 ≤ 15%。

首轮软件 CPU +15.09% 超线。 这里最关键的做法是:没有直接计通过,也没有放宽阈值,而是产品不改、以新→旧倒序额外复测两例:

  • 倒序 NR:5.949594 → 5.796090 ms,UI 35 → 36 次/秒,CPU 0.238783 → 0.235530 秒/秒。
  • 倒序本身及两种顺序平均 CPU:0.229344 → 0.244308(+6.52%),通过同一 15% 守卫。
  • 所有 NR/UI 守卫保持;统计用 QML 的 SHA e88541114240fad417f7d1f08bde0b8236964ff7e9005c8fc8214743c006958b 不变。

记录对结论的措辞同样是克制的:首轮失败与复测数据一起保留,不把这几次短测当严格性能等价证明,更不宣传算法提升或跨机保证。

脚本层还硬性校验了默认 GPU 优先级没被改动:

assert all(r['priority'] == {'status':'0x0', 'value':2} for r in meters if r['elapsed'] > 10), 'normal GPU priority changed'

0x0/value 2 即 normal class,与记录中"保持默认 GPU 优先级"对应。

十、证据、失败与边界

10.1 证据落点与不可变保护

所有新构建、日志、私有配置、缓存和诊断都在 E:/项目/Veyra/{build,logs,tests,tmp,reports,archives}/merge-claude-fixes-20261011。reports/.../validation.json 固定构建/测试/像素/性能回执 SHA;archives/.../start.json 与 source-before.bundle 是不可变保护点,原 54 工作树 / 496 脏文件、七来源分支、原测试包 1626 文件逐项核对后保持不变。

这意味着验收具备可重放性:只要这些 SHA 与 bundle 还在,就能回答"当时到底跑了什么、跑的是哪份源码、产物是哪一份"。

10.2 记录在案的失败(不是产品故障)

整合过程保留了三处过程性失败,均如实记录、不计为通过:

  1. 初次完整配置遗漏旧缓存的显式 protoc 路径,退出 1;补齐旧已验工具位置后配置通过。
  2. 检查脚本误用正斜线匹配 Windows Ninja 反斜线,断言失败;修正检查后完整配置/私有 probe 编译链接通过。
  3. GUI 的 Python -I 隔离模式读不到既有用户站点 psutil;GUI 按既有 -B 方式运行,未安装新依赖。

i18n 方面:合并前后均 29 项未翻译/语言,placeholder 问题 0,未新增缺口。

10.3 明确的未覆盖边界

以下项目没有在本次本机验收中完成,不能对外宣称已通过:

  • Elgato / Blackmagic 真卡验证;
  • 现场 5060Ti 卡死复现;
  • 所有叠加软件组合(OBS 实际采集、RTSS 真实注入);
  • AMD 串流;
  • 长时间显存增长(NVIDIA 显存持续增长仍未根治)。

另外两条同样是硬边界:Claude 文档中的旧实验 FPS/音频改进只作原记录,本轮没有冒用那些数据;本次没有推送、GitHub 发布、重新打包或关机,原测试包不代表已包含本轮修复。

十一、如何复现这套验收流程

仓库中保留了完整的四个脚本,可在 Windows + Visual Studio 2022 BuildTools + Ninja 环境下按顺序复用(脚本内的 BASE、TASK、CACHE、DONOR 等常量需按本机目录调整,这属于环境适配而非仓库修改):

py -3.11 -I scripts/acceptance/merge-claude-fixes-build.py
py -3.11 scripts/acceptance/merge-claude-fixes-configure.py
py -3.11 -I scripts/acceptance/merge-claude-fixes-test.py chain timing hdr lifecycle video rollback presenter inactive inactive-node sr slider menu components vfg-gpu half-rate capture-color audio audio-jitter audio-startup-seek audio-underrate audio-stall audio-stall-direct audio-rate seek-stress file-endpoint contracts
py -3.11 -B scripts/acceptance/merge-claude-fixes-gui.py pixels
py -3.11 -B scripts/acceptance/merge-claude-fixes-gui.py performance
py -3.11 -B scripts/acceptance/merge-claude-fixes-gui.py performance-reverse
py -3.11 -B scripts/acceptance/merge-claude-fixes-gui.py watchdog

几个容易踩的坑,脚本本身已经给出答案:

  • -I 与 -B 不能混用:构建/测试脚本用 -I 保证隔离;GUI 脚本依赖用户站点的 psutil/numpy/Pillow,只能用 -B(不写 __pycache__)。
  • 不要在 GUI 用例运行时开播放器:no_player() 会断言不存在 veyra*、fg-presentation*、flash-pixel* 进程。
  • GPU 用例必须串行:不叠加竞争负载,每进程 ≤ 300 秒。
  • donor 包必须逐文件 SHA 校验:verify() 在开头和结尾各跑一次,结尾还要求文件数不变(donorUnchanged)。

如果只想快速验证整合是否破坏了既有能力,最小集是:build → configure → test 的 chain timing hdr lifecycle 四项 → gui pixels。看门狗注入与性能守卫属于"验证机制与等价性"的补充证据,可以在功能回归通过后再跑。

十二、这套方法可以带走的三条经验

  1. 合并语义比合并动作更重要。 --no-ff 保证撤回项随分支保留;源码零冲突之后仍然要人工复查共同接点,本次正是靠这一步抓到了 hangPreviousStatus_ 的逆序析构竞态。
  2. "没 clean 重编"必须自证。 变更集 + 头文件传递闭包 + 对象级命令行/源码/依赖三重哈希 + 静态库成员展开,再加上 MIDL/MOC/RCC/DXC/RC 的显式重跑,才能让"复用旧对象"变成可审计的结论,而不是运气。
  3. 把边界写进验收产物。 8 秒报告不等于根因已复现,Present→vblank 不等于光学延迟,短测通过不等于性能等价,原测试包不等于包含本轮修复。这些限定语与数字一起存档,才是可被后续 Agent 和 LLM 正确引用的技术事实。

相关实现与验收入口可继续参考:EngineWatchdog.h、EngineController.cpp、ContentDedup.h、CaptureHalfRate.h、WasapiAudioSink.h、ElgatoHdrControl.h、PresentationHooks.h,以及 验收脚本目录。

登录后查看全文
Veyra-NRVideo