Veyra-NRVideo 补帧接近刷新率间歇掉帧诊断:从 60 Hz 节奏根因到队列规则与最终撤销

原创2026-11-15 22:59:421,960 阅读
文章标签:音视频视频处理图像处理桌面应用直播

Veyra-NRVideo 补帧接近刷新率间歇掉帧诊断:从 60 Hz 节奏根因到队列规则与最终撤销

本文以仓库内的执行记录 docs/FG_60HZ_PACING_2026-10-31.md 为主线,拆解 Veyra-NRVideo 在实时采集补帧(FG)场景下「采集 29.972 fps、2X 输出 59.944 fps、屏幕 60.005 Hz」时的间歇性掉帧问题:它如何被定位为时钟拍频、旧垂直同步/自动模式规则,以及 VFG 高档成本膨胀三条独立故障,随后又如何在 2026-11-01 因延迟代价被整体撤销,并改由平滑呈现锚点与 VFG 自动调控承接。读完后你能够读懂该类现场日志、复现对照实验、判断某个掉帧属于哪一类根因,并理解当前源码中为何保留的是另一套规则。

重要前提:该文档开头即声明「2026-11-01:本文的队列、长等待和放宽预算已被撤销」,用户不接受延迟增长。因此本文同时承担两个角色:完整继承 10-31 的诊断与实测证据,并说明现行代码实际执行的规则是什么。文中所有数字均来自该文档的实测/模型表格,原文标注的「更正」值照实保留,请勿把已撤销方案的数字当作现行行为。

一、现场条件与故障现象

文档记录的现场环境非常具体,这是判断问题是否可复用的前提:

  • 显卡:RTX 5060 Ti;采集:4K30 USB 采集卡;显示:60 Hz HDR 屏幕;软件版本:2.1.1。
  • 用户提供现场日志 veyra-qml(69).log,诊断报告位于作者本机私有证据目录(不在本仓库内)。
  • 分支 claude/fg-60hz-pacing-20261031,基于提交 c6c28b9;文档写作时该改动后续已被合入本地 main,但未 push、未 Release。

现象是:补帧输出速率几乎正好等于屏幕刷新率时,画面每隔一段时间出现成串的掉帧,而不是稳定的低帧率。这类「周期性一阵」的观感,本身就是拍频(beat)的典型特征,也是后续三条根因能够被区分开的关键线索。

二、诊断结论:三条互相独立的原因

文档给出的诊断分三块,其中前两块是同一个时间尺度上的两种表现,第三块是 VFG 特有的成本问题。

2.1 时钟拍频:每 16.5 秒差一帧

采集实际速率 29.972 fps,2X 后输出 59.944 fps,而屏幕是 60.005 Hz。两个速率并不相等,差值折算下来每 16.5 秒就会多出一帧的输出机会,于是输出相对刷新边界缓慢漂移,形成 16.5 秒周期的拍频。

更麻烦的是相位锚定方式:每一对帧按 USB 回调到达时刻锚定,回调时刻的标准差约 2.6 ms,而设备 PTS 本身稳定到微秒级。这意味着画面内容与呈现相位之间被注入了一个抖动源。在拍频周期末端的 3–4 秒里,帧就贴着刷新边界来回落,随机落错一侧。

源码里的这段历史注释把这个场景写得很清楚(见 include/veyra/engine/LivePresentationTiming.h):回调抖动在 2026-10-31 的现场日志里是标准差 1.9–2.6 ms,而设备 PTS 稳定到微秒、与主机时钟相差 800 ppm;按回调自身锚定时,一对帧把抖动带到面板,真实帧与下一张生成帧会落在同一个刷新上,其中一个被替换——在 59.94 fps 对 60.005 Hz 的组合下,这涉及约 3.5% 的帧,且几乎都是真实帧。

2.2 v2.0.8 在 320 Hz 上调出来的两条规则

文档指出,v2.0.8 有两条规则是在 320 Hz 高刷显示器上调参得到的,放到 60 Hz 附近就变成丢帧来源:

  1. 垂直同步下生成帧最多等 2 ms:在 320 Hz 上(刷新间隔约 3.1 ms)2 ms 已接近半个刷新,是合理的保守上限;但 60 Hz 下刷新间隔 16.7 ms,2 ms 的窗口几乎必然错过边界,于是直译成「提前丢弃」。
  2. 自动模式 Present(0,0) 下,同一刷新内的新帧替换未显示的旧帧:这种替换对呈现计数不可见,DXGI 计数器仍然显示 60。这就是为什么用户看到「显示 60 fps」但画面确实在掉帧。

