Criador de Mosaicos de Miçangas
Converte imagens em projetos de mosaico de miçangas que se parecem com a imagem original e podem ser realmente montados. Primeiro, garante que o tema principal seja claro na pré-visualização de blocos sem furos; depois, representa a superfície real das miçangas. Posições, códigos de cores e quantidades precisas devem ser calculados por scripts determinísticos; a geração de imagens é usada apenas para imagens opcionais de apresentação.
Como decidir o modo de solicitação
Escolha o modo mínimo que atenda à solicitação:
- Modo planta — padrão quando há imagem: imagem original → visualização precisa do mosaico + grade de montagem numerada + arquivo de cores e quantidades.
- Modo apresentação: primeiro conclua o modo planta; depois, gere uma imagem de apresentação estilo Xiaohongshu (disposição plana ou vista de produto) com base na visualização final. Imagens geradas não devem ser usadas como guias de montagem.
- Modo design textual: quando o usuário não tem imagem, apenas uma ideia textual, gere primeiro uma imagem limpa e focada no tema e, em seguida, entre no modo planta.
- Modo apenas prompt: use apenas quando o usuário solicitar explicitamente; retorne um prompt e parâmetros recomendados, sem afirmar que um projeto foi gerado.
Se o usuário enviar uma imagem e disser apenas "fazer mosaico de miçangas", use diretamente o modo planta. Não pergunte sobre parâmetros que podem ser decididos com segurança.
Leia os guias de referência
- Antes de escolher o tamanho da grade, tratamento de fundo, paleta ou estilo de superfície, leia
references/design-guide.md. - Antes de retornar os resultados, leia
references/quality-gate.mde conclua a verificação.
Convenções de entrada
- Antes de converter, examine a imagem original real, registrando dimensões, proporção, tema, complexidade do fundo, áreas transparentes e texto ou características de identidade importantes.
- A menos que o usuário indique que a imagem é apenas para referência de estilo, trate-a como um alvo de edição cujo tema deve ser preservado.
- Dentro dos limites da grade, preserve características de identidade visíveis, contornos externos, orientação, número de objetos, blocos de cores principais e textos curtos necessários.
- Se a grade for muito pequena para acomodar rostos, texto fino, cenas complexas ou marcas pequenas, explique a limitação concisamente e aumente o tamanho da grade; não invente detalhes.
- Não remova fundos significativos arbitrariamente. Use remoção automática de fundo apenas se ele for quase de cor sólida, ou se o usuário solicitar explicitamente o isolamento do tema.
- Para várias pessoas ou cenas complexas, primeiro faça um "orçamento de clareza": estime quantas células de miçanga cada tema central receberá. Se um rosto, cabeça de animal de estimação ou logotipo principal tiver menos de cerca de 16 células de largura, priorize cortar mais próximo do tema ou aumentar a grade, em vez de gerar diretamente.
Fluxo do modo planta
- Use a capacidade de visualização de imagens local para examinar a imagem original e ler suas dimensões de arquivo.
- De acordo com
references/design-guide.md, escolha o tamanho da grade, paleta, modo de ajuste, tratamento de fundo e estilo de superfície. - Encontre um ambiente Python com Pillow. No Codex desktop, primeiro carregue as dependências do workspace e, em seguida, use o caminho Python interno retornado. Se não houver Pillow, explique a dependência ausente; não instale por conta própria sem permissão.
- Execute:
<Python-com-Pillow> scripts/render_bead_pattern.py imagem_entrada diretório_saída \
--width-beads 48 \
--max-colors 18 \
--fit contain \
--background keep \
--render beads
Resolva os caminhos dos scripts e recursos a partir do diretório desta Skill. Use --help para ver todos os parâmetros. Para ilustrações complexas, adicione --sharpen 1.2; para focar no tema, use --crop "esquerda,topo,direita,fundo"; para fixar cores-chave de área pequena, use --anchor-colors "#F2C76E,#8A315F" entre aspas. Para extrair uma paleta adaptativa da imagem original, use --palette source; para usar paletas do estoque do usuário ou de marca, passe um JSON com a mesma estrutura de assets/generic-palette.json.
- Primeiro, veja a pré-visualização de blocos sem furos para avaliar se a composição e o tema estão claros; depois, veja a visualização com superfície de miçangas e a grade de montagem. Não confie apenas na saída do comando.
- Compare com a imagem original em tamanho real e reduzido. Se identidade ou contornos forem perdidos, priorize cortar mais próximo do tema ou aumentar a grade; se linhas finas forem perdidas, aumente a nitidez; se cores-chave desaparecerem, fixe-as. Tente novamente uma vez.
- Verifique se o total na lista de quantidades corresponde ao número de células não vazias na grade.
O script produz:
*-color-preview.png: pré-visualização de blocos sem furos e sem etiquetas, para avaliar a clareza do tema;*-bead-preview.png: visualização do mosaico renderizada a partir da grade precisa;*-pattern.png: grade de montagem com códigos de cores;*-legend.png: legenda de cores com quantidades de cada cor;*-pattern.csv: tabela de códigos de cores célula por célula;*-bom.csv: lista de materiais;*-metadata.json: parâmetros de conversão, cores e total.
Fluxo do modo apresentação
Primeiro, conclua o modo planta. Em seguida, use a visualização final do mosaico gerada como alvo de edição para a capacidade de geração de imagens integrada.
Mantenha o design, a proporção da grade, os contornos, a orientação e as posições principais das cores inalterados. Apenas permita mudanças no ângulo da foto, material da base, mesa, iluminação, adereços e fundo. Priorize uma mesa de artesanato limpa fotografada de cima, com luz natural suave e algumas ferramentas relacionadas; não deixe mãos ou adereços cobrirem o trabalho.
Se a imagem de apresentação alterar significativamente o design ou as posições das miçangas, tente novamente com exigências de fidelidade mais estritas. Retorne primeiro a visualização precisa e os arquivos de montagem; depois, retorne a imagem de apresentação, para evitar confusão.
Fluxo do modo design textual
- Converta a solicitação do usuário em um contorno centralizado e reconhecível ou uma composição compacta.
- Gere uma imagem limpa com fundo puro ou transparente, blocos de cores amplos, sem textura ou gradiente de iluminação, e sem texto pequeno.
- Passe a imagem gerada para o modo planta.
- Explique claramente que este é um design criado a partir de texto, não uma conversão da imagem original do usuário.
Formato de retorno
Priorize retornar os resultados mais úteis:
**Pré-visualização clara do padrão**

