确认区域与连接入口
核对订单中的 SG、JP、KR 或 HK 节点代码，并记录交付地址。节点会影响访问路径，但不应通过修改项目依赖来掩盖网络问题。
- 验证点
- 订单节点与交付节点一致
- 记录项
- 节点代码、测试来源网络
从核对事实开始排查
把交付、连接与构建问题拆成可执行步骤
先确认物理节点、配置、租期和凭据，再检查网络、开发环境与任务日志。每一步都给出输入、验证点和完成标准，适用于首次启用、日常构建与故障定位。
需要连接方式说明时，可先阅读远程访问流程；涉及现有订单时，请在工单中附上订单号与节点代码。
任务登机检查板
BUILD SUPPORT / 04
排查顺序已就绪
输入
验证
恢复
机器与节点
配置、区域、租期逐项匹配订单
先核对
账户与会话
地址、系统账户与一次性凭据分开保存
再连接
工具链与 runner
版本、标签、并发、缓存与退出清理
后运行
时间线与日志
统一时区并截取故障前后关键记录
供定位
完成标准
问题可复现、边界可说明、日志已脱敏
六类入口
先按问题所在阶段选择检查路径
不要从重装环境开始。先判断问题发生在交付、连接、工具链、任务运行、数据读写还是结算信息，能显著减少无效改动。
01
首次交付
核对节点、机器配置、系统账户、访问凭据、租期起止时间和安全设置。
完成标准：订单与机器事实一致 02远程连接
依次确认地址可达、端口策略、账户状态、网络抖动、键盘布局和会话恢复。
完成标准：可稳定重连并输入 03开发环境
记录 Xcode、命令行工具、证书、描述文件、依赖缓存与项目目录权限。
完成标准：本地与远端基线可比 04CI/CD
检查 runner 注册、标签路由、并发上限、缓存目录、密钥注入和任务后清理。
完成标准：任务可重复且不串环境 05存储
区分系统盘、项目目录、构建缓存与团队存储，先判断空间、权限和同步状态。
完成标准：数据路径和迁出责任清楚 06账单
核对机型、租期、节点、SSD 加购与 Thunderbolt 5 并联数量，再比对应付项目。
完成标准：每项费用可追溯到配置
交付前六项
首次登录前，先保存一份交付基线
基线用于判断后续变化来自订单、系统设置还是项目工具链。核对时只记录必要信息，不把密码、私钥或完整令牌写进团队文档。
核对芯片、内存与磁盘
在系统信息中确认订单对应的 M4 或 M4 Pro、内存容量与系统盘容量。外接或加购存储应单独记录挂载位置。
- 验证点
- 配置与订单逐字段一致
- 记录项
- 芯片、RAM、SSD
区分管理账户与任务账户
确认初始系统账户可登录，再为自动化任务配置最小权限账户。不要让日常 runner 长期使用不必要的高权限。
- 验证点
- 账户可登录且权限符合用途
- 记录项
- 账户角色，不记录密码
首次使用后更新一次性凭据
分别保存远程地址、系统用户名与会话凭据。更新后执行一次退出和重连，确认新凭据在预期方式下生效。
- 验证点
- 旧凭据失效，新凭据可重连
- 记录项
- 变更时间与执行人
统一起止时间与团队时区
将租期起止时间写入项目日历，并标注采用的时区。长时任务应在到期前预留检查点保存、产物同步与环境清理时间。
- 验证点
- 团队成员读取到同一时间
- 记录项
- 起止时间、时区、负责人
先收紧入口，再安装工具
检查共享账户、远程访问范围、目录权限和密钥存放位置。安装脚本应能审阅，敏感变量只在任务运行时注入。
- 验证点
- 最小权限与访问边界明确
- 记录项
- 允许来源、目录与轮换责任
关键术语
八个词先对齐，沟通时少一层歧义
这些术语描述的是资源归属、连接方式和构建环境。提交问题时直接使用对应名称，便于支持人员判断问题所在层级。
- 物理节点
- 承载云端 Mac 的实际设备与所在区域。SoarMac 提供的是指定节点中的 Apple Silicon 物理机器，不是抽象出来的共享计算实例。
- 独享
- 租期内机器资源由一个订单使用，不与其他订单共享系统环境。团队内部仍应自行规划账户、目录与任务权限。
- 非虚拟机
- 系统直接运行在对应物理机器上。排查性能或设备能力时，应先看真实配置、当前任务与存储状态，而不是套用虚拟机规格概念。
- VNC
- 用于访问 macOS 图形界面的远程会话方式。它适合界面操作与视觉检查，不等同于文件同步，也不应代替自动化任务日志。
- self-hosted runner
- 注册在团队 CI/CD 平台、实际运行于云端 Mac 的任务执行器。它需要明确标签、并发限制、工作目录和退出清理规则。
- 构建缓存
- 为减少重复下载和编译而保留的依赖或中间产物。缓存必须有可识别的键、容量上限和失效条件，不能与项目源文件混放。
- 签名环境
- 执行签名检查所需的工具版本、证书、描述文件、权限与任务变量集合。应记录来源与轮换责任，不在普通日志中输出敏感内容。
- 会话凭据
- 用于建立远程会话的地址、用户名和临时认证信息。它与项目密钥、代码仓库令牌不是同一类信息，应分开保存与轮换。
CI/CD 接入
让 runner 可重复执行，而不是只成功一次
接入顺序应固定为注册、路由、限流、缓存、密钥和清理。每次改变 Xcode、依赖或签名材料后，都用同一条最小流水线重新验证。
注册 runner
使用项目或组织要求的注册方式创建执行器，记录 runner 名称、所属范围和服务启动方式。完成后先运行无敏感变量的诊断任务。
规划标签
标签至少表达系统、芯片族、Xcode 基线和用途，例如构建、测试或媒体处理。不要让通用标签把高负载任务错误路由到轻量队列。
限制并发
先从单任务验证 CPU、内存、磁盘写入和派生数据目录，再逐步增加并发。出现抖动时保留队列长度与任务时间线，不只看最终失败码。
划分缓存目录
依赖缓存、构建中间产物与导出文件分别落盘。为缓存设置容量边界、键规则和清理条件，避免旧架构或旧工具链产物被错误复用。
注入密钥
敏感变量只在任务运行阶段进入环境，日志中关闭命令回显并限制可读取任务。验证失败时检查变量是否存在，不输出变量原文。
任务后清理
退出时移除临时文件、卸载临时挂载、结束遗留进程并清空短期凭据。清理步骤即使前序失败也应执行，并保留可审阅的结果码。
最小验证任务
工具版本 → 拉取依赖 → 编译 → 测试 → 导出摘要
需要保留
runner 标签、提交标识、任务时间、退出码、脱敏日志
不应进入日志
密码、私钥、完整令牌、签名材料原文
开发环境基线
先记录版本，再判断是环境差异还是项目问题
远端构建失败不等于机器异常。把工具版本、依赖解析、目录权限和签名材料拆开验证，才能找到真正变化的那一层。
Xcode 版本核对
记录完整版本、构建号与当前选择路径。流水线中显式选择版本，避免图形界面与命令行调用到不同工具链。
命令行工具
检查编译器、包管理器和脚本解释器的实际路径。不要只依据安装界面判断版本，任务日志应输出非敏感的版本摘要。
证书与描述文件
核对有效范围、用途和读取权限。日志只记录标识与检查结果，不输出证书私密内容；轮换后执行一次最小签名验证。
依赖缓存
缓存键应包含依赖锁文件、工具版本与架构信息。遇到不可解释的编译差异时，使用空缓存验证，而不是直接删除全部项目数据。
项目目录权限
确认 runner 对源码、缓存和导出目录分别拥有所需权限。避免用全局放宽权限解决单一目录问题，并记录目录所有者变化。
存储路径
把系统、项目、缓存和交付文件分开管理
磁盘问题通常来自路径混用、缓存无上限、权限漂移或同步尚未完成。先确认数据属于哪一层，再决定清理、扩容或迁移。
保留运行余量
持续观察可用空间，避免构建中间产物挤占系统运行所需容量。系统目录不作为团队共享产物仓库。
明确所有者
源码与配置由固定任务账户管理。目录迁移后重新核对权限、软链接和脚本中的绝对路径。
设置失效条件
按项目、架构和工具版本划分缓存，并为容量与保留周期设置清理规则，避免旧产物影响新任务。
同步后再清理
导出产物先校验完整性，再同步到团队存储。租期结束前完成迁出并保留交接记录。
连接排查顺序
一次只改变一个条件，并记录结果
先确认本地网络和目标地址，再进入认证与会话层。画面、键盘和剪贴板属于会话体验问题，不应与地址不可达混在同一步处理。
| 现象 | 第一步 | 第二步 | 仍未恢复时保留 |
|---|---|---|---|
| 无法建立会话 | 确认节点、地址和本地网络可用，排除公司网络策略拦截。 | 更换已知可用网络复测，不同时修改账户与连接参数。 | 节点、发生时间、来源网络、错误原文与连续测试结果。 |
| 画面延迟 | 降低分辨率与色彩质量，暂停本地大流量上传。 | 比较不同网络下的往返延迟和抖动，确认问题是否持续。 | 节点、分辨率、网络类型、延迟样本和问题时段。 |
| 键盘布局异常 | 核对本地输入法、会话键盘布局和系统区域设置。 | 用纯文本编辑器测试修饰键、符号键和快捷键。 | 本地系统、键盘布局、异常按键与复现步骤。 |
| 剪贴板不同步 | 确认会话工具已允许剪贴板传递，并测试短纯文本。 | 重新建立会话后再测，避免先复制大文件或富文本。 | 会话工具、内容类型、方向和可复现的最小文本。 |
| 重连失败 | 完全退出旧会话并等待连接释放，再使用原地址重试。 | 检查系统账户是否仍有效，避免连续快速发起连接。 | 断开原因、重试间隔、错误原文和最近一次成功时间。 |
| 凭据失效 | 确认使用的是最新系统用户名和会话凭据，没有混用旧记录。 | 由有权限的负责人核对最近变更与轮换时间。 | 订单号、节点、用户名、失效时间；不要附上密码。 |
| 大文件传输中断 | 改用可校验、可续传的文件同步流程，不依赖剪贴板。 | 比较源文件与目标文件的大小和校验结果。 | 文件大小、传输方向、开始时间、失败阶段和校验摘要。 |
服务目标
99.9% 可用率目标，以事件记录核对
所有节点全年 365 天正常运行，不设置周期性停机时段。若出现异常事件，控制台时间线记录开始、影响范围、恢复过程与结束时间；赔付资格和计算方式以服务条款为准。
最近 90 天
三个 30 天核对窗口
实际记录以时间线为准
D−90 — D−61
逐日状态、异常开始时间与影响范围
D−60 — D−31
恢复动作、阶段更新与节点范围
D−30 — D−1
结束时间、持续时长与后续说明
- 核算依据
- 受影响服务记录与订单时间线
- 申请入口
- 控制台工单
- 提交材料
- 订单号、节点、时间与影响说明
账单核对
按配置项目逐行比对，不用总价反推
订单费用由机器档位、租用周期、节点、SSD 加购与 Thunderbolt 5 并联数量构成。每次调整周期或附加项后，重新确认订单摘要。
机器与租期
先核对 SoarMac M4 Air、SoarMac M4 Plus 或 SoarMac M4 Pro，再确认日、周、月或季周期。
节点与附加项
确认 SG、JP、KR 或 HK 节点，以及 +1TB SSD、+2TB SSD 或 Thunderbolt 5 并联台数。
结算记录
所有价格以 USD 结算，仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe）；实际可用网关以系统返回为准。
提交前准备
让工单第一轮就具备定位条件
只写“无法使用”会让排查停在信息补充。按下面顺序提供事实，并把密码、私钥、完整令牌和签名材料从日志中移除。
01
订单号
用于关联机型、租期和交付记录，不要附带支付凭据。
02
节点
写明 SG、JP、KR 或 HK，以及发起连接时所在的大致网络区域。
03
发生时间
使用带时区的时间，注明首次出现、最近复现与最后一次正常运行时间。
04
复现步骤
从初始状态开始逐步描述输入、操作、预期结果和实际结果。
05
脱敏日志
保留错误原文、退出码和前后上下文，移除密码、私钥、完整令牌与个人数据。