硬體驗收
核對 M4、16GB RAM 與基本的 256GB SSD。若訂單包含儲存空間附加項，再另外檢查可用容量與掛載位置。
依工作推進
準備、連線、執行，再定位問題
這不是一組零散的指令。先在控制台核對訂單與節點，再建立連線、重現工具鏈，最後用可保留的日誌驗收工作。適用於 NowMini M4、16GB RAM、256GB SSD 的獨享物理機。
- 4 類工作
- 準備、連線、執行、排查
- 4 個節點
- 新加坡、日本（東京）、韓國（首爾）、香港
- 1 種配置
- NowMini M4 獨享物理節點
快速定位
先描述你正在執行的工作
輸入「Xcode」「SSH」「runner」「磁碟」等詞彙，頁面會保留相關步驟。也可以直接選擇下方的工作入口。
首次開通
連線前先完成六項確認
不要把訂單確認、網路放行與系統初始化混在同一次連線中。依序記錄結果，驗證失敗時才能快速定位問題邊界。
開通檢查清單
從控制台資訊到首次工作階段
以控制台即時回傳的訂單與節點資訊為準。不要從舊工單或團隊聊天記錄複製主機位址。
01
確認訂單識別碼
記錄訂單識別碼、租用期限與 NowMini M4 配置，確認目前操作的是目標訂單。
02
核對節點區域
確認是新加坡、日本（東京）、韓國（首爾）或香港，並讓團隊成員使用相同的區域名稱溝通。
03
讀取系統憑證
核對使用者名稱、主機位址與金鑰要求。憑證只存放在受控密碼庫中，不要寫入程式碼儲存庫。
04
確認存取來源
記錄辦公網路、固定出口或 runner 的來源位址，避免在未知的公共網路上進行首次初始化。
05
建立首次連線
先驗證網路是否可達，再驗證主機指紋與金鑰權限。不要連續修改多個變數後重複嘗試。
06
完成帳戶初始化
建立工作所需的最小權限環境，設定工作目錄與日誌目錄，並儲存一份不含機密的驗收記錄。
工作階段驗收
分別記錄 SSH 與圖形工作階段是否能建立、首次連線所需時間，以及鍵盤輸入與剪貼簿是否符合工作需求。
開啟連線說明
開發環境
依照相依性重現工具鏈
先固定工具版本，再接入憑證、快取與簽署材料。順序顛倒時，往往會把版本問題誤判為權限問題。
固定 Xcode 工具鏈
先確認目前選用的開發者目錄，再記錄 Xcode 與 SDK 版本。團隊流水線應將版本作為建置輸入，而不是依賴互動式選擇。
- 檢查命令列工具路徑
- 記錄編譯器與 SDK 版本
- 使用最小專案完成一次基準建置
設定 Git 憑證
為節點或自動化帳戶設定獨立金鑰，只授予必要的儲存庫權限。首次拉取後記錄遠端位址、分支與提交基準。
- 驗證金鑰檔案權限
- 核對儲存庫讀寫範圍
- 避免在指令碼參數中暴露機密
區分相依性與快取
將可重建的相依性、編譯快取與最終產物分開。快取鍵至少應包含工具版本、鎖定檔摘要與目標平台。
- 鎖定相依性解析結果
- 限制快取目錄增長
- 保留清除快取後的基準建置方式
最後匯入簽署材料
憑證、描述檔與解鎖資訊應在工具鏈驗證後匯入。使用受控目錄，工作結束後清理暫存副本。
- 記錄憑證有效範圍
- 限制鑰匙圈存取主體
- 使用封存工作驗證簽署鏈
驗收標準
同一提交在乾淨工作目錄中能完成相依性解析、編譯、測試與封存；失敗時能從日誌看出具體階段，而不是只留下「建置失敗」的最終狀態。
CI/CD 整合
將物理節點接入現有佇列
runner 是執行入口，不應同時承擔機密儲存庫、長期產物庫與團隊共用目錄。先劃清目錄與權限，再追求並行。
執行鏈路
五個環節，一條可稽核的時間線
每次工作至少記錄提交、runner、開始時間、結束狀態與產物位置。節點全年 365 天正常運作，持續提供服務。
註冊 runner
使用獨立的自動化帳戶註冊執行器，標籤只表達系統與工作能力，不包含機密或個人名稱。
隔離工作目錄
每條流水線使用獨立的工作路徑。工作結束後刪除暫存檔案，避免上一項工作污染下一次建置。
定義快取策略
依鎖定檔與工具版本命名快取，設定容量上限，並保留未命中快取時的完整執行路徑。
回傳建置產物
將封存檔、符號檔與測試報告回傳至團隊既有儲存空間，節點工作目錄不應作為唯一副本。
保留失敗日誌
保留失敗階段、結束代碼與關鍵上下文。提交支援請求前移除權杖、金鑰與簽署材料。
並行控制
先以單一工作完成基準，再逐步增加佇列並行數。16GB RAM 下應依實際工作峰值拆分測試、封存與推理工作。
重試邊界
只對網路瞬斷等可復原步驟重試。編譯、測試或簽署失敗時應保留原始結果，避免重試覆蓋首次錯誤現場。
產物驗證
回傳後核對檔案大小、摘要與工作識別碼。團隊成員應能從流水線記錄追溯至對應提交與建置環境。
MLX 實驗
先驗證環境，再擴大推理工作
NowMini M4 適合建立可重現的小型 MLX 實驗。模型檔案、執行參數與結果記錄應彼此分離，方便清理與重新執行。
MLX CHECKPOINTS
NOWMINI M4
環境驗證
記錄 Python、MLX 與關鍵相依性版本，使用小型張量操作確認環境可執行。
模型放置
模型檔案放入獨立資料目錄，驗證檔案摘要，不要與原始碼儲存庫或暫存快取混放。
工作執行
固定模型、輸入、取樣參數與隨機種子；先執行小批次，再觀察記憶體與輸出的穩定性。
資源監控
記錄峰值記憶體、磁碟增長、執行時間與結束狀態，防止日誌或中間結果佔滿空間。
一次實驗至少要保留什麼
- 輸入
- 模型識別碼、檔案摘要、提示或資料集版本
- 環境
- 系統、Python、MLX 與相依性版本
- 參數
- 批次大小、生成長度、取樣設定
- 結果
- 執行時間、峰值資源、輸出摘要、結束狀態
儲存空間邊界
基本方案包含 256GB SSD。下載模型前先核對可用空間；大型模型、中間結果與多版本權重應納入清理計畫，或在訂購時選擇固定儲存空間附加項。
查看方案與儲存空間
故障樹
從邊界條件開始，不要隨機修改配置
先判斷問題發生在本地網路、存取控制、驗證、工具鏈還是資源層。每次只變更一個變數，並記錄結果。
無法連線節點：先檢查哪一層
- 確認本地網路可以存取外部服務，關閉可能改變路由的暫時代理後再測試。
- 從控制台重新核對主機位址與節點區域，不要使用舊截圖中的位址。
- 確認目前存取來源符合限制，並檢查本地防火牆是否封鎖目標連接埠。
- 分別記錄 DNS 解析、網路可達性與協定握手結果，避免只提供「連不上」的結論。
驗證失敗：如何區分使用者名稱與金鑰問題
- 核對使用者名稱是否對應目前節點，不要沿用其他伺服器的帳戶名稱。
- 檢查私密金鑰檔案權限、檔案格式，以及用戶端實際載入的金鑰路徑。
- 驗證主機指紋是否與首次記錄一致；出現變更時先停止連線，並提交工單核對。
- 開啟用戶端詳細日誌，保留驗證方法協商與伺服器拒絕階段，提交前移除敏感內容。
建置異常：從版本、相依性還是簽署開始
- 先確認 Xcode、SDK 與命令列工具路徑與基準一致。
- 在乾淨工作目錄中重新解析鎖定的相依性，判斷是否受到快取污染。
- 將編譯問題與簽署問題分開：先完成不依賴發布簽署的建置，再驗證封存。
- 保留第一個錯誤及其上下文，不要只截取日誌末尾的彙總資訊。
磁碟空間不足：優先檢查哪些目錄
- 記錄總容量、已用容量，以及工作開始前後的變化，不要立即刪除所有檔案。
- 依序檢查建置快取、封存檔、測試結果、下載的模型與持續增長的日誌目錄。
- 確認產物已回傳後再清理節點副本，避免連同唯一可復原的檔案一起刪除。
- 為快取與日誌設定容量上限，將清理動作納入工作結束流程。
工作逾時：如何判斷是速度慢還是已阻塞
- 對照最後一筆有效日誌，判斷工作仍在計算、等待網路，還是等待子程序。
- 檢查同一節點是否有其他工作競用記憶體、磁碟或工作目錄鎖。
- 為下載、建置、測試與上傳設定個別逾時，不要使用單一總逾時涵蓋所有階段。
- 重試前儲存程序狀態與失敗日誌；若能穩定重現，附上最小工作提交工單。
診斷記錄
一次有效的排查應留下五項資訊
- 發生時間包含時區
- 節點區域四個在售節點之一
- 操作步驟可重複執行
- 預期與實際說明差異
- 脫敏日誌保留錯誤上下文
安全操作
將存取權限納入工作生命週期
憑證不是設定一次後便永久不變的檔案。人員、runner、網路來源或專案發生變更時，都要重新檢查權限邊界。
輪換憑證
成員變更、懷疑金鑰外洩或自動化帳戶調整後立即輪換。停用舊憑證後再驗證新憑證，避免同時保留多組未知入口。
限制存取來源
優先使用可識別的固定出口。臨時開放的來源在工作結束後撤銷，並記錄變更人員、用途與撤銷結果。
最小化自動化權限
runner 使用獨立帳戶與獨立金鑰，只存取目標儲存庫、工作目錄與產物位置。不要讓建置指令碼繼承個人的長期權限。
遷移與交接清理
先回傳原始碼、模型與產物，再刪除暫存憑證、金鑰、快取與包含敏感欄位的日誌。由接收人依清單重新驗收。
交接完成的判定
新負責人能使用自己的授權建立連線、執行基準工作並讀取日誌；舊負責人的憑證已撤銷；節點上不存在無人負責的暫時帳戶與機密副本。
人工支援
將問題整理成可立即執行的工單
已有訂單的問題優先在控制台提交工單；售前諮詢、批次工作流程評估或無法登入時，可寄送電子郵件。對外聯絡管道僅限這兩種。
工單欄位
提交前準備六項內容
資訊越接近可重現條件，就越容易直接進入診斷，而不是反覆確認基本事實。
- 訂單識別碼
- 控制台顯示的目前訂單識別碼
- 節點區域
- 新加坡、日本（東京）、韓國（首爾）或香港
- 發生時間
- 寫明日期、時間與時區
- 重現步驟
- 從正常狀態到錯誤出現的操作順序
- 實際結果
- 錯誤文字、結束代碼或異常行為
- 脫敏日誌
- 保留上下文，移除密碼、金鑰與權杖
不要提交敏感材料
工單與電子郵件中不要附帶密碼、私密金鑰、完整支付憑證、簽署材料或可直接存取程式碼儲存庫的權杖。
已有訂單的問題
登入控制台提交工單，即可將問題與訂單及節點建立關聯。適用於連線異常、帳單核對、節點狀態與現有工作問題。
提交控制台工單售前與登入協助
寄送電子郵件至 support@nowmini.com，說明工作流程、目標區域、預計租用期限與可重現的問題。電子郵件地址可直接換行顯示。
寄送電子郵件至 support@nowmini.com
下一步
配置明確後，立即開始使用
選擇 NowMini M4 獨享物理機，在新加坡、日本（東京）、韓國（首爾）或香港執行建置、自動化與 MLX 工作。實際可用性以控制台即時回傳為準。