分流矩阵 · 八步 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」「签名」标签。