퍼러 비즈 패턴 생성기
이미지를 원본과 비슷하면서도 실제 제작 가능한 퍼러 비즈 도면으로 변환합니다. 먼저 무광 색상 미리보기에서 주요 대상을 명확히 확인할 수 있도록 한 후, 실제 비즈 표면을 표현합니다. 정확한 비즈 위치, 색상 번호 및 수량은 결정론적 스크립트로 계산해야 하며, 이미지 생성은 선택적인 분위기 전시 이미지에만 사용합니다.
요청 모드 판단
요청을 충족할 수 있는 최소한의 모드를 선택합니다.
- 도면 모드 — 이미지가 있을 때 기본 사용: 원본 이미지 → 정확한 퍼러 비즈 결과물 이미지 + 번호가 매겨진 시공 그리드 + 색상 구성 및 소요량 파일.
- 전시 모드: 먼저 도면 모드를 완료한 후, 결과물 이미지를 바탕으로 샤오홍슈 스타일의 평면 배치도 또는 제품 전시 이미지를 생성합니다. 생성형 전시 이미지를 시공 도면으로 사용해서는 안 됩니다.
- 텍스트 디자인 모드: 사용자에게 이미지가 없고 텍스트 아이디어만 있을 때, 먼저 깔끔하고 주제가 집중된 원본 이미지를 생성한 후 도면 모드로 전환합니다.
- 프롬프트 전용 모드: 사용자가 명시적으로 요청한 경우에만 사용하며, 프롬프트와 권장 매개변수를 반환하고 도면이 생성되었다고 주장하지 않아야 합니다.
사용자가 이미지를 업로드한 후 "퍼러 비즈로 만들어 줘"라고만 말하면 직접 도면 모드를 사용합니다. 안전하게 결정할 수 있는 매개변수는 사용자에게 되묻지 않습니다.
관련 가이드 읽기
- 그리드 크기, 배경 처리, 색상 팔레트 또는 비즈 표면 스타일을 선택하기 전에
references/design-guide.md를 읽습니다. - 반환물을 출력하기 전에
references/quality-gate.md를 읽고 검사를 완료합니다.
입력 규칙
- 변환 전에 실제 원본 이미지를 확인하고, 크기, 가로세로비, 주요 대상, 배경 복잡도, 투명 영역 및 중요한 텍스트나 식별 특징을 기록합니다.
- 사용자가 이미지를 스타일 참고용으로만 사용한다고 명시하지 않는 한, 주요 대상을 유지해야 하는 편집 대상으로 간주합니다.
- 그리드 용량이 허용되는 범위 내에서, 보이는 식별 특징, 외곽선, 방향, 객체 수, 주요 색상 블록 및 필요한 짧은 텍스트를 유지합니다.
- 그리드가 너무 작아 얼굴, 작은 글자, 복잡한 장면 또는 미세한 마크를 수용할 수 없는 경우, 제한 사항을 간결하게 설명하고 그리드 크기를 늘리며, 세부 사항을 허위로 생성하지 않습니다.
- 의미 있는 배경을 함부로 제거해서는 안 됩니다. 배경이 거의 단색이거나 사용자가 명시적으로 피사체만 분리하도록 요청한 경우에만 자동 배경 제거를 사용합니다.
- 여러 인물이나 복잡한 장면의 경우 먼저 "선명도 예산"을 계산합니다. 각 핵심 피사체에 할당될 수 있는 비즈 셀 수를 추정합니다. 핵심 얼굴, 반려동물 머리 또는 로고의 너비가 약 16셀 미만이면, 직접 생성하는 대신 피사체를 더 좁게 자르거나 그리드를 높이는 것을 우선시합니다.
도면 모드流程
- 로컬 이미지 보기 기능을 사용하여 원본 이미지를 확인하고 파일 크기를 읽습니다.
references/design-guide.md에 따라 그리드 크기, 색상 팔레트, 맞춤 방식, 배경 처리 및 비즈 표면 스타일을 선택합니다.- Pillow가 설치된 Python 환경을 찾습니다. Codex 데스크톱에서는 먼저 워크스페이스 종속성을 로드한 후, 반환된 내장 Python 경로를 사용합니다. Pillow가 없으면 종속성 누락을 설명하고, 허가 없이 직접 설치하지 않습니다.
- 다음 명령어를 실행합니다:
<Pillow-포함-Python> scripts/render_bead_pattern.py 입력_이미지 출력_디렉토리 \
--width-beads 48 \
--max-colors 18 \
--fit contain \
--background keep \
--render beads
이 Skill 디렉토리에서 스크립트와 리소스 경로를 분석합니다. --help를 사용하여 모든 매개변수를 확인합니다. 복잡한 일러스트의 경우 --sharpen 1.2를 추가하고, 주요 대상에 초점을 맞춰야 할 때는 --crop "left,top,right,bottom"을 사용하며, 작은 영역의 주요 색상을 고정해야 할 때는 따옴표로 묶인 --anchor-colors "#F2C76E,#8A315F"를 사용합니다. 원본 이미지에서 적응형 색상 팔레트를 추출해야 할 때는 --palette source를 사용하고, 사용자의 재고 또는 브랜드 팔레트를 사용해야 할 때는 assets/generic-palette.json과 동일한 구조의 JSON을 전달합니다.
- 먼저 무광 색상 미리보기를 보고 구도와 주요 대상이 명확한지 판단한 후, 비즈 결과물 이미지와 시공 그리드를 확인합니다. 명령 출력에만 의존하지 않습니다.
- 원본 크기와 축소 크기에서 각각 원본 이미지와 비교합니다. 식별 특징이나 윤곽선이 손실된 경우, 피사체를 더 좁게 자르거나 그리드를 높이는 것을 우선시하고, 가는 선이 손실된 경우 선명도를 높이며, 주요 색상이 사라진 경우 주요 색상을 고정합니다. 한 번 재시도합니다.
- 소요량 표의 합계가 모든 비어 있지 않은 셀의 수와 일치하는지 확인합니다.
스크립트는 다음 파일을 출력합니다:
*-color-preview.png: 구멍이나 레이블이 없는 명확한 색상 미리보기로, 피사체의 식별 가능성을 판단하는 데 사용됩니다.*-bead-preview.png: 정확한 그리드로 렌더링된 퍼러 비즈 결과물 이미지.*-pattern.png: 색상 번호가 표시된 시공 그리드.*-legend.png: 색상 범례 및 각 색상의 수량.*-pattern.csv: 셀별 색상 번호 테이블.*-bom.csv: 재료 명세서.*-metadata.json: 변환 매개변수, 색상 및 총 개수.
전시 모드流程
먼저 도면 모드를 완료한 후, 생성된 퍼러 비즈 결과물 이미지를 내장 이미지 생성 기능의 편집 대상으로 전달합니다.
디자인, 그리드 비율, 윤곽선, 방향 및 주요 색상 위치를 변경하지 않고 유지합니다. 촬영 각도, 베이스 재질, 테이블, 조명, 소품 및 배경만 변경할 수 있습니다. 깔끔한 탑뷰 수작업 테이블, 부드러운 자연광 및 약간의 관련 도구를 우선적으로 사용하며, 손이나 소품이 작품을 가리지 않도록 합니다.
전시 이미지가 디자인이나 비즈 위치를 명백히 변경한 경우, 더 엄격한 유지 조건으로 한 번 재시도합니다. 먼저 정확한 결과물 이미지와 시공 파일을 반환한 후 전시 이미지를 반환하여 혼동을 방지합니다.
텍스트 디자인 모드流程
- 사용자 요청을 중앙에 배치되고 식별 가능한 윤곽선 또는 간결한 구도로 수렴합니다.
- 배경이 순수하거나 투명하고, 색상 블록이 넓으며, 텍스처나 조명 그라데이션, 작은 글자가 없는 원본 이미지를 생성합니다.
- 실제 생성된 이미지를 도면 모드로 전달합니다.
- 이것은 텍스트를 기반으로 디자인된 것이며 사용자의 원본 이미지를 변환한 것이 아님을 명확히 설명합니다.
반환 형식
가장 실용적인 결과물을 우선적으로 반환합니다.
**명확한 패턴 미리보기**

