先找出問題，再恢復建置

付款確認後，登入控制台，找到對應訂單與節點詳細資料，即可查看節點 IP、使用者名稱及初始密碼。先確認訂單中的機型、節點與租用期間和付款時選擇的一致，再開始連線。交付進度以控制台即時顯示為準。

1. 01確認訂單

   記下訂單編號、機型與節點代號，避免使用另一台節點的舊憑證連線。

2. 02查看憑證

   複製完整 IP 與使用者名稱，並確認沒有多出空格；請勿將初始密碼貼到公開紀錄中。

3. 03首次變更密碼

   成功登入後，變更目前使用者的密碼，並存入自己的密碼管理工具。

ssh -p 22 USER@NODE_IP
passwd

請將 USER 和 NODE_IP 替換成控制台顯示的值。若詳細資料中的連接埠不同，請使用實際連接埠。SSH 輸入密碼時通常不會顯示字元，這是正常情況。

先區分「已發起付款」和「平台已確認收款」。信用卡付款完成頁面或鏈上轉帳提交紀錄，都不能取代訂單中的收款狀態。重新整理對應訂單，確認付款金額與交易狀態；頁面尚未更新時，請勿重複付款。

若付款紀錄與訂單狀態不一致，請在控制台工單中附上訂單編號、付款方式、金額、付款時間與時區。USDT-TRC20 請一併提供交易雜湊；信用卡付款提供收據中的參考資訊即可，請勿提供完整卡號、安全碼或簡訊驗證碼。

Arm Line M4 規格為 M4 / 16GB / 256GB；Arm Grid M4 Pro 規格為 M4 Pro / 64GB / 2TB。兩種機型均於新加坡、日本東京、韓國首爾、香港及美國東部這 5 個節點提供租用，實際供應狀態以控制台即時顯示為準。

互動操作請優先考量團隊到節點的網路路徑；無人值守建置也要考量程式碼、相依套件與產物的傳輸路徑。若訂單內容與預期不符，請先透過工單確認，再上傳專案與簽署素材。

先中斷重複的遠端工作階段，再重新連線。確認用戶端連到目前的節點，並檢查 macOS 是否停留在鎖定畫面或切換使用者畫面。若仍可透過 SSH 登入，請先儲存建置紀錄，不要直接強制重新啟動正在執行 archive 的節點。

若可進入圖形介面，請在「系統設定 → 一般 → 共享」中檢查螢幕共享及允許存取的使用者。不同 macOS 版本的選項位置可能略有差異。也可以透過 SSH 查看目前的主控台使用者，協助判斷是否存在圖形工作階段：

stat -f '%Su' /dev/console

若黑畫面持續，請在工單中註明「SSH 是否可連線」、黑畫面前的操作、用戶端名稱與版本，並附上不含密碼的截圖。請勿為了排查而反覆終止系統程序。

先將 VNC 用戶端的顯示模式設為「符合視窗」，區分用戶端縮放與遠端實際解析度。遠端目前的顯示選項可在「系統設定 → 顯示器」中查看。先以 1920 × 1080 作為排查起點，再依用戶端螢幕與網路狀況調整。

跨區域連線時，建議先降低解析度與色深，並提高壓縮程度；確認文字輸入與選單操作順暢後，再提高畫質。建置工作本身不受遠端桌面畫質影響，不必為了查看紀錄而一直維持高解析度圖形工作階段。

「逾時」通常表示網路路徑或連接埠沒有回應；「連線遭拒」表示收到拒絕回應，應檢查連接埠與服務；「驗證失敗」則應確認使用者名稱、密碼或金鑰。先在本機終端機檢查，再將必要的紀錄片段附於工單：

nc -vz NODE_IP 22
ssh -vv -o ConnectTimeout=10 -p 22 USER@NODE_IP

若公司網路限制對外連線，可改用其他網路重試並記錄兩次結果。紀錄只需保留錯誤訊息，請隱藏實際公開 IP、使用者名稱、私鑰路徑等敏感資訊。請勿將私鑰檔案傳給服務團隊。

整台機器重新安裝後，主機指紋可能會改變。請先在控制台確認節點身分；尚未確認前，請勿直接忽略主機金鑰警告。

在遠端「系統設定 → 鍵盤 → 文字輸入」中檢查輸入來源，再到「修飾鍵」確認 Command、Option 與 Control 的對應。Windows 鍵盤與 Mac 鍵盤的修飾鍵位置不同，請先在一般文字編輯器中測試符號，再輸入終端機指令。

若問題只出現在遠端用戶端，請檢查鍵盤配置及快捷鍵轉送設定。剪貼簿不同步時，可重新連線並檢查用戶端的共享剪貼簿選項；請勿透過公開剪貼簿服務傳送密碼或簽署素材。

先查看目前的開發者目錄與版本。圖形介面開啟某個 Xcode，不代表命令列也使用相同版本。全域切換會影響同一台機器上的工作；共用建置流程較適合在單一工作中設定 DEVELOPER_DIR。

