连接失败不一定来自网络，构建失败也不一定来自 Xcode。先按任务选择入口，再核对该类问题最有区分度的证据。
检查节点地址、端口、客户端网络、主机验证与远程 Mac 桌面参数。适合处理超时、黑屏、剪贴板不同步和输入延迟。
查看连接排查路径确认登录邮箱、实例归属、临时凭据是否已更新，以及命令或目录所需的本机权限。不要在支持信息中提交密码。
查看权限核对项核对 Xcode 路径、SDK、Scheme、工作区、依赖缓存和磁盘空间，并保存完整的 xcodebuild 退出码与首个错误位置。
查看构建诊断方法区分 Ruby 环境、Bundler、lane 参数、环境变量和签名材料问题。优先记录失败步骤名称，而不是只截取最后一行。
查看自动化日志重点分别测量延迟、抖动、丢包和目标端口连通性。不要只用一次 ping 判断线路，也要比较本地网络与其他接入网络。
查看网络测量顺序区分基础方案、租用周期、节点、存储扩展与 Thunderbolt 5 并联项目，并核对订单确认页和账单中的逐项金额。
查看账单核对方式以下六条路径同时保留在页面中。分类按钮只负责定位和高亮，不会把其他内容藏起来，方便在相邻问题之间交叉核对。
先在控制台确认实例处于可连接状态，并逐字核对节点地址和端口。随后从本地执行端口连通性测试；如果端口不可达，切换一次本地网络以区分节点问题与接入线路问题。SSH 首次连接时要核对主机指纹，凭据失败则确认用户名、密钥路径和文件权限。图形会话已建立但出现黑屏时，先降低分辨率和动态效果，再断开旧会话并重新连接。
先判断失败发生在控制台登录、本机登录，还是某条命令的权限检查。控制台用于查看订单、实例、账单和工单；节点内的本机权限则由当前用户、目录所有者和命令要求共同决定。若看到 Permission denied，记录目标路径、执行命令和当前用户，不要反复修改整个项目目录的权限。临时凭据完成首次登录后应及时更新，并避免在公共设备保存连接信息。
whoami、pwd 和目录权限信息确认执行上下文。先确认命令是在项目根目录执行，并区分 .xcodeproj 与 .xcworkspace。随后输出 Xcode 选择路径和可用 SDK，再核对 Scheme 是否共享、名称大小写是否一致。依赖更新后出现问题时，不要先删除全部缓存；应保存第一次失败日志，定位首个明确错误，再决定是否清理 DerivedData 或重新解析依赖。
先确认项目约定使用系统命令还是 bundle exec fastlane，并检查 Ruby、Bundler 与 Gemfile.lock 是否对应。日志中最后一行往往只是流程终止提示，真正原因通常更早出现。应从首个错误块向上保留上下文，标明失败 lane、action 和参数来源。环境变量只提交名称和是否存在，不提交真实值。
远程体验同时受延迟、抖动、丢包和可用带宽影响。先从日常使用地点分别测试新加坡、日本东京、韩国首尔与香港节点，选择中位延迟较低且抖动较小的路径。测试时固定本地网络、时间段和样本数；若无线网络结果波动明显，再用有线或另一接入网络复测。图形会话可降低分辨率、色彩质量和动态效果，命令与长任务则优先通过 SSH 分流。
账单核对应从订单确认页逐行进行：先确认 GPUMini M4 Core 或 GPUMini M4 Plus，再核对按天、周、月或季选择的周期、目标节点，以及是否添加存储扩展或 Thunderbolt 5 并联。不要只比较账单总额；总额相同也可能来自不同的周期与附加组合。所有金额均以美元结算，可用支付方式为 USDT-TRC20，或 Visa、Mastercard、Amex 经 Stripe 处理，实际可用网关以结算界面返回为准。
SSH、xcodebuild 与 Fastlane 的末尾都可能只显示“任务失败”。真正可用于判断的信息通常位于首次报错位置及其前后数行。
$ ssh -v build@node.example
debug1: Connecting to node [port 22]
debug1: Server host key verified
Permission denied (publickey).
↑ 常见失败位置：用户名、密钥路径或密钥权限
$ xcodebuild -workspace App.xcworkspace -scheme App build
Resolve Package Graph
xcodebuild: error: The workspace does not contain scheme "App".
↑ 常见失败位置：工作区选择或 Scheme 未共享
$ bundle exec fastlane build
[build] Running gym
Exit status: 65
↑ 继续向上查找首个 xcodebuild 错误块提交用户名、目标节点、端口、主机验证结果和完整错误行。私钥内容不得进入日志或工单。
提交工作目录、workspace 或 project、Scheme、destination、Xcode 版本和退出码。
提交 lane、action、依赖版本和首个错误块。环境变量只列名称及是否存在。
每完成一步再进入下一步，并记录结果。一次改动多个配置会让问题暂时消失，却无法确认真正原因。
登录控制台核对实例、节点代码和当前状态，确认正在查看正确订单。新加坡、东京、首尔和香港均为常态可订节点，实际可用状态以控制台实时返回为准。
检查域名解析、目标端口、延迟、抖动与丢包，并用另一接入网络复测。端口不可达和认证失败是两类问题，不应使用同一种处理方法。
逐字核对用户名、密钥路径、文件权限与主机指纹。不要在多次失败后盲目替换所有凭据，也不要把密码或私钥发送给支持团队。
检查系统卷剩余容量、DerivedData、依赖缓存、归档产物和临时目录。磁盘压力可能表现为构建中断、导出失败或工具异常退出。
从首个明确错误向前后扩展日志上下文，记录命令、目录、工具版本、退出码和复现步骤。只提交最后一行通常不足以定位问题。
GPUMini 的四个节点全年 365 天正常运行，不设置定期停机时段。若发生突发节点事件，状态信息会围绕受影响节点、开始时间、当前影响、处理进度与恢复结果更新。单个用户的网络、凭据、磁盘或项目配置问题不会被误写成整站事件。
查看状态时，先确认节点代码和实例状态，再比较自己观察到的时间范围。问题仍在持续时，不要只提交“无法连接”；应附上本地接入地区、连接方式、完整错误、首次发生时间和最近一次复现时间。
如何判断是否需要人工介入：同一问题在完成节点、网络、凭据、磁盘和日志检查后仍可稳定复现，或订单与账单项目存在明确差异时，应提交工单。一般咨询也可发送到 support@gpumini.com。
节点、发生时间、复现步骤和脱敏日志是处理技术问题的四项基础信息。账单问题还需提供订单编号与需要核对的账单行。
技术问题请准备节点、时间、复现步骤和脱敏日志；订单、实例与账单问题优先通过控制台工单关联处理。