首次连接
收到交付信息，但还没有进入桌面
先核对节点地址、远程访问方式、初始凭据和客户端版本。确认键盘布局与分辨率后，再传输代码、证书或媒体素材。
查看连接流程
先定位，再处理
把云端 Mac 问题拆成可执行的排查步骤
先确认问题属于连接、构建、权限、磁盘、账单还是服务状态，再按顺序收集节点信息和错误输出。已有订单的技术问题可登录控制台提交工单。
- 排查入口
- 6 类问题
- 服务目标
- 99.9% 可用率
- 人工渠道
- 控制台工单与支持邮箱
任务登记板
先记录现象，再改变环境
可执行清单
CONNECT
无法首次接入
核对节点地址、远程方式、凭据状态与客户端兼容性
路径 01
BUILD
Xcode 或自动化任务失败
保留完整命令、退出码、工具链版本和签名阶段输出
路径 02
BILLING
费用或续订不明确
对照订单周期、附加项数量、付款状态与 USD 应付金额
路径 03
问题分流
按现象选择第一条排查路径
不要同时修改网络、工具链和权限。每次只改变一个条件，并记录改变前后的结果，才能判断真正原因。
连接中断
会话卡顿、黑屏或重连后状态异常
记录客户端名称、网络类型、发生时间和是否能通过命令行访问。先排除本地网络抖动，再调整显示参数或重新建立会话。
查看连接排查
Xcode 构建
编译、归档或签名阶段失败
保留执行命令与完整退出码，依次核对磁盘容量、证书有效性、Keychain 权限、依赖缓存和 Xcode 版本。
查看构建排查
自动化任务
Runner、脚本或打包流水线执行异常
确认执行用户、工作目录、环境变量、密钥读取范围和清理脚本。对比交互式 shell 与自动化进程使用的实际环境。
查看命令示例
磁盘扩展
容量不足或附加存储未确认
先用系统命令确认卷容量与可用空间，再核对订单中的 +1TB SSD 或 +2TB SSD 附加项。不要只依据项目目录大小判断剩余容量。
查看附加项计费
账单问题
付款状态、续订周期或应付金额不一致
准备订单编号、租用周期、机型、节点、附加项数量和支付方式。应付金额与实际可用网关以控制台实时返回为准。
查看账单帮助
交付后第一步
先完成五项核对，再迁移工作内容
交付信息可用于确认节点和接入方式，但项目是否能稳定构建还取决于工具链、权限与依赖是否一致。
-
01
核对节点信息
确认订单编号、节点区域、主机地址与交付的远程访问方式属于同一台云端 Mac。
-
02
确认账户权限
检查当前用户是否拥有项目目录、构建目录和必要系统设置的访问权限，避免直接扩大权限范围。
-
03
验证远程会话
检查键盘映射、显示缩放、剪贴板需求与会话重连行为，确认安全退出后再进行长时间任务。
-
04
记录系统与工具版本
保存 macOS、Xcode、命令行工具和包管理器版本，后续排查时以这组基线复现环境。
-
05
小批量验证依赖
先拉取最小项目或测试分支，验证依赖安装与构建目录，再迁移证书、缓存或大体积素材。
命令输出样例
保留命令、阶段和退出结果
工单中的“构建失败”不足以定位问题。请复制失败命令前后的关键输出，并说明同一命令是否能在交互式会话中复现。
$ ssh build-user@node-address
Last login: current session
$ sw_vers
ProductName: macOS
ProductVersion: [当前系统版本]
$ xcodebuild -version
Xcode [当前安装版本]
Build version [当前构建号]
$ xcodebuild -workspace Project.xcworkspace \
-scheme Project \
-configuration Release \
-destination "generic/platform=iOS" \
archive
note: Resolving package dependencies
note: Compiling target Project
error: Build input file cannot be found
** ARCHIVE FAILED **
exit status: 65
$ bundle exec fastlane ios build
[fastlane] Loading configuration
[fastlane] Running build lane
[fastlane] Step failed: archive
[fastlane] Preserve the complete log and exit code
SSH 验证
证明节点可达，并记录当前执行用户。
Xcode 输出
保留 scheme、configuration、destination 与退出码。
Fastlane 输出
说明失败 lane、具体 step 和同次执行的完整日志位置。
构建故障
按依赖关系从底层条件开始检查
磁盘不足会引发缓存、依赖解压和归档异常；工具链不一致又会放大签名问题。建议严格按以下顺序执行。
-
01
磁盘容量
运行
验证结果：构建目录具有足够可用空间df -h查看系统卷与工作卷的实际可用空间，再检查 DerivedData、归档、包管理器缓存和旧产物。 -
02
签名证书
确认项目选择的签名身份、描述文件、Bundle Identifier 和构建配置互相匹配，不要只检查证书文件是否存在。
验证结果：目标配置能找到对应签名身份 -
03
Keychain 权限
比较交互式会话与自动化进程的执行用户，确认任务能够读取所需签名材料，并记录权限失败发生在哪个阶段。
验证结果：自动化用户能读取必要项目 -
04
依赖缓存
先保留锁文件和失败日志，再按项目工具清理对应缓存。不要同时删除全部缓存，否则无法判断损坏来源。
验证结果：依赖解析可重复且版本一致 -
05
Xcode 版本
记录
验证结果：图形界面与命令行使用同一工具链xcodebuild -version与xcode-select -p，确认命令行任务实际使用的版本与项目要求一致。
先复制错误，再执行清理
清理 DerivedData、依赖缓存或归档目录会改变现场。提交工单时应同时说明清理前错误、清理动作和清理后的结果。
远程访问
区分本地网络、客户端和节点会话
远程画面异常不等于节点离线。先判断命令行是否可达，再检查客户端兼容性和显示设置，最后处理会话重连。
| 观察到的现象 | 优先检查 | 验证结果 |
|---|---|---|
| 客户端无法建立会话 | 核对节点地址、客户端版本、网络出口限制与交付的远程方式 | 同一节点能通过受支持方式建立连接 |
| 画面间歇卡顿或输入延迟 | 记录本地网络类型、抖动发生时间、是否使用代理以及当时传输任务 | 降低并发传输后能判断是否为本地链路问题 |
| 分辨率或缩放异常 | 检查客户端缩放策略、目标分辨率和会话内显示设置 | 文字与交互区域可完整显示且不被裁切 |
| 快捷键与预期不一致 | 确认本地键盘布局、修饰键映射和客户端快捷键拦截设置 | 常用组合键在测试编辑器中输出一致 |
| 重连后停留在旧画面 | 确认旧会话是否仍在运行，记录命令行可达性并重新建立客户端会话 | 新会话显示当前系统状态且输入可响应 |
| 结束工作后仍保留会话 | 保存任务、停止敏感进程、锁定屏幕并从客户端安全退出 | 会话关闭且后续接入需要重新验证 |
工单中应附什么
客户端名称与版本、本地网络类型、节点、发生时间、画面现象、命令行是否可达，以及已经尝试的重连步骤。
工单中不要附什么
不要提交密码、私钥正文、访问令牌或未脱敏的签名材料。需要说明凭据问题时，只描述错误类型和发生阶段。
服务状态与 SLA
用目标、记录范围和申请条件理解可用率
SetMini 采用 99.9% 可用率目标。节点全年 365 天正常运行，不设置定期停机安排；实际事件记录和节点状态以控制台返回为准。
账单帮助
先对照租期、附加项和付款状态
所有订单均以 USD 结算。实际可用付款网关和订单状态以控制台实时返回为准，提交账单工单时请附订单编号。
按天、周、月或季确认续订
续订金额取决于所选机型、租用周期、节点和附加项。不要用日价简单乘算其他周期，四种周期均有独立目录价格。
查看完整价格两类渠道，统一使用 USD
- USDT-TRC20按订单页返回的信息完成付款
- 银行卡Visa / Mastercard / Amex，经 Stripe 处理
付款状态、可用网关和应付金额以控制台实时返回为准。
| 附加项 | 每天 | 每周 | 每月 | 每季 |
|---|---|---|---|---|
| +1TB SSD | $2.4 | $6.4 | $11.8 | $32.1 |
| +2TB SSD | $4.8 | $12.8 | $23.6 | $64.2 |
| Thunderbolt 5 并联，每台 | $1.5 | $4.1 | $7.6 | $20.7 |
01
订单编号
用于确认机型、周期和附加项。
02
节点
填写区域代码与主机标识。
03
发生时间
注明时区，并给出开始与结束范围。
04
错误输出
附完整命令、退出码和关键日志。
05
已执行步骤
按顺序说明每次修改及其结果。