面向首次连接、VNC 会话、Xcode 构建和订单问题的操作指南。按本地网络、节点状态、连接信息、客户端和任务日志逐层检查，不依赖模糊重试。
六个入口同时可见。选择入口只负责带你到对应检查项，不会隐藏其他指南。
从本地网络、目标地址、客户端版本和会话占用开始检查。
进入连接排查 凭据确认地址、账户名和凭据属于同一订单，避免复制多余空格。
核对首次使用路径 性能分别记录网络延迟、桌面画质设置和任务资源表现，不混为一个结论。
查看观察顺序 订单准备订单编号、计费周期、美元金额和支付结果，再提交控制台工单。
查看人工支持流程 存储记录所选附加项、系统识别结果、挂载路径和首次出现问题的时间。
准备请求信息 构建保留版本、标签、工作目录、完整日志和最小复现步骤。
进入构建排查每一步都有明确的确认结果。前一步没有通过时，先保留现场信息，不要同时更改多个变量。
登录控制台，打开对应订单，确认节点已进入可连接状态，并核对区域与购买时选择一致。
分别复制服务器地址、账户名和连接凭据。不要把字段合并保存，也不要在公开文档或聊天记录中传播。
在可信 VNC 客户端中填写目标地址和账户名，先使用默认画质建立会话，再根据实际网络调整分辨率与色彩质量。
进入 macOS 图形界面后，确认键盘输入、显示缩放、终端打开和项目目录访问正常，再开始同步工程或启动 runner。
先判断问题发生在本地、目标信息、凭据、客户端还是现有会话。记录每一步结果，比连续重连更容易定位。
| 顺序 | 检查对象 | 具体操作 | 需要记录 | 通过判据 |
|---|---|---|---|---|
| 01 | 本地网络 | 切换到已知稳定网络，确认防火墙或代理没有拦截 VNC 连接。 | 网络类型、是否使用代理、失败时间 | 同一网络下目标地址可达 |
| 02 | 目标地址 | 从当前订单重新复制服务器地址，不使用旧截图或其他订单保存的地址。 | 订单编号、节点区域、地址字段来源 | 地址与当前节点记录一致 |
| 03 | 连接凭据 | 分别核对账户名和凭据，检查复制内容前后是否带有空格或换行。 | 错误文本，不提交实际密码 | 客户端不再返回认证错误 |
| 04 | 客户端版本 | 记录客户端名称、版本和显示设置，必要时用另一款可信客户端交叉验证。 | 客户端版本、操作系统版本、画质设置 | 相同信息可建立稳定会话 |
| 05 | 会话状态 | 检查是否已有会话占用、画面冻结或客户端仍保留失效连接。 | 断线前操作、重连表现、会话时间 | 关闭旧会话后可重新连接 |
输入延迟、画面刷新慢和构建任务耗时是三个不同指标。分别记录网络条件、VNC 画质设置和任务日志，避免把所有现象归结为节点性能。
先保存失败现场，再建立最小复现。以下六项应来自同一次失败任务，不能把不同时间的日志混在一起。
记录 Xcode 完整版本、命令行工具选择结果和任务实际调用的构建命令。
判断重点 同一项目在固定版本下能否重复失败。保留失败步骤之前和之后的上下文，不只截取最后一行错误。
判断重点 错误来自依赖、编译、测试、导出还是脚本阶段。记录时区、开始时间、失败时间和任务持续时长，方便与节点记录对应。
判断重点 问题是否集中在固定步骤或固定持续时间后出现。确认工作流匹配到预期标签，并记录工作目录、缓存目录和执行账户。
判断重点 任务是否被路由到正确的 self-hosted runner。移除无关脚本和并发任务，用最少命令复现同一个错误。
判断重点 失败是否依赖当前项目配置、缓存或环境变量。在同一节点用干净工作目录复测，或让一个最小示例执行相同工具链。
判断重点 最小示例也失败时，再按节点环境问题提交工单。仅特定分支、依赖、缓存或脚本失败，干净示例可以运行。
多个独立项目在相同工具步骤失败，且最小示例能够稳定复现。
使用明确术语可以减少“机器、实例、服务器”混用带来的来回确认。
一份可处理的请求需要订单上下文、发生时间、完整错误和已尝试步骤。敏感凭据不属于排查材料。
用于定位订购记录，不要只写机型名称。
写明新加坡、日本东京、韩国首尔、香港、美国东部或美国西部。
填写 BookAMini M4 Core 或 BookAMini M4 Plus。
包含日期、时间和时区，便于对应节点记录。
复制原始文字，保留错误码和上下文，不只描述“无法使用”。
按执行顺序列出，并说明每一步得到的结果。
说明每次发生、偶发，或只在特定项目和网络下发生。
已有订单的问题优先走控制台工单，以便关联订单、节点和后续补充记录；无法登录控制台时使用支持邮箱。
在控制台创建工单，选择对应订单并附上区域、机型、时间、错误文本、日志片段和复现步骤。
支持人员根据证据判断问题所属范围。信息不足时，工单会列出需要补充的具体字段。
补充新日志时注明新的发生时间和测试条件，不要为同一问题重复创建多个工单。
在控制台查看处理进度、建议操作和需要验证的结果。完成验证后，在原记录中确认是否恢复。
BookAMini M4 Core 与 BookAMini M4 Plus 均为云端 Mac 独享物理机、非虚拟机。订单以美元结算，可用状态以控制台实时返回为准。