Veyra-NRVideo UI 修复 v3 独立只读复核全解析:哈希对齐、11+15 项原生验收与 8.191ms 切换 P95
Veyra-NRVideo UI 修复 v3 独立只读复核全解析:哈希对齐、11+15 项原生验收与 8.191ms 切换 P95
本篇技术指南以 Veyra-NRVideo 的《UI 修复 v3 独立只读复核》报告为主线,系统拆解一次"可审计的 UI 修复验收"是如何被设计的:包括只读复核的边界设定、构建身份(EXE SHA256)如何对齐两份结果、11 条原生专项与 15 条双模式回归各自断言了什么、40 次模式切换 P95 8.191ms 背后的提交连续性证据,以及为什么 build15 的 FAIL 被原样保留、build16 只调整"观察起点"而不改断言。读完后你能掌握一套可复用的桌面 UI(Windows 原生控件 + DWM 材质 + GPU 预览)验收方法论,并能对照源码定位每条证据的落点。
一、复核的定位:只读、不重跑、证据分层
复核报告开篇就把自身的证据等级写死了,这是整篇文档最重要的方法论前提:
- Reviewer 身份为
/root/review_ui_v3,独立上下文、只读; - 主 Agent 负责实现与运行测试,Reviewer 没有修改文件,也没有再次执行 GPU 测试;
- 因此"下列结论来自实际只读审查回复,不能当作第二次独立运行"。
这段限定看起来保守,实际解决了一个常见的验收失真问题:同一份结果的自我复述不是独立验证。在 GPU/图形栈项目里,"再跑一遍"通常意味着重新消耗数百秒、重新依赖驱动状态,因此复核被拆成了三层:
| 证据层 | 产出方 | 可被验证的形式 |
|---|---|---|
| 实现与测试执行 | 主 Agent | logs/ 下的 result.json、应用日志、截图 |
| 只读一致性审查 | Reviewer | 哈希对齐、断言与实际日志比对、源码路径核对 |
| 范围外补充证据 | 主 Agent(复核之后) | Repair 18 项、原生 4K 当前合同 23 项、最终原生截图 |
第三层特别值得注意:报告明确写了"Reviewer 最终回复之后,主 Agent 又完成 Repair18 项、原生4K当前合同23项与最终原生截图;这三项是主Agent补充证据,不谎称Reviewer另行执行或复查"。这种"谁产出谁署名"的分层,比笼统说"已验证"更有工程价值——读者可以准确判断某条结论的强度。
原始复核记录见 复核记录,完整命令、失败记录与限制见其上游的 交付报告。
二、最终结论与验收矩阵
复核给出的结论是一句边界极清晰的判定:本轮限定修复审查通过,未发现未关闭的 P0/P1/P2。
支撑该结论的量化证据可以整理为一张矩阵:
| 维度 | 证据 | 数值 |
|---|---|---|
| 构建身份 | build16 与两组结果的 EXE 哈希一致 | B1892C51E8AFC27D7223E271D48D93107C34CAA96BC4014DFF6F45FDE0D7BF74 |
| 原生专项 | 11 条命令全部通过 | 81.001 秒 |
| UI 全套 | 15 条命令全部通过 | 141.187 秒 |
| 模式切换 | 40 次切换 P95 | 8.191ms(最大 9.963ms) |
| 提交连续性 | 播放切换期间实际提交次数 | 442 次 |
| 图元/句柄 | GDI 与 handles 变化 | GDI 12→12、handles 721→721 |
| 内存 | PrivateBytes 变化 | 1729171456 → 1729171456 |
这张矩阵的设计要点是跨维度交叉:既有"跑没跑过"(条数与耗时),也有"跑的是不是同一个二进制"(哈希),还有"跑的时候系统有没有退化"(GDI/句柄/内存)。只报 PASS 数量而不锁二进制,是验收里最常见的漏洞。
三、构建身份锚定:为什么哈希比"重跑一次"更重要
复核的第一条实质动作不是看功能,而是核对 build16 与两组结果的 EXE 哈希一致。原因很直接:原生控件 + DWM 材质的修复极其依赖"最后一次链接的是哪份产物"。交付报告中记录过这类事故:
build1/2、build9 曾因旧 Veyra 占用 EXE 导致链接失败;正常结束空闲预览后重新构建成功。
一旦出现"构建没换掉但测试跑起来了"的情况,所有 PASS 都会失去意义。因此验收入口在写 result.json 时会显式把 EXE 哈希落盘,例如 ui-repair-v3.ps1 的收尾段:
[ordered]@{passed=$passed;seconds=$timer.Elapsed.TotalSeconds;
limitSeconds=$MaxRuntimeSeconds;
exeSha256=(Get-FileHash (Join-Path $bin 'veyra.exe')).Hash;
checks=$checks;failure=$failure} | ConvertTo-Json -Depth 8 |
Set-Content (Join-Path $dir 'result.json')
同一模式也出现在 ui-dual-mode.ps1 中,它除了 exeSha256,还会把 limits 一并写入:
limits = @('software short tests only',
'capture hardware reserved for user',
'physical scanout/photon latency unmeasured')
这一点正是复核报告"结论限于本轮 UI、材质、开关、草稿和 SR 修复"的机器可读版本——限制条件由脚本自动落盘,而不是依赖事后回忆。
四、原生专项 11 条:真正点下去的原生控件
复核报告提到"原生专项11条命令通过,81.001秒",并强调它"不是仅编译"。对应的脚本 ui-repair-v3.ps1 组织了一次完整的取证链,关键在 Run 函数同时重定向 stdout/stderr,并为每个用例单独设置 VEYRA_LOG_FILE:
$env:VEYRA_LOG_FILE = Join-Path $dir ($name+'.app.log')
$p = Start-Process -FilePath $exe -ArgumentList $arguments `
-WorkingDirectory $Root -WindowStyle Hidden -PassThru `
-RedirectStandardOutput (Join-Path $dir ($name+'.stdout.log')) `
-RedirectStandardError (Join-Path $dir ($name+'.stderr.log'))
主用例的启动参数是这样的(三条:image、video、reject):
Run $case (Join-Path $bin 'veyra.exe') (
'--smoke-seconds 25 --nr --no-sr --no-fg ' + $flag +
' --smoke-save "' + (Join-Path $dir ($case+'-sr.png')) + '" "' + $input + '"')
其中 $flag 在 reject 用例切换为 --smoke-repair-ui-reject,其余为 --smoke-repair-ui。断言不是"退出码 0 就算通过",而是解析应用日志:
if($log -match '\[ui-repair-test\].*=false' -or $log -notmatch '\[ui-repair-test\]'){
throw "$case native click evidence missing or failed" }
if($case -ne 'reject'){
if($log -notmatch 'PASS native controls' -or $log -notmatch 'output=2880x2160'){
throw "$case incomplete" } }
这里有两个质量细节值得单独指出:
- 拒绝"空日志通过":
-notmatch '\[ui-repair-test\]'让"根本没执行到检查"的构建无法蒙混过关; - 保存尺寸用外部工具二次确认:保存后的 PNG 会交给
ffprobe读流信息,必须严格等于2880x2160,而不是相信自己打印的数字。
而 reject 用例之所以不校验 PASS/output=,是因为它走的是失败回滚分支,断言目标是另一组字段(见下一节)。
4.1 检查器本体:11 个步骤的有限状态机
真正"点按钮"的代码在 UiRepairChecks.h,它是一段只在 --smoke-repair-ui 下启用的原生集成检查,用 repairStep 做状态机推进。文件头注释直接点明了方法:BM_CLICK 故意穿越与真实 UI 输入相同的 child/control/parent 处理器。
// Native integration checks, run only with --smoke-repair-ui[-reject].
// BM_CLICK deliberately traverses the same child/control/parent handlers as UI input.
bool smokeRepair=false, smokeRepairReject=false;
int repairStep=0;
ULONGLONG repairTick=0, repairSettledTick=0;
uint64_t repairRevision=0;
每一步都通过 require() 把布尔断言写进日志,一旦为 false 就立即把 repairStep 置为 -1 终止:
auto require=&{
log::info("ui-repair-test",std::format("{}={}",message,ok));
if(!ok)repairStep=-1; return ok; };
这也解释了脚本为何能用 \[ui-repair-test\].*=false 一条正则捕捉所有失败。步骤覆盖的核心场景(按 switch(repairStep) 归纳):
| 步骤 | 场景 | 断言要点 |
|---|---|---|
| 0 | 输入非法草稿 NaN 后点击 NR 开关 |
NR_off_click_works_with_invalid_draft |
| 1 | 失败注入路径 / 正常路径分叉 | rejected_NR_checkbox_rollback_keeps_draft |
| 2 | NR 开启 | NR_on_click_works_with_invalid_draft |
| 3 | SR 开启并按比例规划尺寸 | SR_click_applies_aspect_preserving_output |
| 3 | 总增强事务进行中提交数值 | master_pending_blocks_overlapping_numeric_submit |
| 4 | 关闭总增强 | master_off_syncs_independent_switches |
| 5 | 单项开启带动总增强 | NR_click_enables_master_and_preserves_draft |
| 5 | 滚动参数被独立父窗口裁剪 | scroll_controls_clipped_by_separate_viewport |
| 6 | 全屏铺满显示器 | fullscreen_covers_monitor_and_diagnostics_keeps_seek |
| 7 | 日常模式 13 个控件可见且不越界 | daily_action_has_visible_contained_slot |
| 7 | 命中区互不重叠 | daily_action_hitboxes_do_not_overlap |
| 8 | 总增强旁路后 SR 显示"有效关闭" | daily_SR_shows_effective_off_after_master_bypass |
| 9 | 日常点 SR 恢复总增强 | daily_SR_click_restores_master_and_syncs_professional_without_submitting_draft |
第 3 步的 SR 尺寸断言不是"硬编码 2880×2160",而是从规划器现算期望值再比对:
auto expected = pipeline::ResolutionPlan::make(
s.metrics.resolution.source, true, pipeline::NrSizePolicy::Native, true).output;
if(!require(s.applied.sr && checkControl(201) &&
s.metrics.resolution.output == expected &&
std::wstring(draft)==L"NaN",
"SR_click_applies_aspect_preserving_output")) break;
期望值来自 ResolutionPlan.h 的 make(),其尺寸规则是"塞进目标框、只放大、并保证偶数边长":
const auto enlarge=[](Extent from,Extent box){
const double scale=std::min(double(box.width)/from.width,double(box.height)/from.height);
return scale>1.0
? Extent{std::max(2u,uint32_t(from.width*scale+1e-6)&~1u),
std::max(2u,uint32_t(from.height*scale+1e-6)&~1u)}
: from; };
对 1448×1086(约 4:3)的素材套用 Uhd4K 目标框,等比结果即 2880×2160——这同时解释了交付报告中"4:3 得到 2880×2160"、以及图片保存与视频导出共用同一规则的说法。
五、UI 全套 15 条:切换成本、提交连续性与资源稳定
复核报告记录"UI全套15条命令通过,141.187秒",并给出 40 次切换的 P95 与几个关键不变量。这套入口在 ui-dual-mode.ps1,用 $Case 把场景拆成可单跑的子集:
[ValidateSet('state','switch','pause','master','masterreject',
'audio','export','canceljob','exitjob','all')]
[string]$Case='all'
5.1 阈值不是"越快越好",而是双阈值
if($p95 -gt 16 -or $values[-1] -gt 50){
throw "Mode UI command threshold failed: p95=$p95 max=$($values[-1])" }
同时要求样本数必须精确为 40,且日志里不得出现身份漂移:
if($matches.Count -ne 40 -or $log -match 'hostSame=false|sessionSame=false|revisionSame=false'){
throw 'Mode identity contract failed' }
这两个字段来自 UI 自身的埋点。在 AppShell.cpp 中,模式切换完成后会记录同一行结构化日志:
veyra::log::info("ui-mode",std::format(
"professional={} hostSame={} sessionSame={} revisionSame={} "
"positionBefore={} positionAfter={} commandMs={:.3f}",
uiState.mode==veyra::ui::Mode::Professional, host==video,
before.sessionId==after.sessionId, before.desired.revision==after.desired.revision,
before.position, after.position,
std::chrono::duration<double,std::milli>(std::chrono::steady_clock::now()-start).count()));
也就是说,"切换快"必须与"切换没有重建视频宿主、没有换会话、没有动设置版本、播放位置没跳"同时成立,否则快也无意义。这正是复核报告强调"保留同一个视频宿主、来源和设置版本,延迟中间尺寸的 swapchain 重建"的机器证据。
5.2 build16 的最终三组 P95
| 最终 build16 场景 | 40 次切换 P95 | 最大值 |
|---|---|---|
| 播放 | 8.191ms | 9.963ms |
| 暂停 | 8.633ms | 9.173ms |
| 同时导出 | 8.481ms | 8.506ms |
作为对照,被用户否决的"应用内模拟玻璃"实现曾达到 P95 22.117ms,超过 16ms 门槛并留下 FAIL 记录(f342c983cfe24d83b282daa04719e9a9)。交付报告对此的表述很关键:"该实现已删除,改为系统桌面合成,没有放宽性能阈值。"——阈值不动、实现改造,是这类性能回归唯一可接受的解法。
5.3 442 次提交与"epoch 恒为 1"
复核报告中最容易被误读的一组数字是:
播放切换期间 442 次实际提交,epoch 始终 1、最大提交间隔 18.1116ms,无 Feature 创建、历史 reset 或重开源。
脚本对这段区间的切法很讲究——只截取第一条到最后一条 [ui-mode] 日志之间的行,然后在该区间内做三重否定与两类统计:
if($interval -match 'CreateFeature id=|Create DLSSG|\[source-file\] opened|reset=1'){
throw 'Mode interval recreated feature, source or history' }
$submits=[regex]::Matches($interval,'\[submit\].*epoch=(\d+).*host100ns=(\d+)')
即:切换动画期间不允许重建 Feature、不允许重新打开源文件、不允许历史 reset;同时对提交时间戳求最大间隔(脚本阈值 100ms,实测 18.1116ms)。这与复核报告"无 Feature 创建、历史 reset 或重开源"逐字对应。
报告还特意加了一句限定:"以上指软件提交与 UI 命令耗时,不冒充显示扫描率或完整动画帧率。"这与脚本落盘的 limits 一致,避免把 UI 命令耗时包装成帧率指标。
5.4 GDI 12→12、handles 721→721、PrivateBytes 不变
资源维度同样被复核单独核对:GDI12→12、handles721→721、PrivateBytes1729171456→1729171456。这组数字的价值在于它覆盖的是最容易被玻璃材质实现破坏的地方——每次重绘都创建 DIB/DC/Graphics 或 GDI+ 对象而不释放,会立刻体现为句柄或 GDI 对象增长。因此"释放顺序正确"不是代码风格问题,而是可被计数验证的行为契约(下节展开)。
六、被保留的 FAIL:build15 的观察时序缺陷与 build16 的修正
复核报告里最有说服力的一段,是它没有把一次失败抹掉,而是精确解释了失败原因:
build15
bfc72bf...失败保留:回滚结束仅 34ms 后读取复选框,早于 250ms UI timer。build16 把有界等待起点放在后台回滚完成之后,原断言不变;最终独立字段日志证实 checkbox 先旧值、约 547ms 后正确,draft 一直保留。
对应代码在 UiRepairChecks.h,注释把因果关系写在了现场:
case 1: if(smokeRepairReject){
if(!s.rejectedRevision)return;
// Rollback can rebuild the GPU graph for longer than the click delay.
// Start the bounded UI timer allowance after the backend has settled.
auto observe=[&]{ log::info("ui-repair-observe",std::format(
"rollback appliedNR={} desiredNR={} checkboxNR={} draftPreserved={}",
s.applied.nr, s.desired.nr, checkControl(200), std::wstring(draft)==L"NaN")); };
if(!repairSettledTick){ repairSettledTick=GetTickCount64(); observe(); return; }
if(GetTickCount64()-repairSettledTick<500)return;
observe();
if(require(s.applied.nr && checkControl(200) && std::wstring(draft)==L"NaN",
"rejected_NR_checkbox_rollback_keeps_draft")) repairStep=10;
break; }
这段修复包含三个可复用的测试设计原则:
- 区分"状态未到"与"状态错误":第一次进入分支只记录起始时刻并立即返回,不判定;
- 等待起点后移到后端 settle 之后:
repairSettledTick在s.rejectedRevision已到达后才置位,避免用"点击时刻"给一个可能耗时 1.4 秒的 GPU 图重建计时; - 断言一个字都没改:仍是"回滚后 NR 实际开启、复选框勾选、草稿
NaN保留"。
报告给出的失败日志与成功日志对照,正好证明了"旧失败是观察时序"而非功能缺陷:
appliedNR=true desiredNR=true checkboxNR=false draftPreserved=true ← 先旧值
checkboxNR=true draftPreserved=true ← 约 547ms 后正确
注意 draftPreserved=true 在两次采样中都成立,这是复核报告"日志证实草稿始终保留,复选框随后同步"的直接依据。
七、玻璃材质:A=255 黑底与"不把玻璃画进视频像素"
复核报告用了一句话总结最关键的材质边界:
代码确认视频空闲 A=255 黑色,未发现把玻璃画入视频像素的路径;DIB/DC/GDI+释放顺序正确,诊断父背景已统一。
7.1 A=255 为什么必须显式写
材质实现位于 GlassMaterial.h。文件顶部注释就是结论:
// Explicit premultiplied BGRA is required for DWM glass. Compatible GDI
// bitmaps lose alpha and turn transparent controls into solid rectangles.
class AlphaRaster {
HBITMAP bitmap_=nullptr; HGDIOBJ previous_=nullptr;
public:
HDC dc=nullptr; uint32_t* pixels=nullptr; int width=0,height=0;
create() 使用 biHeight = -height 的自顶向下 32bpp DIB,并把整块像素清零:
info.bmiHeader.biBitCount=32; info.bmiHeader.biCompression=BI_RGB;
dc=CreateCompatibleDC(target);
bitmap_=CreateDIBSection(target,&info,DIB_RGB_COLORS,
reinterpret_cast<void**>(&pixels),nullptr,0);
...
std::fill_n(pixels,size_t(width)*height,0);
而"视频空闲必须是 A=255 的不透明黑"由 opaqueBlack() 用 SourceCopy 一次性覆盖实现——SourceCopy 会替换目标像素(含 alpha),而不是像 SourceOver 那样与既有透明底混合:
inline void opaqueBlack(HDC dc,RECT r){
AlphaGraphics paint(dc); auto& g=paint.get();
g.SetCompositingMode(Gdiplus::CompositingModeSourceCopy);
Gdiplus::SolidBrush black(Gdiplus::Color(255,0,0,0));
g.FillRectangle(&black,Gdiplus::Rect(r.left,r.top,r.right-r.left,r.bottom-r.top)); }
这也是复核那句"未发现把玻璃画入视频像素的路径"的技术含义:玻璃只通过 GlassBackdrop::copy() 在父窗口/卡片区域以 SourceOver 叠加(tint 恒为 36 级透明),全屏时 copy() 直接返回,不再绘制任何 pane:
Gdiplus::SolidBrush base(Gdiplus::Color(active_?26:255,10,13,17));
g.FillRectangle(&base, Gdiplus::Rect(area.left,area.top,area.right-area.left,area.bottom-area.top));
if(full_)return true;
active_ 为假(或全屏)时底色 alpha 为 255,即"退化为纯深色实底",不会出现半透明残影。
7.2 DIB / DC / GDI+ 的释放顺序
AlphaRaster 的析构走 clear(),顺序是"先还原选入对象、再删位图、最后删 DC",并用 previous_ 空指针做二次防护:
void clear(){
if(dc&&previous_)SelectObject(dc,previous_);
if(bitmap_)DeleteObject(bitmap_);
if(dc)DeleteDC(dc);
dc=nullptr; bitmap_=nullptr; previous_=nullptr; pixels=nullptr; }
create() 在 CreateDIBSection 失败或 SelectObject 返回 HGDI_ERROR 时都会调用 clear() 回退,避免半初始化的句柄泄漏——这与复核报告的"释放顺序正确"以及"GDI 12→12、handles 721→721"的实测结果相互印证。
PaintBuffer 则把"内存合成、一次 BitBlt 落地"固定下来,规避擦除/填充闪现:
class PaintBuffer {
HWND window_; HDC target_; AlphaRaster raster_; PAINTSTRUCT ps_{};
bool external_=false;
public:
RECT rect{}; HDC dc;
八、复核发现并修复的三类缺陷
复核报告第 14 行是整个文档里最有"审查增量"的一句:
审查中修复:诊断父面板原先实色、HTHEME没有失效处理及raw-GDI文字回退破坏alpha、EDIT重绘缺少粘贴/滚动/IME消息。后续已核对主题reset与coverage-mask回退闭合,没有新的阻断P0/P1/P2。
这三条都能在源码里定位到对应机制。
8.1 诊断父面板统一背景
TelemetryWindow.cpp 与 AppShell.cpp 一样需要响应 WM_CTLCOLOR* 家族,否则子控件会各自铺不透明底,与父面板的玻璃底色割裂:
// apps/veyra/TelemetryWindow.cpp
case WM_CTLCOLORSTATIC: case WM_CTLCOLOREDIT:
case WM_CTLCOLORLISTBOX: case WM_CTLCOLORBTN: return colors(m,w,l);
colors() 的策略是按控件类决定底色:EDIT 用 raised(因输入框需要可读的实底,除非被标记为 veyra.flat),其余用父级 surface();并且统一 SetBkMode(TRANSPARENT),把背景交给父窗口绘制:
inline LRESULT colors(UINT msg,WPARAM w,LPARAM l=0){
HDC dc=reinterpret_cast<HDC>(w); HWND h=reinterpret_cast<HWND>(l);
wchar_t cls[32]{}; GetClassNameW(h,cls,32);
const bool edit=_wcsicmp(cls,L"EDIT")==0;
COLORREF bg = edit && !flat ? raised : surface(h);
SetTextColor(dc, edit?textColor:secondary);
SetBkColor(dc,bg); SetBkMode(dc,TRANSPARENT); ... }
8.2 HTHEME 失效与 raw-GDI 文字破坏 alpha
这是最隐蔽的一条。玻璃表面是 32bpp 预乘 alpha 位图,而直接调用 GDI DrawTextW 会按 BK_OPAQUE/不透明规则把 alpha 通道抹平,导致文字周围出现实心方块。源码用双保险解决:
其一是把主题句柄封装成可重置对象,并在 WM_THEMECHANGED 时失效:
struct GlassTextTheme {
HTHEME value=nullptr; bool opened=false;
void reset(){ if(value)CloseThemeData(value); value=nullptr; opened=false; }
HTHEME get(){ if(!opened){ value=OpenThemeData(nullptr,L"CompositedWindow::Window"); opened=true; } return value; }
~GlassTextTheme(){ reset(); } };
inline GlassTextTheme& glassTextTheme(){ static GlassTextTheme theme; return theme; }
窗口过程一侧的挂点(AppShell.cpp):
case WM_THEMECHANGED: veyra::ui::glassTextTheme().reset(); [[fallthrough]];
其二是回退路径不再直接画,而是先渲染到独立 AlphaRaster 作为覆盖率蒙版,再按蒙版 alpha 重新合成彩色像素:
inline int glassText(HDC dc,const wchar_t* text,int count,RECT* rect,UINT flags){
DTTOPTS options{sizeof(options)};
options.dwFlags=DTT_COMPOSITED|DTT_TEXTCOLOR; options.crText=GetTextColor(dc);
auto theme=glassTextTheme().get();
if(theme && SUCCEEDED(DrawThemeTextEx(theme,dc,0,0,text,count,flags,rect,&options)))
return rect->bottom-rect->top;
// Theme services may be unavailable. Use a coverage mask, never raw GDI
// text directly on the alpha surface (GDI would erase its alpha channel).
AlphaRaster ink; if(!ink.create(dc,rect->right-rect->left,rect->bottom-rect->top))return 0;
...
for(size_t i=0;i<size_t(ink.width)*ink.height;++i){
auto pixel=ink.pixels[i];
auto alpha=std::max({pixel&255,(pixel>>8)&255,(pixel>>16)&255});
ink.pixels[i]=(alpha<<24) | (GetRValue(color)*alpha/255<<16)
| (GetGValue(color)*alpha/255<<8) | GetBValue(color)*alpha/255; }
代码注释把问题描述得比文档更直白:"GDI would erase its alpha channel"。这也是复核报告说"coverage-mask 回退闭合"的实证。
8.3 EDIT 重绘消息补全
第三条缺陷是原生编辑框在玻璃父窗口下重绘不完整——粘贴、滚动、输入法组合都不触发重绘。修复方式是给 EDIT 挂子类化过程 editGlassPaint,用 WM_PRINTCLIENT 把系统绘制结果打到独立位图上,再从亮度推导 alpha:
if(m==WM_PAINT||m==WM_PRINTCLIENT){
PaintBuffer paint(h,reinterpret_cast<HDC>(w)); fillSurface(paint.dc,paint.rect,h);
AlphaRaster ink;
if(ink.create(paint.dc,paint.rect.right,paint.rect.bottom)){
SetPropW(h,L"Veyra.EditPrint",HANDLE(1));
DefSubclassProc(h,WM_PRINTCLIENT,WPARAM(ink.dc),PRF_CLIENT);
RemovePropW(h,L"Veyra.EditPrint"); GdiFlush();
for(size_t i=0;i<size_t(ink.width)*ink.height;++i){
auto p=ink.pixels[i];
auto maximum=std::max({p&255,(p>>8)&255,(p>>16)&255});
auto alpha=std::min(255u,maximum*255/240);
ink.pixels[i]=(p&0xffffff)|(alpha<<24); }
...
而"补原生编辑的粘贴/撤销/滚动/IME 重绘"就体现在触发模型更新(updateControlModel)的消息白名单里——注意它保留了原生编辑模型,只接管绘制:
if(m==WM_SETTEXT||m==WM_CHAR||m==WM_KEYDOWN||m==WM_LBUTTONDOWN||m==WM_LBUTTONUP
||m==WM_MOUSEMOVE&&(w&MK_LBUTTON)||m==WM_HSCROLL||m==WM_VSCROLL||m==EM_SETSEL
||m==WM_SETFOCUS||m==WM_KILLFOCUS||m==WM_PASTE||m==WM_CUT||m==WM_CLEAR
||m==WM_UNDO||m==EM_UNDO||m==EM_REPLACESEL||m==EM_SCROLL||m==EM_LINESCROLL
||m==WM_MOUSEWHEEL||m==WM_IME_COMPOSITION||m==WM_IME_ENDCOMPOSITION
||m==WM_SIZE||m==WM_SETFONT||m==WM_ENABLE)
return updateControlModel(h,m,w,l);
updateControlModel 的做法也很克制:先关闭重绘让模型更新,再恢复重绘并 InvalidateRect 交给缓冲绘制器,从而避免"系统同步绘制绕过 WM_PAINT"造成的闪烁:
inline LRESULT updateControlModel(HWND h,UINT m,WPARAM w,LPARAM l){
const bool suppress=(GetWindowLongPtrW(h,GWL_STYLE)&WS_VISIBLE)&&!GetPropW(h,L"SysSetRedraw")
&&!GetPropW(h,L"Veyra.ModelUpdate");
if(suppress){SetPropW(h,L"Veyra.ModelUpdate",HANDLE(1));DefSubclassProc(h,WM_SETREDRAW,FALSE,0);}
const auto result=DefSubclassProc(h,m,w,l);
if(suppress&&IsWindow(h)){DefSubclassProc(h,WM_SETREDRAW,TRUE,0);
RemovePropW(h,L"Veyra.ModelUpdate");InvalidateRect(h,nullptr,FALSE);}
return result; }
注意注释里的那句提醒:"WM_SETREDRAW removes WS_VISIBLE,所以绝不能在输入分发期间持有抑制状态"——BM_CLICK 可能进入模态弹窗,这正是原生检查用 BM_CLICK 而非伪造消息的价值所在。
九、视觉证据的正确读法
复核报告对截图的态度同样值得借鉴:它明确划出"截图不冒充独立运行"。
实际查看 build14 红/蓝截图:控制区随背窗变色、空闲视频保持黑色;video-red 中画面及字幕清晰。
证据来自一个独立测试窗口(DesktopBackdropFixture.cpp):每 30 秒在红蓝之间切换、180 秒自动退出,而 Veyra 并不读取它的图像。因此"控制区随背窗变色"证明的是 DWM 的真桌面合成生效,而不是应用内自绘渐变。报告还标注了"上述三张来自 build14;最终 build16 保留相同材质主路径,随后只补主题失效回退、编辑重绘消息及测试观察时序"——证据版本与被测版本不一致时,必须说明差异范围。
同一区域报告还写了一句常被忽略的限制:
原生数值框实际键盘输入 0.75、Shift+End 选择和光标已检查。真实中文IME候选组合过程尚未验证,不将 Unicode 输入当IME验收。
这条边界在源码里能对上:WM_IME_COMPOSITION 只进入了"触发重绘"的消息列表,而候选窗口的真实组合行为需要真实输入法环境,无法由软件短测替代。
十、结论范围、保留项与下一步
复核报告最后两段把"通过"压缩到了它真正覆盖的范围内,这部分必须完整继承:
- 结论限于本轮 UI、材质、开关、草稿和 SR 修复;
- 真实 IME 候选、实卡及长稳未获证明;旧保护 gate 的 FAIL 保留;
- 交付报告进一步补充:本轮未开启采集流,实卡视频/音频/断连/体感延迟仍由用户验收;真实多屏 DPI、物理扫描率、完整 SR4K+4X 性能未通过本轮证明;全局状态仍
needs_review,专有二进制公开分发仍distribution_blocked; - 受保护合并 gate 在旧 23 帧断言处 FAIL(
logs/delivery/04388a82e2424d4a8f8832daa4db83db/result.json,36.690 秒);当前 CFR 合同为 12 源帧 2X 含尾帧占位共 24 帧,补测23 checks PASS / 14.417 秒,但"保护脚本及断言未改,补测不替代 Phase gate 通过"; - 下一条唯一任务:用户从
Veyra.cmd启动,验收这版真实毛玻璃与播放器交互,再按原合同做实卡体验验收。
这种"PASS 有边界、FAIL 有留痕、补充证据有署名"的写法,是这篇复核文档最值得复用的部分。
十一、复现路径与命令清单
如果你要在本地重走这条证据链,按原报告的调用方式(每次调用上限 300 秒)执行:
# 1) 构建
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/build.ps1 -Root . -Preset x64-release
# 2) 原生专项 11 条(报告实测 81.001s)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/acceptance/ui-repair-v3.ps1 -Root .
# 3) UI 双模式全套 15 条(报告实测 141.187s)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/acceptance/ui-dual-mode.ps1 -Root . -Case all
# 4) 复核之后主 Agent 的补充证据(同一次最终 EXE)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/acceptance/repair-v2.ps1 -Root . -Case all
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/acceptance/ui-4k-regression.ps1 -Root .
几个使用要点(均可从脚本本体确认):
- 结果落在
logs/ui-repair-v3/<guid>/result.json与logs/ui-dual-mode/<guid>/result.json,其中含passed、seconds、exeSha256、逐条checks/items;单次上限由-MaxRuntimeSeconds控制,默认且最大 300 秒(ui-repair-v3.ps1); ui-repair-v3.ps1依赖 PATH 中的ffmpeg/ffprobe生成 1448×1086 的图片与视频夹具,并用它们反查保存尺寸必须为 2880×2160;ui-dual-mode.ps1会先校验合成素材哈希62BA4375...A5D4D236,不匹配直接失败,避免用错素材得出错误结论;- 取消/退出作业场景要求输出只剩
.partial、且 worker PID 不残留(Worker orphan or missing start evidence),这是"无孤儿进程退出"的判定依据; - 拒绝路径由环境变量
VEYRA_TEST_REJECT_NR_DISABLE=1注入,日志措辞为 "test-only reject NR-disable transaction ... no driver failure"——它不是真实驱动报错,阅读证据时不要混为一谈。
十二、这套复核方法能迁移到哪里
把整篇复盘压成可迁移的工程规则,大致是六条:
- 先锁二进制,再谈结论:把 EXE SHA256 写进
result.json,跨报告比对; - PASS 必须来自日志断言,而不是退出码:同时防止"空日志通过";
- 性能阈值只收紧、不放宽:实现不合格就换实现(模拟玻璃 P95 22.117ms → 系统合成 8.191ms);
- 快必须与身份不变同时成立:
hostSame/sessionSame/revisionSame与host/source/reset否定断言; - 失败要按"观察时序 / 功能缺陷"分类:只有后者才改代码,前者改测量起点且断言不变(build15→build16 的
repairSettledTick); - 证据分级署名:只读复核不等于重跑,补充证据要显式标注产出方。
这些规则的落地位置分散在 UiRepairChecks.h、GlassMaterial.h、Theme.h、ResolutionPlan.h 与四个验收入口脚本中;沿这些路径阅读,可以完整还原"宿主编译—原生点击—日志断言—外部探针校验—只读复核"这条证据链。