品牌與產品團隊每次調整 Design Token，都需在多主題下產出可比的 PNG 預覽。本篇整理遠端 Mac上以 OpenClaw 串接閘道、監聽或任務觸發、token JSON 批量彩現、閾值對比與差異報告的步驟與清單；安裝總覽見《OpenClaw 全平台安裝指南》。
多主題品牌素材的痛點
macpng 使用者常交付 Logo、活動主視覺與介面條帶，須在多主題下維持觀感一致。未自動化時常見三類問題：
- 靜默漂移：JSON 裡改了一個十六進位色碼，部分預覽未重渲，審核依據錯誤。
- 環境不可複現：本機字型平滑、色彩描述檔與 CI 不一致，PNG 永遠對不齊。
- 審閱低效：僅靠資料夾並排難以掃完；利害關係人需要帶閾值的 diff 與一頁摘要。
將重負載固定在同一台遠端 Mac，由 OpenClaw 排程技能與檔案存取，日誌可對齊 token 版本。
觸發方式：監聽／定時／手動
| 觸發 | 適用 | 注意 |
|---|---|---|
| 防抖資料夾監聽 | 設計將更新後的 tokens.json 或匯出資源丟進 inbox/ |
避開 iCloud 反覆同步；防抖數秒，避免每次自動儲存都入列 |
launchd／cron |
夜間對 main 分支 token 做迴歸 | 建議依 git 提交雜湊或檔案 mtime 閘門，避免空轉 |
| 手動呼叫技能 | 發版前或審閱會前定點出圖 | 依賴 SSH 上有人觸發；適合與 CI webhook 互補 |
多批 PNG 目錄與鎖檔寫法可參考《OpenClaw 監聽資料夾批量 PNG 套圖》：合併事件、寫處理鎖、每批帶 batch id 記日誌。
可複現流水線步驟
- 準備遠端機與目錄：租用 Mac mini M4 節點，依 使用說明與幫助設定 SSH／VNC；建立
tokens/、templates/、out/previews/、out/diff/、logs/、baselines/。 - 安裝 OpenClaw 並啟用閘道：版本與相依套件依安裝指南鎖定；閘道健康檢查 URL 須回傳正常，API 金鑰須可讀專案根。
- 註冊技能或封裝腳本：參數含主題列表、畫布寬高、PNG 命名規則、基線目錄與閾值設定。
- 接上觸發器：
fswatch監聽tokens/防抖數秒，或由流水線在合併後 POST 呼叫技能。 - 彩現迴圈：逐主題合併變數到模板，無頭場景固定 DPR、關動畫、背景寫死；輸出
{元件}_{主題}_{寬}x{高}.png，並與上一版已核准基線做像素級對比，超標寫熱力圖與失敗原因。 - 發布產物：在
out/diff/產生report.md或summary.json，可同步至 DAM 或工單附件。
Token JSON 約定與彩現迴圈
每條品牌線維護一份清單即可。最小結構含 themes[]：每項有 id、colors 語意對應、radius、可選 font，以及 template 路徑。OpenClaw 步驟在啟動無頭彩現前先做 JSON Schema 校驗，避免半行 JSON 拖垮整批。
- 決定性：固定裝置倍率、停用過渡動畫、顯式背景色；若交付要求 sRGB，依團隊色彩規範嵌入或轉換 ICC（勿混用 P3 與 sRGB）。
- 命名與批量：主題 id 用小寫 slug；M4 上單次可先 12～48 張預覽，再視記憶體與 GPU 決定是否平行。
閾值對比與報告輸出
可用 ImageMagick compare 或同類工具取得數值與可選熱力圖。常見閘門：在統一縮放寬度（如 1024 px）後，變更像素占比低於約 1%，且 RMSE 不超過經標定的上限。報告每行建議含：主題、檔名、指標、是否通過、熱力圖路徑、基線雜湊。體積、透明與色盤規則可與《OpenClaw PNG 批量質檢》對齊，避免只看像素、忽略通道。
常見錯誤與重試
| 現象 | 可能原因 | 重試策略 |
|---|---|---|
| 閘道 502／逾時 | 技能冷啟動或連接埠衝突 | 指數退避 2s、4s、8s；連續三次失敗重啟閘道後再試 |
| 寫入 Permission denied | 沙箱或 SSH 使用者與目錄擁有者不一致 | whoami 對齊擁有者與 ACL，修正後單次重跑 |
| 白畫面或色偏 | 缺字型、P3 與 sRGB 混用 | 遠端機安裝完整字庫，統一色彩設定後全量重渲 |
| diff 永遠失敗 | 反鋸齒雜訊或尺寸不一致 | 先統一尺寸，適度 fuzz，或由審閱確認後調整閾值 |
建議在 logs/runs.jsonl 逐行追加：時間戳、git sha、通過數、失敗數，便於回溯是哪次 token 變更引入迴歸。
上線前驗收清單
- 閘道健康；OpenClaw 與彩現相依版本已鎖定並寫入文件
- Token Schema 校驗通過；模板路徑在遠端機上存在且可讀
out/、logs/對執行帳號可寫；監聽目錄不在 iCloud「僅下載」項目上- 基線已版本化；閾值數字寫在 README 並經已知良品對校準
- 監聽防抖與處理鎖生效，禁止重疊跑批；報告已上傳或工單可存取連結
FAQ
token JSON 最少要哪些欄位？
主題 id、模板會用到的語意色與圓角／字階即可起步；路徑一律相對儲存庫根，減少環境差異。
閾值一開始怎麼定？
先用 0.5%～1% 變更像素區間試跑，蒐集誤報再收緊或放寬，並記錄規則版本。