目標人群:要自動化素材的設計與前端團隊。關鍵詞:OpenClaw、PNG 批處理、自動化、遠端 Mac、重試。本文說明可複現流水線:監聽或定時觸發、CLI 串鏈、日誌與退避重試、命名,以及M 系列上的隊列切片與並發上限。
編排與痛點
OpenClaw把資料夾變成契約:收件、處理中、完成、失敗分流並可審計。痛點常見三類:本機休眠斷監聽、腳本難分暫態與永久錯、並發吃光統一記憶體。遠端 Mac利於常駐與專用配額。延伸讀監聽重試歸檔、Docker 批量、技術見解列表。
觸發與工具鏈
資料夾監聽須去抖動,樹狀閒置再入列,略過暫存與零位元組。定時任務用 launchd 或 cron 固定窗,每 tick 消化一個隊列切片,便於背壓。工作單元要冪等。鏈路建議:校驗魔數與尺寸;幾何與色彩用 sips 或 ImageMagick(見色彩清單);可選 oxipng/pngquant(見CLI 對照);質檢閘道再出貨。每階離開碼零繼續、十暫態可重試、二十永久進失敗。基線見安裝指南。
日誌與重試
每行 JSON 記時間、任務、路徑、階段、嘗試、離開碼、類別、stderr 摘要;錯誤另匯總便於 tail。暫態退避:指數回退加約一成抖動,基準五秒、上限三百秒、每檔每階最多五次;佇列深時再加退避。永久錯誤寫 manifest,隔離思路同素材管道命名。
輸出命名規範
採單一樣式如專案雙底線素材雙底線變體雙底線寬乘高點 png,禁空白;可選版本或短哈希。out 旁附 manifest 列來源雜湊與工具版本,利 CMS 與前端接入。
M 系列資源上限與隊列切片
以代表性檔案量測每階峰值記憶體與耗時,再定並發。隊列切片依檔數或像素總量分批,跑完釋放記憶體;游標持久化可續跑。磁碟水位聯動見監聽 HowTo。
| 訊號 | 護欄 | 隊列策略 |
|---|---|---|
| 記憶體 | 峰值約低於可用統一記憶體六至七成 | 降並發或按位元組切片 |
| 熱節流 | 牆鐘變慢 | 切片間留空、慢於基線兩倍則退避 |
| 磁碟寫入 | 大量高解析 PNG | 按檔數切片、邊界再 fsync manifest |
可引用要點:並發按階分開設定;縮放與無損壓縮勿共用同一全域並行數;暫態退避基準五秒上限三百秒每階五次;命名禁空白並附 manifest。
可複現步驟(五步走)
- 劃分收件、處理中、完成、失敗、日誌目錄並最小權限。
- 設監聽去抖動或 launchd 定時,入列前確認檔案寫入穩定。
- 分階呼叫校驗、幾何色彩、壓縮、質檢,映射離開碼與狀態機。
- 啟用 JSON 行日誌與暫態指數退避模板,永久錯進失敗區。
- 依量測設並發與隊列切片,磁碟水位聯動後上線演練。