視覺化操作
圖形桌面
適合首次檢查系統、執行 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
證據層
收集用戶端日誌
保留發生時間、用戶端版本、錯誤原文、重現步驟與已完成的檢查。提交支援請求時，不要只寫「無法連線」。
準備開始
先選擇設定，再依這份清單完成連線
三種固定設定涵蓋輕量建置、日常開發與大型語言模型推理。下單後依訂單確認資訊連線實體節點，再逐步遷移開發環境。