Este manual está disponível, por enquanto, em inglês e chinês simplificado. Versão em inglês · Versão em chinês simplificado

Documentação

Skye Desk manual

Everything Skye Desk does and how to use it – from shooting your photos to using the finished LoRA. Each feature shows its status; only features in the current build have steps.

Primeiros passos

This chapter gets Skye Desk open on your Mac and explains projects and the workspace.

Download and first open

The first public build is not out yet; join the waitlist to get one email when it is. When it is out:

Download Skye Desk from the Download page.
Drag Skye Desk into Applications.
Open it. If macOS says it cannot check the app, open System Settings › Privacy & Security.
Scroll to Security and click Open Anyway next to Skye Desk, then confirm.
From then on Skye Desk opens normally.

Until the build is signed by Apple, macOS asks once. For Apple silicon Macs; system requirements will be confirmed with the first build; Intel Macs are not tested yet.

Workspace and projects

A workspace is a folder on your Mac that holds your projects. A project is one subject – one product, one character, one style – with its images, captions and training runs. Everything stays as ordinary files in that folder.

A first walk-through

Create a project and give it a trigger word (a made-up word such as prodshoot).
Drop 15–30 photos on the Dataset page.
Write a caption for each image, starting with the trigger word.
Export a training ZIP, or try a run in demo mode.
Compare the samples in a blind test.

Preparing your images

This chapter covers the photos a LoRA learns from: shooting them, choosing them and importing them.

Shoot with your phone

Most people do not need AI pictures to start – 20 to 30 good phone photos of your subject are enough.

How many photos

Product, Character	15–30
Roupas	20–40
Comida	15–25
Estilo	30 or more
A real person (only with their consent)	20–40
Effect, Material, Interior, Packaging	20–30

Vary everything except the subject

Angles: front, three-quarter, side, back, from above, and a few close-ups.
Backgrounds: change them 3–5 times. One background in every photo gets learnt as part of the subject.

Light: daylight by a window, shade, a lamp – not all the same.
Distance: wide, medium and detail shots.

Phone settings

Main camera at 1×; not the ultra-wide lens (it bends shapes).
Portrait mode off, filters off, beauty effects off.
Tap to focus on the subject; wipe the lens first.
Keep the highest resolution; HEIC is fine.

Avoid

Other brands’ logos and any text you do not want learnt.
Fingers over the subject; your reflection in shiny surfaces.
Near-identical shots – ten photos from the same spot teach less than three different ones.

Tips by kind

Produto: Turn it a little between shots; include the logo side, the back and the base; one close-up of any engraving or label.
Roupas: Use a dress form or a hanger, then a few worn shots (face out of frame is fine); include cuffs, collar, buttons and the fabric up close.
Character / figure: Front, three-quarter, side, back; the face and any markings close up; keep the same lighting.
Comida: Shoot within minutes, before it changes; top-down, 45° and side; one shot cut open if the inside matters.
Interior: Corners and straight-on walls at eye height; daylight and lamp light; avoid people walking through.
Estilo: Many different subjects in the same style – the subjects should vary, the style should not.
A real person: Written consent first. Varied expressions, light and clothes; no other people in frame.

Get them onto your Mac

Select the photos on your iPhone and share with AirDrop to your Mac.
They land in Downloads.
Drag them onto the Dataset page.

A shooting checklist inside the app, which shows what is still missing after import, is Planejado.

Use photos you already have

Pick sharp photos of the subject from different occasions; drop blurry ones, heavy filters and screenshots. 15–30 good photos beat 100 similar ones.

Use AI-generated or reference images

You can also build a dataset from pictures you generated, for example from a design sheet. Check each one for drift – a changed logo or pattern is learnt too.

Working with reference images directly, without training, is the Reference Kit: Planejado.

Importing

Como importo imagens? Disponível agora

Comece com 15 a 30 imagens de um único tema, de ângulos diferentes.
Clique em Import (importar) ou arraste imagens, pastas ou um ZIP.
Pesquise nomes ou legendas para encontrar qualquer imagem.
Abra Dataset overview (visão geral do dataset) para encontrar lacunas e desequilíbrios.
Digite a legenda (o texto que descreve a imagem) no painel à direita.

Supported: PNG, JPG, WebP, BMP, HEIC and TIFF images, folders, ZIP files, and same-name TXT or JSON captions. iPhone HEIC photos import as they are.

Solte ou cole em qualquer lugar Na próxima beta

