콘텐츠·디자인 납품·운영 팀은 대량 PNG를 넘길 때 PNG QC 없이는 번짐·CDN 비용·깨지는 파일명이 반복됩니다. 여기서는 지표 정의 → OpenClaw로 원격 Mac 오케스트레이션 → 투명 픽셀·용량·명명 일괄 검증 → 실패 재실행까지 재현 가능한 흐름만 압축해 정리합니다. 키워드: OpenClaw, PNG QC, 투명 픽셀, 일괄 검증, 원격 Mac.
① 검수 지표 정의 (용량·투명도·해상도)
QC는 수출과 다운스트림 사이의 계약입니다. YAML·JSON에 한 번 적고 매 실행이 같은 숫자를 비교하게 하세요. 아이콘·배너 등 클래스마다 행을 나누면 소재 거버넌스가 수월합니다.
- 파일 용량(바이트): 클래스별
max_bytes. 예: 아이콘≤150KB, 웹 히어로 2×≤1.5MB, 스플래시≤4MB. 로그에 바이트+해상도를 같이 남기세요. - 투명도·알파: 스트레이트 알파 필수/알파 금지/컷아웃 최소 면적 등을 클래스마다 적습니다. 투명 픽셀 예시: 내부 완전 투명 비율
≤0.1%, 가장자리 밖8/255미만 먼지 금지, UI 오버레이는 알파 필수. - 해상도·치수:
min/max w·h, 선택modulo(예: 너비 8px 배수). 웹은 DPI보다 픽셀 치수가 본질입니다. - 명명: 팀 단일 정규식(예:
^[a-z0-9]+(?:-[a-z0-9]+)*__w[0-9]+h[0-9]+\.png$). 공백·이중 확장·비허용 유니코드 거절.
qa_rules_version을 올리면 과거 실패와 필터링이 추적됩니다.
② OpenClaw 작업 오케스트레이션 단계
OpenClaw는 셸 스킬·로그 파싱을 묶는 코디네이터입니다. 원격 Mac에서는 절대 경로를 쓰고 iCloud Desktop 등은 피하세요.
- 입력: PNG를
~/qa_jobs/{job_id}/inbox/에 둡니다. 선택:fswatch로30초무활동 후 job 1회. - 정규화: 확장자·PNG 시그니처·필요 시 캐논 이름.
- 검증: 용량·알파·치수·이름 스크립트 또는 단일 드라이버. 실패는
FAIL\tcode\tfile.png한 줄. - 집계:
report.json으로 배치 합격 판정. - 알림: 실패 시 매니페스트 경로 전달, 합격 시
pass/또는 업로드.
감시: launchd·tmux로 상시 실행. 수출 임시 파일 때문에 디바운스 필수.
# 디바운스 개념: inbox가 잠잠해지면 QA 드라이버 1회 실행
WATCH="$HOME/qa_jobs/demo/inbox"
fswatch -o "$WATCH" | while read; do
sleep 30
~/bin/openclaw-qa-run.sh --job demo --config ~/qa/rules.yaml
done호스트 연결은 폴더 감시·이름 변경 가이드와 Mac 설치·일괄 검증 글을 함께 보세요.
③ 스크립트 템플릿과 파라미터 예시
복사용 템플릿입니다. 알파 통계는 ImageMagick(brew install imagemagick), 픽셀 규칙은 Pillow 권장.
Bash: 치수 + 바이트 용량 게이트
#!/usr/bin/env bash
set -euo pipefail
MAX_BYTES=1500000
MIN_W=64 MAX_W=4096
MIN_H=64 MAX_H=4096
for f in "$@"; do
read -r w h < <(magick identify -format "%w %h" "$f")
sz=$(stat -f%z "$f")
[[ "$sz" -le "$MAX_BYTES" ]] || { echo "FAIL\tsize_bytes\t$f"; continue; }
(( w >= MIN_W && w <= MAX_W && h >= MIN_H && h <= MAX_H )) || echo "FAIL\tdimensions\t$f"
doneBash: 알파 채널 필수(오버레이인데 RGB만 있으면 실패):
for f in "$@"; do
magick identify -format "%[channels]" "$f" | grep -q alpha \
|| echo "FAIL\tmissing_alpha\t$f"
donePython: 대략적인 “투명 픽셀” 비율(THRESH·MAX_FRAC 조정, pillow 필요):
#!/usr/bin/env python3
from PIL import Image
import sys
THRESH = 16 # 가시로 칠 최소 알파(0–255)
MAX_FRAC = 0.002 # 완전 투명 픽셀 상한 비율
for path in sys.argv[1:]:
im = Image.open(path).convert("RGBA")
a = im.split()[-1]
transparent = sum(1 for p in a.getdata() if p < THRESH)
frac = transparent / (im.width * im.height)
if frac > MAX_FRAC:
print(f"FAIL\ttransparent_ratio\t{path}\t{frac:.4f}")rules.yaml에 넣을 파라미터 예:
icons:max_bytes: 120000,square: true,must_have_alpha: true,max_transparent_fraction: 0.0005hero_web:max_bytes: 1800000,width: [1920, 3840],height: [1080, 2160],must_have_alpha: false
④ 실패 샘플 회수·재실행
실패 이력을 자동으로 남겨야 대량 배치가 유지됩니다.
- 이동:
FAIL→failed/{job_id}/,manifest.jsonl에path·rule·detail·qa_rules_version. - 수정 루프: 매니페스트 기준으로 소스 수정 후
inbox/재투입. 파일명 유지 권장. - 재실행:
--only failed_manifest.jsonl등으로 실패분만. 통과 행은 매니페스트에서 삭제. - golden: 검증 샘플 10장을 두고 배포마다 돌려 회귀 차단.
트러블슈팅 요약:
- 투명 오탐: 프리멀티·프로파일 → 스트레이트 알파·sRGB 재수출.
- 용량 급증: 메타·내장 썸네일 의심 → 정책 허용 시
mogrify -strip옵션. - 감시 과다: 디바운스·
*.tmp·.DS_Store제외. - SSH: non-interactive
PATH확인, 절대 경로 고정.
⑤ FAQ
PNG 일괄 검사에서 원치 않는 투명 픽셀은 어떻게 잡나요?
알파 히스토그램을 보거나 불투명도 임계 미만 픽셀을 셉니다. 가장자리는 허용하되 내부는 막아야 한다면 바운딩 박스·마스크와 조합하세요. 정상 컷아웃은 통과하도록 유형별로 임계값을 조정합니다.
파일 용량 임계값은 어떻게 정하나요?
마지막 안정 릴리스 기준에 여유(예: 25%)를 더합니다. 아이콘·단순 도형은 작게, 디테일 일러스트는 상한을 높입니다. 바이트와 함께 해상도를 항상 로그에 남겨 리사이즈인지 재압축인지 판단하게 하세요.
OpenClaw가 전용 DAM QC를 대체하나요?
OpenClaw는 수출 옆 머신에서 일괄 검증과 글루 코드에 강합니다. 분류·권리 메타는 DAM이 담당하고, OpenClaw는 업로드 전 빠른 게이트로 쓰는 구성이 일반적입니다.
이 파이프라인을 원격 Mac에서 돌리는 이유는?
대부분의 디자인 수출과 같은 OS, 네이티브 sips와 도구, 안정적인 경로, 노트북을 비우는 장시간 배치 실행이 가능합니다.
관련: PNG 자동 명명·일괄 검증, 투명도 체크리스트, AI 보조 PNG 처리. 전용 노드가 필요하면 구매·대여·요금을 로그인 없이(기간 한정) 보고 SSH/VNC 가이드로 접속하세요.