远程 Mac 桌面色彩与 HiDPI 验收基线

远程连接云端 Mac 后，设计稿里的灰色看起来偏蓝，模拟器文字边缘也比本地模糊。此时先不要改颜色值或替换图片。远程桌面呈现的是“应用渲染结果经过传输，再由本地屏幕显示”的最终画面，任一环节都可能引入缩放、压缩或色彩转换。正确做法是先保存云端原件，再逐层定位差异。

先把三层变量拆开

一次远程视觉验收至少包含三层：

1. 云端 Mac 实际生成的像素，包括应用窗口、模拟器截图和导出文件。
2. 远程连接对画面执行的缩放、色深转换与压缩。
3. 本地设备的显示缩放、色彩描述文件和客户端窗口尺寸。

如果只对着远程画面截图，第二层和第三层会一起进入证据，后续无法判断问题来自哪里。建议为每次验收建立一个目录，分别保存系统信息、云端原始截图和本地观察记录。

mkdir -p "$HOME/visual-baseline"/{system,source,notes}
system_profiler SPDisplaysDataType \
  > "$HOME/visual-baseline/system/displays.txt"
system_profiler SPColorSyncDataType \
  > "$HOME/visual-baseline/system/colorsync.txt"
sw_vers > "$HOME/visual-baseline/system/macos.txt"

这些文件不用于比较性能，而是回答三个基础问题：当时用了什么系统版本、桌面输出尺寸是什么、系统识别到了哪些色彩配置。

远程桌面适合操作和快速复核，但远程画面的肉眼观感不能替代云端生成的原始文件。

固定分辨率与缩放关系

模糊最常见的原因不是资源分辨率不足，而是逻辑尺寸、物理像素和客户端窗口没有按整数关系缩放。先在显示设置中选择固定档位，记录“看起来像”的逻辑尺寸，再从系统报告确认实际输出像素。验收期间不要频繁切换分辨率。

客户端侧优先使用一比一显示。窗口放不下时，可以暂时缩放用于操作，但截取证据前应恢复原始比例。若客户端提供“适应窗口”和“拉伸填满”，应区分两者：前者通常保持宽高比，后者可能让圆形、字体和像素网格发生形变。

建立可复用的测试画面

基准画面应同时包含小字号文字、单像素线、圆角、透明阴影、灰阶和连续渐变。不要只用一张颜色鲜艳的首页，因为高对比大色块很难暴露缩放误差。测试画面应固定内容、固定窗口尺寸，并记录生成它的提交版本。

如果目标是 iOS 界面，优先直接从已启动的模拟器导出原始截图：

mkdir -p "$HOME/visual-baseline/source"
xcrun simctl io booted screenshot \
  "$HOME/visual-baseline/source/simulator.png"
sips -g pixelWidth -g pixelHeight -g profile \
  "$HOME/visual-baseline/source/simulator.png"
shasum -a 256 "$HOME/visual-baseline/source/simulator.png"

哈希用于确认团队成员拿到的是同一文件，不代表两张视觉相同的图片一定应有相同哈希；重新保存图片可能改变元数据或编码。

用原始截图判断问题属于哪一层

先把云端生成的 simulator.png 下载到本地，不经过聊天软件预览或二次转码。使用能够按一比一像素显示的查看方式检查文字边缘、细线和渐变。

若原始文件清晰，而远程桌面模糊，应用无需修改，问题在传输或客户端缩放层。若原始文件同样模糊，再检查图片资源倍率、布局是否落在非整数像素、文本栅格化方式以及截图目标设备。若只有本地某台显示器看起来偏色，则应对照文件的色彩描述与本地显示设置，而不是直接改设计色值。

可以按以下顺序留档：

01-source.png        云端工具直接生成的原始图
02-remote-view.png   远程客户端看到的画面
03-local-view.txt    本地屏幕、缩放和客户端设置
04-system.txt        云端显示与色彩环境

对比时一次只改变一个变量。例如先保持云端分辨率不变，只切换客户端缩放；确认结果后，再测试另一种色深或压缩档位。多项设置同时变化会让结论失去可复现性。

处理偏色而不破坏系统基线

色彩问题应先确认文件是否携带描述信息。sips -g profile 能快速查看图片关联的配置，但不能证明整个传输链完全正确。若导出工具允许指定输出色彩空间，应在项目规范中固定选择，并让自动化任务和人工导出使用同一规则。

不要为了让远程预览“看起来接近本地”而随意替换云端系统的默认显示配置。这样可能让一个客户端看起来正常，却影响截图、视频导出或另一位成员的会话。更稳妥的做法是保持云端基线稳定，在本地客户端记录显示模式，并始终以原始产物做最终判断。

对半透明阴影与深色渐变，还要警惕远程压缩造成的色带。可在原始图中放大检查：原图平滑而远程画面出现断层，说明无需调整应用渐变；原图已有明显断层，才进入资源位深、导出参数或渲染流程排查。

把验收流程写进交接清单

团队应把视觉基线与代码版本绑定，而不是依赖某位成员记住客户端设置。每次更换系统版本、远程客户端、显示分辨率或截图目标设备后，都重新生成一组基准文件。

交接前至少确认：

• 云端系统版本和显示报告已经保存。
• 远程桌面使用固定分辨率，客户端没有非等比拉伸。
• 模拟器或应用直接生成了原始截图。
• 原始图的像素尺寸、色彩描述和哈希已经记录。
• 判断模糊或偏色前，已分别检查原始渲染、传输画面和本地显示。
• 缺陷记录包含提交版本、目标设备、客户端设置和最小复现步骤。
• 所有临时测试文件已移出项目产物目录，避免进入正式归档。

在 VMOak 的远程 Mac 上执行这套流程时，也应把连接体验和产物验收分开：前者关注操作是否顺畅，后者关注云端生成的文件是否满足规范。只要证据始终从原始产物开始，远程压缩、HiDPI 缩放和真实渲染缺陷就不会混成同一个问题。

常见问题