테마별 브랜드 PNG 미리보기는 토큰 변경마다 재현되어야 합니다. 원격 Mac에서 OpenClaw 게이트웨이, 디바운스 폴더 감시 또는 스케줄, token JSON 배치 렌더, 임계 diff·보고서까지 한 런북으로 묶는 튜토리얼+체크리스트입니다. 설치는 OpenClaw 전 플랫폼 설치 가이드를 따르고, 감시 패턴은 아래 PNG 세트 폴더 감시·PNG 일괄 QC와 맞추면 됩니다.
목차
다중 테마 브랜드 PNG가 깨지는 지점
MacPng 사용자는 키트·배너·스토어 컷을 테마마다 맞춰야 합니다. 자동화가 없으면 드리프트(일부 PNG만 옛 팔레트), 기기 편차(폰트·ICC), 리뷰 공백(눈대중 한계)이 반복됩니다. OpenClaw로 스킬·파일을 한 macOS 호스트에 고정하세요.
트리거 매트릭스: 감시 vs 스케줄 vs 수동
| 트리거 | 적합 | 트레이드오프 |
|---|---|---|
| 디바운스 폴더 감시 | 디자이너가 tokens.json 또는 수출 SVG를 inbox/에 둘 때 |
전체 디스크 접근 경로·자동 저장마다 발화하지 않게 디바운스 필수 |
launchd·크론 |
main 브랜치 토큰에 대한 야간 회귀 | git 해시 게이트 없으면 무변경도 돌 수 있음 |
| 스킬 수동 호출 | 릴리스 태그 직전·이해관계자 리뷰 전 | SSH로 누군가 명령을 실행해야 함 |
감시·락·배치 로그는 앞서 인용한 PNG 세트 감시 글과 같은 계약을 쓰면 됩니다.
파이프라인 재현 단계
- 원격 Mac 준비: 프로젝트 트리에
tokens/,templates/,out/previews/,out/diff/,logs/를 만들고 워커는 단일 macOS 사용자로 고정합니다. - OpenClaw·게이트웨이: 설치 가이드의 버전 핀을 따르고, 문서화된
/health(또는 동등 엔드포인트)가 OK인지 확인합니다. API 키가 프로젝트 루트를 읽을 수 있는지 검증합니다. - 스킬·스크립트 등록: 테마 목록, 렌더 가로·세로, PNG 명명 규칙, 베이스라인 경로를 인자로 받게 합니다.
- 트리거 연결:
tokens/에 수 초 디바운스 감시를 걸거나, 머지 후 CI에서 스킬을 호출합니다. - 렌더 루프: 테마마다 토큰을 템플릿에 합성하고 고정 DPR로
{컴포넌트}_{테마}_{WxH}.png를 씁니다. - 비교·요약: 직전 승인 베이스라인과 픽셀 메트릭으로 비교하고, 실패 시에만 히트맵을 남깁니다.
- 아티팩트:
out/diff/report.md또는summary.json을 DAM·티켓에 연결합니다.
Token JSON 계약·렌더 루프
라인당 매니페스트 하나: themes[]에 id, colors, radius, 선택 font, template. 렌더 전 스키마 검증으로 미완성 JSON을 걸러냅니다. 결정성: DPR·정지 프레임·배경·필요 시 sRGB ICC 고정. 명명: 소문자 슬러그. 배치: M4에서 12~48장 단위로 재측정 후 병렬 확대.
임계 비교·보고서 출력
ImageMagick compare 등으로 점수·선택 히트맵을 냅니다. 예: 너비 1024px로 맞춘 뒤 변경 픽셀 <1%, 보정한 RMSE 상한. 행마다 테마·파일·지표·합격·히트맵·베이스라인 해시. 알파·용량 게이트는 서문에서 인용한 PNG 일괄 QC 글과 통합하세요.
흔한 오류·재시도·로그
| 증상 | 가능 원인 | 재시도 패턴 |
|---|---|---|
| 게이트웨이 502·타임아웃 | 스킬 콜드 스타트·포트 충돌 | 2s·4s·8s 지수 백오프 최대 3회, 연속 실패 시 게이트웨이 재시작 |
| 쓰기 Permission denied | 샌드박스·SSH 사용자 불일치 | whoami로 소유자 맞추고 ACL 수정 후 1회 재실행 |
| 렌더 공백·색 어긋남 | 폰트 미설치·P3 vs sRGB | 원격 Mac에 폰트 설치·프로파일 삽입 후 재렌더 |
| diff 항상 실패 | 안티앨리어싱 노이즈·해상도 불일치 | 크기 맞춤·소량 fuzz·베이스라인 검토 후 임계 조정 |
logs/runs.jsonl에 시각·sha·합격/불합격 건수를 남깁니다.
사전 점검 체크리스트
- 게이트웨이 헬스 OK·OpenClaw 버전 핀 고정
- 토큰 스키마 검증 통과·템플릿 경로 존재
out/·logs/SSH 사용자에게 쓰기 가능- 베이스라인 버전 관리·README에 임계 수치 문서화
- 감시 디바운스·처리 락으로 동시 실행 방지
- 보고서를 티켓·DAM에 링크
FAQ
토큰 JSON에 PNG 미리보기에 꼭 필요한 필드는?
테마 id, 시맨틱 색, 코너, 템플릿 타이포 키. 경로는 프로젝트 루트 기준 상대 경로로 통일.
diff 임계는?
정규화 후 변경 픽셀 0.5~1.0% 시작, 정상 쌍으로 RMSE 상한 보정.
왜 원격 Mac?
macOS·폰트·색 관리 일치, 노트북 부하 분리.