訂單與主機狀態
核對訂單識別碼、租用期間、主機狀態與交付資訊。新購、續租與主機管理均在控制台完成，實際可用狀態以控制台即時回傳為準。
從確認狀態開始
先定位問題，再提交可直接處理的資料。
適用於 MiniDebug 雲端 Mac 的啟用、連線、系統登入、Xcode 建置、儲存空間加購、續租與釋放流程。先完成頁面中的本機檢查，再透過控制台工單提交訂單情境與去識別化日誌。
支援範圍
先判斷問題屬於哪一層。
遠端連線失敗、建置失敗與訂單狀態異常可能呈現相似結果，但檢查入口不同。以下六類問題均可透過控制台工單回報。
節點與遠端連線
涵蓋新加坡、日本（東京）、韓國（首爾）、香港、美國東部五個節點的位址、連接埠、網路路徑與遠端工作階段排查。
系統登入與權限
檢查首次登入、憑據更新、SSH 金鑰、圖形工作階段權限與帳戶存取範圍。多人協作時應使用可追蹤的獨立憑據。
建置環境
依 Xcode 版本、命令列工具、相依性快取、簽署資料、磁碟空間與建置日誌定位 xcodebuild 或 fastlane 工作。
儲存空間加購
確認訂單選擇的儲存容量、掛載狀態、剩餘空間與工作目錄。磁碟空間不足時先清理可重新產生的快取，再判斷是否需要調整設定。
續租與釋放
續租前核對週期與加購項目；釋放前完成程式碼、憑證、模型、素材與建置產物備份，並確認自動化工作已停止寫入。
首次啟用流程
五步完成首次連線驗證。
不要從已儲存的舊位址開始嘗試。每份訂單都應以控制台顯示的主機狀態與連線資訊為準。
-
01
輸入：訂單識別碼
查看訂單與主機狀態
登入控制台，開啟對應訂單，確認機型為 MiniDebug M4，配置為 M4、16GB RAM、256GB SSD，並記錄所選節點。主機狀態尚未達到可連線階段時，不要反覆嘗試遠端登入。
-
02
輸出：連線參數
取得本次訂單的連線資訊
複製目標位址、連接埠、帳戶與支援的連線方式。位址與連接埠應成組保存，不要混用 SSH 參數與 VNC 或螢幕共享參數。
-
03
驗證：主機身分
完成首次系統登入
優先從受信任的本機裝置發起連線。首次 SSH 連線應核對主機指紋；圖形連線應確認目標節點與訂單一致，不要在共用裝置上儲存憑據。
-
04
動作：更新憑據
更新憑據與存取範圍
登入後立即更新初始憑據，SSH 自動化優先使用金鑰。團隊使用時限制授權成員範圍，避免多人長期共用同一帳戶或在指令碼中寫入明文密碼。
-
05
結果：基礎環境可用
驗證網路與建置基礎環境
檢查程式碼儲存庫存取、DNS 解析、磁碟空間、Xcode 路徑與命令列工具。先執行輕量驗證指令，再下載完整相依性或啟動耗時建置。
建置錯誤分流
從第一個穩定重現的錯誤開始。
日誌末尾通常只是工作終止結果。應向上尋找第一個穩定出現的錯誤，將問題歸入以下六類，再決定修改專案或提交基礎設施工單。
先區分身分、目標與匯出階段
- 確認建置目標、Bundle Identifier 與簽署設定一致。
- 檢查 archive 成功後是否在 export 階段失敗。
- 記錄第一個簽署錯誤及其前後各 20 行日誌。
處理方向：專案簽署設定由使用者核對；若無法讀取簽署資料，再檢查檔案權限與自動化注入路徑。
核對有效性、相符關係與讀取權限
- 確認所需檔案已放入目前工作實際使用的位置。
- 檢查憑證、描述檔與目標環境是否相符。
- 避免將密碼、憑證原始檔或完整金鑰寫入工單。
處理方向：先在互動式工作階段中驗證讀取，再重現自動化工作，比較兩者的環境變數與執行帳戶。
讓圖形介面與命令列使用相同工具鏈
- 記錄 Xcode 版本、SDK 版本與目標平台。
- 執行
xcode-select -p核對目前路徑。 - 檢查 CI 程序是否繼承預期的開發者目錄。
處理方向：先固定版本與路徑，再清理與新版本不相容的衍生資料，不要同時變更多個變數。
先驗證鎖定檔，再判斷是否清除快取
- 保留相依性鎖定檔並記錄套件管理工具版本。
- 比較乾淨目錄建置與命中快取建置的差異。
- 僅清理可重新產生的目錄，不要刪除尚未備份的專案檔案。
處理方向：快取問題應能透過空快取重現比對確認；網路下載失敗則另行記錄目標、時間與錯誤碼。
同時查看總容量、可用空間與大型目錄
- 檢查工作目錄、衍生資料、封存檔與相依性快取的用量。
- 確認日誌與暫存檔是否持續增加。
- 清理前先確認產物已封存，且可從其他位置復原。
處理方向：優先刪除可重新產生的快取；長期容量需求應在後續訂單中核對儲存空間加購項目。
保留指令、時間與第一個錯誤
- 附上觸發方式、執行目錄與已去識別化的完整指令。
- 記錄問題發生時間並註明時區。
- 同時提供預期結果、實際結果與重現頻率。
處理方向：優先提交文字日誌，不要只提交螢幕截圖；移除儲存庫權杖、上傳金鑰、密碼與原始碼片段。
連線排查樹
依序檢查，不要跳過上游條件。
以下七項形成一條相依鏈。上游未通過時，下游用戶端設定通常不會改變結果。
-
01
通過後繼續
主機狀態
在控制台確認訂單與主機狀態。若狀態與預期不一致，記錄訂單識別碼與頁面顯示結果後提交工單。
-
02
確認目標一致
目標位址
逐字複製目前訂單的連線位址，排除多餘空格、舊位址與本機 hosts 覆寫，並確認沒有連線至另一份訂單。
-
03
記錄錯誤類型
連接埠與連線方式
確認 SSH、VNC 或螢幕共享使用相應的連接埠與用戶端。連線逾時、拒絕連線與驗證失敗應分別記錄。
-
04
完成網路比對
本機網路
使用相同參數從另一個可信任網路測試，判斷公司出口、代理伺服器或電信業者鏈路是否影響連線，測試時不要暴露憑據。
-
05
確認對外連線規則
防火牆規則
檢查本機裝置與組織網路是否允許目標連接埠對外連線。不要為了排錯關閉所有防護，應依最小範圍進行驗證。
-
06
確認驗證結果
帳戶權限
區分網路連線成功與帳戶驗證成功。確認帳戶名稱、金鑰權限、圖形登入權限以及憑據是否已更新。
-
07
保留重試結果
工作階段佔用
檢查是否存在未結束的圖形工作階段、重複的自動化工作或資源佔用。先安全結束舊工作階段，再進行一次受控重試。
工單資料範本
一次提交足夠的可重現情境。
控制台工單適合處理已有訂單的問題。無法登入控制台時，可使用唯一支援信箱 support@minidebug.com，並提供必要的帳戶驗證資訊。
建議工單結構
複製欄位名稱並逐項填寫
- 訂單識別碼
- 控制台中的訂單識別碼，不要提交付款憑據。
- 節點
- 新加坡、日本（東京）、韓國（首爾）、香港或美國東部。
- 發生時間
- 寫明日期、時間與時區，並註明是首次發生或持續重現。
- 重現步驟
- 從開啟控制台、執行指令或啟動用戶端開始，依實際順序編號。
- 去識別化日誌
- 包含第一個錯誤及其情境，移除密碼、權杖、私鑰與專案敏感內容。
- 預期與實際結果
- 分別描述應出現的結果、實際結果，以及是否能穩定重現。
已有訂單
建立控制台工單
使用控制台工單
工單會保留訂單情境，適合處理主機狀態、節點連線、加購項目、續租與釋放問題。提交前先完成對應排查步驟。
無法登入
support@minidebug.com
寄送支援郵件
郵件主旨寫明問題類型與訂單識別碼，內文使用左側欄位結構。信箱地址較長時可直接複製。
回應範圍
問題歸屬決定處理方向。
我們會根據工單資料判斷問題位於物理節點、macOS 使用、專案程式碼或外部相依服務，並提供下一步驗證方向。
節點基礎設施問題
包括控制台顯示的主機狀態異常、連線資訊與訂單不一致、節點網路可達性異常，以及訂單設定未依所選內容呈現。
- 提供訂單識別碼、節點與發生時間。
- 附上不同本機網路的連線比對結果。
- 記錄控制台狀態與用戶端錯誤類型。
macOS 使用問題
包括系統設定、檔案權限、Shell 環境、磁碟清理、遠端用戶端參數與本機帳戶權限等操作層問題。
- 先在受控工作階段中重現操作。
- 記錄系統版本、執行帳戶與目標路徑。
- 提交錯誤文字，不要只提交介面截圖。
專案程式碼與建置設定
包括編譯錯誤、測試失敗、簽署設定、相依性版本衝突、指令碼路徑、環境變數與應用程式執行邏輯。
- 以最小變更重現第一個錯誤。
- 比較本機與雲端 Mac 的工具鏈差異。
- 由專案維護者修改程式碼或流程設定。
第三方服務問題
包括程式碼託管、相依性映像站、套件來源、通知系統與上傳目標回傳的驗證、流量限制或伺服器錯誤。
- 確認目標服務狀態與帳戶權限。
- 記錄回應碼、請求時間與重試結果。
- 向對應服務提供者提交已去識別化的日誌。
自助資源
先閱讀對應指南，避免重複提交。
連線參數、價格、資料保護與常見建置問題已有獨立說明。若指南中的檢查項目未解決問題，再將結果寫入工單。