HEIC 定稿与 PNG 交付并存时,须在远程 Mac上把监听、sips 转码、ICC、体积阈值与重试一次说清。本文给出可复现步骤、决策表、网关健康检查与色彩 FAQ;ICC 细则见《PNG 元数据与 ICC 再压缩清单》。
痛点与约束
- 半文件入队:导出未闭合即触发,易出空壳 PNG。
- 色彩漂移:宽色域与元数据未统一 ICC 时下游各看各的。
- 体积与单点:大 PNG 超接口上限;网关挂仍入队则堆积,需阈值与探活。
目录与《PNG 监听、队列重试与日志归档》对齐:in、out、failed、logs 写进文档。
方案决策矩阵
macOS 批处理优先系统工具;复杂合成再引入其他栈。
| 路径 | 适用 | ICC 与维护 |
|---|---|---|
| sips | 转 PNG、缩放、挂 ICC | -m 指 sRGB;可版本化,宜远程机 |
| 自动操作 | 本机一键 | 需图形会话,不宜 SSH 主力 |
| 第三方库 | 跨平台或特管色彩 | 依赖与审计成本更高 |
落地步骤(可复现)
一、目录。本地卷建 heic_in、png_out、failed、logs,避开 iCloud;账户对入站读、对出站与日志写。
二、监听。fswatch 盯 *.heic,防抖二十至六十秒或两次 stat 大小不变再交 OpenClaw;忽略临时文件与 .DS_Store。
三、sips。转 PNG 后嵌入约定 ICC(路径按机器调整):
SRGB="/System/Library/ColorSync/Profiles/sRGB Profile.icc"
sips -s format png "$SRC.heic" --out "$DST.png"
sips -m "$SRGB" "$DST.png"
若走 matchProfile,规则里白名单配置文件,防非交付色彩空间;全链路见《PNG 色彩管理 sRGB 与 P3 清单》。
四、编排。队列调 sips、写 png_out、写 manifest;网关与技能按官方文档完成最小安装校验。用 launchd 或 tmux 常驻。
五、验收。命名与资源表同源;抽检 ICC 与体积规则。
OpenClaw 网关健康检查思路
对网关做HTTP 探活(如 /health)、设超时与连续失败阈值;不健康时暂停入队,防无限重试占盘。恢复后先 dry-run 再全量。探活失败写入与任务同一套日志字段,便于和 manifest 对照定位,显著缩短排障耗时。
体积阈值与重试
按用途设 max_kb;超标写告警(路径、像素、千字节、规则版本),进重试或 failed。IO 与锁冲突用指数退避(二、八、三十二秒,至多五次)加抖动;魔数错、规则拒收不可重试直进 failed。
rules.yaml 与转码脚本同库;规则版本写入日志便于回放。
色彩偏差 FAQ
浏览器偏灰?
查看器未按嵌入 ICC 解释;交付统一嵌入并软打样抽检。
与设计稿色不同?
工作空间与导出 ICC 不一致;勿在链路中混 P3 与 sRGB。
高光细节变?
排查意外缩放或多次转档;尽量单次明确转换。
可引用验收要点
- 监听:防抖对齐导出习惯,半文件趋零。
- ICC:抽检嵌入与命名,日志带规则版本。
- 体积:分档
max_kb统计进周报,驱动改规则。