Solte na grade, em um projeto na barra lateral, na página Projects (projetos) ou na página Home (início), ou cole com ⌘V. Segure ⌥ para mover em vez de copiar. Duplicatas são detectadas antes de qualquer cópia, e a importação pode ser desfeita.

Not in the current build yet – no steps until it is.

Organising your dataset

This chapter keeps the dataset tidy so the LoRA learns the right things.

Pré-visualize com Space Disponível agora

Select an image and press Space.
Use ← e → to move between images.
Press Space again to close.

Legendas ausentes sinalizadas Disponível agora

Look for the marked images in the grid.
Choose the Missing captions filter to see only those.
Write or import the captions.

Um dataset que funciona como o Finder Na próxima beta

Pressione Return para renomear, ⌘⌫ para mover para a Lixeira (com desfazer) e use as mesmas etiquetas de cor do Finder. As alterações feitas no Finder aparecem na hora.

Not in the current build yet – no steps until it is.

Renomear em lote Na próxima beta

Escolha um padrão e veja cada novo nome antes de aplicar. As legendas também são renomeadas, e um único desfazer restaura o lote.

Not in the current build yet – no steps until it is.

Verificação do dataset Na próxima beta

Imagens sem palavra-gatilho, pequenas demais para treinar, com proporções estranhas ou quase idênticas a outra são marcadas, com uma correção ao lado de cada uma. Quase duplicatas podem ser encontradas pelo conteúdo com um modelo que roda no seu Mac (baixado só se você concordar); as imagens nunca são enviadas.

Not in the current build yet – no steps until it is.

Pesquise em todos os projetos a partir do Início Na próxima beta

Pesquise em todos os projetos por legenda, nome de arquivo ou prompt. Cada projeto mostra o próximo passo.

Not in the current build yet – no steps until it is.

Writing captions

This chapter explains what to write – and what to leave out.

Leave out what you want the LoRA to learn. Write what should stay changeable. Start every caption with your trigger word.

Dicas de legenda para cada tipo

Personagem: Descreva: pose, vista (frente, lado), fundo, iluminação, onde está apoiado.
Deixe de fora: a aparência do próprio personagem – forma, cores, rosto, marcas – para que a palavra-gatilho carregue isso.
Produto: Descreva: ângulo, fundo, superfície, iluminação, objetos próximos.
Deixe de fora: a forma do produto, a área do logo, a estampa e os materiais.
Roupas: Descreva: como é mostrado (manequim, cabide, flat lay), ângulo, fundo.
Deixe de fora: corte, tecido, costuras, botões, cor.
Estilo: Descreva: o tema de cada imagem (uma árvore, uma casa, um barco).
Deixe de fora: o próprio estilo – camadas de papel, sombras suaves, branco sobre branco.
Efeito: Descreva: o objeto por baixo (uma pinha, uma chave) e o cenário.
Deixe de fora: o efeito – cristais de gelo, brilho, desgaste.
Material: Descreva: a forma que o material assume e como está iluminado.
Deixe de fora: a textura e a cor do material.
Interior: Descreva: disposição do ambiente, móveis, posição da câmera, hora do dia.
Deixe de fora: acabamento das paredes, piso, paleta de cores, qualidade da luz.
Comida: Descreva: prato, mesa, ângulo, se está cortado.
Deixe de fora: o próprio prato – crosta, disposição das frutas, cores.
Embalagem: Descreva: o que está ao redor, superfície, ângulo, iluminação.
Deixe de fora: o formato do frasco ou da caixa, a área do rótulo, a tampa e a cor.

The trigger word

A short made-up word that calls up your subject, such as prodshoot. Spell it the same way in every caption.

Verificação da grafia da palavra-gatilho Na próxima beta

Grafias diferentes da sua palavra-gatilho (a palavra que chama o seu tema) são encontradas e corrigidas em um passo.

Not in the current build yet – no steps until it is.

Como corrijo legendas em lote? Disponível agora

Abra Caption tools (ferramentas de legenda) › Find and replace (localizar e substituir).
Digite as palavras a localizar.
Digite o que elas devem virar.
Clique em Preview (pré-visualizar) e leia cada linha de antes/depois.
Clique em Apply (aplicar). Undo (desfazer) restaura o lote.

Veja o equilíbrio das tags Disponível agora

Open Dataset overview.
Read the share of images for each tag.
Click a tag to see those images, and fix captions that lean one way.

