核對交付資訊
確認訂單中的機型、節點與租期與交付資訊一致。主機位址、系統帳戶、連線方式與一次性憑證應分別記錄，不要將所有敏感資訊複製到同一則團隊訊息中。
- 確認節點是否為已選的新加坡、日本（東京）、韓國（首爾）或香港節點
- 確認主機名稱與位址沒有多餘空格或轉寫錯誤
- 僅在獲授權成員之間傳遞首次連線資料
從交付到穩定工作階段
先確認連線邊界，再將工作流程遷移至雲端 Mac
收到主機位址、系統帳戶與一次性憑證後，不要立即搬入完整專案。先驗證網路路徑與主機身分，再更新憑證、建立最小權限帳戶，最後分批遷移資料、工具鏈與自動化工作。
- 連線前
- 確認對外網路允許所需連接埠
- 首次工作階段
- 更新一次性憑證並記錄復原方式
- 遷移原則
- 資料、工具鏈、CI 分階段驗證
工作階段檢查板
遠端工作階段連線檢查
依序核對
01
本機網路
出口策略與抖動
02
身分核對
位址、帳戶、指紋
03
工作接入
專案、快取、runner
交付資訊
主機位址與系統帳戶逐項比對訂單
先核對
連線身分
透過獨立管道確認主機指紋
必做
憑證輪換
一次性憑證僅用於建立首次工作階段
首次
遷移驗證
每個階段保留可回退的完成標準
分階段
SG · JP · KR · HK
獨享實體機 · 非虛擬機
遠端存取概覽
將首次連線拆分為四個可驗證階段
交付郵件中的位址、帳戶與一次性憑證只是起點。真正可重複使用的連線流程，還需要驗證網路、主機身分、權限邊界與復原路徑。完成一個階段後再進入下一階段，能大幅縮小認證失敗或環境污染時的排查範圍。
驗證本機網路
先使用穩定的有線網路或可靠 Wi-Fi，暫停佔用上傳頻寬的同步工作。企業網路使用者應確認代理伺服器、防火牆與出口策略允許所選連線方式。
- 測試基本連線能力與往返延遲，不要只看下載頻寬
- 觀察連續連線中的封包遺失與抖動，而非單次測速結果
- 準備另一條網路作為故障對照，避免誤判主機狀態
建立最小工作階段
首次只建立空白桌面或命令列工作階段，不要立即同步完整儲存庫。核對主機指紋、系統版本、鍵盤配置、顯示比例與可用磁碟空間，再更新初始憑證。
- 記錄已確認的主機指紋與確認管道
- 建立日常帳戶，避免長期使用高權限工作階段
- 驗證中斷連線後可透過既定方式重新連線
逐層接入工作
先遷移可驗證的小型樣本，再重現工具鏈，最後註冊 CI runner 或長時間工作。每一層都保留輸入、驗證點與完成標準，出現偏差時只回退目前這一層。
- 使用小型儲存庫驗證檔案權限與相依套件安裝
- 使用固定提交驗證建置產物是否一致
- 自動化工作結束後清理快取與臨時憑證
選擇連線方式
依工作選擇工作階段，不要讓圖形介面承擔所有工作
圖形介面適合需要視覺回饋的操作，命令列適合開發除錯與重複執行，檔案傳輸應與互動式工作階段分離，自動化工作則應由獨立 runner 帳戶承載。連線方式越貼合工作，權限邊界與故障定位就越清晰。
圖形介面
適合 Xcode、視覺化檢查與人工操作
用於專案設定、介面驗證、模擬器檢視、媒體預覽與需要拖放操作的工作。連線前先將解析度設為易讀檔位，再依網路狀況調整色彩品質。
- 適合
- 短時間人工操作、視覺核對、互動式除錯
- 限制
- 不適用於持續佔用前景的無人值守工作
開發除錯
由命令列處理建置、日誌與環境檢查
將相依套件安裝、版本核對、建置命令與日誌收集寫成可重複執行的指令碼。長時間工作使用可復原的工作階段管理方式，避免本機網路短暫中斷導致程序隨連線退出。
- 適合
- 編譯、測試、日誌追蹤、程序與磁碟檢查
- 限制
- 不要將敏感變數直接寫入命令歷程或共用指令碼
檔案傳輸
大型檔案使用可驗證、可續傳的傳輸路徑
原始碼優先透過版本控制同步；快取、素材與建置產物使用支援續傳與驗證的方式。先傳送小型樣本驗證權限與目錄，再批次遷移，避免完成後才發現目標目錄無法寫入。
- 適合
- 儲存庫、相依套件快取、素材、建置結果與檢查點
- 限制
- 剪貼簿只傳送短文字，不用於大型檔案或敏感資料遷移
自動化工作
CI runner 使用專用帳戶與清理規則
為 runner 設定獨立標籤、工作目錄與並行上限。金鑰在工作執行期間注入，工作結束後刪除暫存檔案、掛載與殘留程序，不讓人工桌面工作階段與自動化環境互相影響。
- 適合
- 持續建置、回歸測試、簽署檢查與批次處理
- 限制
- 不要與個人日常帳戶共用長期憑證與可寫入的快取目錄
首次連線流程
首次工作階段完成六項檢查後，才進入正式工作流程
首次連線的目標不是盡快看到桌面，而是建立一條可重複、可撤銷、可交接的存取路徑。以下六個步驟依相依關係排列，任何一步尚未確認，都不應直接匯入完整專案或長期憑證。
-
01
比對主機位址與訂單節點
將交付位址、機型、節點與租期逐項對照訂單。若團隊內有多台機器，請為每台建立獨立記錄，避免複製舊位址而連線至錯誤執行個體。
-
02
透過獨立管道核對主機指紋
首次命令列連線出現新指紋時，不要在未核對的情況下直接接受。將顯示值與交付記錄比對；若位址曾重新分配，應先清除舊記錄並確認新值。
-
03
立即更新一次性憑證
首次登入成功後更新臨時密碼或金鑰，將日常憑證存入受控的團隊憑證管理流程。不要把新憑證寫入專案儲存庫、建置日誌或工單內容。
-
04
建立最小權限帳戶
將日常開發、自動化與高權限維護分開。一般建置工作只取得專案目錄、快取目錄與必要工具的存取權；高權限操作按需執行並保留變更記錄。
-
05
驗證鍵盤、解析度與剪貼簿
分別測試中英文輸入、常用快速鍵、顯示縮放與剪貼簿方向。發現按鍵配置不一致時，先記錄本機與遠端配置，再調整對應，避免在程式碼編輯與命令輸入中產生隱蔽錯誤。
-
06
記錄復原與重新連線方式
主動中斷一次並重新連線，確認團隊知道從哪裡取回位址、如何驗證身分，以及憑證失效後如何透過控制台提交工單。復原說明應能由未參與首次設定的成員獨立執行。
遷移路徑
本機 Mac 到雲端 Mac：三條路徑分別驗收
不要將整個本機環境壓縮後一次複製。資料遷移、工具鏈重現與 CI 接入有不同的輸入與風險，應分別設定驗證點與完成標準。三欄全部通過後，雲端 Mac 才算真正接入現有工作流程。
起點
本機 Mac
保留可回退環境，凍結一份已知可用的提交、相依套件清單與建置結果。
資料遷移
- 輸入
- 原始碼、素材、必要快取、測試資料、建置產物與實驗檢查點。
- 驗證點
- 目錄權限正確；檔案數量與驗證值一致；敏感資料沒有進入公開目錄或日誌。
- 完成標準
- 從乾淨工作目錄取出專案後，可以讀取必要資源並產生與基準一致的最小產物。
工具鏈重現
- 輸入
- 系統版本要求、Xcode 版本、命令列工具、套件管理清單、編譯參數與環境變數名稱。
- 驗證點
- 編譯器、執行階段與相依套件版本可記錄；指令碼不依賴本機絕對路徑；快取刪除後可重新建立。
- 完成標準
- 固定提交在新環境中通過建置與測試，輸出版本資訊與關鍵產物均可追溯。
CI 接入
- 輸入
- runner 註冊資訊、專用標籤、並行策略、快取目錄、工作金鑰與結束清理指令碼。
- 驗證點
- 工作只在目標機器上執行；失敗後日誌足以定位問題；取消工作不會留下建置程序與臨時憑證。
- 完成標準
- 連續執行建置、取消與重試流程後，工作目錄可復原至預期狀態，人工工作階段不受影響。
驗收終點
雲端 Mac 工作流程
資料可驗證、工具鏈可重現、自動化工作可清理，團隊成員能依照記錄完成交接。
工作階段體驗最佳化
先處理抖動與畫面負載，再考慮提高解析度
遠端工作階段的穩定性取決於往返延遲、抖動、封包遺失、編碼負載與畫面變化頻率。單純提高頻寬或解析度不一定能改善體驗，應依序從節點、網路與畫面參數排查。
節點選擇
在新加坡、日本（東京）、韓國（首爾）與香港之間，優先選擇實際往返路徑穩定的節點，而不是只按地理直線距離判斷。使用同一網路、同一時段進行多次測量並比較中位數。
網路抖動
若滑鼠與鍵盤回應時快時慢，先暫停雲端硬碟同步、視訊會議與大型檔案上傳。切換至有線網路或另一個出口重新測試，區分本機網路波動與遠端工作階段問題。
解析度
從單螢幕、較低縮放檔位開始。確認互動穩定後再提高解析度；多螢幕與高縮放會增加畫面編碼與傳輸壓力，不適合作為排查時的預設條件。
色彩品質
程式碼編輯、建置檢視與一般介面操作可優先確保畫面回應；媒體預覽與色彩檢查時再提高畫質。將「操作模式」與「審閱模式」分開，避免長期使用最高畫質。
剪貼簿
只傳送短文字，貼上命令前檢查換行與特殊字元。密碼、私密金鑰、大段日誌與二進位內容不應透過共用剪貼簿在多人工作階段之間傳遞。
大型檔案傳輸
使用獨立傳輸工作並啟用續傳與驗證。傳輸期間降低圖形工作階段畫質，避免上傳佔滿出口；完成後核對驗證值，不要只根據檔名與大小判斷成功。
安全結束與交接
關閉視窗不等於完成退出
遠端工作階段結束前，應明確確認工作狀態、憑證狀態、資料同步狀態，以及下一位接手者需要知道的變更。尤其是長時間建置、實驗與批次處理工作，必須區分「中斷畫面」與「停止程序」。
退出前六項核對
01
停止敏感工作
結束包含臨時金鑰、客戶資料或除錯代理程式的程序；需要繼續執行的長時間工作應轉入可復原工作階段並記錄負責人。
02
清理臨時憑證
移除一次性檔案、臨時環境變數、測試權杖與下載目錄中的敏感資料，檢查命令歷程與建置日誌是否留下明文。
03
確認資料同步
核對儲存庫狀態、未提交變更、產物上傳與檢查點同步結果。大型檔案以驗證結果為準，不以傳輸視窗顯示完成為準。
04
關閉不再需要的工作階段
退出應用程式與命令列連線，清理臨時連接埠轉送與掛載。僅關閉本機視窗可能仍保留遠端工作階段，應確認實際程序狀態。
05
記錄環境變更
寫明新增工具、版本切換、權限調整、快取位置與待處理問題，讓下一位成員能判斷目前環境與基準的差異。
06
完成團隊交接
交接工作目標、目前提交、最近一次成功結果、失敗日誌位置與復原步驟。憑證透過受控管道傳遞，不要寫入一般交接文件。
交接記錄至少包含
- 訂單號碼與節點代碼
- 機器用途與目前負責人
- 專案提交或實驗檢查點
- 最近一次成功工作的時間範圍
- 未完成事項與可重現步驟
- 復原方式與日誌所在目錄
不要寫入交接記錄
- 明文密碼、私密金鑰與完整權杖
- 未經去識別化的客戶資料
- 可直接重複使用的一次性憑證
- 與目前問題無關的完整系統日誌
故障排查與求助
先定位故障發生在哪一層，再提交可重現資訊
連線故障通常發生在網路路徑、主機身分、帳戶驗證、畫面傳輸或工作階段復原其中一層。按照以下檢查樹逐層排除，不要在原因尚未確認時反覆修改多項設定。
連線逾時：無法連線至位址或工作階段持續等待
- 確認位址：重新複製交付位址，排除舊記錄、空格與連線至其他訂單的情況。
- 確認本機出口：檢查企業代理伺服器、防火牆與所需連接埠，使用另一條網路進行對照。
- 確認網路品質：持續觀察往返延遲、抖動與封包遺失，不要以單次成功探測作為穩定依據。
- 提交資訊：提供訂單號碼、節點、發生時間、使用的連線方式與去識別化後的錯誤內容。
驗證失敗：帳戶、憑證或主機身分不相符
- 停止重複嘗試：連續輸入錯誤憑證可能使排查記錄變得混亂，先確認帳戶名稱與憑證來源。
- 區分錯誤類型：主機指紋變更、帳戶不存在、憑證失效與權限不足並不是同一個問題。
- 核對最近變更：檢查是否剛更新憑證、替換金鑰、調整帳戶權限或重新分配連線位址。
- 安全求助：透過控制台工單提交訂單號碼與錯誤時間，不要在工單中貼上密碼或私密金鑰。
畫面卡頓：滑鼠延遲、輸入跳動或影像模糊
- 降低畫面負載：先改用單螢幕與較低解析度，關閉動態桌布、影片預覽與不必要的動畫。
- 釋放本機出口：暫停同步、上傳與會議流量，優先使用有線連線。
- 比較節點路徑：在同一時段對四個在售節點進行多次測量，以抖動與封包遺失作為主要依據。
- 分離工作：大型檔案改用獨立傳輸，持續建置改用命令列或 runner，不佔用圖形工作階段。
工作階段中斷：本機斷線後無法復原原有工作
- 判斷程序是否仍在執行：關閉圖形視窗不代表遠端工作已停止，先透過另一種已獲授權的方式檢查程序。
- 檢查工作階段設計：長時間工作應在可復原環境中執行，並將日誌寫入固定目錄。
- 核對資源狀態：檢查磁碟空間、記憶體壓力與異常退出記錄，避免將資源耗盡誤判為網路問題。
- 保留時間線：記錄中斷前的操作、發生時間、重新連線結果與最近一次可用狀態，方便支援人員重現問題。
仍然無法定位問題？
先查看完整支援指南；需要人工判斷時，透過聯絡頁取得支援電郵，或登入控制台提交工單。請附上訂單號碼、節點、發生時間、重現步驟與去識別化日誌。