分流矩陣 · 八步 Runbook · 工單結論 · Organizer 圖形驗收
已在用 Xcode Cloud 的小團隊或獨立開發者幾乎都遇到過三類挫敗：隊列長時間不前移、某一構建步驟反覆紅字、以及短時服務端不可用。本文不給空洞安慰，而是一套先分流再動手的流程：先判斷你是否在為配額、並發或 workflow 綁定買單，再判斷籤名素材與 Xcode 指紋是否在雲端可得；必要時切換到租用遠程物理 Mac + VNC 圖形會話完成 Archive、Organizer 上傳與帳號側覆核——這與站內《Xcode Cloud 與遠程 Mac 分工》互補：那篇講常態分工，本篇講異常窗口下的最小介入路徑，並與《首次 TestFlight 外測檢查表》、《遠程 Mac 首次使用清單》形成鏈路。
在沒有凍結指紋的前提下重複點「重新運行」，常常只是把並發配額浪費在同一個前置問題上。下面五條是把工單寫清楚的第一步——每條都可以映射到後續矩陣裡的某一列。
並發與配額：同一 Apple Developer Program 維度下，Cloud 與傳統 CI 的任務並行並不是無限擴展；高峰期隊列前移變慢不等於代碼有錯，但需要你用時間戳證明「卡在分發側」。
工作流綁定漂移：本地分支名、workflow 文件名或 Xcode Scheme 改動會讓雲端跑到你以為沒在跑的腳本階段；這類失敗往往在日誌前半段就出現籤名或緩存路徑線索。
籤名素材只在桌面會話可得：鑰匙串變更、Apple ID 會話過期、描述文件同步滯後——這類狀態SSH-only 會話裡更難肉眼對齊，卻會阻斷雲端歸檔。
依賴解析與鏡像：Swift Package / CocoaPods / 私有 Podspec 任一一環網絡抖動，都會在雲端表現為同一腳本階段超時；若不緩存指紋，排查會變成玄學。
交付窗口的機會成本：熱修復窗口常以小時計——每一次無效重跑都在吃掉你與客戶的信任餘額；Plan B 的本質是把路徑收斂到可複述的版本指紋 + 圖形化證據鏈。
這張表的用法是：先用左側現象對齊日誌層級，再在右側挑最小代價路徑；只有當「雲端短時不可用」或「圖形環節阻斷」命中時，才把租用遠程 Mac + VNC 拉進來。
| 現象（摘錄） | 優先懷疑 | 首選動作 | 何時引入遠程 VNC Mac |
|---|---|---|---|
| 隊列計數不變超過 SLA 閾值 | 配額/並發或側維護公告 | 核對同一帳號其它 workflow、暫緩重複觸發 | 交付倒計時已到且公告確認短時不可用 |
| 下載依賴或腳本階段超時 | 鏡像源、緩存鍵或 Podfile 鎖文件漂移 | 本地復現同一 commit；固化緩存策略後再觸發 | 需在圖形界面裡比對 Xcode 帳戶下載組件與會話狀態 |
| 籤名 / Archive 步驟失敗 | 證書、描述文件或鑰匙串上下文 | 導出桌面會話證據：鑰匙串項與 ASC 對齊截圖 | 強烈建議：用完整桌面會話完成 Organizer 鏈路覆核 |
| 只在雲端失敗、本地同一指紋可通過 | 雲端鏡像差異或隱藏 env | 比對 xcodebuild -version、Swift 工具鏈與環境變量導出 | 需要在租用機上凍結與你 CI 一致的鏡像口徑再做對照構建 |
提示：「遠程 Archive」仍可能需要上傳到 App Store Connect；區別在於誰在圖形會話裡點開 Organizer、誰在截圖留存審批鏈——這正是租用雲端物理 Mac + VNC 能縮短的平均恢復時間。
下列順序刻意寫成可在工單複製的檢查項；若你在步驟 3 就發現指紋不一致，不要盲目跳到 Archive——先把分支與 Xcode Scheme 對齊再往下。
凍結三元組：記錄 commit SHA、Scheme、Configuration（Release/Debug）；把它們貼在工單首位，後續任何重裝或切換節點都必須回到同一三元組對照。
讀 Cloud 日誌分層：先定位第一階段失敗是在 checkout、腳本還是 xcodebuild；避免對著末尾紅字推斷根因。
比對本地一次性構建：在同一 Mac（本地或租用）上用同一三元組跑一次 xcodebuild archive 或 Xcode GUI Archive；失敗則先在同一桌面會話解決籤名。
鑰匙串與帳號會話：在VNC 圖形會話中打開 Xcode → Settings → Accounts，確認開發者帳號未過期；若有雙重認證提示，必須在可視會話完成，而非僅憑 SSH。
Organizer 側最小 smoke：Archive 成功後打開 Organizer，先做Validate App再決定是否 Upload；記錄校驗耗時與警告級別，避免上傳後被靜態掃描退回。
與 CI / 分支策略對齊：若公司有 Git Flow，確認合併標籤與 ASC 構建號遞增策略一致；遠程租用機上不要做「順手改版本號」式的漂移。
導出合規與隱私問卷：對加密與出口合規勾選路徑做一次截圖存檔，便於後續審核問詢快速對照——詳見站內 TestFlight / 上架類長文的清單段落。
復盤寫入 Runbook：寫明觸發 Plan B 的條件、租用時長、節點區域與誰在桌面會話籤字；下次同類故障可直接套用閾值。
# 指紋快照示例（按需增減） xcodebuild -version swift --version git rev-parse HEAD security find-identity -v -p codesigning
SSH 很適合列印指紋與自動化腳本，但在鑰匙串授權、Organizer GUI、Apple ID 雙重認證與導出合規勾選上仍常與桌面會話不等價。下表可直接用作VNC 會話內的勾選清單。
| 核對項 | 圖形會話要點 | 通過標準 |
|---|---|---|
| Accounts | Xcode Settings → Accounts 無警告三角 | Team、Role、證書列表與 ASC 期望一致 |
| Organizer | Validate 警告可為 yellow；紅色須先處理 | 上傳前日誌已存檔 |
| 鑰匙串 | 籤名時對提示選擇「始終允許」並存證據 | 後續連續 Archive 不再頻繁打斷 |
| 網絡與節點區域 | 上傳帶寬與 ASC 路由有關 | 選定節點前對照業務地域與時延預算 |
| 會話連續性 | 避免多人共用帳戶無聲搶佔會話 | 租用窗口內有單一責任人籤字 |
這與自建 Mac mini 的差別在於：你永遠可以把硬體折舊與機房在線率換算成每小時帳單，而把指紋凍結與圖形覆核留給當天的交付責任人——對小團隊而言，這比維護一臺只吃灰的設備更符合現金流節奏。
常態下的職責切分與小團隊落地順序。
閱讀 →Archive 之後的分發與合規勾選銜接。
閱讀 →流水線裡何時必須插入圖形會話。
閱讀 →不一定。請先在 Cloud 面板核對並發佔用與其它 workflow，再結合本文矩陣判斷是否屬於配額排隊；必要時查閱當日維護公告並保留截圖。
重裝會把版本指紋變成新的變量；應先凍結三元組並對照日誌層級，優先排除籤名與會話問題——可參考站內系統更新與工具鏈凍結策略一文。
需要。Archive 只是產物；後續分發、合規聲明與審核回復仍在 ASC / Organizer 鏈路完成——可與站內外測檢查表逐項勾選銜接。
適合，但請在會話預算內一次性完成指紋對齊 + Organizer smoke test；可參考站內套餐與時長相匹配決策避免無謂待機計費。
Xcode Cloud 擅長把常態構建託管出去，但當隊列與籤名鏈路疊加異常時，真正昂貴的是交付窗口內的不確定性：你無法向客戶解釋「我也不知道雲端什麼時候能動」。Plan B 的價值不在於替換 Cloud，而在於凍結指紋 + 圖形證據鏈，把平均恢復時間壓進可控區間。
自建 Mac 要面對折舊、系統更新窗口與電費；低配機器又在 Archive 與校驗階段容易被磁碟與內存卡住。相較之下，按需租用雲端物理 Mac並把圖形會話留給當天的責任人籤字，能把固定成本轉成與交付節奏對齊的可變成本。
若你需要一臺隨時可建立完整桌面會話、並按小時擴展節點的環境來完成本文第三節 Runbook，可通過 VNCMac 租用遠程 Mac：下方主按鈕進入中文站購買頁；需要先做 SSH/VNC 路徑比對請查閱SSH 與 VNC 選型指南（站內）；還想補齊上架鏈路請回到博客首頁篩選「TestFlight」「籤名」標籤。