適用於首次連線、VNC 工作階段、Xcode 建置和訂單問題的操作指南。依本地網路、節點狀態、連線資訊、用戶端和工作日誌逐層檢查，不依賴模糊重試。
六個入口同時可見。選擇入口只會帶你前往對應的檢查項目，不會隱藏其他指南。
從本地網路、目標位址、用戶端版本和工作階段占用開始檢查。
進入連線排查 憑證確認位址、帳戶名稱和憑證屬於同一筆訂單，避免複製多餘空格。
核對首次使用路徑 效能分別記錄網路延遲、桌面畫質設定和工作資源表現，不要混為一個結論。
查看觀察順序 訂單準備訂單編號、計費週期、美元金額和付款結果，再提交控制台工單。
查看人工支援流程 儲存空間記錄所選附加項目、系統辨識結果、掛載路徑和首次出現問題的時間。
準備請求資訊 建置保留版本、標籤、工作目錄、完整日誌和最小重現步驟。
進入建置排查每個步驟都有明確的確認結果。前一步未通過時，先保留現場資訊，不要同時變更多個變數。
登入控制台，開啟對應訂單，確認節點已進入可連線狀態，並核對區域與購買時選擇的一致。
分別複製伺服器位址、帳戶名稱和連線憑證。不要合併儲存欄位，也不要在公開文件或聊天記錄中傳播。
在可信任的 VNC 用戶端中填入目標位址和帳戶名稱，先使用預設畫質建立工作階段，再依實際網路調整解析度與色彩品質。
進入 macOS 圖形介面後，確認鍵盤輸入、顯示縮放、終端機開啟和專案目錄存取正常，再開始同步專案或啟動 runner。
先判斷問題發生在本地、目標資訊、憑證、用戶端還是現有工作階段。記錄每一步結果，比連續重新連線更容易定位。
| 順序 | 檢查對象 | 具體操作 | 需要記錄 | 通過判定標準 |
|---|---|---|---|---|
| 01 | 本地網路 | 切換至已知穩定的網路，確認防火牆或代理伺服器沒有攔截 VNC 連線。 | 網路類型、是否使用代理伺服器、失敗時間 | 在同一網路下可連達目標位址 |
| 02 | 目標位址 | 從目前訂單重新複製伺服器位址，不要使用舊螢幕截圖或其他訂單儲存的位址。 | 訂單編號、節點區域、位址欄位來源 | 位址與目前節點記錄一致 |
| 03 | 連線憑證 | 分別核對帳戶名稱和憑證，檢查複製內容前後是否帶有空格或換行。 | 錯誤文字，不提交實際密碼 | 用戶端不再回傳驗證錯誤 |
| 04 | 用戶端版本 | 記錄用戶端名稱、版本和顯示設定，必要時使用另一款可信任的用戶端交叉驗證。 | 用戶端版本、作業系統版本、畫質設定 | 使用相同資訊即可建立穩定工作階段 |
| 05 | 工作階段狀態 | 檢查是否已有工作階段占用、畫面凍結，或用戶端仍保留失效連線。 | 中斷連線前的操作、重新連線表現、工作階段時間 | 關閉舊工作階段後即可重新連線 |
輸入延遲、畫面更新緩慢和建置工作耗時是三個不同指標。分別記錄網路條件、VNC 畫質設定和工作日誌，避免把所有現象歸結為節點效能。
先儲存失敗現場，再建立最小重現。以下六項應來自同一次失敗工作，不可混合不同時間的日誌。
記錄 Xcode 完整版本、命令列工具選擇結果和工作實際呼叫的建置命令。
判斷重點 同一專案在固定版本下能否重複失敗。保留失敗步驟前後的上下文，不要只擷取最後一行錯誤。
判斷重點 錯誤來自相依套件、編譯、測試、匯出還是指令碼階段。記錄時區、開始時間、失敗時間和工作持續時間，方便與節點記錄比對。
判斷重點 問題是否集中在固定步驟或固定持續時間後出現。確認工作流程符合預期標籤，並記錄工作目錄、快取目錄和執行帳戶。
判斷重點 工作是否被路由至正確的 self-hosted runner。移除無關指令碼和並行工作，使用最少命令重現同一個錯誤。
判斷重點 失敗是否取決於目前專案設定、快取或環境變數。在同一節點使用乾淨工作目錄重新測試，或讓最小範例執行相同工具鏈。
判斷重點 最小範例也失敗時，再依節點環境問題提交工單。只有特定分支、相依套件、快取或指令碼失敗，乾淨範例可以執行。
多個獨立專案在相同工具步驟失敗，且最小範例能穩定重現。
使用明確術語可以減少「機器、執行個體、伺服器」混用造成的反覆確認。
一份可處理的請求需要訂單背景、發生時間、完整錯誤和已嘗試步驟。敏感憑證不屬於排查材料。
用於定位訂購記錄，不要只填寫機型名稱。
請寫明新加坡、日本東京、韓國首爾、香港、美國東部或美國西部。
請填寫 BookAMini M4 Core 或 BookAMini M4 Plus。
包含日期、時間和時區，方便與節點記錄比對。
複製原始文字，保留錯誤碼和上下文，不要只描述「無法使用」。
依執行順序列出，並說明每一步得到的結果。
說明是每次發生、偶爾發生，還是只在特定專案和網路下發生。
已有訂單的問題優先透過控制台工單處理，以便關聯訂單、節點和後續補充記錄；無法登入控制台時，請使用支援電子郵件。
在控制台建立工單，選擇對應訂單，並附上區域、機型、時間、錯誤文字、日誌片段和重現步驟。
支援人員會根據證據判斷問題所屬範圍。資訊不足時，工單會列出需要補充的具體欄位。
補充新日誌時註明新的發生時間和測試條件，不要為同一問題重複建立多個工單。
在控制台查看處理進度、建議操作和需要驗證的結果。完成驗證後，在原記錄中確認是否恢復。
BookAMini M4 Core 與 BookAMini M4 Plus 均為雲端 Mac 獨享實體機，並非虛擬機。訂單以美元結算，可用狀態以控制台即時回傳為準。