Veyra-NRVideo 本地 main 合并实践:性能优化分支与现场修复的可验证整合
Veyra-NRVideo 本地 main 合并实践:性能优化分支与现场修复的可验证整合
在多人(多 Agent)并行开发的视频增强项目里,"先合并到 main"往往比写功能更容易出错:谁的分支在前、树是否真的等价、哪些验证是合并前做的、哪些历史构建不能算作本轮重编译。这篇指南以 Veyra-NRVideo 在 2026-10-05 的一次真实合并为骨架,逐条拆解可审计的合并流程——提交拓扑、存档与 checkpoint、验证口径,以及这次并入的五项改动在源码中的落点,帮助你在自己的仓库里复现同一套证据链。
一、这次合并的对象、边界与结论
原始记录只有 32 行,但信息密度很高:它同时定义了合并方式、参入内容、存档结构、验证证据和权限边界。下面先把它还原成一张可对照的表。
1.1 三方身份与提交拓扑
| 角色 | 身份 | 说明 |
|---|---|---|
| 合并前 main | 354b1c6e39ba0f62b2e6aac4c161f682dea9c2ff |
对应已发布的 2.0.3 产品源码 |
| 来源工作树 | E:/项目/Veyra/worktrees/field-fixes-20261005 |
分支 claude/field-fixes-20261005 |
| 来源继承 HEAD | 2dbf26c |
即 codex/perf-nr-20261004 的性能优化分支末端 |
| 未提交文件提交 | 6e9d8273c1d3ae5182d07cfec8c370b68bb4da23 |
29 个文件,含预热、采集节奏、AMD NR、libass、GPU 计时与验收文档 |
| 合并提交 | f7ced91d920f072fb9637e95811e701b7e1bd876 |
两个父提交分别为 354b1c6 与 6e9d827 |
| 合并树 | b35201b90e1911da492f4aecf92ed59a41092d41 |
与来源提交的树完全相同 |
注意来源分支继承的是性能分支 HEAD:也就是说这次 --no-ff 合并一次性把"整条 NR 性能优化历史 + 现场修复"带进了 main,而 29 个未提交文件是模型/会话被迫中断时留在工作树里的产物,必须先落盘成提交才能参与合并。
1.2 合并命令与为什么必须 --no-ff
文档给出的实际命令是:
git merge --no-ff -m "Merge verified NR performance optimization and Claude field fixes" claude/field-fixes-20261005
--no-ff 在这里不是风格偏好,而是证据需求:只有保留显式合并提交,才能事后用"两个父提交 + 合并树"三元组证明"main 现在的内容 = 已被实际复测过的那份源码"。如果用快进(fast-forward),29 个文件的来源、性能历史与修复历史会混成一条线性历史,无法在回滚或审计时区分边界。
对应的核验逻辑可以抽象成三条断言:
# 1) 合并提交确有两个父,且顺序为 [旧 main, 来源分支]
git rev-list --parents -n 1 f7ced91 # 期望输出: f7ced91 354b1c6 6e9d827
# 2) 合并树与来源提交的树一致(无冲突解决的意外改动)
git rev-parse f7ced91^{tree} # 期望: b35201b...
git rev-parse 6e9d827^{tree} # 期望: b35201b...
# 3) 来源分支仍是 main 的祖先
git merge-base --is-ancestor claude/field-fixes-20261005 main && echo ancestor-ok
记录里明确写了"main 是来源分支祖先""无冲突",也就是合并没有产生任何冲突解决内容——这是后面"不必重编译"的前提。
1.3 明确没有做的事
原文档用一整句划清权限:
- 没有 push,没有发布,没有实施新的修复;
- 没有重新编译:因为"没有新增产品代码,合并 Git 树与已构建/复测版本相同",所以"不把历史构建冒称本轮重新编译";
- 未新提交 runtime/SDK/模型,既有测试包不变,分支与工作树均保留。
这条边界非常关键:合并的合法性来自"Git 树等价",而不是来自"我又跑了一遍 building"。只要合并前后的树完全一致,合并前在来源分支上跑通的构建与测试就可以继续作为同一份源码的证据——但前提是你能证明树一致,而且能证明那个构建确实是在该树上做的。
二、29 个文件到底改了什么:从记录到源码落点
原文档一句话概括:"涵盖预热默认关闭/设置分类、采集节奏与电源节流、AMD NR 规范化、libass ASS 字幕、图重建后 GPU 计时以及验收文档。"下面把它还原成可检索的实现细节。
2.1 增强预热默认关闭,并按显卡能力置灰
性能分支此前把"启动时预热增强组件"做成了默认开启(见 PERF_UI_FINAL_2026-10-05 的界面表:默认开启、首页空闲 2 秒后预建一次会话)。现场修复把默认值改成关闭,理由是显存常驻成本:
- 开关提示写明约 0.8–1.8 GB 显存常驻;
- RTX 30/40(Ada/Ampere 的补丁式补帧会话)上
enhancementPrewarmAvailable返回 false,界面置灰,避免"显示可用却不生效"。
源码落点很清楚。默认值在引擎侧:
// include/veyra/engine/EngineController.h
std::atomic<bool> prewarmEnabled_{false}; // off until the saved preference enables it (default off since 2026-10-05)
能力判定与调度在桥接层:
// src/ui/bridge/Preferences.cpp
bool QmlPlayerBridge::enhancementPrewarmAvailable() const {
// PreviewGpuSession::prepare refuses RTX 30/40 (patched FG sessions keep the
// full NGX lifetime), so the switch must not look usable there either.
const auto gpu=effectGpu();
return gpu.vendor==0x10DE&&!ngx::FgCompatibilitySession::requested(gpu.vendor,gpu.deviceId);
}
void QmlPlayerBridge::scheduleEnhancementPrewarm(){
QTimer::singleShot(2000,this,[this]{
if(!impl_->prefBool("prewarmEnhancement",false)||!impl_->enhancementPrewarmAvailable()||
impl_->openingSource||impl_->snapshot.running||!impl_->engine.idle())return;
...
});
}
可以读出三层一致性:偏好默认 false、能力不满足直接返回、调度前再检查一次"是否空闲/是否已打开源"。这是合并后唯一生效的默认值——性能分支原来的默认开启被现场修复覆盖,属于"后者优先"的正常合并语义,不是冲突。
预热本身的价值与代价分界,可参考 PERF_2D_PREWARM_2026-10-04:它把首次成功 Present 的等待从约 1942–2053 ms 压到约 92–107 ms,但"预建工作依然需约 2–3 秒,只移到首页空闲时,不声称消灭了模型初始化成本"。
2.2 采集节奏:把"引擎自己跳帧"从"源节奏中断"里剔除
这是本次现场修复里最值得深入的一处,因为它是一个自我放大的环路:跳帧造成 PTS 断档 → 场景检测把断档判成源节奏中断 → 重置 NR/补帧历史 → 补帧相位被拉长 → 采集信箱再次丢帧 → 回到第一步。
修复点一:场景分析改为按源帧步长归一化每帧间隔。头文件把语义写得很直白:
// include/veyra/core/SceneCadenceAnalyzer.h
// `sourceStep` is how many source frames advanced since the previous
// analysed frame (>1 when the player skipped or the capture mailbox
// dropped frames). The cadence check uses the per-source-frame interval,
// so a gap the player created itself is not reported as a source break.
SceneAnalysisResult analyze(uint64_t frameId,
const std::vector<double>& histogram,
double sad,
uint64_t ptsUs,
uint64_t sourceStep = 1);
调用侧用源帧序号差算出步长,真实源断档(源自身步长为 1 但 PTS 大幅跳变)仍会触发中断:
// src/pipeline/EnhanceGraph.cpp
const uint64_t sourceStep=sceneLastSourceId_&&sourceFrameId>sceneLastSourceId_
?sourceFrameId-sceneLastSourceId_:1;
const auto analysis=scene_.analyze(realFrameIndex_,hist,sad,
static_cast<uint64_t>(std::max(0.0,ptsMs)*1000),sourceStep);
而中断判据本身也从"单次间隔"改成了对 5 个样本取上中位数的自适应阈值,顺带修掉"重复帧后下一帧被误判为中断":
// src/core/SceneCadenceAnalyzer.cpp
cadenceDeltaUs = result.ptsDeltaUs / double(sourceStep ? sourceStep : 1);
if (cadenceCount_) {
auto intervals = cadenceIntervals_;
auto middle = intervals.begin() + cadenceCount_ / 2;
std::nth_element(intervals.begin(), middle, intervals.begin() + cadenceCount_);
result.isCadenceBreak = cadenceDeltaUs > *middle * 3.0 + config_.cadenceBreakPtsJitterUs;
}
注释里还保留了一个具体反例:"普通 16.683/20.833 ms 帧围绕一个孤立的 1 ms 正向增量,过去会重置全部时序历史"——这正是"重复帧后误判"的成因。
修复点二:采集补帧的呈现相位不再无条件采用 A/B 实际 PTS 跨度。头文件把 100 ms 这个上限的用途写成了契约:
// include/veyra/engine/LivePresentationTiming.h
// Variable-refresh capture often retains the negotiated maximum-rate sample
// duration. The actual A/B source span controls interpolation, not that cap.
// Never use a stale/reset predecessor to establish the new phase.
inline int64_t capturePairInterval100ns(pipeline::Rational duration,double nominalFps,
double previousPtsMs,double ptsMs,bool reset){
const double span=ptsMs-previousPtsMs;
if(!reset&&std::isfinite(span)&&span>=1&&span<=100)return int64_t(std::llround(span*10000));
return liveSourceInterval100ns(duration,nominalFps);
}
调用点在引擎主干,且把"历史已重置"与"检测到空隙"合并成同一个 reset 条件,避免用跨丢帧的 100 ms 跨度去定下一对的展示节奏:
// src/engine/EngineController.cpp
capturePairInterval100ns(pkt.duration,activeSource->info().averageFps,
lastProcessedPtsMs,pts,historyReset||gapCandidate)
2.3 播放期间退出 Windows 电源节流
文档把触发源推测为"Windows 对非前台进程的电源节流(EcoQoS 执行速度、计时器精度)",并明确标注"本机无法复现用户现象"。实现上它做的是一个有明确 Windows 文档依据的 opt-out:播放时关闭 PROCESS_POWER_THROTTLING_EXECUTION_SPEED 与 PROCESS_POWER_THROTTLING_IGNORE_TIMER_RESOLUTION,停止播放即交还系统策略。
// include/veyra/ui/PlaybackPowerGuard.h
class PlaybackPowerGuard {
bool active_=false;
public:
~PlaybackPowerGuard(){update(false);}
void update(bool playing){
if(playing==active_)return;
const auto flags=ES_CONTINUOUS|(playing?(ES_DISPLAY_REQUIRED|ES_SYSTEM_REQUIRED):0);
if(!SetThreadExecutionState(flags)){ /* 记录 win32 错误并返回 */ }
active_=playing;
throttle(playing);
}
private:
static void throttle(bool playing){
PROCESS_POWER_THROTTLING_STATE state{};
state.Version=PROCESS_POWER_THROTTLING_CURRENT_VERSION;
state.ControlMask=playing
?(PROCESS_POWER_THROTTLING_EXECUTION_SPEED|PROCESS_POWER_THROTTLING_IGNORE_TIMER_RESOLUTION)
:0;
state.StateMask=0; // controlled bits off = never throttle; ControlMask 0 = system default
SetProcessInformation(GetCurrentProcess(),ProcessPowerThrottling,&state,sizeof(state));
}
};
两个工程细节值得抄走:StateMask=0 表示"受控位全部置为不节流",而 ControlMask=0 表示"回到系统默认"——只有两者区分开,释放才真的是释放;另外类注释强调 SetThreadExecutionState 必须在同一 UI 线程获取与清除,析构函数负责兜底释放。日志前缀固定为 [playback-power],便于从现场日志里直接 grep 到节流状态切换。
2.4 AMD 适配器不再被 NVIDIA 规范化关掉 NR
现场日志显示 nr=false 与 ui-nr-rollback:一个只针对 NVIDIA 的"关闭不支持效果"的函数,在 AMD 显卡上把 NR 一路关掉了。修复改成显式区分"AMD 上 NR 走 lmxxf 运行库"的路径:
// include/veyra/engine/BackendRecovery.h
// amdNr: the adapter is AMD, where NR runs on the lmxxf runtime (the graph
// selects it for every NR layer; an unsupported RX model fails in its own
// open/admits and is reported like any other NR backend failure).
inline bool disableUnsupportedNvidiaEffects(EnhancementSettings& settings,bool nvidia,bool amdNr=false){
if(nvidia)return false;
const auto before=settings;
if(!amdNr)settings.nr=false;
// NVOF does not exist on these adapters; NR motion uses AMD FidelityFX flow.
if(amdNr&&settings.nr&&settings.opticalFlowBackend==OpticalFlowBackend::Nvidia)
settings.opticalFlowBackend=OpticalFlowBackend::AmdFidelityFx;
settings.videoHdr.enabled=false;
settings.sr=settings.sr&&settings.videoSrQuality==kVideoSrFsr;
if(settings.frameGenerationBackend==FrameGenerationBackend::Dlss)settings.multiplier=1;
return settings!=before;
}
三个容易踩的坑在这里都被显式处理:NVOF 在 AMD 上不存在,必须切到 FidelityFX 光流;SR 只保留与厂商无关的 FSR 路径;比较 settings!=before 作为"是否发生过规范化"的返回值,方便调用方决定是否写回滚日志。文档同时注明导出侧的限制——"在 lmxxf 预算内(≤1920×1080 像素、高 ≤1080)同样启用,超出时明确提示"。
2.5 用 libass 补齐 ASS 特效字幕
原 1.4.4 只有"样式类"ASS,\move/\t/\clip/卡拉 OK 均未实现。这次引入 libass 0.17.5 静态库,构建入口是一个可选的 CMake 缓存变量,缺失时回退到内置样式渲染器:
# CMakeLists.txt
# libass (ISC) + FreeType/FriBidi/HarfBuzz, static, for full ASS/SSA effect
set(VEYRA_LIBASS_ROOT "" CACHE PATH "libass static install prefix (include/ass/ass.h, lib/ass.lib)")
if(VEYRA_LIBASS_ROOT AND EXISTS "${VEYRA_LIBASS_ROOT}/include/ass/ass.h")
target_include_directories(veyra_qml_bridge PRIVATE "${VEYRA_LIBASS_ROOT}/include")
target_compile_definitions(veyra_qml_bridge PRIVATE VEYRA_HAS_LIBASS=1)
...
else()
message(STATUS "libass: not configured; ASS effects use the built-in styled renderer")
endif()
数据侧的做法是"保存原文而非烘焙结果":外挂 .ass/.ssa 存全文,内嵌轨存编解码器头 + 原始事件块,并读取 Matroska 字体附件(单个 ≤64 MB、合计 ≤256 MB)。渲染器在 apps/veyra/ui/AssSubtitleRenderer.cpp 中按视频显示区域(含缩放/平移)渲染后合成到原有分层字幕窗口,只在 libass 报告变化或几何变化时刷新;它还把 libass 的日志按 500 ms 限速,避免高频 warn 拖累主线程。
一个真实的工程教训写在文档"构建注意"里:vcpkg/MSVC/meson 在含中文的路径下会失败(D8050、跨盘 relpath、ninja 链接路径编码),因此 libass 的构建树与安装目录必须放在纯 ASCII 路径下。这类信息通常不会出现在代码注释里,却是复现构建的关键。
2.6 图重建后 GPU 耗时全部"未测量"
这是用户实测发现的问题:播放中开关 NR、加层、开 2X 补帧后,界面耗时全显示"未测量"(日志 enhancementProcessingMs=-1),但 player-timing 里的各阶段 GPU 时间其实是正常的。根因是性能优化把处理图改成"每次重建都新建对象",而"记录 GPU 计时"只在开播时对最初的那个对象打开过一次。
工程上的修法不是"缓存计时开关",而是把"打开记录"变成收集前的例行动作——collectTimings 在每次轮询与解析完成前后都会再次触发:
// src/engine/EngineController.cpp
auto collectTimings=[&]{
auto record=&{
const auto& fgCost=sample.gpu[size_t(diagnostics::GpuStage::FgBatch)];
for(auto& watch:pendingCompletions){
const auto& id=watch->output.batch.identity;
if(id.epoch==sample.identity.epoch&&
id.settingsRevision==sample.identity.settingsRevision&&
id.sourceFrameId==sample.identity.sourceFrameId){
if(const auto span=diagnostics::graphExecutionSpanMs(sample))watch->gpuExecutionMs=span;
...
}
}
};
...
};
...
if(!watch.gpuExecutionMs)collectTimings();
配对键 (epoch, settingsRevision, sourceFrameId) 是这段代码能被信任的原因:重建后的新图也有自己的 identity,只有三者同时匹配才把 GPU 样本记到某个待完成批次上,避免把旧图的耗时错配给新配置。
三、存档结构:把"可回滚"做成三层
文档把运行产物分成 archives / logs / tmp 三类,并以一次性 Run 标识 merge-20261005T063850Z-1b5fef 贯穿:
| 目录 | 内容 | 用途 |
|---|---|---|
archives/merge-main-20261005/<run>/ |
合并前 before.bundle、before.json、未提交原字节 ZIP、binary patch / index patch、SHA 清单;合并后增量 bundle 与最终 receipt |
不可变保护点 |
logs/merge-main-20261005/<run>/ |
逐命令日志、bundle 核验、进度 JSON、独立合并核验 | 过程可复算 |
tmp/merge-main-20261005/<run>/ |
合并/核验夹具、commit 文本;子进程 TEMP/TMP 同在此处 |
不污染系统 Temp |
关键身份:
before.bundle SHA256 = 15b44fccbd73f090d05c894b62035a34560ae0113059fdc6bc2660fc8a6f984b
为什么要 bundle 而不是只打 tag?因为 tag 依赖同一个 Git 库;一旦共用库被移动、重建或损坏,标签就不再指向可验证的对象。bundle 是自包含的对象包,可以脱离原库 git bundle verify 后重新 fetch 出来。本仓库的 分支归档 就沿用了这一做法,并给出恢复模板:
git bundle verify <archive>/source-before.bundle
git fetch <archive>/source-before.bundle refs/heads/<branch>:refs/heads/<branch>
三个 checkpoint 标签把合并过程切成可回退的三段:
| 标签 | 指向 | 语义 |
|---|---|---|
checkpoint/pre-merge-perf-field-main-20261005 |
354b1c6 |
合并前的 main |
checkpoint/perf-field-branch-tip-20261005 |
6e9d827 |
来源分支落盘后的 tip |
checkpoint/merged-perf-field-main-20261005 |
f7ced91 |
合并提交 |
四、验证证据:哪些是"实测",哪些是"继承"
原文档第 3 节列出的验证全部来自合并前已在来源分支完成的实跑,证据目录为 logs/claude-handoff-20261005/takeover-20261005T061823Z-1ad4ac/。展开如下:
| 验证项 | 结果 | 证据位置 / 备注 |
|---|---|---|
| 既有 build-6 构建 | 成功 | build/field-fixes-20261005/B |
| 第二版 NVIDIA ZIP | CRC 通过,1578 个载荷 | 主程序 SHA256 09b439d8faf4df121a0749b6eaaccf71de0b8c344d144feb1ea743cc7d973a14 |
| ZIP 内源码 | 1605 个源码文件与工作树原字节一致 | 对应源码 ZIP SHA256 93c773d6…262d |
| 运行组件 | 123 个组件原字节审核通过 | 不含新增 runtime/SDK/模型 |
| 单元/合同测试 | 5 个程序全部 exit 0 | scene 18/18、repair contract 246/246、live timing、effect chain、UI i18n |
| 真实播放 | 约 45 秒、七阶段全部计时有效 | 增强合计约 7.22 / 7.07 / 8.18 / 10.43 / 16.85 ms |
七阶段的顺序本身就是一份"重建路径覆盖清单":效果全关 → 播放中开 NR → 关 NR → 再开 NR(日志确认 feature-cache 命中)→ DLSS SR → DLSS 2X → 第二层 NR。每一步都会触发处理图重建,因此能同时验证 2.6 的计时修复与缓存复用。文档对这份数据给了两条限定:它是"计时显示恢复"的证明,不是 A/B 性能收益测量,也不能外推为物理延迟或全部组合通过。
同时,原文档明确写出"Claude 原性能验收仍为有条件通过;本地合并不把这些条件改写成通过"。这是合并记录里最容易被忽略、也最重要的一句:合并操作不产生新的验收结论,它只搬运已经存在的结论。
五、核验脚本的坑:口径不一致会伪装成"失败"
文档里有一段非常真实的排错记录:verify-merge.py pre-docs-v2 首次核验失败,原因是"桌面 untracked 状态的目录折叠与归档逐文件枚举口径不同";处理方式是保留原失败 JSON,把命令统一为 --untracked-files=all 后重跑通过,而不是放宽字节断言或改文件。
这类问题的通用形态是:验证器 A 用"目录级"快照,验证器 B 用"文件级"快照,当目录里出现未跟踪文件时两者必然不等。正确的收敛方向永远是统一口径,而不是降低断言强度。文档随后还追加了最终轮核验:允许范围内的五个文档差异、源码一致性、清洁状态、其他工作树保护、以及增量 bundle 校验。
六、边界清单:合并之后仍然"未验"的部分
原文档把未验项写得毫不含糊,这部分应原样保留,因为它决定了这次合并能被怎样引用:
- 暂停后新接 OBS、用户采集卡后台问题、RX 9000 实卡 NR 推理与画质;
- 其他 RTX 生命周期(不同型号/驱动的 NGX 核心与缓存生命周期);
- 可选尺寸的主观画质(Auto 内部尺寸、先粗后细组合);
- 约 110 ms 的 CPU 图提交长尾与旧 2.8 s 断档的根因;
- HDR/Dolby Vision PR、旧 Win32 删除、推送与 Release:本轮均无授权。
同一阶段的其他记录也保持同样的克制口吻,例如 MERGE_MAIN_2026-10-09 就明确写着"HDR 现场根因未确认""不能将这些本机定向通过称为现场问题根治"。把这种"证据—结论"的距离固定成文档规范,比任何单次合并技巧都更重要。
七、可复现的操作序列(通用化)
把这次合并抽象成可复用的流程,大致是七个阶段。下面的命令是流程骨架,路径与分支名需按你的仓库替换;原始记录中的实际实现是 py -3.11 -B <tmp>/merge-local.py commit-source|merge|tag-merge 与 verify-merge.py。
# 0) 开工前记录:工作树、分支、脏文件
git -C <main-worktree> rev-parse HEAD
git -C <main-worktree> status --porcelain=v1 --untracked-files=all
# 1) 全量存档:自包含 bundle + 状态 JSON + 未跟踪文件归档
git bundle create before.bundle --all
git bundle verify before.bundle
# 2) 把来源工作树的未提交改动原字节落盘(先归档 patch,再提交)
git -C <source-worktree> add -A
git -C <source-worktree> diff --cached --check
git -C <source-worktree> commit -m "field fixes: <scope>"
# 3) 合并(保留双父)
git -C <main-worktree> merge --no-ff -m "Merge <scope>" <source-branch>
# 4) 打三段 checkpoint
git tag checkpoint/pre-merge-<task> <old-main>
git tag checkpoint/source-tip-<task> <source-tip>
git tag checkpoint/merged-<task> <merge-commit>
# 5) 独立核验:父提交、树等价、工作树清洁、其他 worktree 未变
git rev-list --parents -n 1 <merge-commit>
git rev-parse <merge-commit>^{tree} <source-tip>^{tree}
# 6) 合并后增量 bundle(只含新增对象)
git bundle create after-incremental.bundle <old-main>..<merge-commit>
八、给同类合并的检查表
把上面所有细节压缩成一张可以贴在 PR 描述里的清单:
- 身份先行:合并前 main、来源 tip、合并提交、合并树四个哈希必须能互相推导(父提交 + 树等价)。
- 未提交内容先归档再提交:原字节 ZIP + index/binary patch 双份,
diff --cached --check必过;否则"合并的是什么"无法回答。 - 树等价才可复用旧验证:树一致 → 之前的构建与测试仍有效;树不一致 → 必须重编重测,不能用历史结果冒名。
- 默认值冲突要显式记录:本例中预热默认值由性能分支的"开启"被现场修复改成"关闭"(EngineController.h),这属于正常覆盖,但必须写进记录。
- 验证口径统一:所有快照工具统一
--untracked-files=all,失败 JSON 保留不删。 - 结论与权限分离:合并不代表验收通过;push/Release/新修复需要单独授权。
- 未验项单列:硬件型号、真实采集卡、主观画质、长尾根因,逐条写成"未验证",不要用"已修"替代。
这次合并的技术含金量,其实不在于 git merge --no-ff 本身,而在于它示范了一种在"多 Agent + 大量现场日志 + 无法本地复现"的条件下依然可审计的工作方式:把每一次"我改了"都变成可校验的哈希、可回放的 bundle、可对照的测试日志,并把"没验证的部分"当作交付物的一部分写下来。想继续深入这次并入的具体实现,可以从 FIELD_FIXES_2026-10-05 的分主题章节、PERF_EXECUTION_NR_2026-10-04 的节点账本,以及 历史索引 里的报告清单继续追踪。