这一点在呈现层的实现里有直接对应:PresentSink 用 DXGI 帧统计差分判断「未被扫描输出的提交」(见 include/veyra/gfx/PresentSink.h 与 src/gfx/PresentSink.cpp)。注释明确写道:一次刷新只显示一张新提交,两次被显示帧之间超出刷新的提交数即为「被替换」数量;在 Present(0,0) 下它们会被丢弃,而其它计数器仍读满速率——注释直接标注了「field log 2026-10-31」。对应字段即 replacedAtLeast,它是被替换帧的下限而非精确丢帧数。

2.3 VFG 高档在跳帧后成本膨胀,引发 76 秒的 30 fps

第三条与刷新率无直接关系,但决定了修正方案里为什么需要一项「成本预热」规则:

  • VFG 高档连续运行时每对约 23.1–23.6 ms。
  • 一旦发生跳帧,单次补帧会升到 28.5 ms(窗口)甚至 39.6 ms(全屏)。
  • 而准入预算只允许约 25.9 ms。

结果是「探测超预算 → 拒绝 2 秒 → 再次探测仍超预算」的循环,日志里连续 30 fps 最长 76 秒,只有改设置才能恢复。这段描述后来被完整搬进源码注释,见 include/veyra/engine/FgRecoveryBudget.h,其中还写明了现场条件(RTX 5060 Ti、4K30、VFG 高档)与「一次孤立探测超预算就拒绝下一对 2 秒」的机制。

三、10-31 方案的规则表(完整继承)

文档给出的改动是一张四项规则 + 一项诊断的表格,下表照实继承,并对每项补充其源码命名:

项 规则 适用范围
垂直同步等待 生成帧等到下一帧到期前 0.5 ms 才放弃(liveGeneratedCapacityExpired) 实时、图内补帧、输出 ≤ 刷新率×1.02。超过时仍是最多 2 ms,DLSS 6X 高刷不变
自动模式 输出在刷新率的 0.65–1.02 倍时改走一帧深度垂直同步队列(automaticQueueWanted),状态显示「显示同步:自动(补帧接近刷新率)」。决定需保持 1.5 秒才切换(首次立即) 同上;可变刷新已是该路径。XeSS 自行呈现,不变
迟到容忍 接近刷新率时生成帧可晚到下一帧到期前 0.5 ms(60 Hz 2X:16.2 ms,原 10 ms),准入预算用同一数字 只在输出间隔大于 10.5 ms 时有差别,即约 95 Hz 以下屏幕
VFG 成本 跳帧后前 2 次补帧不计入成本估计(FgCostSettling) 只限实时 VFG。DLSS 重新播种本来就不计入,文件播放不变
诊断 [fg-near-refresh]、[fg-drops](截止/容量/上限三类丢帧累计)、[display-latency] replacedAtLeast(被替换帧的下限)、[pacing] automaticQueue 只写日志

配套的对照开关是 VEYRA_TEST_LEGACY_NEAR_REFRESH=1,用于一次性恢复全部旧规则做 A/B。文档还明确记录:方案第 4 项(用设备时间戳平滑到达时刻)当时未做——而这一项后来正是 11-01 返工的核心。

「输出 ≤ 刷新率×1.02」这个 1.02 的容差并非临时数字,它作为共享常量存在于补帧倍率建议逻辑中:kDisplayFgFitTolerance = 1.02、以及「源已占满面板」阈值 kDisplayFgFillRatio = 0.97,见 include/veyra/engine/DisplayFgBudget.h。该文件同时说明:面板一次刷新最多显示一张新画面,超出该速率的生成画面在自动模式会被替换、在垂直同步下会等待或被丢弃。

四、每条规则的源码落点

4.1 垂直同步容量等待:从固定 2 ms 到跟随间隔

