每个入口都指向本页内的具体检查项。建议一次只改变一个变量，并记录改变前后的命令、版本和结果。
SSH 适合命令行、自动化与文件传输；VNC 适合需要 macOS 图形界面的任务。两者都应先核对节点地址，再验证凭据。
从订单交付信息中核对主机地址、端口、用户名与临时访问方式。不要从旧终端历史记录复制可能已经变化的地址。
先在可信网络中运行详细模式连接，核验主机指纹后再继续。指纹与交付信息不一致时立即停止。
把自己的 SSH 公钥写入授权文件，确认新会话可登录后，再移除不再使用的临时访问项。
先停止前台任务并确认日志已经写入，再使用 exit 退出。不要直接关闭仍在执行发布任务的终端。
超时先查网络与端口；拒绝连接查地址和服务状态；认证失败则查用户名、密钥权限和授权文件。
使用受信任的 VNC 客户端，按交付信息填写节点地址和端口。连接前关闭客户端中不必要的凭据记忆功能。
确认显示的是预期 macOS 图形界面，并核对地区与设备配置。画面异常时不要立即导入代码或证书。
替换临时密码后重新建立连接，验证新凭据有效。不要在团队聊天记录或构建脚本中保存完整凭据。
保存工作、关闭敏感窗口并退出会话。多人协作时记录当前占用者和正在运行的图形任务。
黑屏先重连并检查会话状态；卡顿先降低显示质量；无法建立连接则回到地址、端口和本地网络检查。
详细模式会告诉你连接停在网络、指纹还是认证阶段。下面的地址仅用于示例，实际连接信息以订单交付内容为准。
$ ssh -v -p 22 build@203.0.113.24
OpenSSH: reading configuration data
debug1: Connecting to 203.0.113.24 port 22
debug1: Connection established
debug1: identity file ~/.ssh/id_ed25519 type 3
The authenticity of host cannot be established.
ED25519 key fingerprint is SHA256:verify-with-delivery-record
Continue connecting only after fingerprint verification.
debug1: Server host key accepted
debug1: Offering public key: ~/.ssh/id_ed25519
debug1: Authentication succeeded (publickey)
Connected to the dedicated physical Mac node
$ sw_vers
ProductName: macOS
$ exit
Connection closed.先换到可确认正常的网络，再检查地址与端口是否准确。若多个网络都超时，记录发生时间、本地出口环境和完整日志。
停止连接，不要直接删除本地已知主机记录后重试。先核对订单节点与交付信息，再通过工单确认变化原因。
检查用户名、私钥路径、文件权限和公钥是否完整写入授权文件。提交日志时隐藏密钥内容，只保留认证阶段信息。
构建机最常见的环境漂移来自命令行工具路径、目标名称、依赖状态和签名变量不一致。先验证机器层，再进入项目层。
运行 xcode-select -p 查看当前路径，再用 xcodebuild -version 核对版本。切换版本后重新打开终端，让后续任务使用一致环境。
先执行 xcodebuild -list，确认 workspace、project、scheme 和 configuration 名称，再把准确名称写入自动化命令。
检查构建所需变量是否在当前会话中存在，避免把敏感值写入仓库。只输出变量是否存在，不在日志中回显完整内容。
为每次任务保留命令、开始时间、退出码、构建日志和产物路径。失败时同时保留首次错误附近上下文，不只复制末尾摘要。
runner 接入的重点不是只让第一条任务成功，而是让后续任务知道该落到哪台节点、使用哪个目录，并在停用时清理注册关系。
创建专用运行身份与工作目录，确认该身份可以读取仓库、写入构建目录，但不默认拥有与构建无关的管理权限。
标签应描述地区、芯片族、Xcode 主版本和用途，不要使用“最新”“最快”这类会随时间失真的标签。
不同仓库或流水线使用独立子目录，缓存目录单独管理。任务结束后清理临时文件，但保留仍需复用且来源明确的缓存。
先从单任务执行开始，观察 CPU、内存、磁盘和构建耗时，再决定是否增加并发。图形任务与重型构建不应无记录地同时运行。
先停止接收新任务，等待当前任务完成，再从自动化平台注销 runner，移除注册令牌与不再需要的工作目录。
工单和团队文档使用同一组术语，可以减少把网络、设备、会话与构建工具混在一起描述的情况。
先展开最接近的症状。完成一个检查点后再进入下一个，不要在没有结果记录时跳过中间步骤。
ssh -v 判断是否已经建立网络连接、是否通过指纹检查以及认证停在哪一步。xcode-select -p 与 xcodebuild -version 输出。df -h 查看卷级空间，不要只看单个项目目录。先整理事实，再通过控制台提交。完整上下文通常比多次补充零散截图更快定位问题。
提供必要的订单标识即可，不发送支付凭据或其他无关信息。
注明新加坡、日本（东京）、韩国（首尔）或香港，以及实际连接方式。
写明时区、首次出现时间、持续时长，以及是否能够稳定复现。
保留命令、退出码和错误上下文，隐藏令牌、密码、私钥与完整凭据。