Skip to content

Latest commit

 

History

History
88 lines (65 loc) · 6.07 KB

PERFORMANCE-AUDIT.md

File metadata and controls

88 lines (65 loc) · 6.07 KB

性能审查与优化记录

日期:2026-10-01。基于任务开始时的工作区文件开展审查,保留已有未提交修改。

范围与方法

对 src、tools、scripts、tests 的第一方 C++、C#、Python、XAML、PowerShell 代码进行静态检索,清单包含 354 个文件;排除构建产物、二进制依赖、DDI 和资源文件。 按数据流深入检查采集、解码、渲染、音频、录制/推流、虚拟摄像头、USB/蓝牙输入、 界面刷新、日志、更新下载和驱动管理。第三方实现和安装包中的二进制不属于此次源码审查范围。

先运行已有回归测试,再修改能直接确认的高频分配和复制问题。数值来自本机 Release 构建的微基准,不代表完整应用的 CPU、帧率或端到端延迟变化。

已完成的优化

路径 原有开销 修改与约束
MediaOutputService.FrameLatch 每次发布 NV12 帧都 ToArray(),持续产生大对象堆分配 改为生产、待消费、消费三个缓冲区轮换。复制在交换锁外进行,锁内仅交换引用。消费者在下一次 Get() 前独占当前帧,慢速管道不会读到覆盖中的数据。待消费帧只保留最新一帧。
materialize_gpu_frame 每次 GPU→CPU 读回都创建 staging texture 复用一张暂存纹理,尺寸/格式变化时重建;沿用互斥保护。RAII 保证复制失败或分配异常时仍执行 Unmap 和 keyed-mutex 释放;设备丢失后清理缓存,允许下次重新创建。
QuickTime.StreamDecoder 每批 USB 数据先写入组包缓冲,再复制到包对象,并移动剩余数据 完整包直接从输入读取,仅复制到拥有独立生命周期的包对象。组包缓冲只保存当前未完成的包,先验证长度再追加数据。
DirectUsbInputBridge 触控、键盘、按钮和剪贴板消息先生成 UTF-16 JSON 字符串,再编码为 UTF-8 五处发送路径直接使用 SerializeToUtf8Bytes。继续使用相同的 JSON 字段、长度前缀和发送锁。

帧缓冲复用仍保留一次必要的像素复制,用于隔离原生复用数组与异步管道写入。 其容量最多为三个已分配帧缓冲;分辨率增大时会重新分配,预热后的零分配只适用于稳定尺寸。 FrameLatch 的契约是单生产者、单消费者,旧视图不可在下一次 Get() 之后继续使用。

实测

托管帧交接分配

使用实际 FrameLatch 处理 120 帧 1920×1080 NV12,先预热 8 次,再通过 GC.GetAllocatedBytesForCurrentThread() 测量同步发布/消费循环。与原 ToArray() 快照方式对比:

方式 120 帧累计分配
原快照方式 373,250,880 字节
三缓冲复用,预热后 0 字节

按 60 帧/秒估算,这条路径可避免约 186.6 MB/秒的持续托管分配。 这不是整个录制流程的零分配承诺,也不是常驻内存减少 373 MB。

USB QuickTime 解包

分别编译修改前保存的源码和当前源码,使用相同 MSVC Release /O2 设置。 每种输入累计处理 512 MiB,重复 7 次取中位数;两版输出校验和均为 11654662656。

输入 修改前 修改后 耗时下降
完整 64 KiB 包 31.070 ms 15.913 ms 48.8%
2 MiB 包按 64 KiB 分片 206.456 ms 189.937 ms 8.0%
每批合并 64 个 1 KiB 包 95.269 ms 82.328 ms 13.6%

这些是内存输入微基准,不包含 USB 驱动、真实传输、解码和屏幕呈现耗时。 GPU 纹理复用和 UTF-8 序列化未单独量化速度收益。

验证结果

  • 主程序 Release 构建通过,最终构建 0 警告、0 错误。
  • 原生 Release 构建通过;CTest 11/11 通过。
  • 新增 GPU 读回测试实际执行 NV12/P010、尺寸切换、连续更新、错误尺寸后恢复,逐行核对亮度和色度数据;本机没有跳过 GPU 用例。
  • 新增 QuickTime 测试覆盖每一个双段切分位置、逐字节输入、连续多包、空输入、非法长度和源数组复用。
  • 应用逻辑测试通过;新增帧交接测试覆盖慢速消费者、生产消费并发、尺寸增减、空输入和稳定尺寸下的分配上限。
  • WPF 运行时测试通过,包括当前工作区已有的倒计时、窗口与主题回归。
  • Python 离线测试 109/109 通过;驱动管理器测试通过。
  • 三语资源校验通过,缺失键为 0;本次修改的文件通过 git diff --check。

运行时测试的常规输出目录被已有测试进程占用,因此改用 work/performance-audit/managed-artifacts 单独构建、运行;没有终止其他任务的进程。

其他审查结论和验证边界

  • 采集队列已有样本数/字节数预算和关键帧恢复策略;音频已有有界环形缓冲。 蓝牙输入已有运动合并及按键释放保留机制;继续保留这些延迟与正确性约束。
  • 虚拟摄像头请求使用条件变量调度;无线消息队列已有容量限制;设备刷新在活动有线会话期间避免重复枚举。
  • 下载使用流式传输与池化缓冲,多段下载有进度限频;运行时文件哈希属于完整性验证,未通过删除校验来优化启动。
  • D3D 预览仍有 1 ms 轮询,原生日志仍可能在调用线程触发批量刷盘,托管日志仍同步追加文件。 这些路径需要结合实际帧间隔、磁盘与 CPU 采样进一步评估;本次没有把增大等待间隔当作延迟优化。
  • 没有执行真机长期投屏、远端推流、多设备压力测试或设备丢失故障注入。 端到端延迟、长时间音画同步及不同显卡驱动上的收益仍需这些场景确认。

本次只更新源码和测试,没有重新打包发布目录或安装器。

本机复现材料位于 work/performance-audit/:source-inventory.txt、修改前源码、 packet-benchmark/、packet-before.log、packet-after.log、logic.log、native.log、 python.log、driver.log、runtime.log、localization.log 和构建日志。 该工作目录由 Git 忽略;帧交接分配回归和协议/GPU 正确性测试已加入正式测试源码。