Tutorial
Escrito passo a passo no formato "em qual página → onde clicar → o que preencher → o que você vê": seguindo, você vai do zero à implantação. Todo o fluxo roda offline no seu computador, e as imagens e os dados não saem dele (só quando você escolhe usar a "Xuntong AI" na anotação assistida é que as imagens são enviadas para a plataforma Xuntong AI).
01 Instalação e primeira execução
1.1 Baixar e instalar
- Abra o site oficial https://wulabel.xiaowuiot.com e clique em Baixar no canto superior direito, ou baixe na página de Releases do GitHub.
-
Windows: baixe
Wulabel_<versão>_x64-setup.exe, dê um duplo clique e siga as instruções. Depois de instalar, abra o Wulabel pelo menu Iniciar ou pela área de trabalho. -
Mac: baixe
Wulabel_<versão>_universal.dmg, dê um duplo clique para abrir e arraste o Wulabel para a pasta "Aplicativos". -
Linux (desde a v0.4.0): baixe
Wulabel_<versão>_amd64.debe executesudo apt install ./Wulabel_<versão>_amd64.debno terminal. Depois de instalar, abra o Wulabel pelo menu de aplicativos. Você também pode baixar o.AppImage, executarchmod +x Wulabel_<versão>_amd64.AppImagee abri-lo com duplo clique, sem instalar. Em computadores ARM (Phytium, Kunpeng), baixeWulabel_<versão>_arm64.debouWulabel_<versão>_aarch64.AppImage(desde a v0.4.2); o uso é o mesmo.
-
Requisitos do sistema: Windows 10 / 11 (64 bits); macOS 11 ou posterior (funciona com Apple Silicon e Intel); Linux x86_64 (Ubuntu 22.04 ou posterior, Debian 12, UnionTech UOS, Kylin em computadores x86 etc.); Linux ARM64 (desde a v0.4.2: Kylin, UnionTech UOS etc. em computadores Phytium e Kunpeng; baixe os arquivos com
arm64ouaarch64no nome). - Ainda não suportados: Loongson, HarmonyOS. Dispositivos HarmonyOS podem participar da anotação em equipe pelo navegador.
- Se, ao abrir pela primeira vez no Windows, aparecer um aviso de que falta o WebView2, instale-o conforme indicado (a maioria dos Windows 10 / 11 já vem com ele).
-
No Mac, a primeira abertura avisa que não é possível verificar o desenvolvedor (o software não tem assinatura de desenvolvedor da Apple): em "Aplicativos", clique com o botão direito no Wulabel → Abrir → clique em "Abrir" de novo. No macOS 15 ou posterior, dê um duplo clique uma vez e depois vá ao final de "Ajustes do Sistema → Privacidade e Segurança" e clique em "Abrir Mesmo Assim". Se aparecer que o app "está danificado", execute
xattr -cr /Applications/Wulabel.appno terminal e abra de novo. Isso só é necessário na primeira vez.
1.2 Conhecendo a interface principal
Ao abrir, você vê primeiro a página Projetos. Depois de abrir um projeto, a barra de navegação fica à esquerda, de cima para baixo:
| Página | Para que serve |
|---|---|
| Projetos | Criar, abrir e trocar de projeto |
| Dados | Importar imagens / vídeos / conjuntos de dados, gerenciar imagens, exportar conjuntos de dados |
| Anotar | Desenhar caixas e contornos, escolher classes, marcar pontos-chave, assistência de IA e pré-anotação |
| Diagnóstico | Encontrar problemas como anotações faltando, rótulos errados e imagens repetidas |
| Treinar | Escolher o modelo, ajustar parâmetros, iniciar o treinamento, ver os treinamentos anteriores |
| Avaliar | Ver métricas, matriz de confusão e erros, limiar recomendado, teste de falsos positivos, exportar relatório |
| Implantar | Teste ao vivo, exportar modelo, gerar pacote de serviço de inferência, importar o retorno do campo |
| Colaboração | Colaboração em tempo real: ativar o compartilhamento (rede local / online), membros, atribuição de tarefas, estatísticas de progresso |
| Configurações | Instalar o ambiente de treinamento, fonte de download, Xuntong AI |
No canto superior direito ficam os botões Feedback e Fechar projeto.
02 Configurações: ambiente de treinamento, fonte de download, Xuntong AI
Se você só vai anotar, importar e exportar, sem treinar, pode pular este capítulo por enquanto.
2.1 Instalar o ambiente de treinamento com um clique
- Clique em Configurações à esquerda.
-
Veja a seção "Ambiente de treinamento":
- A linha GPU mostra a placa de vídeo detectada, a memória de vídeo, o driver e a versão de CUDA suportada. Sem GPU NVIDIA, aparece o aviso de que só é possível treinar na CPU (bem mais lento).
-
A lista Versão do PyTorch já vem com a versão recomendada selecionada (marcada como "Recomendado"); em geral não é preciso mudar:
- CUDA 12.8: GPUs novas, como a série RTX 50;
- CUDA 13.0: exige um driver mais recente;
- CUDA 11.8: GPUs e drivers mais antigos;
- Versão CPU: sem GPU NVIDIA.
- (Opcional) Local de instalação: por padrão, a instalação vai para a pasta de dados local no disco C. Se o disco C estiver com pouco espaço, clique para escolher outro disco com mais espaço e clique em Salvar.
- Clique em Instalar. A versão para GPU tem cerca de 3 GB; uv, Python 3.11 e PyTorch são baixados automaticamente, e o tempo restante aparece abaixo da barra de progresso. Só é preciso instalar uma vez.
- Ao terminar, o status muda para Pronto e aparece "GPU disponível (cuda)" logo abaixo.
O ambiente de treinamento é independente e não afeta outras instalações de Python no sistema.
2.2 Fonte de download
- Na seção "Fonte de download", clique em Testar velocidade e recomendar. O software baixa alguns MB da fonte oficial e dos espelhos na China para medir a velocidade e seleciona automaticamente a mais rápida.
- Com "Espelhos na China" selecionado, os modelos auxiliares, como o SAM e o prompt de texto, também são baixados de um espelho na China (hf-mirror.com).
2.3 Xuntong AI (opcional)
Só é necessário se você quiser usar os modelos da plataforma Xuntong AI para anotar automaticamente, enviar modelos, buscar imagens de alarme ou colaborar online pelo "Retransmissor oficial da Xuntong":
- Na seção "Xuntong AI", clique em Entrar na conta Xuntong AI.
- O navegador abre a página da Xuntong AI: se ainda não estiver conectado, entre (como você faz normalmente na Xuntong). Depois, confira se o código de confirmação na página é o mesmo mostrado no Wulabel e clique em Permitir.
- Volte ao Wulabel: em alguns segundos aparecem automaticamente Conectado como, o nome da conta, o plano e a cota restante, além dos métodos de reconhecimento disponíveis (reconhecer pelas classes do projeto, modelos dedicados ativados na plataforma, reconhecimento geral por LLM). Não é preciso copiar e colar nenhuma Key.
- Se o navegador não abrir sozinho, clique em Reabrir ou copie o endereço mostrado na janela e abra você mesmo.
- Sair da conta: a Key deste computador é apagada, e a Key criada automaticamente no login também é revogada na plataforma.
Se você já tem uma API Key ou usa a Xuntong em implantação privada, clique em Avançado: informar a API Key manualmente, endereço da plataforma em implantação privada, preencha os campos e clique em Salvar e testar conexão. O status da conexão fica sempre visível nesta seção.
2.4 Usar um ambiente Python existente (avançado)
Se você já tem um ambiente Python com PyTorch instalado, não precisa baixar de novo:
- Expanda "Usar um ambiente Python existente (avançado)".
-
Clique em Escolher python.exe e selecione o
python.exedo ambiente (por exemplo,D:\envs\torch\Scripts\python.exe). - Clique em Salvar. O ambiente precisa ter torch, torchvision, numpy e pillow; para exportar ONNX, também precisa do onnx.
- Para voltar ao ambiente do próprio software: apague o caminho e salve.
2.5 Verificar atualizações
Ao iniciar, o software verifica uma vez se há uma versão nova; se houver, aparece um aviso no canto inferior direito. Clique em Atualizar agora: o software baixa a nova versão em segundo plano, confere se está íntegra, instala automaticamente e reabre sozinho, sem você precisar clicar em nada (no Windows aparece só uma barra de progresso da instalação; no Linux instalado pelo .deb, a atualização automática também funciona desde a v0.4.2, e pode ser pedida a senha do sistema uma vez durante a instalação). Projetos e dados são mantidos (desde a v0.4.1). Você também pode clicar em "Baixar" para abrir a página de download. Para não ver mais o aviso de uma versão, clique em "Não lembrar mais desta versão". Também dá para clicar manualmente em Verificar atualizações em "Sobre e atualizações", no final da página de configurações.
A verificação de atualizações só envia a versão do software, o tipo de sistema e um identificador anônimo aleatório, usado para estimar quantas pessoas usam o software; não inclui imagens, projetos nem qualquer dado pessoal. Se não quiser essa verificação online, desligue Verificar atualizações ao iniciar em "Sobre e atualizações".
2.6 Idioma, aparência e a chave do Xuntong AI
No topo da página Configurações você pode mudar:
- 语言 / Language (a partir da v0.5.0): a interface está disponível em 简体中文, 繁體中文, English, 日本語, 한국어, Español, Português, Русский, Deutsch, Français, Tiếng Việt, Bahasa Indonesia. Por padrão usa Seguir o sistema (chinês em um sistema em chinês, inglês para idiomas não incluídos); a interface recarrega ao mudar. Logs de treinamento, mensagens de erro, relatórios de entrega e as instruções do pacote de serviço de inferência também usam esse idioma.
- Aparência (a partir da v0.5.1): Seguir o sistema, Claro ou Escuro. Por padrão segue o modo claro ou escuro do sistema. Áreas de imagem, como a tela de anotação e a pré-visualização, ficam sempre escuras para ver bem as imagens.
- Chave do Xuntong AI (a partir da v0.5.2): a chave no canto superior direito do cartão "Xuntong AI". Vem ligada no chinês simplificado e desligada nos outros idiomas. Desligada, ficam ocultos o Xuntong AI e as regras de reconhecimento em Anotar, a busca de imagens de alarme em Dados, o envio ao Xuntong em Implantar e a retransmissão oficial do Xuntong em Colaboração; ligue se precisar.
03 Criar e abrir projetos
Um projeto é só uma pasta: as imagens (copiadas para dentro dele), as anotações, os modelos e os treinamentos ficam todos lá dentro. Copie a pasta inteira para outro computador e ela abre direto.
No primeiro uso, a página "Projetos" mostra no topo um guia de introdução, que leva você por seis passos: instalar o ambiente de treinamento, criar um projeto, importar imagens, anotar um pequeno lote, treinar, e pré-anotar e implantar. Os passos concluídos são marcados automaticamente. Clique no × no canto superior direito para fechá-lo; depois, clique em "Mostrar guia de introdução" para abri-lo de novo.
Os cartões de "Projetos recentes" mostram a capa do projeto, o número de imagens, quantas já foram anotadas (barra de progresso) e quantas vezes o projeto foi treinado, para você ver de relance em que ponto cada projeto está.
3.1 Criar um projeto
- Na página Projetos, clique em Novo projeto.
- Nome do projeto: por exemplo, "Detecção de capacete em obra".
- Local de armazenamento: o padrão é "Documents/Wulabel"; você também pode clicar em Procurar e escolher outra pasta. O projeto será criado dentro dela.
-
Tipo de tarefa (não pode ser alterado depois de criado):
Tarefa Forma de anotar Indicado para Detecção de objetos Caixas retangulares Localizar capacetes, veículos, fumaça e fogo Segmentação de instâncias Contornos poligonais Quando a forma exata importa: áreas alagadas, montes de lixo, regiões com defeito Classificação de imagens Uma classe por imagem inteira Cena "normal / anormal", classificação de cenas Pontos-chave Caixa do objeto + pontos marcados um a um conforme o template Pose humana (queda, escalada), partes-chave de objetos - Classes (opcional): escreva antes as classes que vai anotar, separadas por vírgula ou quebra de linha, por exemplo "capacete, pessoa, colete refletivo". Se deixar em branco, dá para adicioná-las a qualquer momento na página Anotar.
- Clique em Criar. Aparece a mensagem "Projeto "…" criado" e o projeto abre automaticamente.
3.2 Abrir um projeto
- Na lista Projetos recentes, clique em um projeto para abri-lo; a lista mostra quando cada projeto foi aberto pela última vez.
- Se não estiver na lista, clique em Abrir projeto… e escolha a pasta do projeto.
- Se a pasta do projeto foi movida, a lista mostra "Pasta não encontrada": clique em Localizar… e escolha o novo local para continuar usando o projeto. Se a pasta já foi excluída, clique em "Remover da lista" (os arquivos não são excluídos).
04 Importar dados
Clique em Dados à esquerda.
4.1 Importar imagens ou pastas
-
Primeiro, escolha a forma de importação no topo da página:
- Copiar para o projeto: as imagens são copiadas para a pasta do projeto, e o projeto pode ser levado inteiro para outro lugar (recomendado);
- Só referenciar o caminho original: só registra onde as imagens estão, sem ocupar espaço extra, mas as imagens originais não podem ser movidas.
-
Importe:
- clique em Importar pasta e escolha uma pasta (as imagens das subpastas também são encontradas);
- ou clique em Mais opções de importação → Importar arquivos de imagem e escolha algumas imagens;
- ou arraste para a janela as imagens e pastas e solte quando aparecer "Solte para importar imagens ou vídeos". Se você arrastar um arquivo de vídeo, a janela "Extrair quadros de vídeo" abre direto (veja 4.2).
- Durante a importação, aparece o progresso "N / M imagens processadas (calculando impressões digitais, gerando miniaturas)". Se escolheu errado, clique em Parar; as imagens já processadas entram normalmente. No final, uma mensagem informa quantas imagens foram adicionadas e quantas repetidas foram puladas; clique em Começar a anotar na mensagem para ir direto à página Anotar.
A importação remove duplicatas pelo conteúdo (a mesma imagem não entra duas vezes) e corrige a orientação das fotos de acordo com as informações EXIF.

