사용 시점
사용자가 텍스트 설명을 기반으로 커버 이미지, 썸네일, 배너, 포스터, 헤더 생성을 요청할 때 사용합니다. 트리거에는 'generate a cover', 'create a thumbnail', 'make a banner', '设计封面', '生成封面图' 또는 크기 지정과 함께 이미지 생성을 요청하는 모든 경우가 포함됩니다.
이 스킬은 2단계 파이프라인을 사용합니다:
- mflux (FLUX.2 4비트, Apple MLX)가 AI 배경 이미지를 생성합니다.
- HTML/CSS + Playwright Chromium이 그 위에 선명한 텍스트를 렌더링합니다.
다음의 경우에는 사용하지 마십시오: 텍스트 오버레이 없는 일반 이미지 생성, 이미지 편집, 업스케일링, 또는 커버 이외의 용도.
요구 사항
- macOS Apple Silicon (M1+) 탑재
- 16 GB+ RAM 권장 (8 GB에서도 저해상도로 작동 가능)
- mflux:
brew install uv && uv tool install mflux - Playwright:
pip install playwright && playwright install chromium - 첫 실행 시 FLUX.2 모델 다운로드 (~2-4 GB), 이후 완전 오프라인
절차
- 사전 요구 사항 확인:
python3 cover_generator.py --detect— mflux와 Playwright+Chromium 모두 ✓ 표시 확인 - 크기 결정: 사전 설정 또는 정확한 W×H 사용:
youtube-thumbnail(1280×720),twitter-header(1500×500),blog-cover(1200×630)instagram-post(1080×1080),facebook-cover(1640×624),linkedin-banner(1584×396)podcast-cover(3000×3000),github-social(1280×640),story(1080×1920)
- 레이아웃 선택:
--layout bottom(기본값),centered,hero,top - 그라데이션 선택:
--gradient dark(기본값),subtle,light,none - 생성:
python3 cover_generator.py -p "설명" --preset blog-cover - 프롬프트 최적화:
--prompt는 영어로 (AI 배경),--title은 원래 언어로 (표시 텍스트) 유지 - 확인: 출력 파일이 올바른 크기로 생성되었는지 확인
주의사항
- mflux는 Apple Silicon (M1+)이 필요합니다 — Intel Mac에서는 실행 불가
- Playwright는 Chromium을 별도로 설치합니다 (~300 MB 다운로드)
- 첫 mflux 실행 시 FLUX.2 모델 다운로드 (~2-4 GB); 이후 실행은 오프라인
- AI 프롬프트에 중국어 텍스트를 사용하면 배경 품질이 저하될 수 있습니다.
--prompt는 영어로 번역하고,--title에는 표시할 중국어 텍스트를 사용하세요. - 매우 큰 크기(>3840 px)는 느릴 수 있습니다. A4 인쇄(3508 px)의 경우 3-5초 렌더링 시간 예상
- 프롬프트 품질이 배경에 큰 영향을 미칩니다. 스타일을 구체적으로 명시하세요 (예: '미니멀리스트 수채화', '어둡고 시네마틱한', '깔끔한 추상 그라데이션')
- mflux는 크기를 64의 배수로 반올림합니다 — 배경 이미지가 요청한 크기보다 약간 작을 수 있으며, 최종 오버레이 단계에서 정확한 크기로 보정됩니다
확인
python3 cover_generator.py --detect— mflux ✓, Playwright+Chromium ✓- 전체 파이프라인 테스트:
python3 cover_generator.py -p '새벽의 고요한 산호수' -o test.png - 출력 이미지 크기가 입력 내용과 일치하는지 확인
- 원시 모드 테스트:
python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png