Como obtenho legendas da minha própria IA? Disponível agora

Exporte todas as imagens e peça a qualquer IA um .txt para cada uma.
Escolha Import (importar) › Import Caption Pack (importar pacote de legendas) e selecione o arquivo.
Confira se Write to (gravar em) mostra o projeto certo.
Confira as linhas: MATCH será gravado, SKIP não.
Clique em Write captions (gravar legendas).

Painel de tags para todo o dataset Na próxima beta

Veja todas as tags e com que frequência são usadas, depois adicione, remova ou renomeie em muitas imagens de uma vez, com desfazer.

Not in the current build yet – no steps until it is.

Revise legendas de IA uma a uma Na próxima beta

Veja cada legenda antiga e nova lado a lado e mantenha só as que você marcar. Um backup é feito antes.

Not in the current build yet – no steps until it is.

Training

This chapter turns the dataset into a LoRA – and explains what is real and what is simulated today.

In the current build, training runs in demo mode: no GPU is rented and nothing is charged.

Como exporto um ZIP de treinamento? Disponível agora

Dê uma legenda a cada imagem; legendas vazias bloqueiam a exportação.
Abra o menu File (arquivo).
Escolha Export Training Package (exportar pacote de treinamento) ou pressione ⌘⇧E.
Descompacte: 01.png fica ao lado de 01.txt.
Vai treinar com o kohya (outro treinador)? Coloque os arquivos em uma pasta extra com o nome da contagem de repetições, como o kohya espera.

Modo demo

Como inicio uma execução de treinamento? Disponível agora

Defina os passos (quantas rodadas de aprendizado).
Escolha a GPU na nuvem – um computador potente que você aluga online.
Confira a estimativa de tempo e custo.
Clique em Start training (iniciar treinamento). Nesta beta, a execução é simulada e não custa nada.

Predefinições e checklist de treinamento Na próxima beta

Escolha o tipo de LoRA para ter configurações prontas e um checklist antes de cada execução. O checklist dá conselhos, não uma nota.

Not in the current build yet – no steps until it is.

Treinamento com um clique no RunPod Durante a beta

Escolha a mais barata ou a mais rápida; o Skye Desk seleciona uma GPU disponível e mostra a estimativa antes de alugar qualquer coisa.

Not in the current build yet – no steps until it is.

Limite de gastos e parada automática Durante a beta

Defina um limite para cada execução. A GPU para quando o treinamento termina, fica ociosa ou atinge o limite.

Not in the current build yet – no steps until it is.

Continue de onde parou Durante a beta

Se isso acontecer, o treinamento continua a partir do último passo salvo em uma nova GPU.

Not in the current build yet – no steps until it is.

Connecting Runpod

Real training on Runpod is Durante a beta. You will need a Runpod account with credit and an API key, pasted on the Connections page.

Simple and advanced modes

Simple mode asks for the kind, base model and budget; advanced mode shows every setting with an explanation. Planejado

Using reference images

Reference Kit: use imagens de referência em vez de treinar Planejado

Monte um conjunto de referência a partir de uma folha de design, revise-o e use-o com ferramentas de imagem que aceitam imagens de referência – ou deixe o Skye Desk comparar os dois caminhos e sugerir um.

Not in the current build yet – no steps until it is.

Creator mode (modo criador)

Creator mode (modo criador) Planejado

Um espaço de trabalho mais simples em torno de um personagem e suas séries, para blogueiros, influenciadores de IA e criadores de vídeos curtos.

Not in the current build yet – no steps until it is.

Generating and comparing

This chapter makes new pictures with your LoRA and helps you keep the best version.

Como trago de volta os resultados do ComfyUI? Disponível agora

Escolha um número de imagem.
Escreva o prompt e o prompt negativo dela.
Copie o workflow e execute-o no ComfyUI.
Dê a cada resultado o nome do número da imagem e clique em Import (importar).

Como comparo checkpoints? Disponível agora

Abra o teste às cegas a partir das amostras de uma execução.
Escolha a melhor imagem de cada par A/B.
Clique em Stop here and see results (parar aqui e ver resultados) para ver o ranking.
Clicou errado? Use Undo last vote (desfazer último voto).

Compare execuções e defina a LoRA final Na próxima beta

Na página Projects (projetos), compare duas execuções de treinamento lado a lado e marque uma como LoRA final, com o modelo base exibido.

Not in the current build yet – no steps until it is.

Workflows encontrados nas suas imagens Na próxima beta

