订购与交付
适用于付款已完成但状态尚未更新、交付信息不完整、节点或租期与订单记录不一致等情况。
查看订单状态含义定位入口
先按问题类型选择排查路径
同一现象可能来自不同层级。先确认它属于订单、连接、环境、账单还是安全问题，再收集该层级需要的信息。
订单状态
状态决定下一步该检查什么
进入控制台后，先记录订单标识、当前状态、所选节点和租期到期时间。不要仅凭远程客户端的提示判断设备状态。
-
01
待确认
订单信息或付款结果正在确认。核对机型、周期、节点、附加项和 USD 应付总额是否与提交内容一致。
重点字段：订单标识、付款方式、创建时间 -
02
配置中
物理节点正在完成订单对应的配置。此阶段连接地址或凭据可能尚未完整显示，不应反复尝试旧地址。
重点字段：目标节点、配置状态、最新状态变化 -
03
可连接
连接信息已生成。使用控制台当前显示的地址、账户说明和连接方式，并确认客户端指向正确节点。
重点字段：连接地址、节点、到期时间 -
04
租期结束
当前租用周期已经结束，原连接信息不再代表有效服务。数据应在到期前迁出，后续订单以新的控制台记录为准。
重点字段：租期起止时间、最后迁出记录
节点目录与实时结果
ZoomMini M4 Core 与 ZoomMini M4 Plus 均提供新加坡、日本（东京）、韩国（首尔）、香港四个节点。实际可用性与下单结果以控制台实时返回为准。
连接排查
从网络可达性走到会话恢复
按顺序检查可以避免把本地网络问题误判为设备问题。每一步都保留发生时间、目标地址和错误原文。
$ ping -c 4 <host>
4 packets transmitted, 4 received
$ ssh -vvv user@<host>
debug1: Connecting to <host>
debug1: Server host key verified
$ nc -vz <host> <port>
Connection succeeded验证网络可达性
更换已知稳定的本地网络，记录目标地址、端口和超时结果。不要只用浏览器是否能访问其他站点作为判断。
核对账户凭据
确认用户名、密码或 SSH 密钥来自当前订单说明，检查复制时是否带入空格，不要连续重复提交错误凭据。
处理 SSH 指纹变化
先在控制台核对目标地址是否改变。确认目标无误后再移除对应的旧 known_hosts 条目，不要直接清空整个文件。
区分客户端与节点问题
使用另一台受信设备或另一种连接方式复测。若 SSH 可用而 VNC 不可用，应优先记录图形客户端版本与会话表现。
构建环境
按工具链依赖顺序检查
先确认系统实际选择的 Xcode，再检查签名、包管理器与 runner 权限。跳过前置检查会让后续错误失去参考价值。
-
01
确认 Xcode 版本与选择路径
执行
xcodebuild -version和xcode-select -p，核对项目要求的版本与当前开发者目录是否一致。 -
02
验证命令行工具
执行
clang --version与swift --version。若工具不存在或版本不匹配，先修正 Xcode 选择路径再重新测试。 -
03
核对证书与描述文件
确认构建用户能够读取所需签名材料，检查证书有效性、描述文件标识与项目配置。日志中只保留名称和错误类型，不附秘密内容。
-
04
检查 Homebrew 路径
Apple Silicon 环境通常需要确认
/opt/homebrew/bin已进入非交互 shell 的 PATH，并验证 runner 启动环境与终端环境是否一致。 -
05
验证 runner 最小权限
确认 self-hosted runner 对工作目录、缓存目录和构建产物目录具备必要权限，不要通过扩大整个系统权限掩盖单个路径问题。
$ xcodebuild -version
Xcode <required-version>
Build version <build-version>
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ command -v brew
/opt/homebrew/bin/brew
$ test -w "$RUNNER_WORKDIR"
$ echo $?
0
$ xcodebuild -scheme App build
** BUILD SUCCEEDED **
成功判定不要只看最后一行
同时检查命令退出码、实际产物路径、测试报告与签名步骤。缓存命中不等于构建成功，runner 在线也不等于具备工作目录权限。
术语小词典
八个高频术语的准确含义
这些词分别描述硬件归属、连接方式、自动化角色和订单边界。提交问题时使用准确术语，可以减少定位歧义。
- 物理节点
- 实际运行 macOS 工作负载的 Apple Silicon 硬件设备，也是订单连接地址与运行状态所对应的基础资源。
- 独享
- 一个有效订单对应一台独享物理机，计算、内存和本地存储不与其他客户会话共享。
- 非虚拟机
- 工作负载直接运行在订单对应的物理 Mac mini 上，不是从共享宿主机切分出的虚拟计算实例。
- VNC
- 用于访问 macOS 图形界面的远程显示协议，适合需要窗口操作、界面测试和可视化配置的任务。
- SSH
- 用于命令行操作、自动化执行、文件传输和诊断的加密连接方式，适合持续集成与脚本化工作流。
- self-hosted runner
- 部署在独享云端 Mac 上、由团队自行配置权限和工具链的自动化执行器，用于接收并运行流水线任务。
- 租期
- 订单约定的服务起止区间，可按天、周、月或季选择。连接信息、续租核对和数据迁出都应以该区间为准。
- 节点
- 设备所在的服务地区。当前目录包括新加坡、日本（东京）、韩国（首尔）和香港，共四个节点。
计费问答
续租前先核对账单结构
账单应把基础机型、周期、节点和附加项分开列示。支付网关的实际可用状态以控制台返回为准。
天、周、月、季如何计价？
订单按下单时选择的单一周期计价，不把不同周期混合拼接。续租前应重新确认机型、周期、节点、租期起止时间和应付总额。
SSD 与 Thunderbolt 5 并联如何列示？
+1TB SSD、+2TB SSD 与 Thunderbolt 5 并联按所选周期独立列示，不应被合并进基础机型名称。Thunderbolt 5 并联按每台设备计算，确认数量时应同时核对关联设备。
使用什么货币与支付方式？
全部订单以美元（USD）结算。仅支持 USDT-TRC20，以及 Visa / Mastercard / Amex（经 Stripe）；实际可用网关以控制台实时返回为准。
续租前必须检查哪些字段？
依次核对订单标识、基础机型、所选周期、目标节点、SSD 附加项、Thunderbolt 5 并联数量、USD 小计、应付总额和新的租期结束时间。若字段不一致，应在付款前提交工单。
付款后状态没有更新，应提供什么？
提供订单标识、支付方式、付款发生时间、控制台当前状态和已脱敏的交易参考信息。不要发送完整卡片信息、完整支付凭据或任何账户密码。
工单清单
提交能直接进入排查的信息
一个有效工单应回答“哪一笔订单、哪个节点、何时发生、如何复现、看到了什么”。敏感信息应先脱敏。
按以下顺序组织工单正文
-
01
订单标识与节点
写明控制台中的订单标识，以及新加坡、日本（东京）、韩国（首尔）或香港中的目标节点。
-
02
问题发生时间
提供带时区的首次发生时间、最近一次复现时间，以及问题是持续出现还是间歇出现。
-
03
复现步骤与预期结果
从进入控制台或执行命令开始逐步描述，并分别写出实际结果与预期结果。
-
04
环境与连接方式
注明本地系统、客户端版本、VNC 或 SSH、macOS 与 Xcode 版本，以及是否经过代理网络。
-
05
脱敏日志
保留错误码、命令、退出码和必要上下文，替换用户名、地址、令牌、仓库路径与支付参考中的敏感部分。