4.2 Importar vídeos (extrair quadros)
- Clique em Mais opções de importação → Importar vídeos (extrair quadros) e escolha um ou mais arquivos de vídeo.
-
Na janela "Extrair quadros de vídeo", configure:
- A cada N segundos, extrair 1 quadro: se os objetos mudam devagar, use um intervalo maior para evitar um monte de imagens quase iguais;
- Máximo por vídeo: N quadros (0 = sem limite).
- Clique em Iniciar extração. No primeiro uso, o ffmpeg (cerca de 90 MB) é baixado automaticamente; depois não é preciso baixar de novo. Se configurou algo errado, clique em Parar; os quadros já extraídos são importados normalmente.
- Os quadros extraídos são copiados para o projeto, com remoção automática de duplicatas pelo conteúdo. No final, aparece uma mensagem como "M quadros extraídos de N vídeos: K imagens novas".
4.3 Extrair quadros de stream de vídeo (RTSP / ao vivo / gravação)
- Clique em Mais opções de importação → Extrair quadros de stream de vídeo (RTSP / ao vivo / gravação).
-
Preencha o endereço: uma câmera RTSP (
rtsp://…) ou um endereço http(s) ao vivo, de gravação ou de vídeo sob demanda (mp4, m3u8, flv).-
Hikvision:
rtsp://usuário:senha@IP:554/Streaming/Channels/101(stream principal) ou102(substream) -
Dahua:
rtsp://usuário:senha@IP:554/cam/realmonitor?channel=1&subtype=0
-
Hikvision:
- Clique em Testar conexão. Aparecem a resolução e se é uma "Transmissão ao vivo (sem fim, defina um limite)" ou um "Stream de gravação · Duração …".
-
Configure:
- A cada N segundos, extrair 1 quadro;
- Extrair até N quadros e Capturar por até N minutos (0 = sem limite, só ao vivo). Uma transmissão ao vivo não tem fim: defina pelo menos um desses limites;
- marque Pular quadros quase idênticos: guarda menos imagens repetidas quando a cena está parada.
- Clique em Iniciar captura. As imagens entram no projeto à medida que são capturadas, e você as vê aparecer uma a uma na página Dados.
- Durante a captura, você pode clicar em Minimizar e fazer outra coisa; o canto inferior direito mostra "Capturando · N quadros extraídos". Clique em Expandir para voltar. Clique em Parar captura a qualquer momento para encerrar; as imagens já capturadas são mantidas.
-
As imagens capturadas ficam na pasta
images/stream_<endereço>_<hora>/do projeto. No final, você pode clicar em Abrir pasta para vê-las.
O usuário e a senha só são usados durante a captura; o software não coloca o endereço com senha no nome da pasta do projeto.
4.4 Importar conjuntos de dados anotados
Se você já tem dados anotados em outro lugar, pode importá-los junto com as anotações:
-
Clique em Mais opções de importação e escolha conforme o tipo de projeto:
- Projetos de detecção / segmentação: Importar conjunto de dados anotado (YOLO / COCO / VOC), que suporta YOLO (inclusive seg), COCO (inclusive segmentação) e VOC;
- Projetos de pontos-chave: Importar conjunto de dados anotado (YOLO-pose / pontos-chave COCO);
- Projetos de classificação: Importar conjunto de dados de classificação (uma pasta por classe). Cada subpasta da pasta escolhida é uma classe (também pode haver um nível intermediário train / val).
- Escolha a pasta raiz do conjunto de dados; o formato é detectado automaticamente.
- No final, aparece uma mensagem como "Conjunto de dados YOLO importado", com as classes que foram adicionadas.
4.5 Ações em lote, desfazer, excluir, limpar
Os cartões de estatística no topo da página Dados (Sem anotação, Anotadas, Ignoradas) são clicáveis: clique em um para ver só esse tipo de imagem e clique de novo para voltar a ver todas. Os botões de filtro logo abaixo funcionam da mesma forma.
Tudo isso fica no menu Gerenciar:
-
Seleção em lote: entra no modo de seleção. Clique nas imagens para marcá-las; segure Shift e clique em outra imagem para selecionar todo o intervalo entre elas. "Selecionar tudo nesta página" seleciona a página atual, e "Selecionar todas as N imagens" seleciona todas as imagens do filtro atual. Depois você pode:
- Marcar como ignorada: essas imagens não entram no treinamento;
- Restaurar para sem anotação: as imagens que já têm anotações voltam a ficar como anotadas;
- Ir para anotação: manda só as imagens selecionadas para a página Anotar, para anotar uma a uma;
- Dividir: mover para o conjunto de treino, de validação ou de teste (só vale para imagens anotadas; veja 10.1);
-
Excluir.
Ao trocar de filtro ou de página, a seleção é limpa, para você não excluir sem querer imagens que não está vendo. Por fim, clique em Concluído para sair.
- Desfazer a última importação (N imagens): importou algo errado? Exclua com um clique as imagens da última importação (uma captura de stream de vídeo conta como uma importação).
- Limpar todas as imagens: exclui todas as imagens do projeto.
Ao excluir, as anotações das imagens também são excluídas, sem como recuperar. As cópias das imagens dentro do projeto são apagadas, mas as imagens originais no seu computador não são afetadas.
4.6 Triagem de qualidade de imagem
Imagens borradas, escuras demais ou superexpostas são difíceis de anotar e podem atrapalhar o treinamento. Você pode filtrá-las antes:
- Clique em Gerenciar → Triagem de qualidade de imagem (borradas, escuras demais, superexpostas).
- Ver só imagens sem anotação vem marcado por padrão; para verificar todas, desmarque.
- Clique em Iniciar triagem.
- Os resultados são agrupados por problema: Borrada, Escura demais, Superexposta e Baixo contraste; clique nas etiquetas no topo para filtrar. Abaixo de cada imagem aparecem os valores de nitidez, brilho, proporção superexposta e contraste.
-
O que fazer:
- Revisar uma a uma: vai para a página Anotar para você ver cada imagem e decidir;
- Marcar como ignorada: marca como "Ignorada", e a imagem não entra no treinamento (ela continua lá e dá para desfazer depois);
- Excluir: exclui direto.
4.7 Buscar imagens de alarme da Xuntong AI
Depois que o modelo é implantado na plataforma Xuntong AI, as capturas de alarme do campo (principalmente falsos positivos e falsos negativos) são exatamente os dados que mais valem a pena acrescentar:
- Primeiro, configure a Xuntong AI em Configurações (veja 2.3).
- Na página Dados, clique em Mais opções de importação → Buscar imagens de alarme da Xuntong AI.
- Escolha o período (últimos 1 / 3 / 7 dias; a plataforma guarda as imagens de alarme por 7 dias, então busque com regularidade), o modelo (todos ou um específico) e Até N imagens. Só contas Xuntong com um canal de envio configurado geram registros de alarme.
- Usar as caixas detectadas pela plataforma como pré-anotações vem marcado por padrão: as caixas são associadas às classes do projeto pelo nome, e as que não existirem são criadas.
-
Clique em Iniciar busca. As imagens ficam na pasta
images/xuntong_<hora>/do projeto, e as caixas detectadas aparecem tracejadas (origem "Xuntong"). - Confira na página Anotar: exclua as caixas de falsos positivos (em imagens sem objetos, basta pressionar Enter (Concluir) para mantê-las como amostras negativas), adicione o que faltou e treine de novo.
05 Anotar
Clique em Anotar à esquerda.
5.1 Conhecendo a página Anotar
- Topo: setas para trocar de imagem, nome e posição da imagem atual (imagem tal de tantas; clique no número para digitar outro e ir direto até ela), resolução, etiqueta de status (Sem anotação / Anotada / Ignorada; imagens sem objetos mostram "Sem objetos"); botões de filtro Todos / Sem anotação / Anotadas / Ignoradas (na colaboração em equipe, também "Revisadas" e "Devolvidas"); na ponta direita, o zoom e o status de salvamento (Salvo / Não salvo / Salvando… / Falha ao salvar).
- Barra de ferramentas à esquerda: selecionar, desenhar caixa (ou contorno), seleção inteligente SAM, desfazer, refazer, copiar a imagem anterior, interpolação de quadros-chave, rastrear adiante, ajustar à janela. Passe o mouse sobre um botão para ver a descrição e o atalho.
- Centro: a tela com a imagem. Use a roda do mouse para dar zoom; segure Espaço ou o botão direito para arrastar a imagem.
- Direita: os blocos "Assistência de IA", "Classe", "Objetos nesta imagem" (em projetos de classificação, "Classe desta imagem") e "Concluído" (na colaboração em equipe, este último se chama "Revisão").
- Abaixo da tela: dicas dos atalhos disponíveis no projeto atual; pressione ? para abrir o painel com todos os atalhos.
- Parte de baixo: uma faixa com as miniaturas das imagens anteriores e seguintes; clique em uma para ir direto até ela. O pontinho no canto superior direito de cada miniatura mostra o status: azul é anotada, cinza é ignorada, sem ponto é sem anotação.
As alterações são salvas automaticamente; não é preciso salvar manualmente.
5.2 Adicionar e gerenciar classes
- No bloco "Classe" à direita, digite no campo "Nome da nova classe; Enter para adicionar", por exemplo "capacete", e pressione Enter.
- As 9 primeiras classes podem ser trocadas rapidamente com as teclas 1–9; a classe atual fica destacada.
-
Clique no botão de editar ao lado de uma classe para:
- mudar o nome e a cor;
-
preencher o Prompt em inglês (usado na anotação automática por "Prompt de texto"; você pode escrever vários termos separados por vírgula, por exemplo
helmet, hard hat); - preencher as Instruções de reconhecimento (usadas no "Reconhecer pelas classes do projeto" da Xuntong AI: o que exatamente esta classe significa e o que conta / não conta, por exemplo "pessoa sem capacete na cabeça; capacete sem a jugular afivelada também conta");
- excluir a classe. Se a classe já tiver anotações, você pode escolher outra classe em "Mesclar em…": as anotações passam para essa classe e não se perdem (muito útil quando usou a classe errada ou quer juntar duas classes em uma). Se não escolher nenhuma, a classe é excluída junto com as anotações.
5.3 Detecção de objetos: desenhar caixas
- Pressione 1–9 para escolher a classe.
- Pressione R (ou clique na ferramenta de desenhar caixa à esquerda) e arraste com o mouse sobre o objeto para desenhar uma caixa.
- Ajuste: pressione V para mudar para a ferramenta de seleção; clique em uma caixa para arrastá-la ou puxe as bordas e cantos para redimensionar.
- Excluir: selecione a caixa e pressione Del ou Backspace; pressione Esc para desmarcar.
- Mudar a classe: selecione a caixa e pressione uma tecla numérica, ou mude em "Objetos nesta imagem" à direita.
- Pressione H para ocultar / mostrar os nomes das classes nas caixas, o que ajuda quando há muitas caixas juntas.

5.4 Segmentação de instâncias: desenhar contornos
- Escolha a classe e pressione R.
- Clique ponto a ponto ao longo da borda do objeto.
- Dê um duplo clique ou pressione Enter para fechar o contorno; se errar um ponto, pressione Backspace para desfazer o último.
- Depois de selecionar o contorno, você pode arrastar os vértices para ajustes finos.
- Um jeito mais rápido é pressionar S para usar a seleção inteligente SAM: um clique e o contorno sai automaticamente (veja o capítulo 6).
5.5 Classificação de imagens: uma tecla por imagem
- Olhe a imagem e pressione uma tecla numérica 1–9 para escolher a classe. A classe atual aparece no canto superior esquerdo da imagem.
- Ative a chave Avançar ao escolher à direita: depois de pressionar a tecla numérica, você vai automaticamente para a próxima imagem, uma tecla por imagem.
- Pressione Del para limpar a classe desta imagem; pressione Ctrl+D para repetir a classe da imagem anterior.
5.6 Pontos-chave
-
Primeiro, veja o Template de pontos-chave à direita. O padrão é "COCO corpo humano 17 pontos" (nariz, olho esquerdo, olho direito… tornozelo esquerdo, tornozelo direito). Para mudar, clique em Editar:
- Nome do template;
- Nomes dos pontos (um por linha; a ordem dos pontos é a ordem de clique na anotação);
-
Conexões (um par de números por linha, por exemplo
1-2, usadas para desenhar o esqueleto); - você também pode clicar em Usar COCO corpo humano 17 pontos para voltar ao padrão.
- Depois que houver anotações de pontos-chave, só é possível mudar os nomes e as conexões, não adicionar nem remover pontos.
- Escolha a classe e pressione R para desenhar a caixa do objeto.
-
Depois de desenhar a caixa, siga as instruções e clique em cada ponto-chave, na ordem (a parte de baixo da tela mostra qual ponto marcar agora, por exemplo "Clique em ombro esquerdo (6/17)"):
- clique normal: ponto visível;
- Shift + clique: ponto encoberto;
- N: pula um ponto que não dá para ver;
- Backspace: volta ao ponto anterior;
- Esc: termina este objeto.
- Ajuste fino: selecione o objeto e arraste os pontos-chave diretamente. A lista à direita mostra o status de cada ponto; clique em um nome para remarcar só esse ponto, e clique no status para alternar entre "visível / encoberto".
- Com o objeto selecionado, clique em Remarcar pontos-chave para recomeçar a marcação a partir do primeiro ponto.
5.7 Copiar a imagem anterior, desfazer e refazer
- Ctrl+D (ou o botão de copiar à esquerda): traz todas as anotações da imagem anterior, o que economiza muito tempo em cenas parecidas e quadros consecutivos. Em projetos de classificação, repete a classe da imagem anterior.
- Ctrl+Z desfaz, Ctrl+Y refaz.
5.8 Concluir e ignorar
Quem anota sozinho não precisa de revisão: imagens com objetos anotados contam automaticamente como "Anotada" e entram direto no treinamento. No bloco "Concluído" à direita:
-
Concluir e próxima (atalho Enter): vai para a próxima imagem sem anotação.
- Se a imagem realmente não tem objetos, pressionar Enter a registra como "Sem objetos", e ela entra no treinamento como amostra negativa (ensina o modelo a não dar falso positivo nesse tipo de cena). Se apertou sem querer, clique em Desfazer status na mensagem.
- Imagens pré-anotadas em lote (caixas tracejadas): depois de conferir e corrigir, pressione Enter e elas passam a contar como anotadas.
- Ignorar (atalho X): marca como "Ignorada", e esta imagem não entra no treinamento. Bom para imagens borradas ou irrelevantes.
- Desfazer status: volta "Sem objetos" ou "Ignorada" para o status anterior.
- Shift+D: vai direto para a próxima imagem sem anotação.
Ao terminar a última imagem, aparece "Lote concluído", com o número de imagens anotadas e das que faltam. Você pode clicar em Ir para treinamento ou em Continuar com as sem anotação.
Escolha "Ignoradas" no filtro do topo para encontrar as imagens ignoradas e conferi-las de novo.
O fluxo de revisão só existe na colaboração em equipe (quando há membros adicionados ou a colaboração em tempo real está ativa). Aí este bloco passa a se chamar "Revisão", com os botões Aprovar e próxima e Devolver; veja o capítulo 9.
5.9 Quadros de vídeo: interpolação de quadros-chave e rastreamento adiante
Vale para projetos de detecção e de pontos-chave. Os quadros extraídos de vídeo (na mesma pasta, em ordem pelo nome do arquivo) não precisam ser desenhados um a um.
Interpolação de quadros-chave (trechos em que o objeto se move em velocidade constante):
- Vá ao primeiro quadro do trecho e anote todos os objetos (esse é um "quadro-chave").
- Vá ao último quadro do trecho e anote os mesmos objetos.
- Nesse último quadro, clique no botão Interpolação de quadros-chave à esquerda.
- O software associa os objetos das duas pontas por classe e posição e preenche automaticamente os quadros intermediários. Aparece a mensagem "M objetos interpolados em N quadros intermediários"; os objetos que não corresponderem nas duas pontas são informados à parte.
Rastrear adiante (quando o objeto se move de forma irregular):
- Anote os objetos no quadro atual.
- Clique no botão Rastrear adiante à esquerda, preencha Quadros na janelinha (padrão 30, máximo 500) e clique em Rastrear.
- O software segue, quadro a quadro, a partir das caixas deste quadro. Ele para se o objeto ficar encoberto ou se perder, e também para ao chegar a um quadro anotado manualmente mais adiante, sem sobrescrever anotações manuais.
- Ao terminar, vai automaticamente para o último quadro rastreado. Se uma caixa saiu do lugar, arraste-a de volta (a caixa arrastada vira anotação manual, e esse quadro vira um novo quadro-chave) e clique de novo em Rastrear adiante para continuar.
As caixas geradas por interpolação e rastreamento aparecem em "Objetos nesta imagem", à direita, com origem "Interpolado" e "Rastrear". Interpolar ou rastrear de novo substitui essas caixas; as caixas manuais não são alteradas.
Dica para economizar esforço: anote primeiro um pequeno lote à mão (de algumas dezenas a uma ou duas centenas de imagens), treine um modelo inicial e use-o para pré-anotar o resto (capítulo 12). Você só corrige os erros.
06 Anotação assistida por IA
Mesmo antes de ter um modelo seu, você pode deixar a IA ajudar a anotar.
6.1 Seleção inteligente SAM
- Escolha a classe e pressione S (ou clique no botão SAM à esquerda).
- No primeiro uso, é preciso instalar componentes e baixar o modelo, o que pode levar alguns minutos; a tela mostra "Preparando o SAM…". Com GPU NVIDIA, é usado o SAM ViT-B; sem ela, o compacto SlimSAM.
-
Clique uma vez sobre o objeto e o contorno dele é selecionado automaticamente (pré-visualização).
- Pegou área demais: Shift + clique na parte que sobrou para excluí-la;
- Pegou área de menos: clique na parte que ficou de fora;
- Clicou errado: pressione Backspace para desfazer o último ponto;
- Você também pode arrastar uma caixa em volta do objeto.
- Quando estiver bom, pressione Enter para aceitar com a classe atual; pressione Esc para descartar.
- Resultado: em projetos de segmentação, você obtém um polígono; em projetos de detecção, uma caixa justa; em projetos de pontos-chave, um novo objeto (depois clique em "Remarcar pontos-chave" para marcar os pontos).
6.2 Prompt de texto
Encontra objetos na imagem automaticamente pelo nome da classe:
- Em "Assistência de IA", à direita, escolha Prompt de texto.
- O modelo só entende inglês. Nomes de classe comuns em chinês (como 安全帽, 人员, 电动车, 渣土车, 锥桶 e mais de cem outros) são associados automaticamente ao inglês, e o termo aparece depois do nome da classe, por exemplo "安全帽 · helmet" (安全帽 = capacete); também funciona se o nome da classe contiver uma dessas palavras, como "红色安全帽" (capacete vermelho). Se o nome não tiver correspondência (por exemplo, nomes em português) ou se você quiser mudar, preencha o Prompt em inglês na edição da classe.
- Ajuste a Confiança: se encontrar coisas demais, aumente; se não encontrar nada, diminua.
- Clique em Anotar esta imagem (P) para anotar a imagem atual, ou em Pré-anotação em lote para anotar várias de uma vez.
- No primeiro uso, o modelo é baixado, o que leva alguns minutos. Em projetos de segmentação, o SAM é usado em seguida para gerar os contornos.
6.3 Xuntong AI
(O uso completo da Xuntong AI está no capítulo 16.)
- Primeiro, configure a Xuntong AI em Configurações (veja 2.3).
-
Em "Assistência de IA", escolha Xuntong AI e, em "Selecionar modelo de reconhecimento", escolha:
- Reconhecer pelas classes do projeto (recomendado): procura só as classes do projeto, com os nomes das classes exatamente como estão, seguindo as instruções de reconhecimento de cada classe e as regras gerais; não aponta coisas de que você não precisa;
- um modelo dedicado ativado na plataforma;
- Reconhecimento geral por LLM: procura por categoria de risco de segurança (incêndio, elétrico, higiene ambiental etc.).
- Clique em Anotar esta imagem (P) ou Pré-anotação em lote. A pré-anotação em lote com um modelo dedicado (por exemplo, separação de lixo) é rápida: lotes de 8 imagens, dois lotes enviados ao mesmo tempo. O LLM e o reconhecimento pelas classes do projeto vão uma imagem por vez e são mais lentos.
- A Xuntong AI conta 1 chamada por imagem e consome a cota do plano da sua conta; antes de um lote, aparece um aviso.
6.4 Regras de reconhecimento: explique à IA como reconhecer
Só com o nome da classe, a IA nem sempre sabe exatamente o que você quer. Você pode escrever as regras com clareza ou simplesmente conversar com a IA:
- Clique em Regras de reconhecimento, ao lado do título "Assistência de IA"; o painel de regras de reconhecimento abre à direita.
-
Conversar com a IA: diga com palavras simples como reconhecer, por exemplo "capacete sem a jugular afivelada conta como sem capacete", "colete refletivo não conta", "olhar só o corredor na metade de baixo da imagem". Você também pode perguntar "por que a pessoa à esquerda nesta imagem não foi reconhecida?".
- Anexar a imagem atual vem marcado por padrão: a IA testa o reconhecimento nesta imagem com as novas regras.
- Depois que a IA responder, se ela sugerir atualizar as regras, aparece "A IA sugere atualizar as regras" com o conteúdo; as regras só são salvas quando você clica em Aplicar estas regras.
- Se o teste de reconhecimento encontrar algo, clique em Adicionar as N caixas do teste a esta imagem para usá-las direto como pré-anotação.
-
Ctrl+Enterenvia. Cada conversa consome cota da Xuntong AI.
- Regras atuais: você pode editar diretamente as Regras gerais (valem para todas as classes) e as Instruções de reconhecimento por classe, e clicar em Salvar regras.
- A partir daí, a pré-anotação da Xuntong AI com "Reconhecer pelas classes do projeto" segue essas regras.
- (Opcional) No final de "Regras atuais", clique em Sincronizar com a plataforma Xuntong: as classes e as regras são salvas na plataforma Xuntong. Por padrão ficam desativadas e não afetam o reconhecimento atual da plataforma. Depois de vincular, cada vez que você salvar ou aplicar regras o conteúdo é sincronizado automaticamente (sem mudar a ativação nem os cenários aplicáveis que você definiu no console da Xuntong).
- Para que o reconhecimento da própria plataforma Xuntong (assistente de captura, envio de alarmes) também reporte só as classes que você quer, ative Usar estas regras também no reconhecimento da plataforma. Atenção: depois de ativado, todo o reconhecimento da conta Xuntong segue as classes deste projeto; os cenários aplicáveis podem ser ajustados em "Regras de reconhecimento" no console da Xuntong. Para parar de sincronizar, clique em Desvincular (as regras na plataforma não são apagadas). Cada conta Xuntong pode ter no máximo 20 conjuntos de regras de reconhecimento.
Limites: o reconhecimento pelas classes do projeto aceita no máximo 30 classes, com nomes de até 30 caracteres; as regras gerais têm no máximo 1000 caracteres, e as instruções de reconhecimento de cada classe, no máximo 500.
Na colaboração, os membros também podem abrir as regras de reconhecimento e conversar com a IA (se o anfitrião liberou a assistência de IA, é usada a cota do anfitrião); se eles podem alterar as regras depende da chave "Os membros podem adicionar e editar classes".
6.5 Conferir os resultados da assistência
As caixas e contornos marcados pela IA aparecem tracejados. Confira tudo: exclua os errados, arraste os desalinhados para o lugar certo, adicione o que faltou e pressione Enter (Concluir e próxima).
07 Diagnóstico de dados
Clique em Diagnóstico à esquerda para encontrar com um clique os problemas nos dados.
-
Escolha como verificar:
- Se tiver um modelo treinado: escolha "Verificar com o modelo: nome do modelo · mAP50 …"; as regras e o modelo verificam juntos;
- Sem modelo: escolha "Só verificação por regras (sem modelo)".
- Clique em Iniciar diagnóstico.
-
Os resultados aparecem agrupados por problema:
Problema Significado Requer modelo Possível anotação faltando O modelo tem certeza de que há um objeto aqui, mas não há anotação Sim Possível classe errada A posição da caixa confere, mas a classe é diferente da que o modelo previu Sim Caixa imprecisa A classe confere, mas a caixa se sobrepõe pouco à previsão do modelo Sim Possível caixa a mais Há uma caixa anotada, mas o modelo não vê nada nessa posição Sim Caixa minúscula O lado menor tem menos de 8 pixels; o modelo quase não consegue aprender Não Caixa duplicada Duas caixas da mesma classe na mesma imagem quase totalmente sobrepostas Não Imagens repetidas Imagens quase iguais, que inflam os resultados da avaliação Não Sem classe A caixa não tem classe e não entra no treinamento Não -
Para cada problema, você pode:
- Corrigir: vai para a página Anotar com a caixa destacada;
- Adicionar como anotação: em uma possível anotação faltando, adiciona direto uma caixa conforme a previsão do modelo;
-
Não é um problema: ignora, e os próximos diagnósticos não apontam mais.
Quando um tipo de problema tem muitos itens, use Adicionar tudo como anotações (possíveis anotações faltando) ou Ignorar tudo para resolver de uma vez. Os problemas ignorados podem ser recuperados clicando em "N itens ignorados · Restaurar".
- As imagens que você corrigiu na página Anotar aparecem como "Modificada" e recolhidas por padrão quando você volta ao diagnóstico, sem precisar rodar o diagnóstico de novo.
- As imagens repetidas aparecem em grupos, e cada imagem mostra o status e o número de anotações. A de borda verde é a que fica; por padrão, a que tem as anotações mais completas (Revisada > Anotada > mais anotações). Clique em outra imagem para trocar, ou dê um duplo clique para vê-la na página Anotar. Clique em Manter só uma por grupo para excluir as outras; imagens com anotações não são excluídas por engano.
- Mais abaixo na página estão a Distribuição das classes (caixas · imagens) e a Distribuição do tamanho das caixas; quando há classes com poucos exemplos ou caixas pequenas demais, aparecem sugestões. Em projetos de classificação, só são verificadas as possíveis classes erradas e as imagens repetidas.
08 Versões do conjunto de dados
Salve os dados de um momento como snapshot, para comparar e voltar atrás quando quiser.
- Na página Dados, clique em Gerenciar → Versões do conjunto de dados (snapshot, comparação, restauração).
-
Preencha o nome da versão (por exemplo, v1, imagens noturnas adicionadas) e a Observação (opcional) e clique em Salvar os dados atuais como nova versão.
- A versão guarda as imagens anotadas e revisadas no momento, suas anotações e a divisão treino / validação / teste.
-
Em cada linha da lista de versões, você pode:
- Comparar com os dados atuais: ver as imagens adicionadas, removidas e com anotações alteradas, e a mudança no número de anotações de cada classe;
- Exportar esta versão;
- Restaurar para esta versão: antes de restaurar, os dados atuais são salvos automaticamente como uma versão "Backup automático antes da restauração", para você poder voltar a qualquer momento;
- Renomear, observação, Excluir esta versão (só apaga o snapshot, sem afetar os dados atuais nem os modelos já treinados).
- Em "Dados de treinamento", na página Treinar, você pode escolher uma versão para treinar (veja 10.1).
09 Colaboração em equipe
Quando há imagens demais para uma pessoa só, existem duas formas:
- Colaboração em tempo real: várias pessoas anotam o mesmo projeto ao mesmo tempo. Seu computador é o anfitrião; os membros abrem o endereço no navegador, entram e já podem anotar, com as alterações sincronizadas em tempo real. Funciona na rede local e pela internet.
- Pacotes offline: quando não há rede ou os dados não podem sair da empresa, divida as imagens em pacotes de anotação, copie para outras pessoas e, depois de anotados, mescle de volta (veja 9.10).
9.1 Iniciar a colaboração em tempo real
- Clique em Colaboração à esquerda.
-
Primeiro, adicione membros em "Membro": preencha o Nome (usado para entrar), escolha a Função; a senha é gerada aleatoriamente por padrão (você pode mudar). Clique em Adicionar. Copie o usuário e a senha que aparecem e envie para a pessoa (só aparecem desta vez; se alguém esquecer, use Redefinir senha).
- Anotador: só vê e altera as imagens atribuídas a ele;
- Revisor: vê todas as imagens e é responsável por aprovar ou devolver;
- Você é o Administrador.
-
Em "Compartilhamento", escolha a forma de compartilhar:
- Rede local: os membros estão na mesma rede da empresa ou no mesmo Wi-Fi que você. É o mais rápido, e os dados não saem da empresa.
-
Online · Retransmissor próprio: os membros estão na internet (terceirizados, home office). É preciso um servidor em nuvem da sua equipe com o serviço de retransmissão do Wulabel instalado (as instruções de implantação estão na pasta
relay/do repositório); preencha o Endereço de retransmissão e a Chave secreta. Os dados passam só pelo servidor de vocês. - Online · Retransmissor oficial da Xuntong: para quando os membros estão na internet e vocês não têm servidor próprio. Usa a sua API Key da Xuntong para se conectar ao servidor de retransmissão da Xuntong. As imagens e as anotações passam pelos servidores da Xuntong (só repassadas, não armazenadas); para projetos com dados sensíveis, use uma das duas primeiras formas.
- Preencha Seu nome (o nome do anfitrião que os membros veem). Em geral, não é preciso mudar a Porta (padrão 8765).
-
Opções:
- Os membros podem usar assistência de IA: seleção inteligente com SAM, pré-anotação por modelo e prompt de texto rodam no seu computador; conversar com a IA sobre regras de reconhecimento usa a sua cota da Xuntong.
- Os membros podem adicionar e editar classes e instruções de reconhecimento: excluir uma classe apaga todas as anotações dela, então só você pode fazer isso.
- Sobrepor na tela do membro uma marca-d'água com o nome dele: inibe o vazamento por captura de tela; bom para terceirizados.
-
Clique em Iniciar colaboração. A página mostra o Endereço na rede local (por exemplo,
http://192.168.1.20:8765/); no modo online, mostra também o Endereço na internet (por exemplo,https://relay.example.com/s/xxxxxxxxxxxx/). Envie o endereço e o usuário e senha de cada um para os membros.- Na primeira vez, o Windows pode mostrar um aviso do firewall; clique em Permitir.
- Com a colaboração ativa, as três opções podem ser alteradas a qualquer momento e valem na hora.
- Clique em Encerrar colaboração: os membros são desconectados na hora, e as anotações já salvas não são afetadas. Trocar de projeto ou fechar o Wulabel também encerra a colaboração.
9.2 Atribuir tarefas
- Em "Atribuir tarefas", escolha os anotadores (você pode clicar em Selecionar todos os anotadores).
-
Escolha o escopo:
- Imagens sem anotação ainda não atribuídas (o mais comum);
- Todas as imagens sem anotação (redistribui também as já atribuídas);
- Imagens não revisadas (sem anotação + anotadas).
- Por pessoa: N imagens: se deixar em branco, todas as imagens do escopo são divididas igualmente. As imagens são atribuídas em sequência, e os quadros consecutivos de vídeo vão para a mesma pessoa.
- Clique em Atribuir. Do lado dos membros, as novas tarefas aparecem automaticamente.
- Na lista de membros, você vê quantas imagens cada um recebeu, enviou e teve devolvidas. Clique em Recolher tarefas para pegar de volta as imagens que ele ainda não enviou e atribuí-las a outra pessoa.
9.3 Como os membros anotam (navegador)
- Abra no Chrome ou no Edge o endereço que o anfitrião enviou e entre com Nome e Senha. No seu próprio computador, você pode marcar Manter conectado. Não é preciso instalar nada.
- Ao entrar, você já está na página de anotação, que mostra só as imagens atribuídas a você. Tudo funciona como no Wulabel: desenhar caixas, atalhos, assistência de IA (se o anfitrião liberou). O canto superior direito mostra quantas imagens você enviou hoje.
-
Ao terminar, clique em Enviar e próxima (
Enter) e aguarde a revisão. - As imagens devolvidas ficam no filtro Devolvidas, com o motivo da devolução exibido acima da imagem. Corrija e envie de novo.
- Uma imagem que outra pessoa está anotando mostra o aviso "Ana está anotando esta imagem": você só pode visualizar, e as alterações dela aparecem em tempo real. Quando ela sair, a imagem fica editável automaticamente.
- Se a rede cair, o canto superior direito avisa "Conexão em tempo real perdida, reconectando…". Quando a conexão voltar, tudo continua automaticamente, e o que já foi salvo não se perde.
9.4 Revisão
- O revisor (ou você mesmo) filtra Anotadas na página de anotação e confere uma a uma.
-
Sem problemas: clique em Aprovar e próxima (
Enter). - Com problemas: clique em Devolver, marque os motivos comuns (Anotações faltando, Caixa imprecisa, Classe errada, Anotações a mais, Pontos-chave errados) ou escreva claramente o que precisa mudar e clique em Devolver.
- A imagem devolvida volta para "Devolvidas" do anotador original, que corrige e envia de novo.
9.5 Progresso, produtividade e registros
- Online: a lista de membros mostra quem está online e que imagem está vendo; clique para ir até ela. O ponto verde em "Colaboração", na navegação à esquerda, indica que a colaboração está ativa.
- Progresso e produtividade: por hoje / últimos 7 dias / últimos 30 dias / tudo, mostra para cada pessoa as imagens enviadas, os objetos anotados, quantas vezes foi aprovada e devolvida, a taxa de aprovação, o número de revisões e o tempo trabalhado (soma dos intervalos de até 5 minutos entre duas ações). Clique em Exportar CSV e abra no Excel, o que facilita o pagamento por produção de terceirizados.
- Registro de atividades: quem entrou, enviou, revisou, devolveu, alterou classes ou atribuiu tarefas, e quando. Clique no número da imagem para ir até ela. Marque Incluir todos os salvamentos automáticos para ver em mais detalhes.
9.6 Como escolher entre as três formas de compartilhamento
| Rede local | Online · Retransmissor próprio | Online · Retransmissor oficial da Xuntong | |
|---|---|---|---|
| Indicado para | Mesma rede da empresa, mesmo Wi-Fi | Terceirizados, home office, com servidor em nuvem próprio | Terceirizados, home office, sem servidor |
| Endereço que os membros acessam | http://IP-do-seu-computador:8765/ | https://seu-retransmissor/s/código/ | https://xuntongai.com/wulabel-relay/s/código/ |
| Velocidade | A mais rápida | Depende da banda do servidor | Depende da banda dos servidores da Xuntong |
| Por onde os dados passam | Só pela rede interna da empresa | Pelo servidor de vocês (só repassados, não armazenados) | Pelos servidores da Xuntong (só repassados, não armazenados) |
| O que preparar | Nada | Um servidor em nuvem com o serviço de retransmissão instalado conforme relay/README.md | Uma conta Xuntong AI (conectada nas configurações) |
- Nas três formas, as imagens e as anotações ficam guardadas só no seu computador; o servidor de retransmissão apenas repassa os dados.
- No modo online, o código de compartilhamento não muda: na próxima vez que você iniciar, o endereço é o mesmo, e os membros só precisam salvá-lo nos favoritos uma vez.
- Seu computador precisa ficar ligado e o Wulabel com a colaboração ativa para os membros conseguirem se conectar; se o computador entrar em suspensão, os membros veem que o Wulabel do anfitrião está offline. Recomendamos desligar a suspensão automática nas configurações de energia.
9.7 Quem pode fazer o quê
| Ação | Administrador (você) | Revisor | Anotador |
|---|---|---|---|
| Imagens visíveis | Todas | Todas | Só as atribuídas a ele |
| Desenhar caixas, alterar anotações | ✓ | ✓ | ✓ (só nas próprias imagens) |
| Enviar | ✓ | ✓ | ✓ |
| Aprovar, devolver | ✓ | ✓ | |
| Adicionar e editar classes e instruções de reconhecimento | ✓ | Depende da chave "Os membros podem adicionar e editar classes" | Depende da chave |
| Excluir classes | ✓ | ||
| SAM, pré-anotação por modelo, prompt de texto | ✓ | Depende da chave "Os membros podem usar assistência de IA" (roda no seu computador) | Depende da chave |
| Pré-anotação com a Xuntong AI | ✓ | ||
| Conversar com a IA sobre regras de reconhecimento | ✓ | Depende da chave "Assistência de IA" (usa a sua cota da Xuntong) | Depende da chave |
| Atribuir tarefas, gerenciar membros, estatísticas | ✓ | ||
| Importar, exportar, treinar, implantar, diagnóstico | ✓ |
Uma imagem só pode ser alterada por uma pessoa de cada vez: quem abre primeiro fica com o "bloqueio", e para os outros ela abre só para visualização, com as alterações aparecendo em tempo real. O bloqueio é liberado automaticamente quando a pessoa passa para a próxima imagem, fecha a página ou fica 90 segundos sem rede.
9.8 Um exemplo completo
Exemplo: "uma equipe terceirizada anota 2000 imagens de separação de lixo, e a sua própria equipe revisa":
- Preparação: no Wulabel, crie um projeto de detecção, importe as 2000 imagens e adicione as classes à direita (reciclável, orgânico, perigoso, outros). Você pode primeiro fazer uma pré-anotação em lote com um modelo dedicado da Xuntong AI (veja 16.4), para que os anotadores só precisem corrigir os erros, o que é bem mais rápido.
- Adicionar membros: na página "Colaboração", adicione 3 anotadores (os terceirizados Ana, Bruno e Carlos) e 1 revisor (Diana, da sua equipe), e envie a cada um o seu usuário e senha.
- Iniciar a colaboração: escolha "Online · Retransmissor oficial da Xuntong" (ou um retransmissor próprio), marque a "Marca-d'água", inicie e envie o endereço na internet para as 4 pessoas.
- Atribuição: selecione todos os anotadores, escopo "Imagens sem anotação ainda não atribuídas", deixe em branco o número por pessoa e clique em Atribuir: cada um recebe cerca de 666 imagens.
-
Anotação: os anotadores abrem o endereço no navegador e entram; cada um vê só as próprias imagens e pressiona
Enterpara enviar cada imagem terminada. -
Revisão: Diana filtra "Anotadas" e confere uma a uma. Sem problemas, pressiona
Enterpara aprovar; com problemas, clica em "Devolver", marca "Anotações faltando" e escreve "ainda tem uma garrafa no canto inferior direito". A imagem devolvida volta para "Devolvidas" do anotador original, que corrige e envia de novo. - Acompanhar o progresso: na página "Colaboração", você vê quem está online, quem anota mais rápido e quem tem mais devoluções. Se alguém ficar para trás, use "Recolher tarefas" para pegar de volta as imagens que ele não fez e atribuí-las a outra pessoa.
- Pagamento: em "Progresso e produtividade", escolha o período e clique em "Exportar CSV" para calcular o pagamento dos terceirizados pelo número de imagens enviadas e pela taxa de aprovação.
- Finalização: depois que tudo for aprovado, encerre a colaboração e volte ao Wulabel para treinar, avaliar e implantar como de costume.
9.9 Perguntas frequentes
-
Os membros não conseguem abrir o endereço da rede local:
- confirme que eles estão na mesma rede que você (a mesma rede da empresa ou o mesmo Wi-Fi; redes de visitantes geralmente não funcionam);
- na primeira vez que você iniciar, é preciso clicar em "Permitir" no aviso do Firewall do Windows. Se você clicou em "Cancelar", vá em "Segurança do Windows → Firewall → Permitir um aplicativo pelo firewall" e marque o Wulabel;
- se a porta estiver em uso, troque por outra, por exemplo 8766.
- Os membros veem que o Wulabel do anfitrião está offline: seu Wulabel não está com a colaboração ativa, o computador entrou em suspensão ou a rede caiu. Inicie de novo e peça para eles atualizarem a página.
-
O endereço na internet fica mostrando "Conectando ao servidor de retransmissão…":
- retransmissor próprio: confira se o endereço e a chave secreta são os mesmos usados na implantação;
- retransmissor oficial: confirme que você entrou na conta Xuntong AI.
- Um membro vê "Esta imagem não foi atribuída a você": anotadores só abrem as imagens atribuídas a eles. Peça ao administrador para atribuir a imagem a essa pessoa, ou deixe outra pessoa anotar.
- Duas pessoas querem alterar a mesma imagem ao mesmo tempo: não é possível; quem abre depois só visualiza. Quando a primeira pessoa passar para a próxima imagem, a outra pode editar.
- Se a rede de um membro cair, o que ele anotou se perde?: o que já foi salvo não se perde (cada alteração é salva automaticamente no seu computador). Quando a rede voltar, a página se reconecta sozinha.
- Dá para anotar pelo celular?: dá para abrir e visualizar, mas para desenhar caixas recomendamos um computador.
- Quantas pessoas no máximo?: não há limite fixo; uma dezena ou mais de pessoas anotando ao mesmo tempo funciona bem. Com muita gente, seu computador precisa ficar ligado e com rede estável.
- O que acontece ao encerrar a colaboração ou fechar o Wulabel?: os membros são desconectados na hora e veem "O anfitrião encerrou a colaboração"; as anotações já salvas continuam lá. Na próxima vez que você iniciar, eles atualizam a página e continuam.
- Troquei de projeto: a colaboração é encerrada automaticamente. A colaboração vale para o projeto aberto no momento.
9.10 Pacotes offline
Use quando não houver rede ou quando os dados não puderem sair da empresa. Cada pacote é um projeto Wulabel independente: copie para outras pessoas anotarem e, quando terminarem, mescle de volta.
Dividir em pacotes:
- Na página Dados, clique em Gerenciar → Colaboração em equipe (dividir em pacotes, mesclar de volta) e mude para Dividir em pacotes.
- Salvar em: escolha uma pasta; os pacotes de anotação são criados nela.
- Preencha os Anotadores, um por linha (ou separados por vírgula), por exemplo "Ana", "Bruno". Será criado um pacote para cada pessoa.
- Escolha o escopo: Só imagens sem anotação / Não revisadas (sem anotação + anotadas aguardando revisão) / Todos (exceto as ignoradas).
- Marque Incluir as anotações existentes: as imagens já pré-anotadas pelo modelo vão junto, para o anotador corrigir em cima, o que é mais rápido.
- (Opcional) Marque Anonimizar imagens para aplicar a anonimização em rostos, placas de veículos e outras áreas privadas antes de enviar (veja 13.2).
- Clique em Dividir em N pacotes. Ao terminar, a pasta de destino abre automaticamente. Copie cada pasta de pacote para a pessoa correspondente, que só precisa usar Abrir projeto no Wulabel para anotar.
Mesclar de volta:
- Copie de volta as pastas dos pacotes anotados.
- Abra Colaboração em equipe e mude para Mesclar de volta (ou, na lista "Pacotes distribuídos", clique direto em Mesclar no pacote).
- Escolha a pasta do pacote. Opções: Em caso de conflito, sobrescrever com a versão do pacote (por padrão, as imagens também alteradas no projeto original depois da divisão não são sobrescritas) e Importar também as imagens que o anotador adicionou ao pacote.
- Clique em Mesclar. O resultado mostra quantas imagens foram mescladas, quantas não mudaram, quantas são novas e quantas têm conflito. Se houver conflitos, clique em Revisar uma a uma.
10 Treinar
Clique em Treinar à esquerda. Antes do primeiro treinamento, é preciso instalar o ambiente de treinamento (veja o capítulo 2); se ele não estiver instalado, a página mostra o botão Instalar.
10.1 Configurar os parâmetros de treinamento
O topo da página mostra o número de "Imagens treináveis" (as imagens anotadas; na colaboração em equipe, também as revisadas). As imagens que ainda não foram divididas são distribuídas automaticamente entre os conjuntos de treino e de validação na proporção 8:2 ao iniciar o treinamento; as que já foram divididas não mudam sozinhas, então dá para comparar diretamente um treinamento com outro.
Clique em Ver e ajustar, ao lado de "Imagens treináveis", para ver em qual conjunto está cada imagem:
- Conjunto de treino: o modelo aprende com estas imagens;
- Conjunto de validação: não é usado para aprender; a cada época o modelo é avaliado nele, e a melhor época é a que fica salva;
- Conjunto de teste: não é usado em nada durante o treinamento; depois do treinamento, recebe uma nota à parte na página "Avaliar", e é o que mais se aproxima do desempenho real do modelo depois de implantado.
Na janela, clique nas imagens para selecioná-las (duplo clique abre para anotar) e use Mover para o conjunto de treino / Mover para o conjunto de validação / Mover para o conjunto de teste para ajustar manualmente. Embaixo, dá para mudar as proporções de treino / validação / teste e clicar em Atribuir agora as N imagens sem atribuição ou em Refazer toda a divisão (a divisão anterior é embaralhada, e os treinamentos de antes e de depois deixam de ser diretamente comparáveis). Se o conjunto de treino ficar vazio, aparece um aviso e não é possível iniciar o treinamento.
| Opção | Descrição |
|---|---|
| Ponto de partida | O padrão é "Começar dos pesos pré-treinados (treinar do zero)". Depois de acrescentar dados novos, você pode escolher "Continuar a partir de …" com um treinamento anterior, o que é mais rápido e mais estável do que treinar do zero; se as classes mudaram, a parte de classificação é reaprendida. |
| Modelo | Lista os modelos conforme a tarefa do projeto; o marcado como "Recomendado" é o indicado para este computador: em projetos de detecção, sem GPU dedicada é recomendado o YOLOX-Tiny, com 4 GB ou mais de memória de vídeo o YOLOX-S, com 8 GB ou mais o YOLOX-M, e no Mac o YOLOX-S. Projetos de detecção novos usam o YOLOX-S por padrão. Ao continuar um treinamento, é usado o modelo daquele treinamento. |
| Épocas | Quanto menos dados, mais épocas são necessárias; em geral, de 20 a 50. |
| Tamanho de entrada | Para objetos pequenos (pessoas distantes, capacetes), use um tamanho maior, o que deixa tudo mais lento. Para classificação, em geral 224. |
| Tamanho do lote | Diminua se aparecer erro de falta de memória de vídeo. |
| Dados de treinamento | "Dados atuais" ou uma versão do conjunto de dados. |
| Dispositivo | "Automático (usa a GPU se houver)" ou "Só CPU". |
| Usar só imagens revisadas | Só na colaboração em equipe: quando marcado, treina só com as imagens revisadas. |
Tamanho de entrada, tamanho do lote, aumento de dados, dispositivo e "Usar só imagens revisadas" (só na colaboração em equipe) ficam em "Configurações avançadas", recolhidas por padrão; clique em "Configurações avançadas" para expandir. O software lembra se você deixou expandido ou recolhido da última vez.
Falta de memória de vídeo durante o treinamento (desde a v0.4.2): o software reduz automaticamente o tamanho do lote pela metade e recomeça o treinamento, até chegar a 1. A interface avisa uma vez, e o registro do treinamento também mostra "Tamanho do lote 2 (reduzido automaticamente de 8 por falta de memória de GPU)". Quanto menor o lote, mais lento o treinamento; se a memória de vídeo realmente não for suficiente, você também pode trocar para um modelo um nível menor ou diminuir o tamanho de entrada.
Modelos disponíveis:
| Tarefa | Modelo | Características |
|---|---|---|
| Detecção | YOLOX-Nano | O mais leve da série YOLO, para CPU, celulares e dispositivos de borda bem fracos; entrada padrão 416 |
| Detecção | YOLOX-Tiny | Muito leve, para inferência em tempo real em CPU e caixas de borda com NPU; entrada padrão 416 |
| Detecção | YOLOX-S | O melhor equilíbrio entre velocidade e precisão; comece por ele na maioria dos projetos |
| Detecção | YOLOX-M | Mais preciso; recomendado 6 GB ou mais de memória de vídeo |
| Detecção | YOLOX-L | O mais preciso e o mais lento; recomendado 8 GB ou mais de memória de vídeo |
| Detecção | Faster R-CNN MobileNetV3 | Rápido e com pouco uso de memória de vídeo; bom para começar e para computadores sem GPU dedicada |
| Detecção | Faster R-CNN ResNet50 | Mais preciso e mais lento; recomendado 6 GB ou mais de memória de vídeo |
| Detecção | RetinaNet | Estágio único, precisão próxima à do Faster R-CNN, converte melhor para TensorRT |
| Detecção | FCOS | Estágio único, sem âncoras, estrutura simples, bom para implantação |
| Detecção | SSDLite | Estágio único, muito leve, para CPU e dispositivos de borda com NPU; entrada fixa de 320, desempenho mediano em objetos pequenos |
| Segmentação | Mask R-CNN | Segmentação de instâncias; recomendado 6 GB ou mais de memória de vídeo |
| Pontos-chave | Keypoint R-CNN | Para os 17 pontos do corpo humano, aproveita o pré-treinamento no COCO |
| Classificação | MobileNetV3 / EfficientNet-B0 / ResNet50 | Do mais leve e rápido ao mais preciso |
10.2 Modelos YOLOX
O YOLOX é um modelo de detecção da série YOLO, de código aberto, da Megvii (Apache-2.0, pode ser usado comercialmente sem preocupação), da mesma série dos modelos dedicados da plataforma Xuntong AI.
- Pesos pré-treinados: no primeiro treinamento, os pesos oficiais pré-treinados no COCO são baixados automaticamente (Nano cerca de 8 MB, S cerca de 70 MB, L cerca de 430 MB), primeiro do site oficial e, se falhar, do GitHub; depois de baixados uma vez, não é preciso baixar de novo.
- Aumento de dados: segue o método oficial do YOLOX: Mosaic, MixUp, escala e rotação aleatórias, variação de cor, espelhamento horizontal e treinamento multiescala são ativados automaticamente, e nos últimos ~10% das épocas o aumento forte é desligado para finalizar. Por isso, com o YOLOX, as configurações de "Aumento de dados" abaixo não aparecem.
- Épocas: o YOLOX precisa de um pouco mais de épocas que o Faster R-CNN; recomendamos 50 ou mais. Com poucos dados (algumas centenas de imagens), cerca de 100.
- Taxa de aprendizado: é ajustada automaticamente ao tamanho do lote; não é preciso configurar.
- Tamanho de entrada: Nano e Tiny usam 416 por padrão; S, M e L, 640. Você pode mudar; o valor é arredondado para um múltiplo de 32.
- Por que não YOLOv5 / v8 / v11: eles têm licença AGPL-3.0, que impõe restrições em produtos comerciais; o YOLOX é Apache-2.0, como o Wulabel. Modelos YOLOv5 / v8 / v11 treinados em outro lugar ainda podem ser trazidos por "Importar modelo externo" para pré-anotar e avaliar.
Os modelos YOLOX treinados funcionam como os demais: avaliação, pré-anotação por modelo, teste de falsos positivos, teste ao vivo, exportação para implantação e envio para a Xuntong são todos suportados.
10.3 Aumento de dados
Durante o treinamento, as imagens são alteradas aleatoriamente para o modelo ver mais variações; o efeito é grande quando há poucos dados.
- Em "Aumento de dados", escolha uma predefinição: Desligado, Padrão, Leve, Médio ou Forte (para poucos dados).
- Para ajustar em detalhes, expanda e altere Espelhar horizontalmente, Espelhar verticalmente, Brilho, Contraste, Saturação, Matiz, Borrada (desfoque aleatório: simula foco errado e borrão de movimento), Ruído (simula pouca luz à noite), Multiescala (ajuda com objetos cujo tamanho varia muito com a distância), Rotação e Recorte aleatório. Depois de alterar, a predefinição passa a mostrar "Personalizado".
- Clique em Pré-visualizar para ver como algumas imagens ficam com aumento aleatório (cada imagem é alterada aleatoriamente duas vezes; as caixas vermelhas mostram as anotações acompanhando a transformação) e confirme que não ficou exagerado.
10.4 Iniciar o treinamento e acompanhar
- Antes de começar, confira o "~N passos por época · ~M no total" acima do botão. Se houver poucas imagens (menos de 20 no conjunto de treino) ou poucos passos no total (menos de uns 300), ao clicar em Iniciar treinamento aparece antes um aviso: treinando assim, o modelo provavelmente não aprende nada, e as métricas podem ficar em 0. O ideal é anotar mais imagens ou aumentar as épocas como sugerido; com pouquíssimos dados, também dá para começar com o Faster R-CNN MobileNetV3. Se quer mesmo só testar, clique em Começar mesmo assim. Também aparece um aviso quando o conjunto de validação tem só uma ou duas imagens: as métricas vão oscilar muito e não são confiáveis.
- Clique em Iniciar treinamento. Na primeira vez, os pesos pré-treinados são baixados, e aparece "Preparando…".
-
Durante o treinamento, aparece "Época N / M · progresso da época · loss · restante estimado", e abaixo ficam a curva de Perda (loss), as curvas de métricas do Conjunto de validação e o Log.
- As "Informações principais", acima do log, mostram sempre as primeiras linhas do log: o dispositivo usado, o número de imagens dos conjuntos de treino e de validação e se os pesos pré-treinados foram carregados. Linhas de erro e de aviso ficam destacadas em amarelo.
- Ao rolar o log para cima, ele não puxa você de volta para o fim; quando você está no fim, ele acompanha as linhas novas.
- Se não foi possível baixar os pesos pré-treinados (geralmente por problema de rede), ou se as métricas ficam em 0 por 10 épocas seguidas, aparece uma barra amarela no topo da página com a causa provável e o que fazer.
- Para terminar antes, clique em Parar e confirme; o treinamento para quando o lote atual terminar. O melhor modelo até o momento é mantido, e depois você pode escolhê-lo para "continuar o treinamento".
-
Quando o treinamento termina, aparece uma notificação do sistema e o ícone da barra de tarefas pisca (você fica sabendo mesmo com o software em segundo plano); no software, o canto inferior direito mostra "Treinamento concluído", com a melhor métrica e uma avaliação (fraco / regular / aceitável):
- se o resultado está bom, você pode clicar direto em Avaliar ou Pré-anotar;
- se o resultado está muito ruim, aparece a sugestão de clicar em Ver a causa para voltar à página Treinar e dar uma olhada;
- se o treinamento falha, aparece um aviso mesmo fora da página Treinar; clique em Ver erro para ver.
- Quando o treinamento dá erro, os erros comuns são explicados em linguagem simples, com um botão para corrigir: o driver da GPU não combina com o PyTorch (Trocar a versão do PyTorch nas Configurações), falta memória de vídeo ou RAM (Usar CPU), disco cheio, falha no download pela rede ou arquivos de imagem não encontrados (Ir para Dados). Clique em Detalhes para expandir a mensagem de erro completa.
10.5 Treinamentos e comparação de treinamentos
Cada treinamento é salvo automaticamente como um registro em Treinamentos, com data e hora, modelo, dados, épocas, métricas e status (Treinando / Concluído / Parado / Falhou). Em cada registro, você pode:
- Ver avaliação (abre a avaliação deste treinamento específico), Exportar ONNX, Abrir pasta do treinamento e excluir. Registros que ainda estão treinando só podem ser avaliados e implantados depois de terminar.
Comparar treinamentos:
- Em Treinamentos, marque 2 ou mais treinamentos.
- Clique em Comparar selecionados (N).
- Na janela de comparação: parâmetros e dados lado a lado (as diferenças em negrito), as métricas, as curvas de perda sobrepostas e, nos resultados por classe, o melhor treinamento destacado.
10.6 Importar modelo externo
Modelos de detecção treinados em outro lugar (por exemplo, com o Ultralytics YOLO) podem ser exportados para ONNX e importados para pré-anotar, fazer diagnóstico, avaliar e testar falsos positivos (não é possível continuar o treinamento nem implantar). No momento, só para projetos de detecção.
- Acima da lista de treinamentos, clique em Importar modelo externo.
- Clique em Selecionar arquivo .onnx.
-
O software detecta automaticamente:
- Formato: YOLOv8 / v11 (Ultralytics), YOLOv5 / v7, modelos ponta a ponta como o YOLOv10, YOLOX, RT-DETR, DETR / RF-DETR e modelos exportados pelo Wulabel. Se a detecção errar, você pode mudar manualmente;
- Tamanho de entrada;
- Nomes das classes (um por linha, na mesma ordem do modelo). Troque os nomes de classe do modelo pelos nomes das classes do projeto para associá-los, por exemplo, mude person para "pessoa".
- Classes a usar: as classes não marcadas não são adicionadas na pré-anotação; as classes com o mesmo nome de uma classe do projeto vêm marcadas por padrão.
- Clique em Importar. Um novo registro "… (externo)" aparece em Treinamentos.
11 Avaliar
Clique em Avaliar à esquerda e escolha um treinamento (se você veio por "Ver avaliação" na página Treinar, ele já vem selecionado). Registros que ainda estão treinando aparecem como "Treinando" e só podem ser escolhidos depois de terminar.
11.1 Ver as métricas
- O topo informa de qual época é o melhor modelo usado nesta avaliação; você pode alternar entre o Conjunto de validação e o Conjunto de teste.
- A primeira linha é a Conclusão: uma avaliação "fraco / regular / aceitável" pela métrica principal (detecção e similares usam o mAP50: abaixo de 0.3 é fraco, de 0.3 a 0.6 regular, acima de 0.6 aceitável; classificação usa a acurácia: abaixo de 0.6 é fraco, de 0.6 a 0.85 regular, acima de 0.85 aceitável), e aponta a pior classe. Ao lado ficam os botões do próximo passo: ver os erros de falsos negativos, mandar os erros para anotação, acrescentar dados e treinar de novo / trocar por um modelo maior; quando o resultado é aceitável, aparece Ir para implantação. Se menos de 10 imagens foram avaliadas, aparece o aviso de que as métricas oscilam muito.
- Projetos de detecção, segmentação e pontos-chave: mAP50 (a métrica de detecção mais comum), mAP50-95 (mais exigente com a precisão das caixas), Precisão (proporção de caixas corretas entre as apontadas; se for baixa, há muitos falsos positivos), Revocação (proporção de objetos reais encontrados; se for baixa, há muitos falsos negativos). Segmentação e pontos-chave são calculados pelas caixas dos objetos.
- Projetos de classificação: Acurácia, F1 macro, precisão média e revocação média.
- Passe o mouse sobre uma métrica para ver a explicação.
- Tabela Por classe: número de imagens, número de caixas reais e as métricas de cada classe.
11.2 Matriz de confusão
As linhas são as classes reais, e as colunas, as previsões do modelo. A diagonal mostra os acertos; as outras células mostram uma classe confundida com outra. A última coluna, "Fundo", são os falsos negativos; a última linha, "Fundo", são os falsos positivos. Passe o mouse para ver os números.
11.3 Erros
- Lista as imagens com problemas; você pode filtrar por Falsos negativos, Falsos positivos e Classe errada.
- Clique em um erro para ir direto à página Anotar, conferir e corrigir. Depois de corrigir, treine de novo, fechando o ciclo.
11.4 Limiar de confiança
Para saber qual limiar usar nos alarmes da implantação, veja aqui:
- O software recomenda o limiar com o maior F1 e mostra a precisão e a revocação nesse limiar.
- As curvas mostram como precisão, revocação e F1 mudam com o limiar. Arraste o controle deslizante para ver o efeito de cada limiar: quantos acertos, quantos falsos positivos e quantos falsos negativos.
- Como escolher: com muitos falsos positivos, aumente o limiar; com muitos falsos negativos, diminua.
- A tabela abaixo mostra o limiar recomendado de cada classe.
- O limiar recomendado é levado automaticamente para o teste ao vivo e para o pacote de serviço de inferência da página "Implantar", como limiar de confiança padrão.
11.5 Avaliar com os dados atuais
Depois de acrescentar dados ou alterar anotações, não é preciso treinar de novo: clique em Avaliar com os dados atuais para recalcular as métricas com os dados anotados de agora (conjunto de validação / teste). Os modelos externos importados também são avaliados assim.
11.6 Teste de falsos positivos
Use um vídeo que não deveria disparar alarmes (sem objetos, ou só com coisas fáceis de confundir, como um corredor vazio ou uma fábrica à noite) para medir quantos falsos positivos o modelo gera:
-
Em "Teste de falsos positivos", clique em Escolher arquivo de vídeo ou preencha um endereço
rtsp:///http(s)://. - Configure: Detectar N quadros por segundo, Alarmar após N detecções seguidas e Testar por N minutos (para streams de vídeo).
- Clique em Iniciar teste; a qualquer momento, você pode clicar em Encerrar antes.
- Resultado: quanto tempo foi testado, quantos alarmes houve e quantos Por hora, com estatísticas por classe; abaixo aparecem os quadros com falso positivo (as caixas vermelhas são o que o modelo apontou; só ficam os 60 mais recentes).
- Clique em Adicionar estes quadros ao conjunto de dados como amostras negativas: eles entram como imagens "Sem objetos", e no próximo treinamento o modelo aprende a não alarmar nesse tipo de cena. Se algum quadro tiver um objeto real, anote-o na página Anotar depois de adicionar.
11.7 Exportar o relatório de entrega
- Clique em Exportar relatório e escolha onde salvar (nome de arquivo padrão: "<nome do projeto>_<nome do treinamento>_relatorio_modelo.html").
- O relatório é um arquivo HTML com a situação dos dados, os parâmetros de treinamento, as métricas, as curvas, a matriz de confusão, os erros, o limiar recomendado e os resultados do teste de falsos positivos. Ele abre direto no navegador e pode ser enviado ao cliente para aceite.
12 Pré-anotação por modelo e escolha de imagens
12.1 Pré-anotar com o seu próprio modelo
- Vá à página Anotar e, em "Assistência de IA", à direita, escolha Meus modelos; na lista, selecione um modelo treinado (aparecem o nome e o mAP50 / acurácia).
- Ajuste a Confiança.
- Uma imagem: pressione P ou clique em Prever esta imagem (P).
- Em lote: clique em Pré-anotação em lote para anotar um lote de imagens sem anotação. A janela fecha na hora e a barra de progresso fica à direita, então dá para continuar anotando enquanto roda; para interromper no meio, clique em Parar ao lado da barra de progresso, e o que já foi anotado é mantido.
- As caixas pré-anotadas são tracejadas; confira, corrija e pressione Enter (Concluir e próxima), e a imagem passa a contar como anotada. Em projetos de classificação, aparecem as "Sugestões do modelo", e basta clicar em uma das 3 primeiras classes para aplicá-la.
Quanto mais você anota → mais preciso fica o modelo → menos trabalho dá a pré-anotação.

12.2 Escolher as imagens que mais valem a pena anotar
Depois que você tem um modelo inicial, em vez de anotar imagens ao acaso, é melhor anotar primeiro aquelas sobre as quais o modelo tem mais dúvida:
- Na página Dados, clique em Gerenciar → Escolher as imagens que mais valem a pena anotar (com modelo).
- Escolha o modelo, preencha Escolher N imagens e clique em Iniciar seleção.
- O resultado vem ordenado da imagem mais incerta para a menos incerta.
- Clique em Anote nesta ordem: a página Anotar mostra só esse lote de imagens (o filtro no topo ganha a opção "Seleção do modelo"). Ao terminar, clique no × ao lado dela para voltar a todas as imagens.
13 Exportar o conjunto de dados (com anonimização)
13.1 Exportar
- Na página Dados, clique em Exportar conjunto de dados.
-
Formato (conforme a tarefa do projeto):
- Detecção: YOLO, COCO, VOC;
- Segmentação: YOLO-seg, COCO, VOC (só caixas delimitadoras);
- Pontos-chave: YOLO-pose, pontos-chave COCO, VOC (só caixas dos objetos);
- Classificação: pastas por classe (train/classe/imagem.jpg).
- Escopo: imagens sem anotação e ignoradas não são exportadas; imagens marcadas como "Sem objetos" são exportadas como amostras negativas. Na colaboração em equipe, também dá para marcar Exportar só imagens revisadas.
- Proporção treino / validação / teste (%): as imagens que ainda não foram divididas são distribuídas nessa proporção. Para refazer a divisão de todas, clique em Refazer toda a divisão (os resultados de treinamentos anteriores deixam de ser diretamente comparáveis com a nova divisão).
- Exportar para: clique em Procurar para escolher o local; o Nome da pasta é gerado automaticamente, e você pode mudar (depois de mudado, trocar de formato não o sobrescreve).
- Clique em Exportar. Ao terminar, aparecem quantas imagens e anotações foram exportadas e quantas imagens há em cada divisão; clique em Abrir pasta para ver.
Para exportar uma versão do conjunto de dados: na lista de versões, clique em Exportar esta versão; a divisão fica fixa conforme a da versão.
13.2 Anonimização
Ao exportar o conjunto de dados, exportar uma versão ou dividir em pacotes, você pode marcar Anonimizar imagens:
- Por classe: na lista, escolha as classes a anonimizar, por exemplo as classes "rosto" e "placa" que você anotou. Classes cujo nome contém "rosto" ou "placa" vêm selecionadas por padrão.
- Detecção automática: marque Detectar rostos automaticamente e Detectar placas automaticamente; o software usa um modelo de detecção de vocabulário aberto para encontrá-los (o modelo é baixado no primeiro uso; com GPU, fica bem mais rápido).
- Método: Mosaico, Borrada (desfoque) ou Tarja preta.
- A exportação ganha uma etapa de progresso a mais, de "Anonimizar".
A anonimização só altera as cópias exportadas; as imagens originais do projeto ficam intactas. A detecção automática pode deixar passar objetos muito pequenos, rostos de perfil e alvos distantes; para dados importantes, confira por amostragem.
14 Implantar
Clique em Implantar à esquerda e escolha um modelo treinado. A página tem quatro abas: Teste ao vivo, Exportar modelo, Pacote de serviço de inferência e Retorno do campo.
14.1 Teste ao vivo
Conecte uma câmera ou um vídeo e veja o desempenho do modelo na prática:
- Escolha Streams de vídeo ou Vídeo local.
-
Preencha o endereço do stream: uma câmera RTSP (por exemplo,
rtsp://admin:senha@192.168.1.64:554/Streaming/Channels/101) ou um endereço HTTP-FLV, HLS (m3u8) ou MP4 via http. Também dá para clicar em Escolher arquivo de vídeo. - Clique em Iniciar: os resultados são desenhados na imagem em tempo real (caixas para modelos de detecção, contornos para segmentação, pontos e esqueleto para pontos-chave e, para classificação, as classes mais prováveis no canto superior esquerdo). O topo mostra a resolução e se a inferência está na GPU ou na CPU.
- Arraste o controle de Confiança para ajustar o limiar. O padrão é o limiar recomendado da página Avaliar; se mudar, clique em "Usar o recomendado (0.xx)" para voltar a ele.
- Ao ver quadros com falsos negativos ou falsos positivos, clique em Adicionar captura ao conjunto de dados: a imagem entra como "Sem anotação", para você anotar e treinar de novo.
- Clique em Parar para encerrar.
14.2 Exportar modelo
-
Escolha o formato:
- ONNX (tamanho dinâmico): formato universal; o onnxruntime roda no Windows, no Linux e em ARM;
- ONNX (tamanho fixo): a entrada fica fixa em [1,3,N,N], para frameworks de inferência que exigem formato fixo;
- OpenVINO: aceleração em CPUs Intel, GPUs integradas e PCs industriais; a conversão e a verificação são feitas direto no software (o OpenVINO é instalado automaticamente no primeiro uso);
- Pacote de conversão TensorRT: GPUs NVIDIA, Jetson; é preciso rodar um script no dispositivo de destino para gerar o engine;
- Pacote de conversão RKNN: Rockchip RK3588 / 3568 etc.; é preciso rodar um script no Ubuntu para converter.
- Se precisar de tamanho fixo, defina o tamanho.
- Escolha o local em Exportar para e o Nome da pasta e clique em Exportar. Cada formato mostra se deu certo ou falhou; clique em Abrir para ver.
O Faster R-CNN embutido é um modelo de dois estágios, com suporte limitado em NPUs (RKNN) e em versões antigas do TensorRT; a conversão pode falhar ou ficar lenta. Para esse tipo de dispositivo, recomendamos treinar o YOLOX ou outro modelo de estágio único (RetinaNet, FCOS, SSDLite). ONNX e OpenVINO podem ser usados sem preocupação.
Ao exportar modelos YOLOX: no ONNX (tamanho dinâmico) e no OpenVINO, funciona como nos outros modelos: o redimensionamento, a decodificação e a remoção de caixas duplicadas (NMS) já estão dentro do modelo, que entrega o resultado final. Já o ONNX (tamanho fixo) e os pacotes de conversão TensorRT e RKNN usam o formato oficial do YOLOX (entrada BGR 0~255, preenchimento com 114 a partir do canto superior esquerdo, saída sem NMS); os operadores são convoluções comuns, que rodam por completo em NPU e TensorRT. O pós-processamento está descrito no README do pacote de conversão.
Modelos de segmentação e pontos-chave (Mask R-CNN, Keypoint R-CNN) também podem ser exportados para ONNX, OpenVINO e outros formatos: o modelo de segmentação tem uma saída a mais, masks (probabilidade da máscara de cada objeto; acima de 0.5 é objeto), e o de pontos-chave tem keypoints (x, y e visibilidade de cada ponto) e keypoints_scores. O teste ao vivo e o pacote de serviço de inferência suportam modelos de detecção, segmentação, pontos-chave e classificação.
14.3 Pacote de serviço de inferência
Gera um serviço de inferência que roda assim que chega ao computador do local. Suporta modelos de detecção, segmentação, pontos-chave e classificação:
-
Streams de vídeo: preencha o nome e o endereço (
rtsp://…, um endereçohttp(s)://…FLV / m3u8 / MP4 ou o caminho de um arquivo de vídeo); clique em Adicionar stream para incluir vários. - Intervalo de detecção (s): de quanto em quanto tempo detectar um quadro de cada vídeo.
-
Regras de alarme:
- Classes de alarme (sem nenhuma selecionada, todas as classes disparam alarme);
- Limiar de confiança (o padrão é o limiar recomendado da página Avaliar);
- Intervalo de deduplicação (s): para o mesmo vídeo e a mesma classe, só um alarme dentro desse período;
-
Horário ativo: dia todo ou, por exemplo,
07:00-19:00; - Salvar capturas dos alarmes (com caixas).
-
Envio de alarmes:
- Webhook: a cada alarme, faz um POST de JSON para este endereço; opcionalmente, Incluir captura (base64);
- MQTT: endereço do servidor, tópico, usuário e senha (em branco, nada é enviado).
- Serviço: Porta da API HTTP; Inferência na GPU (o computador do local precisa ter o onnxruntime-gpu; senão, a CPU é usada automaticamente).
-
Retorno do campo: os quadros em que o modelo está inseguro (confiança dentro do intervalo definido) são salvos na pasta
reflux/do pacote de serviço. - Escolha o local em Gerar em e clique em Gerar pacote de serviço de inferência.
-
Copie a pasta inteira para o computador do local: no Windows, dê um duplo clique em
run.bat; no Linux, executesh run.sh. A configuração fica emconfig.json, e as instruções, emREADME.md. O computador do local não precisa de PyTorch nem de GPU; só depende de onnxruntime, OpenCV e numpy.
14.4 Retorno do campo
-
Enquanto o pacote de serviço roda no local, os quadros em que o modelo está inseguro são salvos na pasta
reflux/. -
De tempos em tempos, copie a pasta
reflux/de volta e, na aba Retorno do campo, clique em Importar imagens de campo e escolha essa pasta. - Clique em Ir para anotação, filtre por "Sem anotação", pré-anote com o modelo e corrija.
-
Treine de novo, gere um novo pacote de serviço e substitua o
model.onnxno local. O modelo fica mais preciso com o uso.
14.5 Enviar para a plataforma Xuntong AI
Se você não quer implantar o serviço por conta própria, pode enviar o modelo para a plataforma Xuntong AI e, lá, conectar câmeras e configurar alarmes (no momento, para modelos de detecção de objetos):
- Primeiro, configure a Xuntong AI em Configurações (veja 2.3).
- No final de Implantar → Exportar modelo, em "Enviar para a plataforma Xuntong AI", ajuste o Nome do modelo e clique em Enviar. Se ainda não houver um ONNX exportado, ele é exportado automaticamente antes.
- Depois do envio, a plataforma leva de alguns segundos a um minuto para validar; aparece "a plataforma está validando" e, se passar, "Validado" (se falhar, aparece o motivo). O limiar recomendado calculado na página Avaliar é enviado junto, como limiar padrão na plataforma.
- Clique em Abrir console e, em "Modelos personalizados", clique em Ativar; a partir daí você pode conectar câmeras e configurar alarmes.
- Logo abaixo, "Modelos personalizados na plataforma" lista os modelos enviados, o status da validação e se estão ativos. Contas sem hospedagem contratada só podem ter 1 modelo; para enviar uma versão nova, Exclua a antiga primeiro.
- As imagens de alarme geradas na plataforma podem ser trazidas de volta para anotar (veja 4.7).
15 Enviar feedback
- Clique em Feedback no canto superior direito.
- Descreva o problema ou a sugestão.
- (Opcional) E-mail: quando o problema for resolvido, o autor avisa você do resultado por e-mail. Depois de preencher uma vez, o software lembra, e você não precisa preencher de novo.
- Anexar captura da tela atual vem marcado por padrão, e você pode ver a pré-visualização; se não quiser anexar, desmarque.
- Anexar logs de execução vem marcado por padrão (desde a v0.4.2): ambiente de treinamento, logs e erros dos dois últimos treinamentos do projeto atual. Clique em "Ver conteúdo" para ver exatamente o que é enviado; o nome de usuário nos caminhos é trocado por ~. Se não quiser anexar, desmarque.
- Clique em Enviar. A descrição, a captura de tela, os logs, a versão do software e o sistema operacional são enviados ao desenvolvedor; as imagens e as anotações do seu projeto não são enviadas.
Você também pode abrir uma Issue no repositório de código aberto no GitHub.
16 Guia de uso da Xuntong AI
A Xuntong AI (xuntongai.com) é uma plataforma de reconhecimento por IA: tem modelos de reconhecimento dedicados prontos (separação de lixo, capacete, fumaça e fogo etc.) e reconhecimento por LLM, e também hospeda os seus próprios modelos, conecta câmeras e envia alarmes. Integrado a ela, o Wulabel fecha o ciclo anotação, treinamento, colocação em produção e retorno do campo. Os capítulos anteriores mostraram o uso em partes; este capítulo reúne tudo.
Onde a Xuntong AI aparece no Wulabel:
| Onde | O que faz | Veja |
|---|---|---|
| Configurações → Xuntong AI | Entrar na conta, ver a cota | 16.1, 16.2 |
| Página Anotar → Assistência de IA → Xuntong AI | Anotação automática com modelo dedicado / LLM / pelas classes do projeto | 16.3–16.5 |
| Página Anotar → Assistência de IA → Regras de reconhecimento | Escrever instruções de reconhecimento, conversar com a IA sobre como reconhecer, sincronizar com a plataforma | 16.5 |
| Implantar → Exportar modelo → Enviar para a plataforma Xuntong AI | Colocar o modelo treinado para uso na plataforma | 16.6 |
| Dados → Mais opções de importação → Buscar imagens de alarme da Xuntong AI | Trazer de volta os falsos positivos e falsos negativos do campo para anotar de novo | 16.7 |
| Colaboração → Online · Retransmissor oficial da Xuntong | Membros na internet se conectam para anotar juntos | 16.8 |
16.1 Entrar na conta
- Abra Configurações e, na seção "Xuntong AI", clique em Entrar na conta Xuntong AI.
-
O navegador abre a página da Xuntong AI:
- se ainda não estiver conectado, entre (como você faz normalmente na Xuntong; código de verificação e SMS funcionam);
- confira se o código de confirmação na página é o mesmo da janela do Wulabel e clique em Permitir.
- Volte ao Wulabel: em alguns segundos aparecem Conectado como, o nome da conta e o plano, a cota restante e os métodos de reconhecimento disponíveis.
Observações:
- Não é preciso ir ao console para criar e copiar uma API Key: no login, a plataforma emite uma Key exclusiva para este computador, chamada "Wulabel · <nome do computador>", que aparece na página "API Key" do console da Xuntong, onde também pode ser desativada.
- Se você entrar de novo no mesmo computador, a Key antiga é substituída automaticamente. Contas pessoais podem ter no máximo 2 Keys; quando o limite é atingido, não dá para clicar em "Permitir" na página. Desative no console uma Key sem uso e tente de novo.
- Se o navegador não abrir sozinho: clique em Reabrir na janela ou copie o endereço e abra você mesmo. O código de login vale por 10 minutos.
- Sair da conta: a Key deste computador é apagada, e a Key emitida no login é desativada na plataforma.
- Se você já tem uma API Key ou usa a Xuntong em implantação privada: clique em Avançado: informar a API Key manualmente, endereço da plataforma em implantação privada.
16.2 Cota e custos
- A página de configurações mostra quanto resta de cada tipo de cota e quando vence: reconhecimento por LLM, reconhecimento por modelo dedicado, reconhecimento com modelo próprio, pacotes extras etc., conforme o seu plano.
- Como é contado: cada imagem reconhecida conta como 1. Antes de uma pré-anotação em lote, aparece o total de imagens; cada rodada de conversa com a IA sobre regras de reconhecimento conta como 1 imagem da cota de LLM.
- Só é usada a cota da sua própria conta; quando membros da colaboração conversam com a IA, é usada a cota do anfitrião (o anfitrião pode desligar "Os membros podem usar assistência de IA" na página Colaboração).
- Quando a cota acaba, aparece um aviso de cota esgotada; a pré-anotação em lote para, e o que já foi anotado é mantido.
16.3 Como escolher entre os quatro métodos de reconhecimento
Na página Anotar, em "Assistência de IA" à direita, escolha Xuntong AI; a lista "Selecionar modelo de reconhecimento" tem:
| Método | Indicado para | Velocidade | Cota |
|---|---|---|---|
| Modelo dedicado (como separação de lixo, capacete) | Quando as classes do projeto batem com um modelo pronto da plataforma | O mais rápido: em lote, 8 imagens por vez, dois lotes ao mesmo tempo | Reconhecimento por modelo dedicado |
| Modelo próprio que você enviou e ativou | Modelos que você treinou e enviou para a plataforma | Igual ao anterior | Reconhecimento com modelo próprio |
| Reconhecer pelas classes do projeto (recomendado) | A plataforma não tem um modelo correspondente; você só quer encontrar estas classes do projeto | Uma imagem por vez, mais lento | Reconhecimento por LLM |
| Reconhecimento geral por LLM | Procurar por grandes categorias de risco de segurança (incêndio, elétrico, higiene ambiental etc.) | Uma imagem por vez | Reconhecimento por LLM |
A escolha é simples: se houver um modelo dedicado correspondente, use o modelo dedicado (rápido e preciso); se não houver, use Reconhecer pelas classes do projeto e escreva com clareza as instruções de reconhecimento de cada classe (16.5).
16.4 Anotação automática em lote com modelo dedicado
Exemplo com separação de lixo:
- Crie um projeto de detecção e importe as imagens. Não é preciso criar as classes antes: quando o nome de uma classe reconhecida pelo modelo (por exemplo, "reciclável") não existir no projeto, ela é criada automaticamente.
- Abra a página Anotar e, em "Assistência de IA" à direita, escolha Xuntong AI e o modelo de separação de lixo.
- Ajuste a Confiança: comece com o valor padrão; se aparecerem caixas demais, aumente; se faltarem muitas, diminua.
-
Primeiro pressione
Ppara anotar a imagem atual e ver o resultado; se estiver bom, clique em Pré-anotação em lote. Todas as imagens "Sem anotação" que ainda não têm anotações são reconhecidas lote a lote, com uma barra de progresso. -
As caixas reconhecidas são tracejadas (origem "Xuntong"). Confira uma a uma: exclua as erradas, arraste as desalinhadas para o lugar certo, adicione o que faltou e pressione
Enter(Concluir e próxima). - Para ir mais rápido: depois de anotar algumas centenas de imagens, treine o seu próprio modelo com esses dados (capítulo 10) e passe a pré-anotar no seu computador, sem gastar cota.
No lote, se aparecer o aviso de solicitações demais, o software diminui o ritmo e tenta de novo automaticamente, sem cobrar a cota duas vezes; erros como cota esgotada ou modelo não contratado interrompem o lote e informam quantas imagens já foram anotadas.
16.5 Reconhecer pelas classes do projeto e regras de reconhecimento
Quando a plataforma não tem um modelo correspondente, use "Reconhecer pelas classes do projeto": a plataforma procura só as classes do seu projeto, com os nomes exatamente como estão, e não aponta nada que esteja fora da lista. Se o resultado vai ser bom depende de você explicar bem as regras.
Escrever as instruções de reconhecimento:
-
No botão de editar ao lado da classe, preencha as Instruções de reconhecimento: o que exatamente essa classe significa e o que conta / não conta. Por exemplo:
- Sem capacete: pessoa sem capacete na cabeça; capacete sem a jugular afivelada também conta; marcar só a cabeça e o tronco.
- Scooter elétrica: scooters e bicicletas elétricas de duas rodas; bicicletas comuns e motos não contam.
- Ou clique em Regras de reconhecimento, ao lado do título "Assistência de IA", e, em Regras atuais, edite tudo de uma vez: as Regras gerais (valem para todas as classes, por exemplo "olhar só o corredor na metade de baixo da imagem, ignorar cartazes e o que aparece em telas") e as instruções de cada classe; depois clique em Salvar regras.
Conversar com a IA: se não souber como escrever as regras, vá em Regras de reconhecimento → Conversar com a IA e diga com palavras simples:
- "capacete sem a jugular afivelada também conta como sem capacete"
- "colete refletivo não conta como capacete"
- "por que a pessoa à esquerda nesta imagem não foi reconhecida?"
Por padrão, a imagem atual é anexada, e depois de responder a IA testa o reconhecimento nesta imagem com as novas regras. Quando a IA sugere mudar as regras, ela lista o conteúdo, que só é salvo quando você clica em Aplicar estas regras; se o teste encontrar algo, clique em Adicionar as caixas do teste a esta imagem para usá-las direto.
Sincronizar com a plataforma Xuntong (opcional): no final de "Regras atuais", clique em Sincronizar com a plataforma Xuntong, e as regras são salvas na plataforma. Por padrão ficam desativadas e não afetam o reconhecimento atual da plataforma.
Para que o reconhecimento da própria plataforma Xuntong (capturas, envio de alarmes) também reporte só as classes do seu projeto, ative Usar estas regras também no reconhecimento da plataforma. Atenção: depois de ativado, todo o reconhecimento da conta Xuntong segue estas regras; os cenários aplicáveis podem ser ajustados na página "Regras de reconhecimento" do console da Xuntong.
Depois de vincular, cada vez que você salvar ou aplicar regras o conteúdo é sincronizado automaticamente, mas a ativação e os cenários que você definiu no console não mudam. Para parar de sincronizar, clique em Desvincular; as regras na plataforma não são apagadas.
Limites: no máximo 30 classes, com nomes de até 30 caracteres; regras gerais com no máximo 1000 caracteres, e instruções de reconhecimento de cada classe com no máximo 500; cada conta Xuntong pode ter no máximo 20 conjuntos de regras.
16.6 Enviar o modelo treinado para a Xuntong
- No Wulabel, treine um modelo de detecção de objetos (no momento, a Xuntong só aceita modelos de detecção).
- Vá em Implantar → Exportar modelo e, no final, em "Enviar para a plataforma Xuntong AI", ajuste o nome do modelo e clique em Enviar. Se ainda não houver um ONNX exportado, ele é exportado automaticamente antes; o limiar recomendado da página Avaliar é enviado junto.
- A plataforma valida em alguns segundos a um minuto: aparece "Validando" → "Validado" (ou "Falha na validação" com o motivo).
- Clique em Abrir console e, em "Modelos personalizados", clique em Ativar. Depois de ativado, você pode conectar câmeras e configurar alarmes na plataforma, e o modelo também aparece na lista de modelos da página Anotar.
- Logo abaixo, "Modelos personalizados na plataforma" lista os modelos enviados, o status da validação e se estão ativos. Contas sem hospedagem contratada só podem ter 1 modelo; antes de enviar uma versão nova, Exclua a antiga. O arquivo do modelo pode ter no máximo 200 MB.
16.7 Trazer de volta as imagens de alarme do campo e melhorar sempre
Depois que o modelo entra em produção, as capturas de alarme do campo trazem falsos positivos e falsos negativos, exatamente os dados que mais valem a pena acrescentar:
- Dados → Mais opções de importação → Buscar imagens de alarme da Xuntong AI.
- Escolha o período (últimos 1 / 3 / 7 dias), de qual modelo são os alarmes e quantas imagens no máximo. Usar as caixas detectadas pela plataforma como pré-anotações vem marcado por padrão.
-
As imagens trazidas ficam na pasta
images/xuntong_<hora>/do projeto, com as caixas tracejadas (origem "Xuntong"). - Corrija uma a uma: exclua as caixas de falsos positivos (em imagens que realmente não têm objetos, basta pressionar Enter (Concluir) para mantê-las como amostras negativas) e adicione o que faltou.
- Treine e avalie de novo, envie a nova versão e substitua o modelo antigo na plataforma.
Atenção: a plataforma guarda as imagens de alarme por 7 dias, então busque com regularidade; só contas com um canal de envio configurado geram registros de alarme.
Esse é o ciclo completo: anotar → treinar → enviar para a Xuntong → alarmes no campo → trazer de volta e corrigir → treinar de novo, e o modelo fica mais preciso com o uso.
16.8 A Xuntong AI na colaboração
- Retransmissor oficial: na página Colaboração, escolha a forma de compartilhamento Online · Retransmissor oficial da Xuntong; os membros na internet se conectam pelos servidores da Xuntong, sem precisar de servidor próprio. É preciso entrar na conta Xuntong antes. Cada conta pode ter no máximo 3 compartilhamentos abertos ao mesmo tempo; as imagens e as anotações passam pelos servidores da Xuntong, que só repassam e não armazenam. Para projetos com dados sensíveis, use a rede local ou um retransmissor próprio.
- O que os membros podem usar: os membros não podem usar a pré-anotação da Xuntong AI diretamente (ela gastaria a sua cota); com "Os membros podem usar assistência de IA" ativado, eles podem abrir as regras de reconhecimento e conversar com a IA (usando a sua cota). Se eles podem alterar as regras depende da chave "Os membros podem adicionar e editar classes".
16.9 Perguntas frequentes
- Cliquei em entrar e o navegador não fez nada: clique em Reabrir na janela ou copie o endereço e abra no navegador. Faça o mesmo se o computador da empresa bloquear a abertura automática do navegador.
- Não consigo clicar em "Permitir" na página: a conta atingiu o limite de Keys; desative uma Key sem uso na página "API Key" do console da Xuntong.
-
Aparece "Falha na conexão":
- veja o motivo no aviso;
-
se a Key foi informada manualmente, verifique se foi copiada por inteiro (começa com
sk-live-), se está ativa no console e se há uma lista de IPs permitidos configurada (a Key emitida no login não tem lista de IPs); - você também pode sair e entrar de novo.
- Aparece "Cota da Xuntong AI esgotada ou solicitações demais": veja a cota restante na página de configurações; quando a cota acaba, é preciso renovar ou comprar um pacote extra na Xuntong. A anotação em lote já controla a velocidade por conta própria.
- Um modelo dedicado não aparece na lista de modelos: a conta não tem esse modelo contratado; contrate o plano correspondente na Xuntong AI.
- Os nomes das classes reconhecidas são diferentes dos do projeto: o modelo dedicado usa os próprios nomes de classe, e as classes que não existem no projeto são criadas automaticamente. Para unificar os nomes, use "Reconhecer pelas classes do projeto" ou, depois do reconhecimento, renomeie as classes na edição de classe.
- Xuntong em implantação privada: em "Avançado", nas configurações, preencha o endereço da sua própria plataforma e a API Key.
Atalhos de teclado
Geral (página Anotar)
| Tecla | Função |
|---|---|
| 1–9 | Trocar de classe (projetos de classificação: escolher a classe direto) |
| A / D ou ← / → | Imagem anterior / próxima |
| Enter | Concluir e próxima (imagens sem objetos são registradas como amostras negativas); na colaboração em equipe, aprovar e ir para a próxima |
| X | Ignorar (não entra no treinamento) |
| Shift+D ou Shift+→ | Próxima imagem sem anotação |
| Ctrl+Z / Ctrl+Y | Desfazer / refazer |
| ? | Abrir o painel de atalhos |
| Ctrl+D | Copiar as anotações da imagem anterior (classificação: repetir a classe da anterior) |
| P | Prever / anotar esta imagem com a assistência de IA |
| F | Ajustar à janela |
| Roda do mouse | Zoom |
| Espaço + arrastar / arrastar com o botão direito | Mover a imagem |
Detecção, segmentação, pontos-chave
| Tecla | Função |
|---|---|
| R | Desenhar caixa / contorno / caixa do objeto |
| V | Selecionar, ajustar |
| S | Seleção inteligente SAM |
| Del / Backspace | Excluir o objeto selecionado |
| H | Ocultar / mostrar nomes das classes |
| Esc | Desmarcar |
Ao desenhar polígonos: clique para adicionar um ponto, duplo clique ou Enter para fechar, Backspace para desfazer o último ponto.
Ao marcar pontos-chave: clique = visível, Shift+clique = encoberto, N pula, Backspace volta ao ponto anterior, Esc ou Enter termina.
Na seleção SAM: clique para selecionar, Shift+clique para excluir, Backspace desfaz o último ponto, Enter aceita, Esc descarta.
Projetos de classificação: Del limpa a classe.
准备好了?下载 Wulabel,开始标你的第一张图。