核對 macOS 與 Xcode 版本
記錄 macOS 版本、Xcode 完整版本、目前命令列工具路徑與專案需求。圖形介面與命令列讀取到的工具鏈應保持一致。
- 確認專案要求的最低與目標系統版本
- 確認目前選擇的 Xcode 與命令列工具一致
- 先以最小專案執行編譯與測試
連線與建置支援
先定位問題所在，再提交可重現的節點記錄
涵蓋雲端 Mac 的首次連線、遠端桌面、SSH、macOS、Xcode、CI Runner、儲存擴充與訂單處理。建議依照登記板順序核對，避免同時變更網路、憑證與建置環境。
SUPPORT ROUTE
問題分流登記
依序核對
01
連線入口
核對主機資訊、使用者名稱與存取方式
輸入
02
節點狀態
以控制台返回的節點記錄為準
確認
03
本機至節點網路
分別檢查解析、連接埠與連線穩定性
測量
04
工具鏈與工作
固定版本後以最小工作重現
重現
工單最小資訊集
訂單識別碼 + 區域 + 時間 + 脫敏日誌
4 FIELDS
選擇入口
依目前卡點進入對應檢查路徑
如果問題橫跨多個環節，請從首次連線開始逐項排除。每次只變更一個變數，並保留變更前後的現象與時間。
首次連線
主機資訊與憑證核對
確認節點區域、主機位址、使用者名稱、憑證版本與目前允許的存取方式。
遠端桌面畫面、輸入與工作階段檢查
區分無法建立工作階段、畫面更新緩慢、輸入異常與用戶端設定問題。
SSH連接埠、金鑰與命令列
核對連線目標、憑證權限、本機金鑰選擇與詳細連線輸出。
Xcode 環境版本與專案隔離
先固定 macOS、Xcode、命令列工具與相依套件版本，再處理專案層級差異。
CI Runner佇列、快取與磁碟
檢查 Runner 線上狀態、工作標籤、並行設定、快取目錄與剩餘空間。
儲存與網路容量、擴充與傳輸路徑
依專案、快取、素材與產物規模評估空間，並單獨驗證網路相依性。
連線診斷
五步縮小連線問題範圍
不要一開始就重新安裝用戶端或重設環境。先確認登記資訊，再逐層判斷問題發生在憑證、節點、本機網路、用戶端或特定工作階段。
-
01
先確認輸入
確認憑證對應目前節點
從控制台重新讀取訂單識別碼、節點區域、主機資訊、使用者名稱與憑證產生狀態。不要繼續使用舊工單、舊螢幕擷取畫面或團隊成員轉傳的歷史連線資訊。
-
02
再確認節點
讀取節點線上狀態
檢查控制台中的節點記錄是否已進入可存取狀態。交付登記仍在進行時，保留目前記錄，不要重複建立連線設定或連續更換憑證。
-
03
測量連線
分離網路連通性問題
在目前網路與另一個可信任網路上分別測試主機解析與目標連接埠。記錄測試時間、網路類型與結果，不要用單次延遲數字取代完整判斷。
-
04
固定用戶端
核對用戶端設定
確認連線協定、主機欄位、連接埠、使用者名稱與憑證選擇沒有錯置。遠端桌面問題還應區分工作階段建立、畫面更新、鍵盤對映與本機顯示設定。
-
05
形成證據
收集最小重現日誌
保留錯誤原文、發生時間、重現步驟與用戶端版本。SSH 可提供脫敏後的詳細連線輸出；遠端桌面可記錄從發起連線到出現錯誤的完整順序。
系統與工具鏈
先固定版本，再定位專案差異
系統升級、Xcode 切換與相依套件更新會同時改變多個變數。開始處理前，先記錄目前環境，再用最小專案驗證基礎工具鏈。
安裝前確認相容範圍
更新系統、Xcode、套件管理器或編譯相依套件前，先核對專案相容性、磁碟剩餘空間與回復材料。不要在正在執行的關鍵工作中途切換版本。
- 儲存目前版本與相依套件鎖定檔
- 確認新版本所需空間與下載來源
- 為驗證工作建立獨立工作目錄
規劃快取目錄
將原始碼、相依套件快取、編譯中間檔、測試結果與最終產物分開。這樣可以判斷磁碟成長來自專案內容、快取命中率變化或建置產物。
- 為快取設定明確路徑與清理條件
- 不要只將最終產物保留在暫存目錄
- 清理前記錄目錄大小與工作影響
隔離專案環境
不同儲存庫、分支與實驗工作應使用獨立目錄、相依套件鎖定與環境變數集合。發生問題時，以相同提交與相同相依套件版本重現。
- 依儲存庫或工作劃分工作目錄
- 記錄環境變數來源，但不要提交敏感值
- 使用可重複執行的初始化指令碼
CI/CD 排查
Runner 離線時，先看控制面再看建置指令碼
分開檢查接單問題、簽章環境、快取、並行與磁碟。若同時變更 Runner 設定、相依套件與快取策略，會讓結果難以重現。
RUNNER
輸出：線上記錄與佇列螢幕擷取畫面
Runner 無法接單
檢查程序狀態、工作標籤、專案授權、佇列分配與最近一次心跳記錄。確認 Runner 實際繫結的儲存庫或組織範圍。
SIGNING
輸出：失敗步驟與錯誤原文
簽章步驟失敗
核對簽章材料是否完整、權限是否正確、指令碼讀取路徑是否一致。工單僅提供脫敏錯誤與材料類型，不要提交任何敏感憑證。
CACHE
輸出：快取金鑰與命中變化
快取失效或建置變慢
比較快取金鑰、相依套件鎖定檔、命中記錄與工作目錄。先以一次停用快取的最小工作確認問題是否確實來自快取層。
QUEUE
輸出：佇列順序與並行數
並行工作互相阻塞
檢查同時執行的工作數、共用目錄、連接埠、模擬器資源與產物路徑。為並行工作分配獨立工作區，避免互相覆寫。
DISK
輸出：目錄使用量對照
磁碟使用量持續增加
分別統計原始碼、相依套件、快取、中間檔、日誌與產物目錄。清理前確認工作是否仍在使用對應目錄，並儲存必要產物。
儲存與擴充
依實際工作集評估容量與 Thunderbolt 5 串聯
評估時應同時計算原始碼、相依套件快取、編譯中間檔、測試資料、素材、模型與最終產物。擴充選項用於明確的容量或串聯需求，不取代專案備份。
STORAGE CHECK
變更前需要確認的四項資訊
- 目前機型、節點區域與訂單識別碼是否正確
- 現有空間、預計新增資料量與快取增長速度
- 擴充用途是長期資料、暫存工作集還是批次處理素材
- Thunderbolt 5 串聯裝置數量、連線方式與工作相依性
需要變更現有訂單時，請進入控制台提交工單並關聯訂單記錄。不要在工作執行期間自行調整儲存路徑或拔除正在使用的裝置。
TB5
以每台串聯裝置計價
適合串聯的工作
大型素材批次處理、明確依賴外接高速儲存的工作流程，以及需要獨立工作磁碟的長期工作。先確認軟體、檔案系統與工作路徑能正確使用串聯裝置。
BACKUP
先確認資料去向再變更
節點本機副本不是唯一副本
專案儲存庫、簽章材料、模型、素材與建置產物應依團隊策略保留獨立副本。擴充容量可解決工作空間問題，但不能取代版本管理與備份流程。
| 附加項 | 每天 | 每週 | 每月 | 每季 |
|---|---|---|---|---|
| +1TB SSD | $2.6 | $7 | $12.9 | $35.1 |
| +2TB SSD | $5.2 | $14 | $25.8 | $70.2 |
| Thunderbolt 5 串聯，每台 | $1.9 | $5.2 | $9.7 | $26.4 |
支援請求範本
一次提交足夠定位的資訊
清楚的請求應讓支援人員知道是哪一筆訂單、哪個區域、何時發生、如何重現，以及預期看到什麼。只有「無法連線」或「建置失敗」通常不足以開始定位。
REQUEST RECORD
複製後填寫
節點問題登記單
- 訂單識別碼
- 填寫控制台中與問題節點對應的訂單識別碼。
- 節點區域
- 新加坡、日本（東京）、韓國（首爾）或香港。
- 發生時間
- 寫明當地時間、時區，以及問題是否持續發生。
- 重現步驟
- 從正常狀態開始，依實際操作順序逐步列出。
- 脫敏日誌
- 保留錯誤原文，移除密碼、金鑰、權杖與專案機密。
- 預期結果
- 說明原本應出現的狀態、輸出或工作結果。
GOOD SIGNAL
資訊應與同一次重現相對應
建議一併提供
用戶端版本、macOS 與 Xcode 版本、Runner 標籤、失敗工作識別碼、網路類型，以及問題發生前最後一次成功操作。
REMOVE FIRST
只提交定位所需的最小證據
提交前必須移除
密碼、私鑰、存取權杖、簽章材料原文、付款憑證、完整環境變數檔案與未處理的專案原始碼。
帳戶與訂單
付款、帳單與節點記錄從控制台處理
訂單金額由所選機型、租用週期、節點區域與附加項組成。現有訂單問題應透過控制台提交，以便工單自動關聯帳戶與節點記錄。
支援哪些付款方式與結算貨幣？
僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe）。所有訂單統一以美元（USD）結算，實際可用的支付閘道以控制台返回為準。
訂單金額由哪些部分組成？
金額由基本機型、按日／週／月／季選擇的租用週期、節點區域，以及已選擇的儲存或 Thunderbolt 5 串聯附加項組成。提交前應逐項核對帳單明細。
為什麼建議從控制台提交連線或設定問題？
控制台工單可以關聯訂單識別碼、節點區域與交付記錄，減少來回確認。提交時仍需補充發生時間、重現步驟、脫敏日誌與預期結果。
團隊成員異動後應如何處理存取憑證？
及時檢查團隊授權範圍、更新相關憑證，並撤銷不再需要的存取權。不要在電子郵件、聊天記錄或工單中傳送未脫敏的憑證內容。