可视操作
图形桌面
适合首次检查系统、运行 Xcode、处理签名材料、观察构建界面和执行需要人工确认的任务。
- 输入
- 主机地址、账户与临时凭据
- 验收
- 画面清晰，键盘、鼠标与剪贴板策略正确
连接与迁移指南
把本地开发流程，稳妥接到云端 Mac
PingMini 提供云端 Mac 独享物理机。先按工作方式选择图形桌面、SSH 或自动化任务，再迁移代码、工具链与构建配置。每一步都给出输入、动作和验收结果。
- 3 条路径
- 图形桌面、SSH、自动化任务
- 4 类迁移对象
- 代码、工具链、签名材料、CI 配置
- 1 个原则
- 先验证，再逐步迁移
连接编排单
本地 Mac → 云端 Mac
待执行
目标节点
SG / JP / KR / HK / US-E
交付对象
独享物理机
桌面
确认分辨率与键盘布局
验收：界面、输入和剪贴板策略符合预期
连接
SSH
核对主机指纹并测试密钥
验收：非交互命令返回正确主机信息
验证
迁移
同步仓库与依赖锁文件
验收：干净环境可以复现构建
复现
CI
注册执行节点并运行探针任务
验收：日志、产物和退出码均可追踪
交付
连接信息以订单确认结果为准
PLAN → CONNECT → VERIFY
选择访问路径
先看任务，再决定怎么连接
三种方式可以并用，但首次开通不建议一次配置全部入口。先完成最小连接验证，再增加自动化和团队协作权限。
命令行
SSH
适合仓库同步、依赖安装、日志采集、脚本执行和低带宽环境。默认优先使用密钥，而不是长期共享口令。
- 输入
- 主机地址、用户名与公钥
- 验收
- 指纹已确认，非交互命令能稳定返回
持续执行
自动化任务
适合 CI/CD、自托管任务执行、定时构建和批量测试。应使用单独的执行账户、工作目录和可撤销凭据。
- 输入
- 运行器配置、最小权限与工作目录
- 验收
- 任务退出码、日志与产物位置可以追踪
首次图形连接
先把会话调到可工作的状态
首次连接的目标不是立刻搬完项目，而是确认主机、显示、输入和数据交换边界。每完成一项就记录结果。
会话核对单
GRAPHICAL SESSION
STEP 01–04
-
01
主机一致
核对主机信息
把订单中的节点、机型、主机地址和账户名逐项核对。不要凭历史记录连接，也不要把旧项目的地址直接套到新订单。
-
02
会话稳定
建立首次会话
从可信网络发起连接。首次进入后先查看系统信息、时区、磁盘容量和网络状态，不急于导入任何敏感材料。
-
03
显示清晰
调整显示参数
按本地屏幕和链路条件选择分辨率。文字模糊时先检查缩放；操作延迟时先降低画质，而不是立即判断主机性能异常。
-
04
输入可控
验证输入边界
测试中英文输入、常用快捷键和键盘布局。确认剪贴板是否允许双向同步，敏感内容不应通过共享剪贴板长期保留。
SSH 初始设置
把命令行入口做成可验证、可撤销的通道
密钥、主机指纹和账户权限应分开管理。不要为了省一步，把长期私钥、项目密钥和团队共享凭据混在同一目录。
本地执行
生成独立密钥并登记用途
为当前设备和当前协作者生成独立密钥。文件名应能看出设备与用途，密钥注释只写必要标识，不写项目机密。
ssh-keygen -t ed25519 -a 64 -f ~/.ssh/pingmini_dev
chmod 600 ~/.ssh/pingmini_dev
ssh-add ~/.ssh/pingmini_dev私钥留在受控本地设备，只提交公钥。团队成员离开项目时，删除对应公钥，不替换整组共享凭据。
远端验证
确认指纹，再测试非交互命令
首次连接显示的主机指纹必须与可信来源提供的信息核对。确认后，再用只读命令验证主机身份和命令执行链路。
ssh -i ~/.ssh/pingmini_dev user@host
ssh -i ~/.ssh/pingmini_dev user@host \
'sw_vers && uname -m && whoami'预期结果应包含 macOS 版本、arm64 架构和正确账户名。结果不一致时停止迁移，先核对订单与连接信息。
限制账户权限
自动化账户只获得任务所需权限。交互账户与 CI 账户分开，避免脚本继承不必要的个人目录访问能力。
固定主机配置
在本地 SSH 配置中使用独立别名、指定密钥文件并关闭无关身份尝试，减少误用其他私钥的概率。
测试退出码
除了看到命令输出，还要检查脚本退出码。自动化系统依赖退出码判断成功与失败，不能只凭日志末行判断。
迁移路径图
把迁移拆成三条可单独验收的路径
本地 Mac 到云端 Mac 不是整盘复制。先迁数据，再复现工具链，最后接入 CI。每条路径都保留输入清单和验收证据。
01
数据迁移
只搬项目需要的数据
- 输入
- 代码仓库、必要素材、配置模板、数据库导出和依赖锁文件。
- 动作
- 优先重新克隆仓库；大型文件分批校验；敏感配置通过受控渠道单独放置。
- 验收
- 仓库状态干净，关键文件校验一致，项目目录中没有本地临时缓存。
02
工具链复现
按版本清单重建环境
- 输入
- Xcode 版本、命令行工具、包管理器清单、SDK 要求和依赖锁文件。
- 动作
- 先安装基础工具，再恢复依赖；不要直接复制旧机器上的全局缓存和派生数据目录。
- 验收
- 同一提交在干净目录完成构建，测试版本、编译器版本和产物信息可记录。
03
CI 接入
把节点纳入任务编排
- 输入
- 运行器注册信息、工作目录、并发策略、缓存规则和产物交付位置。
- 动作
- 使用独立执行账户注册节点，先跑短探针任务，再逐步接入测试、归档和发布准备流程。
- 验收
- 任务能启动、取消和回收；日志可查询；失败任务不会遗留占用资源的后台进程。
开发环境迁移
用清单复现环境，不复制旧机器的杂质
迁移完成的判断标准，是同一提交能够在新环境稳定构建，而不是文件数量与本地设备完全相同。
按依赖关系逐层恢复
代码仓库
从可信远端重新克隆，核对分支、子模块、大文件引用和未提交变更。
依赖锁文件
同步项目使用的锁文件与版本声明，避免在新机器上无意升级依赖。
Xcode 与命令行工具
记录实际版本、选择的开发者目录和 SDK 要求，再执行一次完整构建。
证书与描述文件
只导入项目所需材料，明确保管人、用途和撤销路径，并限制自动化账户的访问范围。
构建与测试结果
保留提交号、工具版本、任务耗时、退出码和产物位置，作为迁移验收记录。
应该同步
目标：可解释、可复现、可撤销
决定构建结果的输入
仓库、锁文件、配置模板、脚本、必要素材、签名材料和明确版本要求。每一项都应知道来源与用途。
不建议复制
原则：先重建，缺失时再补充
可以重新生成的缓存
派生构建目录、包管理器缓存、模拟器临时数据、历史日志和无关下载文件。复制这些内容会放大兼容问题。
会话安全
把访问权当作有开始和结束的任务
远程会话、SSH 密钥和 CI 凭据都应有明确持有人、用途与撤销时间。协作结束不等于关闭窗口，还要回收访问并清理残留数据。
使用独立强凭据
每位协作者使用独立入口。避免多人共用同一账户和同一密钥，以便在人员变化时精确撤销访问。
按事件轮换密钥
设备更换、成员离开、项目交接或凭据疑似泄露时立即轮换，不等待固定周期结束。
限制共享账户
交互操作、自动化执行与维护任务使用不同账户边界，避免 CI 任务获得不必要的个人目录权限。
完成交接与清理
租期结束前导出必要产物、撤销项目凭据、删除敏感文件，并确认协作者入口已回收。
协作开始
登记人员、用途与权限
只开放任务所需入口，并记录对应公钥或执行账户。
协作进行中
检查异常登录与遗留任务
发现来源、时间或任务行为异常时，先暂停访问并保留必要日志。
协作结束
撤销入口并清理敏感数据
验证旧密钥无法继续连接，确认项目材料已按交接要求处理。
连接故障排查
从订单到客户端日志，按层排除问题
不要同时更换地址、网络、凭据和客户端设置。一次只验证一层，保留错误原文和发生时间，才能缩短定位路径。
-
01
订单层
确认订单状态
先确认服务已完成交付，当前租期有效，机型与节点和订单一致。实际可用状态以控制台实时返回为准。
-
02
寻址层
核对主机地址
逐字检查地址、端口和账户名，避免使用历史连接记录。地址变化时同步更新本地别名和自动化配置。
-
03
网络层
检查本地网络策略
切换到可信的替代网络做对照，检查本地防火墙、企业出口策略、代理设置和 DNS 解析是否影响连接。
-
04
认证层
验证凭据与主机指纹
确认使用的是正确密钥和账户。指纹异常时不要绕过验证，应停止连接并核对可信来源中的主机信息。
-
05
服务层
检查系统服务
若 SSH 可用但图形会话不可用，分别检查对应服务状态；若图形会话可用但脚本失败，检查 Shell、路径与权限。
-
06
证据层
收集客户端日志
保留发生时间、客户端版本、错误原文、复现步骤和已完成检查。提交支持请求时不要只写“无法连接”。
准备开始
先选配置，再按这份清单完成连接
三档固定配置覆盖轻量构建、日常开发与大模型推理。下单后按订单确认信息连接物理节点，并逐步迁移开发环境。