SDKMac
節點交付與基礎運作
SDKMac 依訂單記錄準備專屬實體 Mac 節點，顯示節點設定、區域、交付階段與可存取狀態，並維持承載服務所需的基礎運作條件。
- 核對訂單對應的機型、記憶體、儲存空間與區域
- 產生初始存取憑證，並透過受控流程交付
- 在主控台記錄訂單確認、節點準備與可存取狀態
- 接收連線異常、設定不符與可疑存取的支援請求
節點責任登錄
清楚界定實體隔離、存取控制與資料責任
每筆訂單對應一台專屬實體 Mac 節點，而不是與其他租戶共用運算資源和本機儲存空間的虛擬機器。SDKMac 負責節點交付與基礎運作，使用團隊則負責帳戶、憑證、專案資料與內部權限。
NODE RESPONSIBILITY RECORD
專屬節點責任登錄
責任邊界已列明
資源類型
專屬實體機器
租戶共用
不共用
運作標準
全年 365 天正常運作
01
SDKMac 負責
平台
訂單確認、實體節點交付、基礎運作與主控台狀態記錄。
02
團隊負責
使用者
帳戶安全、憑證更新、專案資料、工具鏈與成員授權。
03
共同核對
協作
設定、區域、交付狀態、異常時間軸與去識別化證據。
責任邊界概覽
先確認各層責任歸屬，再討論安全措施
實體節點是否專屬，只能回答資源歸屬問題。帳戶操作、團隊授權、專案備份與工具鏈變更，仍需明確指定負責人。
使用團隊
帳戶、憑證與專案資料
團隊應將節點視為遠端生產資源管理，而不是無人負責的臨時電腦。成員加入、離開或職責變更時，都應同步調整授權。
- 保護帳戶登入方式與節點存取憑證
- 控管成員權限，並定期複核實際使用者
- 管理儲存庫、簽署材料、模型、素材與建置產物
- 確認 macOS、Xcode 與專案相依套件的相容性
共同核對
異常證據與變更結果
發生問題時，雙方依靠同一組可核對資訊協作。記錄越完整，就越容易區分本機網路、用戶端設定、系統變更與節點狀態。
- 使用訂單識別碼與節點區域定位記錄
- 依時間軸說明最後一次正常操作與異常現象
- 提交已去識別化的記錄檔、螢幕截圖與重現步驟
- 完成變更後複核存取權限、設定、磁碟與工作結果
節點隔離說明
一筆訂單對應一台專屬實體 Mac
運算資源與節點本機儲存空間不與其他租戶共用。這項邊界適合需要持續建置、固定工具鏈、長時間實驗與可追蹤節點記錄的團隊。
ORDER → PHYSICAL NODE
資源歸屬鏈
訂單記錄
設定與區域
先確認機型、記憶體、儲存空間、租用期間與節點區域。
節點登錄
專屬實體機器
節點依訂單交付，不拆分為多租戶虛擬運算資源。
團隊工作區
自行管理環境
團隊自行維護工具鏈、儲存庫、快取、權限與專案資料。
運算資源不跨租戶共用
建置、測試或實驗工作會在訂單對應的實體節點上執行。團隊仍應依據並行工作量與記憶體壓力選擇合適設定。
本機儲存空間不跨租戶共用
節點本機磁碟屬於該訂單的工作環境，但本機副本不應成為專案資料、簽署材料或建置產物的唯一副本。
存取憑證生命週期
從產生憑證開始，就應明確指定持有人與撤銷條件
不要將首次收到的憑證長期當作團隊共用密碼。交付完成後，應立即納入團隊自己的存取控制流程。
-
01
產生
初始憑證會與訂單及節點記錄建立關聯。接收前先核對訂單識別碼、節點區域與主機資訊，避免混用不同節點的記錄。
-
02
交付
僅向實際負責節點的成員傳送存取資料。不要在公開頻道、專案文件或未受控的工作描述中複製完整憑證。
-
03
首次更新
首次連線後更新可更新的存取憑證，並將保管人、更新時間與適用節點記錄在團隊內部登錄中。
-
04
內部授權
依成員職責授予最小權限。開發、發佈、維運與稽核角色不應預設擁有完全相同的存取範圍。
-
05
撤銷與複核
成員離開團隊、職責變更、裝置遺失或憑證疑似外洩時，應及時撤銷原有授權並核對近期存取記錄。
遠端連線防護
將遠端入口限縮至真正需要的使用者與來源
連線防護應同時涵蓋憑證強度、成員權限、來源限制、用戶端安全與支援溝通，而不是只依賴單一密碼。
最小權限
區分日常開發、自動化工作與管理操作的權限。臨時協作者只取得完成工作所需的存取範圍，工作結束後即撤銷。
強憑證
避免跨服務重複使用憑證。團隊應使用受控工具保存存取資料，並記錄誰能讀取、更新與撤銷節點憑證。
來源限制
在團隊網路條件允許時限制連線來源。成員從新網路連線前，應先確認本機裝置、用戶端版本與網路路徑可信。
定期審查
複核仍在使用節點的成員、自動化工作、長時間工作階段與授權記錄。發現不再需要的入口時，應及時清理。
提交工單前先移除敏感資訊
進入主控台提交工單
支援請求可以包含錯誤片段、發生時間與重現步驟，但不應提交完整私密金鑰、存取權杖、儲存庫金鑰、簽署材料或未處理的設定檔。需要關聯節點時，提供訂單識別碼與節點區域即可。
系統與工具鏈管理
先確認相容性，再修改正在運作的環境
macOS、Xcode、命令列工具與專案相依套件彼此關聯。任何一層的變更都可能改變編譯結果、快取狀態或自動化工作行為。
變更前
建立可回復的基準線
- 記錄目前 macOS、Xcode 與命令列工具版本
- 確認專案相依套件、建置腳本與 Runner 的相容範圍
- 儲存關鍵設定、相依套件鎖定檔與必要安裝材料
- 選擇不會中斷關鍵建置工作的變更時段
變更中
一次只變更可核對的範圍
- 暫停會寫入同一快取或產物目錄的工作
- 記錄實際執行的版本調整與設定修改
- 避免同時升級系統、工具鏈與全部相依套件
- 保留錯誤輸出，不要以重複操作覆蓋現場
變更後
以小型工作驗證完整流程
- 執行可重現的小型編譯或測試工作
- 核對簽署流程、快取目錄、磁碟變化與產物
- 確認遠端連線與自動化 Runner 是否恢復
- 結果不符預期時，依已儲存的材料回復
節點全年 365 天正常運作，維持持續運行。
使用者發起的系統或工具鏈調整，應由團隊自行選擇合適時段、儲存回復材料並驗證結果。基礎運作異常則透過主控台記錄與支援流程協同處理。
資料管理建議
節點本機副本不是唯一副本
專屬本機儲存空間有利於持續建置與長時間工作，但專案關鍵資料仍應遵循團隊自己的版本管理、備份與復原策略。
資料類別
節點上的用途
團隊應保留的外部副本
專案儲存庫
擷取原始碼、建立工作分支、執行建置與測試。
受控程式碼儲存庫、分支記錄與必要的發佈標籤。
簽署材料
依專案流程完成建置或發佈所需的簽署操作。
限制存取的加密備份、負責人記錄與復原流程。
模型與資料集
準備推論或實驗工作，儲存階段性輸入。
來源記錄、版本說明、完整原始檔案與驗證資訊。
建置產物
本機檢查、自動化測試與交付前驗證。
依團隊規則封存的可追蹤產物及其建置記錄。
快取與暫存檔案
縮短重複工作的準備時間並支援中間運算。
通常不需長期保留，但應能從原始碼與相依套件重新產生。
事件溝通流程
以時間軸與去識別化證據縮短定位路徑
連線異常、設定不符或可疑存取應分別記錄，但都可依同一套資訊順序提交，避免反覆補充關鍵背景。
-
1
停止擴大影響
暫停重複登入、大量重試或會覆寫記錄的自動化工作。若懷疑憑證外洩，先限制相關成員與工作繼續使用該憑證。
-
2
記錄時間與現象
寫明最後一次正常操作、首次發現異常的時間、受影響的工作、用戶端與網路來源，以及是否能穩定重現。
-
3
核對訂單與節點
確認訂單識別碼、節點區域、應有設定與主控台狀態。設定問題應列出預期值與實際觀察值，不要只寫「設定不正確」。
-
4
整理去識別化證據
附上必要的錯誤片段、螢幕截圖、重現步驟與已執行的疑難排解動作。隱藏金鑰、權杖、個人資料及專案敏感內容。
-
5
透過主控台提交
使用與訂單關聯的工單入口提交，後續補充資訊也集中在同一筆記錄中，方便雙方依完整時間軸繼續處理。
可靠性資訊原則
只顯示可追溯至記錄的狀態
可靠性說明應協助團隊做出操作決策，而不是用未經驗證的數字取代事實。
交付階段有來源依據
訂單確認、節點準備、憑證產生與可存取狀態以主控台記錄為準。頁面說明不取代特定訂單的即時狀態。
可租用狀態即時回傳
SDKMac M4 與 SDKMac M4 Pro 的實際可用情況以主控台即時回傳為準，不建立帶時間戳記的靜態狀態快照。
效能結論需要背景資訊
建置時間會受到專案規模、相依套件下載、快取命中率、工作並行數與網路路徑影響，不以單次結果取代可重現測試。
不採用未經稽核的背書
不捏造認證、可用率、效能等級或使用者數量。團隊應依據設定事實、訂單記錄與自身驗證工作評估服務。
1 筆訂單
對應 1 台專屬實體節點
2 種設定
SDKMac M4 與 SDKMac M4 Pro
365 天
節點正常運作，維持持續運行
1 條記錄鏈
訂單、交付、狀態與工單集中核對
需要一台歸屬清楚、可持續運作的實體 Mac 節點
先選擇 SDKMac M4 或 SDKMac M4 Pro，再確認租用期間與節點區域。提交訂單後，透過主控台追蹤交付記錄與可存取狀態。