当时该规则被命名为 liveGeneratedCapacityExpired。当前源码里同一位置是一段带注释的容量等待逻辑(见 src/engine/EngineController.cpp):

  • 显式垂直同步下,每次 Present 只占用一档显示队列容量,因此帧不会积压在 DXGI 队列里。
  • 生成帧最多等待其自身输出间隔的一半;否则它会被下一张替代。
  • 注释保留了对照实测:「等待更久只是把队列搬进本调度器,并让真实帧排在它后面(DLSS 6X 回放在 320 Hz 上:回调→呈现 P95 由 18.4 ms 升到 34.2 ms)」。

这段注释正是对 10-31 方案的否定结论,也与第三节表格中「超过时仍是最多 2 ms」的历史描述形成对照:现行上限由 liveSmoothedCapacityWaitMs 给出。该函数定义在 include/veyra/engine/LivePresentationTiming.h:

base = clamp(2 - (输出间隔ms - 5) / 12, 1.0, 2.0)
间隔 < 12.5 ms        → base(不看抖动)
间隔 >= 12.5 ms       → clamp(1 + 3.125 × 回调抖动ms, base, 3.0)

也就是说:60 Hz 2X(输出间隔约 16.7 ms)基础等待约 1 ms,120 Hz 2X(8.33 ms)落在 1.5–2 ms 之间,320 Hz(约 3.1 ms)仍是 2 ms;只有当输出不高于 80 fps 时才引入抖动项,上限 3 ms。单元测试对这条曲线逐点断言,见 tests/unit/LivePresentationTimingTests.cpp。这条 3 ms 上限是 2026-11-02 由用户在方案对比中选定的,记录在 docs/VSYNC_JITTER_WAIT_2026-11-02.md。

4.2 自动模式的一帧队列:稳定阈值 1.5 秒

10-31 方案在 0.65–1.02 倍区间把自动模式切换成一帧深度的垂直同步队列,并要求「决定需保持 1.5 秒才切换(首次立即)」。这种「带保持时间的状态门控」在本仓库是一个可复用的模式:DisplayFgBudgetGate 用 hold100ns = 15000000(1.5 秒)实现同样的防抖语义,候选值变化即重新计时,首个决定立即生效,见 include/veyra/engine/DisplayFgBudget.h。从源码结构看,这属于同一套「避免状态在边界附近抖动」的设计取向。