**Visualização do mosaico**

**Grade de montagem e quantidades**
- Grade: [largura] × [altura]
- Cores: [número de cores]
- Total de miçangas: [número de células não vazias]
- Grade de montagem: [caminho absoluto clicável]
- Legenda de cores: [caminho absoluto clicável]
- Lista de materiais: [caminho absoluto clicável]
**Configurações de conversão**
- [Grade / Paleta / Ajuste / Fundo / Estilo de superfície]
- [Uma frase explicando o efeito preservado ou compromissos necessários]
Adicione uma seção Imagem de apresentação apenas se o modo apresentação foi executado. Não inclua logs internos ou o JSON completo de metadados, a menos que o usuário solicite.
Regras obrigatórias
- A visualização final, grade de montagem, CSV, legenda e lista de materiais devem vir da mesma matriz de miçangas.
- A pré-visualização de blocos sem furos e a visualização com superfície de miçangas também devem vir da mesma matriz; não use uma imagem "mais bonita" como pré-visualização.
- Nunca use imagens geradas como guias de montagem com contagem precisa de miçangas.
- Nunca rotule números de paleta genéricos como códigos oficiais de Perler, Hama, Artkal ou outros fabricantes.
- Se o usuário fornecer uma tabela de cores de fabricante, use-a como dados e atribua a fonte corretamente.
- Em padrões pequenos, não coloque texto longo; use iniciais, palavras curtas ou uma grade maior.
- Ampliar um PNG de baixa precisão não aumenta a fidelidade; é necessário aumentar o número de células de miçangas e recalcular.
- Se dois temas centrais não forem reconhecíveis na miniatura da pré-visualização de blocos, não descreva o resultado como "claro" ou "totalmente fiel".
Exemplos de uso
- "Use
$make-perler-beadspara transformar esta foto de gato em um projeto de mosaico de 48 células de largura." - "Mantenha apenas a pessoa, remova o fundo, e limite a 16 cores."
- "Transforme este logotipo em um mosaico de 29×29, me dê a grade de montagem e a lista de materiais."
- "Depois de gerar o projeto, crie uma imagem de apresentação estilo Xiaohongshu em uma mesa."