2026 OpenClaw 실전: 원격 Mac에서 App Icon PNG 치수와 Contents.json을 일괄 검증하고 수정 보고서를 만드는 단계

카탈로그 드리프트가 나는 이유

1. 스케일 산술 오류: 마스터를 2×·3×로 복사만 하고 픽셀을 다시 계산하지 않아, 파일명은 Contents.json과 맞지만 실제 해상도가 다릅니다.
2. 낡은 JSON: PNG 이름만 바꾸고 images 항목을 모두 갱신하지 않으면 고아·누락 참조가 생깁니다.
3. 조용한 리사이즈: 최적화·패딩 단계에서 한 변만 바뀌어도 미리보기는 정상처럼 보일 수 있습니다.

머지 전·업로드 전에 한 번 게이트를 두면 이런 문제가 야간 빌드 파손 대신 보고서 한 줄로 떨어집니다.

자동화 형태 선택

설치·구성·실행(다섯 단계)

1. OpenClaw·보조 도구: 워커에서 OpenClaw 설치 가이드를 따르고, 없으면 jq를 설치합니다. 샘플 PNG에 sips -g pixelWidth -g pixelHeight가 동작하는지 확인합니다.
2. 카탈로그 고정: APPICON_DIR=/path/to/AppIcon.appiconset, REPORT_PATH=./logs/appicon_fix_report.md 등 환경 변수를 export합니다. 보고서 상단에 git rev-parse HEAD를 적어 추적 가능하게 합니다.
3. Contents.json 린트: plutil -lint Contents.json으로 문법을 먼저 통과시킵니다. JSON이 깨지면 픽셀 로직 이전에 오탐·미검이 납니다.
4. 기대 픽셀 계산: images[]에서 filename이 있는 항목마다 size(예 60x60)와 scale(2x 등)을 읽습니다. 변 길이는 베이스 포인트에 정수 스케일(2×→2, 3×→3)을 곱해 구합니다.
5. 측정·diff: 참조된 PNG마다 실제 가로·세로를 읽고 다르면 Markdown 행을 추가합니다. 불일치가 남으면 0이 아닌 exit code로 종료해 CI·OpenClaw가 잡을 수 있게 합니다.

감시 훅·배치 스크립트 템플릿

디바운스 감시: inbox/appicon/이 약 45초 무작업이 되면 work/로 복사해 검증하고, 통과 시 report.md와 함께 out/으로 승격, 실패는 failed/로 옮깁니다.

배치 슬라이스: 화이트라벨 저장소라면 Assets.xcassets 아래 모든 *.appiconset을 순회해 야간에 Markdown을 이어 붙일 수 있습니다.

#!/usr/bin/env bash
set -euo pipefail
DIR="${1:?path to AppIcon.appiconset}"
REPORT="${2:-./appicon_validation_report.md}"
JSON="$DIR/Contents.json"
{
  echo "# AppIcon validation"
  echo "- host: $(hostname)"
  echo "- path: $DIR"
  echo ""
  echo "| filename | expected | actual | status |"
  echo "|---|---:|---:|---|"
} > "$REPORT"
while read -r name w h; do
  [[ -z "${name:-}" ]] && continue
  fp="$DIR/$name"
  if [[ ! -f "$fp" ]]; then
    echo "| $name | ${w}x${h} | missing | FIX: add file |" >> "$REPORT"
    continue
  fi
  read -r aw ah < <(sips -g pixelWidth -g pixelHeight "$fp" \
    | awk '/pixelWidth/ {w=$2} /pixelHeight/ {print w, $2}')
  if [[ "$aw" -eq "$w" && "$ah" -eq "$h" ]]; then
    echo "| $name | ${w}x${h} | ${aw}x${ah} | OK |" >> "$REPORT"
  else
    echo "| $name | ${w}x${h} | ${aw}x${ah} | FIX: re-export |" >> "$REPORT"
  fi
done < <(jq -r '.images[] | select(.filename!=null)
  | [.filename,
      ((.size|split("x")[0]|tonumber) * (.scale|sub("x";"")|tonumber)),
      ((.size|split("x")[1]|tonumber) * (.scale|sub("x";"")|tonumber))]
  | @tsv' "$JSON")
echo "Wrote $REPORT"

jq 필터는 ipad 전용 행이나 scale 생략 케이스에 맞게 확장하세요. 기하 검증이 끝나면 OpenClaw PNG 일괄 QC로 알파·ICC·용량 상한을 이어 붙이면 디자인 납품 자동화가 한 층 더 촘촘해집니다.

숫자·정책 메모

• 클래식 스케일: 1×/2×/3×는 Contents.json의 size 포인트에 곱하는 배수가 1·2·3입니다.
• 디바운스·보관: 감시 트리는 30~60초 유휴를 권장합니다. logs/ 옆에 Markdown 또는 JSONL을 약 30일 보관하면 릴리스 간 diff가 쉽습니다.

FAQ: 자주 나는 오류

노트북은 창작에 두고, 검증은 전용 원격 Mac에서 돌리면 야간·CI 부하를 분리할 수 있습니다. 위 세 문서 링크로 슬롯 표·도구 설치·PNG QC를 한 번에 이어가면 됩니다.