訂購與交付
適用於付款已完成但狀態尚未更新、交付資訊不完整、節點或租期與訂單記錄不一致等情況。
查看訂單狀態說明定位入口
先依問題類型選擇疑難排解流程
同一種現象可能源自不同層級。先確認屬於訂單、連線、環境、帳單或安全問題，再收集該層級所需的資訊。
訂單狀態
狀態決定下一步要檢查什麼
進入控制台後，先記錄訂單識別碼、目前狀態、所選節點與租期到期時間。不要只根據遠端用戶端的提示判斷裝置狀態。
-
01
待確認
訂單資訊或付款結果正在確認。請核對機型、週期、節點、附加項目與 USD 應付總額是否與提交內容一致。
重要欄位：訂單識別碼、付款方式、建立時間 -
02
設定中
實體節點正在完成訂單所對應的設定。此階段連線位址或憑證可能尚未完整顯示，請勿反覆嘗試舊位址。
重要欄位：目標節點、設定狀態、最新狀態變更 -
03
可連線
連線資訊已產生。請使用控制台目前顯示的位址、帳戶說明與連線方式，並確認用戶端指向正確節點。
重要欄位：連線位址、節點、到期時間 -
04
租期結束
目前租用週期已結束，原有連線資訊不再代表有效服務。資料應在到期前移出，後續訂單以新的控制台記錄為準。
重要欄位：租期起訖時間、最後移出記錄
節點目錄與即時結果
ZoomMini M4 Core 與 ZoomMini M4 Plus 均提供新加坡、日本（東京）、韓國（首爾）、香港四個節點。實際可用性與下單結果以控制台即時回傳為準。
連線疑難排解
從網路可達性一路檢查到工作階段恢復
依序檢查可避免將本地網路問題誤判為裝置問題。每一步都保留發生時間、目標位址與錯誤原文。
$ ping -c 4 <host>
4 packets transmitted, 4 received
$ ssh -vvv user@<host>
debug1: Connecting to <host>
debug1: Server host key verified
$ nc -vz <host> <port>
Connection succeeded驗證網路可達性
更換為已知穩定的本地網路，記錄目標位址、連接埠與逾時結果。不要只以瀏覽器能否存取其他網站作為判斷依據。
核對帳戶憑證
確認使用者名稱、密碼或 SSH 金鑰來自目前訂單說明，檢查複製時是否帶入空格，請勿連續重複提交錯誤憑證。
處理 SSH 指紋變更
先在控制台核對目標位址是否變更。確認目標無誤後，再移除對應的舊 known_hosts 項目，請勿直接清空整個檔案。
區分用戶端與節點問題
使用另一台受信任的裝置或另一種連線方式再次測試。若 SSH 可用而 VNC 無法使用，應優先記錄圖形用戶端版本與工作階段狀況。
建置環境
依工具鏈相依性順序檢查
先確認系統實際選用的 Xcode，再檢查簽署、套件管理器與 runner 權限。跳過前置檢查會讓後續錯誤失去參考價值。
-
01
確認 Xcode 版本與選取路徑
執行
xcodebuild -version和xcode-select -p，核對專案要求的版本與目前開發者目錄是否一致。 -
02
驗證命令列工具
執行
clang --version與swift --version。若工具不存在或版本不符，先修正 Xcode 選取路徑，再重新測試。 -
03
核對憑證與描述檔
確認建置使用者可以讀取所需的簽署資料，檢查憑證有效性、描述檔識別碼與專案設定。日誌中只保留名稱與錯誤類型，不要附上機密內容。
-
04
檢查 Homebrew 路徑
Apple Silicon 環境通常需要確認
/opt/homebrew/bin已加入非互動式 shell 的 PATH，並驗證 runner 啟動環境與終端機環境是否一致。 -
05
驗證 runner 最小權限
確認 self-hosted runner 對工作目錄、快取目錄與建置產物目錄具備必要權限，請勿透過擴大整個系統的權限來掩蓋單一路徑問題。
$ xcodebuild -version
Xcode <required-version>
Build version <build-version>
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ command -v brew
/opt/homebrew/bin/brew
$ test -w "$RUNNER_WORKDIR"
$ echo $?
0
$ xcodebuild -scheme App build
** BUILD SUCCEEDED **
成功判定不要只看最後一行
同時檢查指令結束碼、實際產物路徑、測試報告與簽署步驟。命中快取不等於建置成功，runner 上線也不等於具備工作目錄權限。
術語小字典
八個高頻術語的準確含義
這些詞分別描述硬體歸屬、連線方式、自動化角色與訂單界線。提交問題時使用準確術語，可以減少定位歧義。
- 實體節點
- 實際執行 macOS 工作負載的 Apple Silicon 硬體裝置，也是訂單連線位址與執行狀態所對應的基礎資源。
- 獨享
- 一筆有效訂單對應一台獨享實體機，運算、記憶體與本機儲存空間不會與其他客戶工作階段共用。
- 非虛擬機器
- 工作負載直接執行於訂單對應的實體 Mac mini 上，而非從共用主機切分出的虛擬運算執行個體。
- VNC
- 用於存取 macOS 圖形介面的遠端顯示協定，適合需要視窗操作、介面測試與視覺化設定的工作。
- SSH
- 用於命令列操作、自動化執行、檔案傳輸與診斷的加密連線方式，適合持續整合與指令碼化工作流程。
- self-hosted runner
- 部署於獨享雲端 Mac 上、由團隊自行設定權限與工具鏈的自動化執行器，用於接收並執行管線工作。
- 租期
- 訂單約定的服務起訖區間，可選擇日、週、月或季。連線資訊、續租核對與資料移出都應以此區間為準。
- 節點
- 裝置所在的服務地區。目前目錄包括新加坡、日本（東京）、韓國（首爾）與香港，共四個節點。
計費問答
續租前先核對帳單結構
帳單應分開列示基礎機型、週期、節點與附加項目。付款閘道的實際可用狀態以控制台回傳為準。
日、週、月、季如何計價？
訂單依下單時選擇的單一週期計價，不會混合拼接不同週期。續租前應重新確認機型、週期、節點、租期起訖時間與應付總額。
SSD 與 Thunderbolt 5 並聯如何列示？
+1TB SSD、+2TB SSD 與 Thunderbolt 5 並聯會依所選週期分開列示，不應合併至基礎機型名稱中。Thunderbolt 5 並聯按每台裝置計算，確認數量時應同時核對關聯裝置。
使用什麼貨幣與付款方式？
所有訂單均以美元（USD）結算。僅支援 USDT-TRC20，以及 Visa / Mastercard / Amex（透過 Stripe）；實際可用的付款閘道以控制台即時回傳為準。
續租前必須檢查哪些欄位？
依序核對訂單識別碼、基礎機型、所選週期、目標節點、SSD 附加項目、Thunderbolt 5 並聯數量、USD 小計、應付總額與新的租期結束時間。若欄位不一致，請在付款前提交工單。
付款後狀態沒有更新，應提供什麼？
提供訂單識別碼、付款方式、付款時間、控制台目前狀態與已去識別化的交易參考資訊。請勿傳送完整卡片資訊、完整付款憑證或任何帳戶密碼。
工單清單
提交可直接開始疑難排解的資訊
一份有效工單應回答「哪一筆訂單、哪個節點、何時發生、如何重現、看到了什麼」。敏感資訊應先完成去識別化。
依以下順序整理工單正文
-
01
訂單識別碼與節點
寫明控制台中的訂單識別碼，以及新加坡、日本（東京）、韓國（首爾）或香港的目標節點。
-
02
問題發生時間
提供含時區的首次發生時間、最近一次重現時間，以及問題是持續發生還是間歇發生。
-
03
重現步驟與預期結果
從進入控制台或執行指令開始逐步描述，並分別寫出實際結果與預期結果。
-
04
環境與連線方式
註明本地系統、用戶端版本、VNC 或 SSH、macOS 與 Xcode 版本，以及是否經過代理伺服器網路。
-
05
去識別化日誌
保留錯誤碼、指令、結束碼與必要上下文，替換使用者名稱、位址、權杖、儲存庫路徑與付款參考中的敏感部分。