云端 Mac 出现问题，按层排查，不靠猜

1. 01

   核对实例与本机环境

   先确认实例处于正常运行状态，并把控制台显示的主机地址与用户名分别写入本机环境变量。不要把密码、私钥或完整凭据写进仓库、聊天记录或自动化日志。

   export MAC_HOST="控制台显示的主机地址"
   export MAC_USER="控制台显示的用户名"
   test -n "$MAC_HOST" && test -n "$MAC_USER" && echo "connection variables ready"

2. 02

   首次连接并核对主机指纹

   执行连接后，将终端显示的指纹与控制台信息核对。主机地址发生变化、重装后指纹变化，或本机保存了旧记录时，不要直接忽略警告，应先确认实例是否仍是同一台设备。

   ssh -v "$MAC_USER@$MAC_HOST"
   ssh-keygen -F "$MAC_HOST"

3. 03

   生成并安装独立密钥

   建议为云端 Mac 单独生成 Ed25519 密钥，便于轮换和撤销。安装公钥后保留当前会话，再开启第二个终端验证密钥登录成功，确认无误后再结束原会话。

   ssh-keygen -t ed25519 -a 64 -f "$HOME/.ssh/macrents_build"
   cat "$HOME/.ssh/macrents_build.pub" | ssh "$MAC_USER@$MAC_HOST" 'umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys'
   ssh -i "$HOME/.ssh/macrents_build" "$MAC_USER@$MAC_HOST"

4. 04

   固定客户端配置并做基线检查

   为该实例设置独立别名、密钥路径和保活参数。进入系统后记录 macOS 版本、磁盘余量、当前用户与系统时间，后续构建失败时可快速判断是否发生环境变化。

   sw_vers
   whoami
   date
   df -h /
   uptime

xcode-select -p
xcodebuild -version
xcodebuild -showsdks
xcrun simctl list devices available
xcrun --find swift
swift --version
security list-keychains -d user
security find-identity -v -p codesigning

set -o pipefail
xcodebuild -workspace Project.xcworkspace -scheme Project -configuration Release -destination 'generic/platform=macOS' clean build | tee "$HOME/logs/xcode-build.log"
printf 'exit_code=%s\n' "$?"