首次开通
连接信息尚未验证
适合刚完成订单、需要核对机型、节点、主机地址、登录方式与初始网络状态的情况。
查看开通检查项
开发任务支持
先保留现场，再沿任务链找到问题
连接失败、构建报错和性能下降通常不是同一种问题。PingMini 按开通、访问、工具链、任务执行、存储与账户六条路径组织排查，让每一步都有输入、检查动作和可验证结果。
- 6 类入口
- 按当前任务选择路径
- 5 项上下文
- 订单、节点、时间、错误与步骤
- 2 种联系渠道
- 控制台工单或支持邮箱
BUILD SUPPORT BOARD
任务现场分流
准备排查
ACCESS
核对地址与指纹
网络
XCODE
固定版本并重放构建
日志
RUNNER
隔离失败任务目录
任务
STORAGE
检查空间与缓存增量
容量
先记录发生时间与最后一次正常状态
CASE READY
选择入口
从正在做的任务开始，不从错误码猜起
先选最接近当前阻塞点的入口。每条路径都列出应保留的信息和下一步动作；若问题跨越多条路径，以最早出现异常的环节为起点。
远程连接
会话、网络或凭据异常
用于图形桌面、SSH、主机指纹、连接超时、键盘布局或剪贴板策略相关问题。
检查连接链路
开发环境
Xcode 与工具链不一致
用于版本切换、命令行工具、证书与描述文件、依赖缓存以及构建日志定位。
进入工具链排查
CI/CD
自托管任务执行失败
检查任务注册、工作目录权限、钥匙串访问、并发策略和失败任务回收是否形成闭环。
核对任务执行链
存储与性能
空间增长或任务变慢
区分系统盘、附加 SSD、构建缓存和项目数据，避免把容量问题误判为算力问题。
查看容量规划
账户与订单
订单、续期或权限需核对
准备订单号、节点代码、发生时间和操作范围，再通过控制台提交与服务状态关联的请求。
准备支持请求
首次使用路径
用四次确认建立可复现的起点
不要在第一次连接时同时迁移项目、修改工具链和接入自动化任务。先证明节点、凭据与网络可用，再逐层加入开发环境。
-
01
结果：字段齐全
获取连接信息
在控制台打开对应订单，记录主机地址、连接方式、账户名与节点代码。不要只保存截图，应把订单号与连接信息放入团队可控的交接记录。
-
02
结果：配置一致
核对节点与机型
确认订单中的节点、芯片、内存和 SSD 与实际用途一致。三档目录配置分别为 M4 / 16GB / 256GB、M4 / 24GB / 512GB、M4 Pro / 64GB / 2TB。
-
03
结果：重新登录成功
完成首次登录并修改凭据
先建立一次最小会话，确认桌面或命令行可进入，再修改初始凭据。修改后立即退出并重新连接，验证新凭据确实生效。
-
04
结果：基线可复现
验证网络与基础命令
检查 DNS 解析、代码仓库访问和依赖源连通性，并执行一个不修改系统状态的基础命令。记录本地网络、客户端和失败时间，便于后续区分链路问题。
Xcode 与工具链
把“构建失败”拆成版本、权限、缓存和日志
同一代码在不同环境出现不同结果时，先固定工具链输入。不要一边升级 Xcode、一边清缓存，再用一次偶然成功判断问题已经消失。
建议排查顺序
VERSION
确认当前 Xcode 与命令行工具
版本记录
记录图形版本、构建版本号以及命令行工具实际指向。项目、脚本与 CI 应引用同一套可确认的工具链。
SIGNING
检查证书与描述文件边界
权限范围
核对文件是否存在、权限是否正确、CI 运行账户是否可以访问所需钥匙串，并记录失败发生在解析、归档还是签名阶段。
CACHE
按层清理缓存
单变量复测
先清项目派生数据，再处理包管理器缓存，最后才考虑更大范围的环境清理。每次只改变一层并重放同一构建。
LOG
保留第一处真实错误
完整日志
从完整日志中定位最早的失败步骤、命令、目标和退出码，不要只复制最后一行汇总信息。
CI/CD 排查
先证明运行器健康，再重放失败任务
自动化失败可能来自注册状态、执行账户、工作目录、钥匙串或并发争用。按任务生命周期检查，避免反复注册运行器掩盖根因。
确认任务注册状态
核对运行器是否在线、标签是否匹配、执行账户是否为预期账户。若任务未被领取，先检查队列规则和标签，不要直接重装工具链。
- 输入
- 运行器名称、标签、队列状态
- 验收
- 最小测试任务可被领取
验证目录与钥匙串权限
用实际执行账户检查工作目录、缓存目录和产物目录的读写权限，并单独验证构建所需钥匙串是否可访问。
- 输入
- 执行账户、目录路径、权限结果
- 验收
- 无提权即可完成最小构建
限制并发并回收残留
将并发降到可控范围，检查残留进程、锁文件、临时目录和未完成归档。失败任务结束后，应明确回收策略而不是继续占用环境。
- 输入
- 并发数、进程列表、磁盘占用
- 验收
- 连续重放结果保持一致
注册健康
权限明确
单任务通过
逐步恢复并发
SSH 连接 Mac
密钥、指纹、网络和权限分开验证
连接超时与身份验证失败属于不同阶段。先确认网络能到达主机，再检查主机指纹和密钥权限，最后验证非交互命令。
最小连接流程
先用明确参数建立一次干净会话
- 准备密钥：为当前用途创建独立密钥，限制私钥文件权限，不在多人之间复制同一份私钥。
- 确认指纹：首次连接前，从可信的订单信息中核对主机地址；指纹变化时先停止连接并查明原因。
- 检查超时：确认本地网络、出口策略、主机地址与端口，不要把超时误判为密码错误。
- 收紧权限：使用完成任务所需的最小账户权限，并通过非交互命令验证自动化可用性。
ssh -i ~/.ssh/pingmini_ed25519 user@host
ssh -i ~/.ssh/pingmini_ed25519 user@host "uname -a"
连接超时
输出：链路结论
检查到达路径
记录本地网络、主机地址、端口、发生时间和客户端错误。先证明网络可达，再处理身份验证。
身份验证失败
输出：权限结论
检查密钥与账户
核对使用的私钥、目标账户、文件权限和服务端授权范围，不要连续尝试不确定的凭据。
存储与性能
先找出哪一类数据在增长
系统盘、附加 SSD、项目数据与构建缓存的生命周期不同。容量规划应同时考虑当前项目、峰值构建、归档产物和租期结束前的迁移空间。
| 存储类别 | 适合内容 | 重点观察 | 建议动作 |
|---|---|---|---|
| 系统盘 | 操作系统、工具链、必要应用与基础配置 | 可用空间、临时文件和工具链版本数量 | 避免长期堆放归档产物，保留安全余量 |
| 附加 SSD | 大型项目、素材、模型、构建产物与团队交接数据 | 持续写入量、单项目峰值和迁移耗时 | 按活跃数据与归档数据分目录管理 |
| 构建缓存 | 派生数据、依赖缓存和可重新生成的中间文件 | 命中率、增长速度与失败任务残留 | 设置回收规则，不与唯一项目数据混放 |
| 项目数据 | 代码、配置、素材、测试数据和最终交付文件 | 是否有独立副本、权限范围和交接责任人 | 按项目建立备份与租期结束前迁移清单 |
记录空闲空间与日增长量
在导入项目之前记录初始占用；正常运行后再记录典型工作日增量。两组数据可帮助判断是持续增长、突发归档还是失败任务残留。
同时容纳输入、中间文件与产物
视频转码、大型归档和模型测试可能同时保留源数据、中间文件与输出结果。不要只按最终产物大小选择空间。
区分磁盘压力与计算压力
记录任务耗时、可用空间、并发数和缓存状态。空间接近上限、频繁清理或多个任务争用同一目录，都可能表现为任务变慢。
安全处置流程
发现异常时，先收口访问范围
凭据疑似泄露、异常登录、成员交接和租期结束属于四种不同场景，但都应遵循停止扩散、保留记录、轮换访问和验证清理的顺序。
暂停相关访问
停止继续共享凭据，结束不必要会话，暂停可能扩大影响的自动化任务。不要在尚未记录现场时大范围删除日志。
记录异常上下文
整理订单号、节点、发现时间、异常来源、受影响账户和最近一次正常操作，保留必要的客户端与任务日志。
轮换凭据与密钥
更换受影响的登录凭据、SSH 密钥和自动化访问材料，并撤销不再需要的团队成员权限。避免只修改一处后继续复用旧密钥。
验证并完成清理
重新测试必要访问，确认旧凭据失效。项目交接或租期结束前，迁移项目数据、构建产物、密钥和证书材料，再按清单清理节点。
升级支持路径
让请求携带足够信息直接进入排查
普通咨询与服务中问题会按影响和可执行上下文分别处理。信息越完整，越少需要往返确认基础字段。
提交前的五项信息
订单号
用于关联机型、租期和服务记录。
节点代码
填写 SG、JP、KR、HK 或 US-E 中与订单一致的一项。
发生时间
写明时区，并补充最后一次正常操作时间。
错误信息
保留完整文本、退出码与最早失败位置，不只提交截断截图。
复现步骤
从可工作的起点开始，逐步写出命令、输入、预期结果与实际结果。
连接失败时，应该先提交截图还是文字错误？
优先提交可复制的完整错误文本、客户端名称、发生时间和操作步骤。截图可作为界面状态补充，但不能替代主机地址核对、退出码和网络阶段判断。
构建偶尔成功，是否说明节点已经恢复正常？
不能只凭一次成功下结论。请在固定 Xcode 版本、相同代码提交、相同依赖与相同并发条件下连续重放，并记录成功与失败之间的输入差异。
任务变慢时，是否应该直接升级机型？
先记录 CPU、内存、可用空间、缓存状态、并发数和任务阶段。若瓶颈来自空间不足、目录争用或失败任务残留，单纯更换配置并不能消除原因。
下一步
准备好上下文，再把问题交给支持团队
若你还在选型，先查看三档固定配置；若服务已经开通，请带上订单号、节点、时间、错误信息和复现步骤提交工单。