需要强调:automaticQueueWanted 与 <a href="https://link.gitcode.com/i/0e2488719eef3953a03af3decf011702" target="_blank">pacing] automaticQueue 当前已不在源码中(在 src、include 内检索不到),它们随 11-01 返工被整条移除。显示同步模式本身仍是三态枚举 DisplaySync { Tearing, Vsync, Automatic },见 [include/veyra/engine/PresentationSettings.h。

4.3 迟到容忍:10 ms 语义的由来

10-31 方案把接近刷新率时的迟到容忍从 10 ms 放宽到 16.2 ms(60 Hz 2X),并与准入预算共用同一数字。现行规则回到 10 ms 基准,并补上一个「迟到回调不得让更多帧过期」的修正:liveGeneratedGrace100ns(callback, anchor) = 10 ms + max(0, callback - anchor),见 include/veyra/engine/LivePresentationTiming.h。测试对三种情形做了断言:回调准时或偏早仍是 10 ms;回调晚 30 ms 时,该帧按回调锚点给出的时刻过期(见 tests/unit/LivePresentationTimingTests.cpp)。

4.4 VFG 成本预热:FgCostSettling 的真实实现

这条规则在源码中完整保留并演进,是本文最适合「以文档为骨架、以代码为血肉」展开的一处。FgCostSettling 定义在 include/veyra/engine/FgRecoveryBudget.h,其行为可直接对应文档中「跳帧后前 2 次补帧不计入成本估计」:

  • kEvaluations = 2:空闲(kIdle100ns = 10 s)之后的前 2 次评估标记为预热样本,返回 true,调用方不把它们计入成本估计。
  • kProbeGroups = 4:探测窗口共 4 组,跑满后清零失败计数。
  • kRetry100ns = 20 s 起始,每次探测失败把重试间隔翻倍,kMaxDoublings = 2,即 2 s → 4 s → 每 8 s 重试。文档里「每 2 秒探测从 1–2 组变为 3 组」以及「失败探测隔 2、4、8 秒重试」都落在这两个常量上。
  • holding(now):探测失败后的保持期,配合 LiveFgRejectionHold 使用。

只跳一对不会改变任何东西:注释写明「One skipped pair changes nothing」。一个真正跑不动的模式会在这 2 次预热之后的整组被拒绝,因此一次探测的代价是 3 组而不是 1 组。

单元测试对这条状态机有明确回放,见 tests/unit/LiveGpuSchedulerTests.cpp:连续评估、空闲打断、跳帧触发保持、探测组计数、以及设置变更 reset() 清空全部状态。另一处断言要求 LiveFgRejectionHold::kResumePairs > kEvaluations + kProbeGroups(见同文件 L309-L313),即「恢复补帧相位所需的连续准入对数必须多于一次探测的评估组数」——否则每次预算探测都会立刻结束保持期,形成文档中描述的「每 3–4 秒回到 30 fps」的抖动。

4.5 诊断日志:现在的字段

<a href="https://link.gitcode.com/i/64999d9e2553740ac0e41dc193cde454" target="_blank">fg-drops] 仍然存在,但字段更精简,见 [src/engine/EngineController.cpp:

[fg-drops] revision=… deadline=… capacity=… cap=… graceMs=… 
(session totals of frames dropped before Present, by reason)

三类计数分别对应三种丢弃路径:

  • deadline:生成帧在呈现前已过期(PreviewFrameReadiness::Expired,同段代码即 ++generatedDropDeadline)。
  • capacity:垂直同步容量等待超时(++generatedDropCapacity,见 src/engine/EngineController.cpp)。
  • cap:输出上限(自定义帧率)判定该候选已陈旧而跳过(++generatedDropCap)。

同一处还会打印 [fg-deadline],给出 expired、readyObservedLateMs、decisionLateMs,并明确标注「CPU fence observations, not scanout」——这是本仓库一贯的测量口径约束:提交侧计数不能冒充屏幕端实际显示。

<a href="https://link.gitcode.com/i/a7f7802f2b8eb01e7a701b321665eb19" target="_blank">display-latency] 的现行字段在 [src/engine/VideoPresenter.cpp 一行内可读全:presentToScanoutP50Ms/P95Ms/MaxMs、samples、replacedAtLeast、compositionMode、refreshHz,并注明这是「DXGI frame statistics:Present 调用到显示它的 vblank」,不是光子测量。<a href="https://link.gitcode.com/i/e0ed14e5ce25971c577b4e63459199cc" target="_blank">live-anchor] 则把 callbackJitterMs、clockDriftPpm、snaps、phaseMs、capacityWaitMs 一起输出(见 [src/engine/EngineController.cpp),这是 11-01 之后新增的可观测点。

五、代价:10-31 方案为什么被撤销

文档「代价」一节是撤销决策的直接依据,完整保留如下:

  • 自动模式在接近刷新率时不再「永不等待」。320 Hz 实测捕获到呈现 P50 差 ≤0.3 ms,P95 为 0 至 +1.8 ms。60 Hz 模型里真实帧最多多等 8–13 ms,P99 为 2–6.7 ms。
    • 原文随后做了更正:该模型把「刚好落在刷新边界的呈现」算早了一个刷新,数字偏低。修正后:比值 0.999 时 P95 3.5、P99 5.7、最多 10.2 ms;比值 1.001 时 P50 4.4、P95 12.6、P99 14.5、最多 16.2 ms。
  • 60 Hz 2X 的 VFG 成本上限约从 25.9 ms 放宽到 32.1 ms。成本落在这段时以前退回 30 fps,现在保持 60 fps,真实帧最多晚一次刷新。
  • 真的跑不动的模式,每 2 秒探测从 1–2 组变为 3 组(回放:600 对中评估 30 对,2 秒内最多 3 对)。

把这三条放在一起看,方案的本质是「用真实帧的等待换生成帧的不丢」。这与用户在 11-01 提出的约束(「保持好低延迟,延迟增长是我不能接受的」)直接冲突,因此整条路径被撤回。

六、验证:320 Hz 上证明机制,60 Hz 只来自模型

文档的验证分为自动模式、垂直同步、边界与回放四组。条件是本机 RTX 5070、320 Hz 窗口模式、DLSS 6X,每组 12 秒 ×2,新旧规则交替,无其他占用。文档特别说明:旧版「实际显示数」只能给范围——下限是 samples(自动模式只记录轮询时刚好看到的帧),上限是呈现数减 replacedAtLeast。

自动模式:

自动模式 比值 旧:呈现/秒 旧:实际显示/秒 新:呈现/秒 新:被替换/秒 容量丢帧(12 秒) 捕获→呈现 P50/P95 ms(旧→新)
回放 53.2×6 0.9975 319.2 284–308 318.2–319.0 0 4–13 不适用
窗口 52.2×6 0.97 311 264–293 306.6–308 0 51–61 19.2→19.4–19.5 / 20.3–20.4→20.3–20.4
窗口 39.6×6 0.74 237.7 205–231 236.6–236.8 0 15–16 25.4–25.5→25.6 / 26.3–26.4→26.2–26.3

文档附注:同一窗口场景较早一轮的 P95 是 20.7–20.8→22.5–22.6(P50 19.8→19.7),所以代价写成 0 至 +1.8 ms。

垂直同步:

垂直同步 比值 容量丢帧(12 秒,旧→新) 呈现/秒(旧→新) 捕获→呈现 P95(旧→新)
回放 53.2×6 0.9975 78–101→18–22 311–314→318 不适用
窗口 52.4×6 0.98 95–105→69–76 305–306→307–308 21.4–22.3→22.5
窗口 53.7×6(输出略高于刷新) 1.006 72–103→75–80 315–316→316 20.4–20.8→22.3

边界与回放结论:

  • 高于刷新率(回放 60×6=360/s)规则不生效:自动 360/s、实际显示下限 304–306 两边相同;垂直同步容量丢帧 505–533→491–501,属波动。
  • 旧自动模式实测丢帧随比值变化:0.38/0.51 无,0.56/0.65 最多约 2%(只有 samples,可能偏高),0.74–1.0 至少 3–6%。0.65 以下未处理。
  • 模拟 60 Hz(VEYRA_TEST_DISPLAY_HZ=60,实际屏幕仍 320 Hz,只验证状态切换):VFG 30×2 进入队列模式、容忍 16.2 ms、状态文字正确,60/s 无丢帧。
  • 60 Hz 模型(29.972×2 对 60.005 Hz,占所有帧):自动 3.19%→0,垂直同步 1.09%→0;生成帧迟到时 19.07%/0.55%→0。原文更正:旧垂直同步应为 1.50%,生成帧迟到时 1.49%。
  • 单元回放:垂直同步 6000 对丢 153→0,真实帧最大等待 2.17→8.17 ms(原文更正:该回放有同样的边界错误,已随规则删除,数字不可用);VFG 陷阱 600 对评估 10→600(窗口与全屏探测成本都恢复)。
  • 卡顿恢复:真实 GPU screen-vfg 新旧规则、screen-dlss 新规则,3 轮 80 ms 卡顿后都恢复。
  • 回归:repair contract、live timing、scheduler、realtime、i18n 全部 0 失败;QtQuick 123/0/1 跳过;9 个原生 GPU 场景(含 DLSS 6X、VFG、FSR、XeSS、生命周期)通过;翻译 2714 条无缺失;UI 启动无 QML 错误。

VEYRA_TEST_DISPLAY_HZ 在源码中仍然存在,作用是替换预算使用的刷新率,见 src/engine/EngineController.cpp。这解释了一个常被误读的点:在 320 Hz 屏上设成 60,只能验证「状态机是否进入该分支、日志与提示文字是否正确」,不能验证 60 Hz 面板上的真实扫描输出行为。

七、未验证边界:这份文档最值得引用的一段

文档把不确定性写得很明确,这部分对任何想复用结论的人都是硬约束:

  • 没有在真实 60 Hz 屏幕、采集卡或 RTX 5060 Ti 上跑过。 320 Hz 结果证明机制,60 Hz 的数字只来自模型,需要现场确认。
  • VFG 陷阱本机无法复现(本机显卡常驻 P0,跳帧后成本不升高),只有日志数字回放。跳帧后高成本的原因(疑似显卡降频)未证实;日志证据只显示窗口下第二次已接近稳态,全屏没有直接证据。若全屏下第三次仍超预算,这部分仍可能退回 30 fps。
  • 第 4 项(平滑到达时刻)和 XeSS 未动,日志里 XeSS 段太短。0.65 以下、无补帧、文件播放都未改。

对读者的实际意义:10-31 的表格是「机制可行性证据」,不是「现场已修好」的证明。仓库中的 docs/CURRENT_STATUS.md 也把「真实采集卡、RTX 5060 Ti 上的补帧修复」列入未实卡验证项。

八、现场如何判读日志

文档给出的判读清单可以直接作为排查脚本使用。用新版复现同样设置(4K30、2X、60 Hz),日志应出现:

  • [fg-near-refresh] near=true outputFps=60.000 refreshHz=60.000,[pacing] ... automaticQueue=true(选自动时)。
  • [display-latency] replacedAtLeast=0,[fg-drops] 的 capacity 基本不再增长,不再每 16.5 秒一串。
  • [live-fg-admission] 不再长时间 admitted=false;全屏切换后约 2 秒内恢复。

对照方法:同机设 VEYRA_TEST_LEGACY_NEAR_REFRESH=1 再跑一次。

但必须注意时代差异。 当前源码中:

  • <a href="https://link.gitcode.com/i/334306c6c24208ca320e7e818ce4b50c" target="_blank">fg-near-refresh]、[pacing] automaticQueue 与 VEYRA_TEST_LEGACY_NEAR_REFRESH 均已随 11-01 返工移除(仅在文档与 [AGENTS.md 的历史段中出现)。
  • 现行的同类对照开关是 VEYRA_TEST_LEGACY_LIVE_PACING=1,用于恢复 10-31 之前的规则,见 src/engine/EngineController.cpp 与 src/engine/EngineController.cpp。
  • <a href="https://link.gitcode.com/i/cb9a186770045b2b8e27543ea9789ac9" target="_blank">fg-drops]、[display-latency]、[live-fg-admission] 仍在使用;[live-fg-admission] 的字段在 [src/engine/EngineController.cpp 一行内可读:timeline、multiplier、admitted、admittedPairs、rejectedPairs、remainingDeadlineMs、queuedGpuMs、predictedMs、elapsedMs、blitGpuP95Ms、warmingHistory。

换句话说:按本文第八节的清单排查历史版本仍然有效;在现行构建上,应把 automaticQueue 一项替换为 [live-anchor] 里的 callbackJitterMs/capacityWaitMs 与 [vfg-fast] 的模型切换计数。

九、复现素材与重跑方式

文档记录的重跑信息如下(脚本与素材位于作者本机的报告目录,不在本仓库内,此处只保留可移植的命令与入口描述):

生成 53.2 fps 的回放素材:

ffmpeg -f lavfi -i "testsrc2=size=1920x1080:rate=53.2:duration=40" \
  -c:v libx264 -preset veryfast -crf 23 -pix_fmt yuv420p near-53p2.mp4

60 fps 素材把 rate 改为 60。

手动入口是作者私有配置下的一个 .cmd 启动脚本,运行目录沿用既定测试目录。文档同时注明:回放素材已清理,但可按上面的命令重新生成。

需要提醒的是,10-31 的对照组(VEYRA_TEST_LEGACY_NEAR_REFRESH=1)在当前构建上已无法使用。若要做同机 A/B,应使用现行的 VEYRA_TEST_LEGACY_LIVE_PACING=1,并配合 docs/FG_NO_LATENCY_GROWTH_2026-11-01.md 记录的环境变量(VEYRA_TEST_REPLAY_AS_CARD、VEYRA_TEST_ARRIVAL_JITTER_MS、VEYRA_TEST_ADAPTIVE_SCREEN_PHASE、VEYRA_TEST_VFG_DELAY_MS)。其中后两者的实现可在源码确认:抖动注入被限制在 0–10 ms,见 src/engine/EngineController.cpp;VFG 人为延迟被限制在 0–40 ms 且只作用于该工作线程,见 src/pipeline/VfgBackend.cpp。

十、撤销之后:现行设计为什么不需要队列

11-01 的返工记录把「撤掉的」与「现在的规则」并列,构成理解现行代码的关键。

被撤掉的四项(均可在现行源码中确认已不存在):自动模式的一帧队列(automaticQueueWanted、状态文字与提示)、垂直同步下生成帧等到下一帧到期(liveGeneratedCapacityExpired)、迟到容忍与 VFG 预算放宽到 16.2 ms(liveGeneratedGrace100ns/graceMs)、以及 displayFgOutputFits/Near、kDisplayFgNearRatio、[fg-near-refresh]。

替代方案的核心是换锚点而不是加等待:

  • 呈现锚点改为「源 PTS + 跟踪的偏移」,用二阶滤波吸收回调抖动,时钟差无滞后,再提前 0.5 ms。单个离群回调不动基线,同侧连续两个才跟过去。实现即 LiveArrivalSmoother(include/veyra/engine/LivePresentationTiming.h):kGain = 0.1、kDriftGain = kGain²/4、kLead100ns = 5000,超出阈值取 min(interval/3, 8 ms)。
  • 单元测试用现场参数(29.972 fps、回调标准差 1.87 ms、PTS 偏 800 ppm,双向)验证两点:锚点保持在回调均值上(不增加延迟),且其离散度不到回调抖动的一半(tests/unit/LivePresentationTimingTests.cpp)。测试注释直接标注了「Field log 2026-10-31」。
  • VFG 走「自动调控」:当这一对的生成帧会与真实帧抢同一个刷新(liveFramesShareRefresh)或预算不够时,改用下一档更快的模型(高→中,中→低)。判定函数见 include/veyra/engine/LivePresentationTiming.h,其思路是「若生成帧与真实帧落在同一刷新(含 latch 影响),则一个会被另一个替换」。调用点在 src/engine/EngineController.cpp,包含一个细节:若已 40 秒没跑过选定模型,则按「成本低 30% 时是否能赶上」来判断,以便在模型实际变快时能纠正过来;此外还要求当前时刻距最后一个 vblank 不超过 10 ms,否则刷新栅格已过期。
  • 预算被拒时走 FastForBudget,即用更快模型的实测成本重新计算是否能满足期限;准入被拒时不会直接掉到 30 fps。

这套设计的取舍与 10-31 完全相反:不再让真实帧等待,而是接受「高档不一定总是高档」。返工文档记录的代价是慢卡上约三分之二的对会使用中档、显存多约 1.9 GB、软件自报的「回调→呈现」P95 高约 2 ms(属口径差异,从采集时钟线算反而低约 3 ms)。

还有一个容易混淆的细节:LiveFgRejectionHold 在「连续 1 秒全是拒绝」后,会让这些对不再等补帧相位、就绪即显示真实帧;而恢复补帧相位需要连续准入的对数超过一次探测的评估组数(include/veyra/engine/LivePairLatency.h)。这条规则针对的正是 10-31 日志里那类「VFG 高档 3X 在 4K 上 98% 被拒、回调后 38–46 ms 才显示 30 fps」的场景——它属于「不增加延迟」这条约束下的另一种解法,与 10-31 的队列思路互为反面。

十一、与其他工作的关系

文档最后一节说明:屏幕采集固定延迟修复与屏幕捕获帧率修复已一起并入本地 main,联合回归见作者本机报告目录中的 FINAL.json。并且注明一个重要限定:捕获帧率修复后,窗口采集 39.6×6 的旧规则也不再有被替换的帧,所以上面表格的窗口数字只代表合并前。

横向对照,可以在仓库中看到这条问题线的完整演进:

十二、结语:从这份记录里能带走的三件事

  1. 拍频要先算清三个速率。 采集、输出倍率、刷新率三者不等时,问题会以「周期性成串」出现,周期长度等于速率差折算出的时间(本例 16.5 秒)。这类现象不应从补帧算法本身找原因。
  2. 同一条规则在 320 Hz 与 60 Hz 上的含义可能完全相反。 2 ms 的容量等待在高刷上是半个刷新,在 60 Hz 上几乎必然错过边界;Present(0,0) 的替换在高刷上不可见,在接近刷新率时就是真实丢帧。参数必须与刷新间隔一起看。
  3. 「不丢帧」和「不增延迟」是互斥的取舍,必须由使用者选边。 10-31 选了前者,11-01 被要求改回后者,最终落在「换锚点 + 换模型」而不是「加等待」。仓库里保留的 [fg-drops]、[display-latency] replacedAtLeast、[live-anchor]、[vfg-fast] 与 VEYRA_TEST_LEGACY_LIVE_PACING=1,就是这条取舍链留下的可观测面与对照开关。
登录后查看全文
Veyra-NRVideo