# 性能面板验收

2026-11-13，目标 `D:/vibeCoding/ueRouge/ueRouge.uproject`，UE 5.8.4，Windows PC 键鼠。最终 Windows Development 产物入口为 `Builds/Windows/x64/ueRouge.exe`，保留完整产物目录。

## 已实现

- 默认开启并位于实际视口右上角，显示 FPS、Frame、CPU Game、CPU Render、RHI 和 GPU；时间单位为 ms。设置页可以关闭、选择四角位置，重启后保持。中英文本即时更新。
- 使用真实墙钟计算帧间隔及最近一秒的滚动 FPS；每帧采集，0.25 秒发布一次缓存。文字格式和宽度测量随缓存或尺寸变化更新；显示不发起同步 GPU 查询。
- CPU 使用 UE 的 Game/Render/RHI 计数，GPU 使用 `RHIGetGPUFrameCycles`。GPU 查询结果可能滞后，计时也可能含管线等待；这些时间不相加，不代表 CPU/GPU 利用率。无有效计时时显示 `—`。
- 面板不接收鼠标输入。原 UI 在剩余顶/底安全区域中等比适配，网格绘制和鼠标命中使用同一变换；准星仍在完整视口中心。超宽屏面板贴实际视口边缘，原菜单保持居中的布局。
- 采集在 `Source/UEAdapter/`，显示在 `Source/ueRouge/`。`gameFramework` 库 SHA-256 保持不变，进度仍为 V1；自定义 UI 偏好使用配置文件，QA 进度和偏好均隔离。

## 实际验证

| 层级 | 结果与记录 |
| --- | --- |
| 构建 | Editor / Win64 Development 编译及 BuildCookRun 成功，[最终产物与核心库校验](build.json)。运行产物不需要 MCP。 |
| UE 自动化 | 最终代码重新执行 4 组测试，4 通过、0 失败：[MCP 记录](editor-final.json)。包括滚动计时、异常/时钟/重置、四分辨率四角布局及 `IRONSPORE.Host.AtomicV1` 的 21 项磁盘检查。 |
| PIE | [启动、退出与保存记录](editor-pie.json)。该项是编辑器烟雾验证，实际画面与功能以最终独立程序记录为准。 |
| 独立程序完整功能 | [12 项通过](Windows/20261113-203019-Full-1920x1080/verification.json)：默认位置、开关、四角、中英、试验场双视角、真实世界暂停后继续更新、回到基地及单一面板实例。 |
| 重启与原生计时对照 | [10 项通过](Windows/20261113-203100-Restart-1920x1080/verification.json)：关闭/左下角/英语跨进程保持，再恢复开启/右上角/中文；采集原生 `stat unit` 与自定义原始计数进行短时对照。 |
| 实际鼠标和键盘 | [输入与拖拽记录](ManualChecks.md)：鼠标开关、选择左上角、Esc 返回、进入机库、实物拖拽和恢复、菜单退出。UID 与 V1 均保持。 |
| 运行日志 | 最终鼠标验收程序[正常退出，0 Error、0 ensure/fatal](runtime-log-summary.json)。 |

所有下列最终独立程序记录的二进制 SHA-256 均与最终产物相同，见[汇总](accepted-runs.json)。

| 实际 PNG 分辨率 | 验证 |
| --- | --- |
| 1280×720 | [通过](Windows/20261113-203117-UI-1280x720/verification.json) |
| 1920×1080 | [通过](Windows/20261113-203019-Full-1920x1080/verification.json) |
| 2560×1440 | [通过](Windows/20261113-203134-UI-2560x1440/verification.json) |
| 3440×1440 | [通过](Windows/20261113-203151-UI-3440x1440/verification.json) |

尺寸均读取实际图片头部。原生截图在 UI 切换后等待 0.25 秒，让字体上传与摄像机历史稳定；数值 JSON 是触发截图时的快照，不承诺与随后图片上的每个数值逐帧相同。

默认右上角，主页，Windows 独立程序 1920×1080：

![默认性能面板](Windows/20261113-203019-Full-1920x1080/home-default-zh.png)

试验场越肩视角，Windows 独立程序 1920×1080：

![局内性能面板](Windows/20261113-203019-Full-1920x1080/training-shoulder.png)

英文设置和左上角，Windows 独立程序 1920×1080：

![英文性能设置](Windows/20261113-203019-Full-1920x1080/top-left-en.png)

## 修复与验证范围

版本库归档保留最终通过的截图与数据，并在[失败摘要](FailureHistory.json)中记录必要的中间问题；重复截图和完整中间记录仅保留在本地。

首次截图发现英文长标签重叠，已加入宽度适配、缓存和裁剪。较早的即时切换截图捕获到字体上传瞬间，最终记录使用稳定后的真实画面。首次重启检查发现自定义 QA 配置文件没有注册进 UE 配置缓存，已显式注册、加载和写入，最终跨进程验证通过；失败记录仍保留。

最终启动检查还发现继承的 `GameFeatureData` 扫描指向只在编辑器启用的 MCP 依赖。直接移除会导致编辑器烹饪错误，最终将该扫描限定为 Editor Only，保留编辑器所需声明并避免独立程序加载缺失类；重新烹饪和独立启动通过。

这是性能显示功能及短时正确性验证，没有执行长时间性能基准，也没有将截图上的瞬时帧率当作整局持续 60 FPS 结论。GPU 不可用、非法计时与时钟异常通过自动化窗口测试验证；本机 DX12 设备的 GPU 计时实际可用，没有冒称在不支持 GPU 时间戳的真实设备上做过实测。

## 收尾

最终编辑器保留在 `L_Hangar`，PIE 已停止并保存；本任务 MCP SDK 客户端已关闭。SDK 返回的 `Session termination failed: 202` 提示原样保留，不能据此声称服务端会话销毁已独立验证；未停止编辑器服务或其他任务的进程。所有独立验收游戏已退出。未创建 Git 仓库、分支、提交或推送。