元桌浏览器视觉工作台 v2.5.0 · 真机像素调参证据与验收门禁

核对日期：2026-09-04（Asia/Shanghai）
开发路线：v2.4.0 已冻结；v2.5.0 在其上增量开发，不从零重构。
目标环境：用户本机元桌浏览器 Chromium 101。
文档用途：区分“公开样本几何调参”、“开发预览”与“真机 pixel PASS”，防止把 JPEG、Edge 或人眼接近写成逐像素已通过。

一、不可更改的版本边界

1. v2.4.0 是当前已冻结候选版。v2.5.0 不回写 v2.4.0 工作目录、release 目录或 ZIP。
2. v2.5.0 继承 v2.4.0 的状态栏系统家族、配置库、状态栏 small icon 与横幅独立配置、旧运行时接管和 Chromium 101 兼容边界。
3. 本版的三个精确机型画像是在家族基线上的窄范围覆盖；只在机型 ID 与系统视觉版本同时匹配时生效。
4. 本文档不改变 STATUS_ICON_SOURCES.txt 对应用通知 small icon 资源身份、版本、可读性和授权边界的结论。

二、当前参考文件与完整性

以下文件位于 v2.5.0 工作容器的 research-evidence 目录，不作为可再分发的扩展运行资源：

1. Xiaomi 17 Ultra／HyperOS 3
   文件：xiaomi17-ultra-hyperos3-real-review.jpg
   像素尺寸：784 × 1704
   文件字节：130788
   SHA-256：57208813DA0FF1D5FFC3AA828AB770466428CFAF19B359411A569828C6E88714
   grade=tuning-only
   eligibleForPixelPass=false

2. OPPO Find X9 Pro／ColorOS 16
   文件：coloros16-findx9pro-real-screenshot.jpg
   像素尺寸：496 × 1080
   文件字节：85480
   SHA-256：7FC59C0114D9694ED116FED5EE0D9600F270D826DC963D944EE76598A9F1D90C
   grade=tuning-only
   eligibleForPixelPass=false

3. vivo X300 Pro／OriginOS 6
   文件：originos6-x300pro-real-screenshot.jpg
   像素尺寸：630 × 1400
   文件字节：132027
   SHA-256：C7474EBF8E5879CFFF4D1805465F144BE09856E464F03D037615173E291D292F
   grade=tuning-only
   eligibleForPixelPass=false

上述哈希只用于确认本次调参看到的是同一份公开参考文件，不能证明该文件是手机未编辑原图，也不能提高其像素验收资格。

三、三个精确机型画像

1. Xiaomi 17 Ultra／HyperOS 3

- 机型 ID：`xiaomi17_ultra`
- 要求的系统视觉版本：`hyperos3`
- 画像 ID：`xiaomi17-ultra-hyperos3-reference`
- 调参场景：12:37；勿扰开；VoLTE 开；5G；四格信号；Wi-Fi 关；68% 图内电量；一枚通知槽位加溢出点。
- 可调项：顶部基线、左右边距、时间宽度／基线、通知槽位与溢出点间距、辅助状态顺序、5G／信号与电池占位、电量填充比例。
- 未闭合项：首枚通知 glyph 对应的应用包、App 版本、通知通道和原始 small-icon 资源未知。不得用微信、小红书或通用类别图标替换后声称精确。
- 目标字体候选：MiSans／MiSans Latin。字体家族名命中不等于版本、字重和栅格化已闭合。

2. OPPO Find X9 Pro／ColorOS 16

- 机型 ID：`oppo_find_x9_pro`
- 要求的系统视觉版本：`coloros16`
- 画像 ID：`oppo-find-x9-pro-coloros16-reference`
- 调参场景：14:58；三枚彩色通知槽位；Wi-Fi 活动标记；5G 在信号簇上方；33% 图内电量。
- 可调项：顶部基线、左右边距、彩色槽位的数量／尺寸／间距、Wi-Fi 与活动标记的组合占位、网络制式与信号的紧凑排列、电池外形与 33% 填充比例。
- 未闭合项：三枚彩色图标的精确应用包身份、App 版本、通知通道、OEM 美化规则和逐字节图形未知。App Store artwork 或品牌轮廓只能作专家近似，不能完成 small icon 像素验收。
- 目标字体候选：OPPO Sans／OPPOSans。同名字体的版本、字重文件和渲染器必须另行闭合。

3. vivo X300 Pro／OriginOS 6

- 机型 ID：`vivo_x300_pro`
- 要求的系统视觉版本：`originos6`
- 画像 ID：`vivo-x300-pro-originos6-reference`
- 调参场景：2:24；NFC 开；静音开；VoLTE 开；实时网速 0.20 KB/s；4G；信号；Wi-Fi；56% 横向图内电量。
- 可调项：顶部基线、左右边距、辅助状态顺序与间距、网速文字占位、4G／信号／Wi-Fi 的组合、横向电池外形与 56% 填充比例。
- 可见性边界：样本没有应用通知图标，没有通知横幅，也不显示原子岛持续活动。在相同验收场景中不得自动添加这些元素。
- 目标字体候选：vivo Sans／Vivo Sans。仅有名称候选不足以声称与真机字形逐像素一致。

四、为什么公开 JPEG 只能调参

1. JPEG 有损压缩会在图标、字形和半透明边缘附近产生块效应、色度抽样和振铃边缘，参考像素本身已不等于原始屏幕像素。
2. 公开页面中的图片可能被缩放、裁剪、水印、色彩转换或再次编码，且无法从当前文件完整还原这条处理链。
3. 截图上显示的 ROM 家族名不能唯一确定完整 build；同一大版本在月度更新、地区、主题和运营商定制后都可能改变 SystemUI。
4. 公开图无法证明系统显示大小、字体大小、字体文件版本、SIM 配置、默认数据卡和所有后台状态开关。
5. 因此，公开 JPEG 可辅助修正“很假”的家族通用布局，但不能作为逐像素对比的最终基准。

