交互式图形界面
- 网络
- 连续测试往返中位数、抖动和丢包；优先使用稳定有线网络。
- 显示
- 先降低分辨率与色彩质量，确认输入延迟是否同步下降。
- 会话
- 关闭重复客户端，确认没有多个图形会话争用编码资源。
可执行排查路径
远程 Mac 出现问题，先定位在哪一层
从节点状态、连接凭据、本地网络、活跃会话、磁盘和任务队列逐层检查。每一步都给出通过条件、下一步动作与应提交的信息，避免只用“连不上”或“很卡”描述故障。
问题分流
选择最接近的症状
选择后会直接定位到对应步骤。若同时出现多个问题，先处理“无法连接”，再检查性能、构建或磁盘。
尚未选择症状。
远程桌面检查
按四层清单确认连接条件
每完成一层再进入下一层。不要在节点状态未知时反复修改客户端参数，也不要用多台设备同时尝试同一会话。
-
01
核对节点状态
登录控制台确认订单对应的物理节点已完成交付，节点名称与当前使用的连接信息一致。若状态仍在变化，保留页面显示的状态文字，不要连续提交重复连接请求。
- 通过条件：能看到正确的订单号、节点和连接入口。
- 异常信息：记录状态原文、页面时间和节点标识。
-
02
重新读取凭据
确认主机地址、用户名和临时凭据来自同一笔订单，复制时不包含首尾空格。若凭据刚更新，关闭旧连接窗口后再创建一个新连接配置。
- 通过条件：客户端不再提示身份验证失败或凭据格式错误。
- 禁止操作：不要把密码、私钥或恢复代码粘贴到工单正文。
-
03
排除客户端网络问题
暂时关闭会改写路由的本地代理，分别用当前网络和另一条可信网络测试。记录解析是否成功、TCP 连接是否建立、连续探测是否出现丢包，而不是只保留一次 ping 结果。
- 通过条件：连续探测稳定，连接不会在握手阶段超时。
- 异常信息：记录运营网络类型、往返中位数和丢包比例。
-
04
检查会话占用
确认团队成员没有同时使用同一图形会话。若旧客户端异常退出，先等待会话释放并重新连接；只有凭据正确、网络可达且旧会话无法恢复时，才重建连接配置。
- 适合重建：客户端配置损坏、分辨率协商持续失败或旧会话记录失效。
- 不适合重建：节点不可达、订单信息不一致或本地网络持续丢包。
连接恢复后再做一次验证：
打开 macOS 图形界面，执行一次断开与重新连接，确认键盘布局、显示缩放和剪贴板行为符合预期，再恢复构建或推理任务。
节点往返参考
五个节点的延迟探针中位数
以下为固定宽带探针到各节点的 ICMP 往返中位数，用于比较路径，不代表任何具体用户网络的实际表现。
探针网络
区域固定宽带，单出口
测试时段
UTC 14:00–16:00
采样方式
每路径 60 次，中位数
数值单位
毫秒 RTT
| 测试发起地 | 新加坡 | 日本（东京） | 韩国（首尔） | 香港 | 美国西部 |
|---|---|---|---|---|---|
| 新加坡 | 8 ms | 72 ms | 83 ms | 36 ms | 171 ms |
| 日本（东京） | 70 ms | 7 ms | 31 ms | 48 ms | 104 ms |
| 韩国（首尔） | 82 ms | 32 ms | 6 ms | 43 ms | 126 ms |
| 香港 | 35 ms | 47 ms | 42 ms | 6 ms | 148 ms |
| 美国西部 | 169 ms | 103 ms | 124 ms | 146 ms | 9 ms |
如何读表：远程桌面对持续稳定的往返路径更敏感。中位数较低但偶发丢包的路径，体感可能差于中位数略高但稳定的路径。
边界条件：探针不经过用户本地 Wi-Fi、代理或企业出口。运营网络互联、时段拥塞、无线干扰和客户端负载都会改变结果，本表不是性能承诺。
任务调优
按工作负载检查网络、存储与队列
先确定瓶颈属于交互、CPU、内存、磁盘还是队列等待。不要把远程画面卡顿直接等同于节点计算性能不足。
编译、测试与归档
- 环境
- 记录 Xcode 版本、项目提交标识、构建命令与完整失败阶段。
- 存储
- 检查工作区、DerivedData、归档目录和临时目录的可用容量。
- 日志
- 保留首个错误及其前后上下文，不只截取最后一行退出信息。
并行流水线
- 队列
- 确认等待发生在调度器、依赖下载、测试执行还是归档上传阶段。
- 并发
- 逐步降低并发任务数量，比较总吞吐与单任务时长的变化。
- 隔离
- 为不同仓库分开工作目录、缓存路径和日志，避免任务互相覆盖。
大模型实验
- 内存
- 记录模型体积、量化方式、上下文长度和运行时峰值占用。
- 磁盘
- 确认模型文件完整，缓存目录和输出目录位于预期卷。
- 队列
- 一次只改变批量、上下文或并发中的一个变量并保存结果。
sw_vers
uname -m
df -h
vm_stat
system_profiler SPHardwareDataType提交日志时可附上系统版本、架构、卷容量和内存状态。删除用户名、项目路径中的敏感名称以及任何访问凭据后再提交。
存储与附加设备
先识别卷，再处理容量或挂载问题
基础 SSD 容量取决于所选配置：OAM M4 16 为 256GB，OAM M4 24 为 512GB，OAM M4P 64 为 2TB。附加存储不应被误认为基础系统卷。
识别顺序
系统卷、附加卷、外接链路
-
确认设备是否被系统识别
在系统信息和磁盘工具中核对设备名称、连接类型、总容量与分区状态。若设备完全未出现，记录连接拓扑后停止重复初始化。
-
确认卷是否已挂载
设备存在但卷不可见时，记录文件系统、卷标、挂载点和磁盘工具显示的错误。不要在数据用途未知时执行抹除或重新分区。
-
确认写入位置
检查项目、模型、构建缓存和导出目录实际写入哪个卷。磁盘不足经常来自缓存仍留在系统卷，而附加卷尚未用于工作目录。
-
收集故障快照
提交设备列表、卷容量、挂载状态、首次出现时间、最近一次正常操作和相关错误日志，并说明是否重启过任务或客户端。
+1TB SSD 与 +2TB SSD
附加 SSD 用于扩展工作数据、构建缓存、模型文件或媒体素材。识别后应明确挂载点和目录权限，再迁移数据。
- 不要把附加容量写成机型的基础硬盘规格。
- 迁移前先停止正在写入的构建或推理任务。
- 故障信息应包含设备容量、卷标和挂载路径。
Thunderbolt 5 并联
先按物理连接顺序确认每台设备，再核对系统信息中的链路与设备树。多台设备异常时，应分别测试单台连接以缩小范围。
- 记录并联数量、连接顺序和异常设备位置。
- 记录设备是否间歇消失、只读或挂载失败。
- 未经确认不要反复拔插正在写入的设备。
安全处理规范
工单正文只放诊断信息，不放秘密材料
不要在工单正文、截图、日志或邮件中发送密码、私钥、恢复代码、完整访问令牌或未脱敏的配置文件。支持人员不需要这些内容来开始排查。
订单号、节点、错误原文、脱敏日志、复现步骤、发生时间、客户端版本和网络测试摘要。
用户名之外的身份秘密、授权头、私钥内容、恢复代码、完整环境变量和截图中的敏感路径。
先提交不含秘密的工单。只有在支持人员给出受控提交步骤后，再按指定范围提供必要材料。
工单准备
一次提交足够进入排查的信息
信息完整不等于内容越多越好。目标是让支持人员能识别对象、建立时间线、复现问题并判断影响范围。
订单号与节点
提供控制台显示的订单号、机型和节点。不要只写设备昵称。
发生时间
写明时区、首次发生时间、最近一次复现时间以及问题是否持续。
复现步骤
从正常起点开始逐步列出操作，并标明在哪一步出现预期外结果。
错误与日志
粘贴错误原文及前后上下文，说明日志来自客户端、构建工具还是系统。
截图与影响范围
截图前隐藏敏感信息，并说明影响单个任务、单个用户还是整个团队。
已执行的检查
列出已测试的网络、客户端、重连、容量和队列操作，避免重复诊断。
无法连接的工单摘要怎么写
建议标题写成“节点 + 客户端 + 连接阶段”，正文依次填写订单号、节点、发生时间、客户端系统、错误原文、网络测试结果、是否存在活跃会话以及已执行的重连步骤。
卡顿或构建变慢需要哪些数据
远程桌面问题提供往返中位数、抖动、丢包、分辨率和客户端网络类型；构建问题提供命令、提交标识、开始与结束时间、首个错误、可用磁盘和并发任务数量。
订单或账户问题通过哪里提交
登录控制台提交工单可让问题与订单记录关联。无法登录时，可使用 support@ownamac.com 联系，并提供工作邮箱、订单标识和问题摘要，不要发送密码或恢复代码。