互動式圖形介面
- 網路
- 連續測試往返中位數、抖動與封包遺失；優先使用穩定的有線網路。
- 顯示
- 先降低解析度與色彩品質，確認輸入延遲是否同步下降。
- 工作階段
- 關閉重複的用戶端，確認沒有多個圖形工作階段爭用編碼資源。
可執行的排查路徑
遠端 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 聯絡，並提供工作電郵、訂單識別碼與問題摘要，不要傳送密碼或復原碼。