五、pixel PASS 硬门禁

以下条件必须全部满足，缺少任一条都必须保持待验：

1. 原始基准
   - 由目标手机本机截图功能直接生成的无损 PNG。
   - 保留原始尺寸、色彩配置／元数据和 SHA-256。
   - 不经聊天软件、社交平台或文档嵌入二次压缩。
   - 如需脱敏或裁剪，同时保存原始文件哈希，并把裁剪矩形和变换记录为可重放数据。

2. 设备与 ROM 元数据
   - 商业型号与完整硬件型号。
   - ROM 名称、完整版本号／build、安全补丁日期和地区。
   - 分辨率、屏幕缩放／显示大小、字体大小、深浅色和主题。
   - 12／24 小时制、系统语言、电量百分比显示方式。
   - SIM 数量、运营商、默认数据卡、漫游、网络制式、信号级别和 Wi-Fi 状态。
   - 勿扰、静音／振动、闹钟、NFC、VoLTE／HD、VPN、蓝牙、热点、网速、充电／省电等所有可见状态的明确开关。
   - 如存在应用通知，记录应用包名、精确 App 版本、通知通道、small-icon 资源链和 OEM 通知图标显示／美化设置。

3. 字体闭合
   - 记录目标 OEM 字体文件的完整名称、版本、字重和 SHA-256。
   - 在预览中记录请求字体、实际命中字体和第一后备字体。
   - 不把只是同名家族、不同版本／字重、浏览器合成伪粗体或系统后备写成真机字体。
   - 本扩展不打包、复制或分发未获授权的 MiSans、OPPO Sans、vivo Sans 或其他 OEM 字体。字体需由用户从有权来源安装并确认使用范围。

4. 目标浏览器闭合
   - 必须在用户本机元桌浏览器 Chromium 101 中加载当前候选版。
   - 页面缩放必须为 100%；CSS 视口、窗口尺寸、DPR 和截图区域必须实测并记录。
   - 页面底图、状态栏透明度、深浅色和所有配置必须与目标 PNG 相同。
   - 较新 Edge／Chromium 的截图只能作为渲染回归与开发预览，不能填充 Chromium 101 验收结果。

5. 像素对比闭合
   - 为每个固定场景分别保存基准 PNG、输出 PNG 和 diff PNG。
   - 保存对齐／裁剪矩形、任何颜色转换、算法版本、阈值、差异像素数、最大通道差和差异包围盒。
   - 基准与输出必须是相同物理像素尺寸；不允许用任意非整数缩放将输出拉伸到基准后再声称通过。
   - 阈值必须在看到最终结果之前锁定；不允许为了把当前图片变绿而临时放宽。
   - pixel PASS 只适用于已记录的单一机型、单一 ROM build、单一字体／主题／状态组合，不可外推为整个系统家族已通过。

六、结果状态与用词

1. `tuning-only`：只有公开 JPEG 或其他有损／不完整样本；可调几何，不可像素通过。
2. `target-rom-pending`：缺目标 ROM build 或完整场景元数据。
3. `font-missing`：未命中目标 OEM 字体。
4. `font-unverified`：命中了家族名，但版本、字重、文件哈希或渲染环境未闭合。
5. `chromium101-pending`：未在用户本机元桌 Chromium 101 中生成并存档匹配输出。
6. `pixel-fail`：硬门禁已齐备，但锁定阈值下差异超限。保留 diff 与失败证据，在后续增量版本修正。
7. `pixel-pass`：所有硬门禁已齐备，目标场景在事先锁定的像素阈值下通过，并完整存档基准、输出、diff、环境和结果。

本版当前三个精确机型的最高允许结论均为：`tuning-only`。
在用户提供原始无损真机 PNG、精确 ROM／build 与场景元数据，安装并闭合对应 OEM 字体，并在用户本机元桌 Chromium 101 生成匹配输出之前，不得宣称任一款机型已完成“真机像素级复刻”或 pixel PASS。

七、待用户提供的最小验收包

1. 每款目标手机至少一张与上述固定场景完全相同的本机原始无损 PNG。
2. “设置 > 关于手机”中的精确型号、ROM 全版本／build 与安全补丁信息，可对敏感设备标识做遮挡。
3. 显示大小、字体大小、字体样式、主题、状态栏图标显示方式与电量百分比设置。
4. SIM、运营商、网络、Wi-Fi、电量、充电、勿扰、静音、NFC、VoLTE／HD、网速和通知状态的文字记录。
5. 如样本带应用通知，提供应用名、安卓包名、App 版本、推送通道／类型和通知图标显示设置。
6. 元桌浏览器版本、Chromium 版本、扩展加载路径、扩展版本、页面缩放、视口尺寸与 DPR。

八、当前结论

1. v2.5.0 已建立三个窄范围精确机型调参目标，不再仅使用一套家族通用状态栏说明它们。
2. 三张参考 JPEG 的文件完整性、固定场景和不可外推边界已记录。
3. 当前证据只允许声称“按公开真机 JPEG 进行几何调参”。
4. 原始无损真机 PNG、精确 ROM build、完整场景元数据、精确 OEM 字体与元桌 Chromium 101 对比输出尚未闭合。
5. 因此，当前没有任何一款目标机型可以记录为 pixel PASS。