**퍼러 비즈 결과물 이미지**

**시공도 및 소요량**
- 그리드: [너비] × [높이]
- 색상: [색상 수]
- 총 비즈 수: [비어 있지 않은 셀 수]
- 시공 그리드: [클릭 가능한 절대 경로]
- 색상 번호 범례: [클릭 가능한 절대 경로]
- 소요량 표: [클릭 가능한 절대 경로]
**변환 설정**
- [그리드 / 색상 팔레트 / 맞춤 / 배경 / 비즈 표면 스타일]
- [유지된 효과나 필요한 절충에 대한 한 줄 설명]
전시 모드를 실행한 경우에만 전시 이미지를 추가로 포함합니다. 사용자가 요청하지 않는 한 내부 로그나 전체 메타데이터 JSON을 출력하지 않습니다.
필수 규칙
- 결과물 이미지, 시공 그리드, CSV, 범례 및 소요량은 모두 동일한 비즈 매트릭스에서 파생되어야 합니다.
- 무광 색상 미리보기와 비즈 결과물 이미지도 동일한 비즈 매트릭스에서 파생되어야 하며, "더 예쁜" 다른 이미지를 명확한 미리보기로 사용해서는 안 됩니다.
- 생성형 이미지를 정확한 비즈 수가 있는 시공 도면으로 절대 사용해서는 안 됩니다.
- 범용 색상 팔레트 번호를 Perler, Hama, Artkal 또는 다른 제조업체의 공식 색상 번호라고 절대 주장해서는 안 됩니다.
- 사용자가 제조업체 색상표를 제공하는 경우, 이를 데이터로 사용하고 출처를 정확히 표시합니다.
- 작은 크기의 패턴에는 긴 텍스트를 배치하지 말고, 대신 이니셜, 짧은 단어 또는 더 큰 그리드를 사용합니다.
- 저해상도 PNG를 확대하는 것은 재현도를 높이는 것이 아닙니다. 반드시 비즈 셀 수를 늘리고 다시 계산해야 합니다.
- 두 개의 핵심 피사체가 색상 미리보기의 축소 이미지에서 여전히 식별되지 않는 경우, 결과를 "명확함" 또는 "완전히 재현됨"이라고 설명해서는 안 됩니다.
호출 예시
- "
$make-perler-beads를 사용하여 이 고양이 사진을 48셀 너비의 퍼러 비즈 도면으로 만들어 줘." - "인물만 남기고 배경을 제거하고, 색상을 16가지 이내로 제한해 줘."
- "이 로고를 29×29 퍼러 비즈로 만들고 시공 그리드와 소요량 표를 제공해 줘."
- "퍼러 비즈 도면 완료 후, 샤오홍슈 스타일의 테이블 전시 이미지를 생성해 줘."