xcode-select -p
xcodebuild -version
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
  xcodebuild -version

路徑必須指向節點上實際存在的 Xcode。若需全域切換，請先暫停依賴目前工具鏈的工作，再執行 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer。首次使用的元件與授權需求，應先在互動工作階段中完成檢查。

確認 runner 的執行使用者與憑證所在的鑰匙圈。圖形工作階段的登入狀態不一定會延續到背景服務；重新啟動後，也可能需要依照流程設定解鎖專用建置鑰匙圈。以下指令可用來查看簽署身分並在互動工作階段中解鎖：

security find-identity -v -p codesigning
security unlock-keychain "$HOME/Library/Keychains/build.keychain-db"

範例中的建置鑰匙圈必須事先存在。無人值守工作應從 CI 機密變數讀取必要憑證、停用命令回顯，並限制憑證的存取範圍。排查時只提供錯誤代碼與已去識別化的紀錄，請勿傳送鑰匙圈密碼、私鑰或憑證匯出密碼。

先沿用專案已驗證的簽署方式。自動簽署適合已授權並受到控管的自動化流程；手動佈建描述檔則適合需要固定憑證、描述檔與匯出設定的發佈流程。排查時請勿同時切換簽署方式與 Xcode 版本。

手動設定時，請逐項確認 Bundle Identifier、Team 識別碼、憑證有效期限、佈建描述檔類型與匯出方式。包含多個 target 的專案也要檢查擴充功能的識別碼與權限。分開記錄「編譯失敗」與「匯出失敗」，並在工單中附上失敗階段、原始錯誤訊息及已去識別化的匯出設定。

先在程式碼代管平台確認 runner 註冊仍有效，再檢查節點上的服務狀態、儲存庫綁定與工作標籤。GitHub Actions 的下列指令應在 runner 安裝目錄中執行；GitLab Runner 指令則需先安裝對應程式：

./svc.sh status
gitlab-runner status
launchctl list | grep -i runner

由 launchd 管理的服務，應確認服務定義中的執行使用者、工作目錄與紀錄路徑。開機時自動啟動與使用者登入後啟動並不相同；設定後請在沒有互動式終端機的情況下驗證。請勿在工單中貼上 runner 註冊權杖。

先在失敗的工作中輸出非敏感環境資訊，確認實際執行使用者、目前目錄、PATH 與 Xcode 版本。背景服務通常不會自動載入互動式 shell 的所有設定。

whoami
pwd
printf '%s\n' "$PATH"
xcodebuild -version

在工作環境中明確設定相依路徑。並行工作應為工作區、DerivedData、封存目錄與暫存檔設定不同路徑；先以單一工作完成一次乾淨建置，再逐步提高並行數量。請勿讓兩次發佈同時修改相同的匯出目錄或簽署資源。

請務必選擇 TRC20。仔細核對目前訂單提供的收款地址、應付金額與付款說明，請勿沿用其他訂單或舊截圖中的地址。轉帳前請確認錢包已選擇正確網路。

鏈上確認通常需數分鐘，可先等待幾分鐘並查看交易狀態；實際時間取決於網路壅塞、錢包廣播情況與付款閘道要求的確認數，並非固定的到帳時間承諾。請以訂單顯示的確認結果為準，提交轉帳不代表平台已確認收款。

交易已確認但訂單尚未更新時，請提交訂單編號、交易雜湊、轉帳金額、時間與時區。請勿重複轉帳，也不要在工單中提供錢包助記詞或私鑰。

Visa / Mastercard / Amex 透過 Stripe 處理。付款後請返回控制台，查看對應帳單狀態並確認 USD 金額。若銀行已顯示交易紀錄，但帳單狀態不一致，請保留收據並提交工單，勿連續重複付款。

請提供訂單編號、付款時間與時區、金額、失敗提示或付款參考編號。截圖應遮蔽完整卡號、安全碼與個人敏感資訊。服務團隊不需要您的簡訊驗證碼。

租用期間分為天、週、月、季四種。開始時間、結束時間、續約操作與訂單狀態，請以控制台中的對應訂單與帳單為準；請勿自行依本機發起轉帳的時間推算服務截止時間。

到期前請確認訂單中的續約狀態與應付帳單，勿假設未付款也會延長服務。暫停 runner 或中斷 SSH 不代表已退租。若需調整設定，請先透過工單確認可行方案，再安排專案移轉與暫停建置。

退租後，整台機器上的資料將會清除。請在服務結束前移出原始碼、封存產物、必要紀錄及自己的設定備份，並確認備份可以還原；請勿將節點磁碟作為唯一副本。

同時請解除 runner 註冊、撤銷曾在節點上使用的自動化權杖，並依照自己的安全政策處理簽署素材。若要改用另一台節點，請先完成新節點驗證，再切換發佈工作。