O Skye Desk lê o workflow do ComfyUI salvo nas suas imagens e as agrupa por modelo base (o modelo de IA ao qual sua LoRA se soma).

Not in the current build yet – no steps until it is.

Use um prompt como rascunho de legenda Na próxima beta

Insira o prompt salvo em uma imagem na legenda dela e depois edite.

Not in the current build yet – no steps until it is.

Envie prompts ao ComfyUI Durante a beta

Envie todos os números de imagem ao ComfyUI de uma vez, cada um com seus próprios prompts.

Not in the current build yet – no steps until it is.

Verifique cada resultado quanto a desvios Planejado

Cada nova imagem é comparada com o seu tema; imagens que se desviam, mostram texto solto ou um logo são marcadas para você manter ou descartar.

Not in the current build yet – no steps until it is.

Página Workflows (fluxos de trabalho): solte uma imagem para encontrar o workflow dela Planejado

Solte imagens, arquivos JSON ou um ZIP na página Workflows (fluxos de trabalho); cada workflow é detectado, nomeado e comparado com os que você já tem.

Not in the current build yet – no steps until it is.

Exporting and using your LoRA

This chapter covers where the finished LoRA lives and how to use it.

Today you train with your own tool (AI Toolkit or OneTrainer) from the training ZIP; the LoRA file (.safetensors) appears in that tool’s output folder.

Copy the .safetensors file into ComfyUI/models/loras.
In ComfyUI, add a Load LoRA node after the model loader.
Choose your file and start with a strength of 0.7–1.0.
Put the trigger word at the start of your prompt.

Base model licences differ: some do not allow commercial use of what you make. Check the licence of the base model before you sell or publish.

Compare execuções e defina a LoRA final Na próxima beta

Na página Projects (projetos), compare duas execuções de treinamento lado a lado e marque uma como LoRA final, com o modelo base exibido.

Not in the current build yet – no steps until it is.

Keeping your files safe

This chapter explains where your files are and how changes can be undone.

Images and captions are ordinary files in your workspace folder; captions sit next to images as .txt files.
Bulk changes show a preview first and can be undone as a whole.
Back up the workspace folder like any other folder (Time Machine works).

Privacy and consent

This chapter covers what leaves your Mac and whose pictures you may train on.

Your images stay on your Mac. Nothing is uploaded unless you start a cloud run.
Train on a real person only with that person’s written consent, and never on minors.
Do not train on other people’s copyrighted work or likeness without permission.

Política de privacidade

Referência

Shortcuts, words and fixes in one place.

Atalhos de teclado

⌘1–⌘8 abrem as páginas da barra lateral, de cima para baixo.
⌘K encontra qualquer página, ação ou projeto.
Space pré-visualiza a imagem selecionada; ← e → alternam entre as imagens.
⌘, abre Settings (configurações); ⌘⇧F abre localizar e substituir nas legendas.

Glossário

LoRA: Um pequeno arquivo complementar que ensina a um modelo de imagem de IA um único tema, como seu personagem, produto ou estilo.
Legenda: O texto que descreve uma imagem. A IA aprende com as imagens e suas legendas juntas.
Tag: Uma frase curta dentro de uma legenda, como “vista frontal” ou “fundo branco de estúdio”.
Palavra-gatilho: Uma palavra inventada, como wren, que chama o seu tema quando você cria novas imagens.
Modelo base: O modelo de imagem de IA ao qual sua LoRA se soma. Uma LoRA só funciona com a família de modelo base em que foi treinada.
Checkpoint: Uma cópia salva da LoRA no meio do treinamento. Comparar checkpoints mostra qual passo fica melhor.
GPU na nuvem: Um computador potente que você aluga online por hora para rodar o treinamento.
ComfyUI: Um app gratuito para criar imagens com modelos de IA. O Skye Desk planeja os prompts; o ComfyUI cria as imagens.
AI Toolkit, OneTrainer: Programas de treinamento gratuitos. O Skye Desk prepara os arquivos de que eles precisam.

Troubleshooting

macOS says it cannot check the app: System Settings › Privacy & Security › Open Anyway (see chapter 01).
Export is blocked: Every image needs a caption; use the Missing captions filter.
Imported captions did not match: Caption files must share the image’s file name (01.png ↔ 01.txt).
The LoRA learnt the background: Re-shoot with 3–5 different backgrounds, or describe the background in each caption.

Ler as perguntas frequentes