發生時間
寫明當地時區與大致時間,說明問題是首次發生、每次發生還是間歇發生。
節點怎麼選、租多久較合適、現有開發環境如何移轉、self-hosted runner 如何串接,都適合透過支援信箱說明需求。若已有訂單、帳單或執行中的執行個體問題,請登入控制台提交工單,並附上訂單編號、節點與重現資訊。
選擇入口後,下方產生器會切換對應的必填欄位。這樣可減少來回詢問,也能避免把訂單問題寫成缺乏裝置背景的泛化描述。
填寫後會在本機產生電子郵件主旨與內文,並交由系統郵件應用程式開啟。頁面不會將內容提交至其他接收端;寄出前仍可在郵件應用程式中檢查與修改。
「無法建置」或「連線很慢」不足以定位問題。以下每個欄位都應提供可複核的內容;若某項不適用,請明確寫「不適用」,不要讓接收方猜測。
寫明當地時區與大致時間,說明問題是首次發生、每次發生還是間歇發生。
記錄完整 macOS 版本,以及問題發生前是否剛完成系統、Xcode 或依賴項調整。
列出 Xcode、Command Line Tools、Homebrew、Git、Fastlane、runner 或相關 SDK 的版本。
從可正常運作的初始狀態開始,依序寫下指令、介面操作、輸入條件與首次出現異常的位置。
分開描述預期產物、狀態或耗時與實際觀察結果,請勿只貼上最後一行錯誤訊息。
保留錯誤前後必要的背景資訊,刪除密碼、私鑰、完整權杖、業務資料與不必要的個人路徑。
先寫環境,再寫動作,最後寫結果。這樣接收方就能沿著相同路徑重現。
環境:macOS 完整版本 / 工具完整版本 / 節點
動作:從初始狀態開始的重現步驟
預期:應產生的產物或應出現的狀態
實際:錯誤、異常狀態與發生頻率
日誌:已去識別化的必要片段
訂單與帳單協助需要能定位到具體記錄。請提供控制台訂單編號、所選節點、機型、租用週期、目前顯示狀態與希望核對的項目。
寫明訂單編號與發生問題的節點。若同一團隊有多筆訂單,請逐筆列出,不要只提供團隊名稱或付款時間。
無需提交完整卡片資訊、加密資產金鑰或登入密碼。只需說明採用哪一類付款方式,以及控制台顯示的訂單狀態。
首次回覆的目標是確認問題範圍、缺少的資訊與下一步行動,不代表所有問題都能在首次往來中完成處理。資訊越完整,就越容易直接進入重現或訂單核對。
電子郵件主旨會包含問題類型、節點與機型;控制台工單則會保留訂單背景。接收方會先核對是否具備開始處理所需的資訊。
售前與合作電子郵件通常以 1 個工作日內首次回覆為目標;已有訂單的控制台工單通常以 4 個工作小時內首次回覆為目標。複雜重現問題會在回覆中說明下一項需要執行的檢查。
請勿為同一問題反覆建立新的電子郵件或工單。沿原記錄補充測試結果、去識別化日誌與變更時間,才能維持診斷鏈路的連續性。
| 管道 | 適用問題 | 應附資訊 | 首次回覆目標 |
|---|---|---|---|
| 支援信箱 | 售前選型、環境移轉規劃、CI/CD 串接、合作諮詢 | 用途、節點、機型、週期、工具鏈與明確問題 | 1 個工作日內 |
| 控制台工單 | 現有訂單、帳單識別、執行中的執行個體與持續技術排查 | 訂單編號、節點、發生時間、版本、重現步驟與去識別化日誌 | 4 個工作小時內 |
控制台工單適合保留訂單與執行個體背景;支援信箱適合節點選擇、租用週期、環境移轉、CI/CD 串接與合作範圍確認。