核对 macOS 与 Xcode 版本
记录 macOS 版本、Xcode 完整版本、当前命令行工具路径和项目要求。图形界面与命令行读取到的工具链应保持一致。
- 确认项目要求的最低与目标系统版本
- 确认当前选择的 Xcode 与命令行工具一致
- 先用最小工程执行编译和测试
连接与构建支持
先定位问题所在，再提交可复现的节点记录
这里覆盖云端 Mac 的首次连接、远程桌面、SSH、macOS、Xcode、CI Runner、存储扩展和订单处理。建议按登记板顺序核对，避免同时改动网络、凭据与构建环境。
SUPPORT ROUTE
问题分流登记
按顺序核对
01
连接入口
核对主机信息、用户名与访问方式
输入
02
节点状态
以控制台返回的节点记录为准
确认
03
本地到节点网络
分别检查解析、端口与链路稳定性
测量
04
工具链与任务
固定版本后用最小任务复现
复现
工单最小信息集
订单标识 + 区域 + 时间 + 脱敏日志
4 FIELDS
选择入口
按当前卡点进入对应检查路径
如果问题横跨多个环节，从首次连接开始逐项排除。每次只改变一个变量，并保留改变前后的现象与时间。
连接诊断
五步缩小连接问题范围
不要一开始重装客户端或重置环境。先确认登记信息，再逐层判断问题发生在凭据、节点、本地网络、客户端还是具体会话。
-
01
先确认输入
确认凭据对应当前节点
从控制台重新读取订单标识、节点区域、主机信息、用户名和凭据生成状态。不要继续使用旧工单、旧截图或团队成员转发的历史连接信息。
-
02
再确认节点
读取节点在线状态
检查控制台中的节点记录是否已进入可访问状态。交付登记仍在进行时，保留当前记录，不要重复创建连接配置或连续更换凭据。
-
03
测量链路
分离网络连通性问题
在当前网络与另一条可信网络上分别测试主机解析和目标端口。记录测试时间、网络类型与结果，不用单次延迟数字代替完整判断。
-
04
固定客户端
核对客户端设置
确认连接协议、主机字段、端口、用户名和凭据选择没有错位。远程桌面问题还应区分会话建立、画面更新、键盘映射与本地显示设置。
-
05
形成证据
收集最小复现日志
保留错误原文、发生时间、复现步骤和客户端版本。SSH 可提供脱敏后的详细连接输出；远程桌面可记录从发起连接到报错出现的完整顺序。
系统与工具链
先固定版本，再定位项目差异
系统升级、Xcode 切换和依赖更新会同时改变多个变量。开始处理前，先记录当前环境，再用最小项目验证基础工具链。
安装前确认兼容范围
更新系统、Xcode、包管理器或编译依赖前，先核对项目兼容性、磁盘余量和回退材料。不要在正在运行的关键任务中途切换版本。
- 保存当前版本与依赖锁定文件
- 确认新版本所需空间与下载来源
- 为验证任务建立独立工作目录
规划缓存目录
把源码、依赖缓存、编译中间文件、测试结果和最终产物分开。这样可以判断磁盘增长来自项目内容、缓存命中变化还是构建产物。
- 为缓存设置明确路径和清理条件
- 不要把最终产物只留在临时目录
- 清理前记录目录大小与任务影响
隔离项目环境
不同仓库、分支和实验任务应使用独立目录、依赖锁定与环境变量集合。出现问题时，用同一提交和同一依赖版本复现。
- 按仓库或任务划分工作目录
- 记录环境变量来源但不提交敏感值
- 使用可重复执行的初始化脚本
CI/CD 排查
Runner 离线时，先看控制面再看构建脚本
将接单问题、签名环境、缓存、并发和磁盘分开检查。一个任务同时改 Runner 配置、依赖和缓存策略，会让结果难以复现。
RUNNER
输出：在线记录与队列截图
Runner 无法接单
检查进程状态、任务标签、项目授权、队列分配和最近一次心跳记录。确认 Runner 实际绑定的仓库或组织范围。
SIGNING
输出：失败步骤与错误原文
签名步骤失败
核对签名材料是否完整、权限是否正确、脚本读取路径是否一致。工单仅提供脱敏错误与材料类型，不提交任何敏感凭据。
CACHE
输出：缓存键与命中变化
缓存失效或构建变慢
比较缓存键、依赖锁定文件、命中记录与工作目录。先用一次禁用缓存的最小任务确认问题是否确实来自缓存层。
QUEUE
输出：队列顺序与并发数
并发任务互相阻塞
检查同时运行的任务数、共享目录、端口、模拟器资源和产物路径。为并行任务分配独立工作区，避免互相覆盖。
DISK
输出：目录占用对照
磁盘占用持续增加
分别统计源码、依赖、缓存、中间文件、日志和产物目录。清理前确认任务是否仍在使用对应目录，并保存必要产物。
存储与扩展
按实际工作集评估容量与 Thunderbolt 5 并联
评估时应同时计算源码、依赖缓存、编译中间文件、测试数据、素材、模型和最终产物。扩展选项用于明确的容量或并联需求，不替代项目备份。
STORAGE CHECK
变更前需要确认的四项信息
- 当前机型、节点区域与订单标识是否准确
- 现有空间、预计新增数据量和缓存增长速度
- 扩展用于长期数据、临时工作集还是批处理素材
- Thunderbolt 5 并联设备数量、连接方式与任务依赖
需要变更现有订单时，进入控制台提交工单并关联订单记录。不要在任务运行期间自行调整存储路径或拔除正在使用的设备。
TB5
以每台并联设备计价
适合并联的任务
大型素材批处理、明确依赖外接高速存储的工作流，以及需要独立工作盘的长期任务。先确认软件、文件系统和任务路径能够正确使用并联设备。
BACKUP
先确认数据去向再变更
节点本地副本不是唯一副本
项目仓库、签名材料、模型、素材和构建产物应按团队策略保留独立副本。扩容解决工作空间问题，不代替版本管理和备份流程。
| 附加项 | 每天 | 每周 | 每月 | 每季 |
|---|---|---|---|---|
| +1TB SSD | $2.6 | $7 | $12.9 | $35.1 |
| +2TB SSD | $5.2 | $14 | $25.8 | $70.2 |
| Thunderbolt 5 并联，每台 | $1.9 | $5.2 | $9.7 | $26.4 |
支持请求模板
一次提交足够定位的信息
清晰的请求应让支持人员知道哪一个订单、哪一个区域、什么时候发生、如何复现以及期望看到什么。只有“连接不上”或“构建失败”通常不足以开始定位。
REQUEST RECORD
复制后填写
节点问题登记单
- 订单标识
- 填写控制台中与问题节点对应的订单标识。
- 节点区域
- 新加坡、日本（东京）、韩国（首尔）或香港。
- 发生时间
- 写明当地时间、时区，以及问题是否持续发生。
- 复现步骤
- 从正常状态开始，按实际操作顺序逐步列出。
- 脱敏日志
- 保留错误原文，移除密码、密钥、令牌和项目机密。
- 期望结果
- 说明原本应出现的状态、输出或任务结果。
GOOD SIGNAL
信息应与同一次复现对应
建议一并提供
客户端版本、macOS 与 Xcode 版本、Runner 标签、失败任务标识、网络类型，以及问题发生前最后一次成功操作。
REMOVE FIRST
只提交定位所需的最小证据
提交前必须移除
密码、私钥、访问令牌、签名材料原文、支付凭据、完整环境变量文件和未经处理的项目源代码。
账户与订单
支付、账单与节点记录从控制台处理
订单金额由所选机型、租用周期、节点区域和附加项组成。现有订单问题应通过控制台提交，以便工单自动关联账户与节点记录。
支持哪些支付方式与结算币种？
仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe）。所有订单统一以美元（USD）结算，实际可用网关以控制台返回为准。
订单金额由哪些部分组成？
金额由基础机型、按天／周／月／季选择的租用周期、节点区域和已选择的存储或 Thunderbolt 5 并联附加项组成。提交前应逐项核对账单明细。
连接或配置问题为什么建议从控制台提交？
控制台工单可以关联订单标识、节点区域和交付记录，减少来回确认。提交时仍需补充发生时间、复现步骤、脱敏日志与期望结果。
团队成员变动后应如何处理访问凭据？
及时检查团队授权范围，更新相关凭据并撤销不再需要的访问。不要在邮件、聊天记录或工单中发送未经脱敏的凭据内容。