每個入口都會指向本頁內的具體檢查項目。建議一次只變更一個變數，並記錄變更前後的指令、版本與結果。
SSH 適合命令列、自動化與檔案傳輸；VNC 適合需要 macOS 圖形介面的工作。兩者都應先核對節點地址，再驗證憑證。
從訂單交付資訊核對主機地址、連接埠、使用者名稱與臨時存取方式。不要從舊終端機歷史記錄複製可能已變更的地址。
先在可信任的網路中以詳細模式連線，核對主機指紋後再繼續。若指紋與交付資訊不一致，請立即停止。
將自己的 SSH 公開金鑰寫入授權檔案，確認新工作階段可以登入後，再移除不再使用的臨時存取項目。
先停止前景工作並確認日誌已寫入，再使用 exit 退出。不要直接關閉仍在執行發布工作的終端機。
逾時先檢查網路與連接埠；拒絕連線則檢查地址與服務狀態；驗證失敗則檢查使用者名稱、金鑰權限與授權檔案。
使用可信任的 VNC 用戶端，依交付資訊填寫節點地址與連接埠。連線前關閉用戶端中不必要的憑證記憶功能。
確認顯示的是預期的 macOS 圖形介面，並核對地區與裝置設定。畫面異常時不要立即匯入程式碼或憑證。
替換臨時密碼後重新建立連線，驗證新憑證有效。不要在團隊聊天記錄或建置腳本中儲存完整憑證。
儲存工作、關閉敏感視窗並退出工作階段。多人協作時記錄目前使用者與正在執行的圖形工作。
黑畫面先重新連線並檢查工作階段狀態；畫面卡頓先降低顯示品質；無法建立連線則回到地址、連接埠與本地網路檢查。
詳細模式會告訴你連線停在網路、指紋還是驗證階段。以下地址僅供示例，實際連線資訊以訂單交付內容為準。
$ ssh -v -p 22 build@203.0.113.24
OpenSSH: reading configuration data
debug1: Connecting to 203.0.113.24 port 22
debug1: Connection established
debug1: identity file ~/.ssh/id_ed25519 type 3
The authenticity of host cannot be established.
ED25519 key fingerprint is SHA256:verify-with-delivery-record
僅在核對指紋後繼續連線。
debug1: Server host key accepted
debug1: Offering public key: ~/.ssh/id_ed25519
debug1: Authentication succeeded (publickey)
已連線至獨享實體 Mac 節點
$ sw_vers
ProductName: macOS
$ exit
Connection closed.先切換到可確認正常的網路，再檢查地址與連接埠是否正確。若多個網路都逾時，請記錄發生時間、本地出口環境與完整日誌。
停止連線，不要直接刪除本地已知主機記錄後重試。先核對訂單節點與交付資訊，再透過工單確認變更原因。
檢查使用者名稱、私密金鑰路徑、檔案權限，以及公開金鑰是否完整寫入授權檔案。提交日誌時隱藏金鑰內容，只保留驗證階段資訊。
建置機最常見的環境漂移來自命令列工具路徑、目標名稱、相依性狀態與簽名變數不一致。先驗證機器層，再進入專案層。
執行 xcode-select -p 查看目前路徑，再使用 xcodebuild -version 核對版本。切換版本後重新開啟終端機，讓後續工作使用一致的環境。
先執行 xcodebuild -list，確認 workspace、project、scheme 與 configuration 名稱，再將正確名稱寫入自動化指令。
檢查建置所需變數是否存在於目前工作階段，避免將敏感值寫入儲存庫。只輸出變數是否存在，不要在日誌中回顯完整內容。
為每次工作保留指令、開始時間、結束代碼、建置日誌與產物路徑。失敗時同時保留首次錯誤附近的內容，不要只複製結尾摘要。
runner 接入的重點不只是讓第一個工作成功，而是讓後續工作知道應落在哪個節點、使用哪個目錄，並在停用時清理註冊關係。
建立專用執行身分與工作目錄，確認該身分可以讀取儲存庫、寫入建置目錄，但不預設擁有與建置無關的管理權限。
標籤應描述地區、晶片系列、Xcode 主版本與用途，不要使用「最新」「最快」等會隨時間失真的標籤。
不同儲存庫或流水線使用獨立子目錄，並單獨管理快取目錄。工作結束後清理暫存檔案，但保留仍需重用且來源明確的快取。
先從單一工作執行開始，觀察 CPU、記憶體、磁碟與建置耗時，再決定是否增加並行數。圖形工作與大型建置不應在無記錄的情況下同時執行。
先停止接收新工作，等待目前工作完成，再從自動化平台註銷 runner，移除註冊權杖與不再需要的工作目錄。
工單與團隊文件使用同一組術語，可以減少將網路、裝置、工作階段與建置工具混在一起描述的情況。
先展開最接近的症狀。完成一個檢查點後再進入下一個，不要在沒有記錄結果的情況下跳過中間步驟。
ssh -v 判斷是否已建立網路連線、是否通過指紋檢查，以及驗證停在哪個步驟。xcode-select -p 與 xcodebuild -version 輸出。df -h 查看磁碟區層級的空間，不要只查看單一專案目錄。先整理事實，再透過控制台提交。完整的上下文通常比多次補充零散截圖更快定位問題。
提供必要的訂單識別碼即可，不要傳送付款憑證或其他無關資訊。
註明新加坡、日本（東京）、韓國（首爾）或香港，以及實際連線方式。
寫明時區、首次出現時間、持續時間，以及是否可以穩定重現。
保留指令、結束代碼與錯誤上下文，隱藏權杖、密碼、私密金鑰與完整憑證。