Nós de vídeo do ComfyUI não aparecem: localize e corrija a etapa ausente

AI Overview

Por que meus nós de vídeo do ComfyUI não estão aparecendo?

O nó pode pertencer a um pacote não instalado, falhar durante a importação do Python ou exigir uma versão mais recente do ComfyUI.

Instalar um modelo de vídeo adiciona seus nós?

Não. Os pesos do modelo e o código dos nós são separados. Instale o pacote de nós correto e suas dependências, depois reinicie.

Por que o VideoHelperSuite está instalado, mas ainda assim ausente?

Verifique o log de inicialização e o ambiente ativo do Python. Uma pasta de pacote pode existir mesmo quando seus nós falham ao ser carregados.

Devo reinstalar o ComfyUI?

Primeiro identifique o tipo de nó ausente e teste um fluxo de trabalho pequeno. Repare o pacote afetado antes de reconstruir tudo.

Comece com o sintoma, não com uma reinstalação

O fato de os nós de vídeo do ComfyUI não aparecerem geralmente é um problema de configuração que ocorre antes da geração. Um grafo baixado abre com caixas desconhecidas, o nome de um nó de um tutorial não aparece na busca ou um carregador de vídeo parece indisponível. Esses sintomas diferem de um fluxo de trabalho que executa com sucesso, mas depois falha ao exibir seu filme finalizado.

Antes de alterar qualquer coisa, salve uma cópia do fluxo de trabalho e anote exatamente os nomes dos nós ausentes. Mantenha o log atual de inicialização. Anote se você usa a versão Desktop, a versão Portable para Windows, um ambiente manual do Python ou uma instalação hospedada. Um comando que repara um ambiente pode modificar uma instalação não relacionada do Python em outra máquina.

Use esta tabela de decisão para escolher a primeira investigação. Trata-se de um auxiliar prático de diagnóstico, não de uma afirmação de que um único sintoma comprove uma única causa.

Se a fila for concluída antes do problema surgir, use o guia separado de recuperação de travamentos do ComfyUI. Este artigo concentra-se na restauração da funcionalidade ausente antes de enfileirar o gráfico de produção custoso.

Identifique o nó exato e seu proprietário

Um rótulo amigável nem sempre é um identificador exclusivo. Autores de fluxos de trabalho podem renomear caixas, e pacotes diferentes podem oferecer carregadores de vídeo com nomes semelhantes. Inspeccione o JSON original do fluxo de trabalho sem editá-lo. Exportações padrão de grafos descrevem tipos de nós; exportações via API normalmente identificam cada nó com um campo class_type. Anote esse identificador juntamente com o rótulo visível.

Em seguida, compare os requisitos do fluxo de trabalho com o repositório ou modelo oficial de onde ele provém. Separe os nós principais do ComfyUI, pacotes personalizados e nós da API hospedada. Atualizar um pacote personalizado não pode adicionar novas funcionalidades principais a um backend mais antigo. Da mesma forma, baixar um grande checkpoint de vídeo não instala a classe do Python capaz de interpretá-lo.

Para o VideoHelperSuite, procure o carregador VHS relevante ou operação de combinação na documentação própria do pacote. Para um fluxo de trabalho com wrapper Wan, verifique os requisitos do wrapper, em vez de substituir um nó Wan nativo por outro com nome semelhante. Rótulos de entrada semelhantes não garantem tipos de soquetes equivalentes, tratamento de modelos ou comportamento idênticos.

Mantenha um pequeno registro de propriedade: nome do arquivo do fluxo de trabalho, tipo ausente, pacote proprietário, revisão instalada e revisão exigida (caso o autor a especifique). Se o autor não fornecer uma lista de dependências, relate o tipo exato desconhecido em vez de pesquisar apenas por “nó de vídeo”. Essa informação torna uma solicitação de suporte acionável e evita a instalação de pacotes não relacionados.

Não substitua um nó ausente apenas para remover seu contorno vermelho. Primeiro explique quais dados entram nele, o que ele produz e o que os nós downstream esperam. Um grafo que abre sem avisos ainda pode estar funcionalmente incorreto.

Instale no ambiente que realmente executa o ComfyUI

Verifique a localização do launcher antes de instalar qualquer coisa. Instalar dependências em um ambiente enquanto abre outro deixa o sintoma inalterado, mesmo que o instalador relatar sucesso.

Use o ComfyUI Manager, quando disponível, para localizar o pacote identificado. Confirme seu publicador e repositório contra os requisitos do fluxo de trabalho, instale-o, inspecione o resultado da instalação e reinicie o backend. Se for necessária instalação manual, siga as instruções desse repositório para posicionar o código no diretório custom-node da instalação ativa e instalar suas dependências.

Para configurações manuais do Python, use o interpretador que inicia o ComfyUI. As verificações a seguir são exemplos diagnósticos para executar nesse ambiente, não comandos a colar em um terminal do sistema arbitrário:

python -c "import sys; print(sys.executable)"
python -m pip --version
python -m pip check

As duas primeiras saídas devem apontar para o ambiente pretendido. A terceira relata inconsistências de dependência; ela não as corrige automaticamente. No Windows Portable, o interpretador embutido normalmente fica em python_embeded. Use o executável embutido real ao seguir as instruções de instalação do pacote. Usuários da versão Desktop devem seguir o caminho de gerenciamento de ambientes suportado pelo Desktop.Após reiniciar, pesquise o tipo exato em uma tela em branco. Reabra o fluxo de trabalho original somente após o nó aparecer. Registre dois resultados distintos: instalação bem-sucedida e registro do nó bem-sucedido. Tratar esses como um único evento é o que torna tão confuso o problema de “instalado, mas ausente”.

Mantenha os pacotes não relacionados inalterados durante este teste. Atualizar todas as dependências de uma só vez dificulta identificar qual alteração restaurou o nó ou quebrou outro fluxo de trabalho.

Corrigir erros de importação e incompatibilidades de versão

Leia o rastreamento de inicialização associado ao pacote ausente. Um módulo faltante, uma importação de API incompatível e uma extensão compilada com falha exigem correções diferentes. Preserve a primeira exceção útil, em vez de relatar apenas o resumo final “importação falhou”.

Para uma dependência ausente, verifique se os requisitos documentados do pacote foram instalados no interpretador ativo. Para uma API renomeada ou uma função indisponível, compare a revisão do pacote com a revisão ComfyUI que ele suporta. Para dependências compiladas, verifique a combinação de Python, PyTorch e plataforma suportada pelo pacote antes de selecionar um wheel.

Um tutorial mais recente também pode direcionar-se a recursos ainda não disponíveis na sua instalação estável. Consulte as instruções oficiais de lançamento e atualização para seu tipo de instalação. Não suponha que atualizar o navegador atualize o backend, nem que atualizar o código-fonte do backend também atualize todas as dependências e componentes de frontend instalados separadamente.

Faça uma única alteração controlada, reinicie e compare os logs. Se nós desaparecerem após uma atualização, mantenha as versões anteriores e posteriores. Compare com um ambiente conhecido por funcionar, em vez de modificar repetidamente a mesma configuração sem anotações.

Quando extensões de interface estiverem envolvidas, a abordagem oficial de solução de problemas do ComfyUI suporta desabilitar extensões e reduzir a causa por grupos. Lembre-se de que desabilitar todos os nós personalizados intencionalmente remove sua funcionalidade: use um fluxo de trabalho de controle com apenas componentes principais (core-only) para esse teste. A falha do gráfico original com nós personalizados nesse modo é esperada e não identifica o culpado.

Assim que o pacote relevante for importado limpa e corretamente, pare de alterar dependências. Prossiga para a verificação funcional, em vez de continuar ajustando um ambiente que já satisfaz o requisito do nó ausente.

Separar modelos ausentes da saída de vídeo ausente

Se um carregador (loader) existe, mas seu menu suspenso está vazio, a instalação do nó progrediu além do que o sintoma original sugere. Verifique a categoria de modelo esperada por aquele carregador específico, os caminhos de busca de modelos configurados e se o arquivo pretendido foi baixado integralmente. Siga o manifesto de modelos do fluxo de trabalho; não coloque todos os arquivos relacionados a vídeo no diretório checkpoints.

A presença de um arquivo no menu suspenso não comprova compatibilidade arquitetural. Um VAE, um codificador de texto e um modelo de difusão devem corresponder aos requisitos do fluxo de trabalho. Renomear um arquivo incompatível não o converte. Para falhas específicas de decodificador, a lista de verificação para carregamento de VAE ajuda a manter a descoberta de arquivos separada do carregamento bem-sucedido do modelo.

Se os nós VideoHelperSuite estiverem visíveis, mas a pré-visualização estiver ausente, inspecione o arquivo salvo antes de reinstalar. Seu carregador converte vídeo em quadros (frames), enquanto o nó Video Combine monta quadros em um vídeo e pode incluir uma entrada de áudio. A taxa de quadros afeta a duração da reprodução, portanto preserve-a deliberadamente ao realizar um ciclo completo (round trip).

O comportamento da pré-visualização é outra camada. A documentação do VideoHelperSuite descreve pré-visualizações avançadas opcionais que usam FFmpeg e podem introduzir um atraso na conversão. Assim, uma pré-visualização em branco ou atrasada é diferente da ausência de uma classe de nó. Verifique se o arquivo abre independentemente, se o formato selecionado é suportado e se os logs indicam um erro de codificador.

Para testes sensíveis a áudio, use o guia passo a passo para recortar vídeo com áudio para manter explícitas a fonte, o cronograma dos quadros e o caminho do áudio. Não avalie um reparo com base em uma única miniatura estática.

Ilustração gerada por IA existente: use um sujeito visualmente simples para inspeção. Este não é um resultado de teste do ComfyUI.

Demonstrar o reparo com um teste pequeno de vídeo

Use um clipe curto cujo conteúdo você já conhece bem. Para um pacote de utilitários de vídeo, comece carregando e salvando imagens existentes antes de envolver um modelo generativo. Isso separa o registro e o tratamento básico de mídia da memória GPU, compatibilidade de modelos e comportamento do amostrador (sampler).

Execute esta sequência de aceitação e registre o resultado real em cada etapa:

1. Reiniciar: o pacote relevante é carregado sem o erro de importação anterior.
2. Pesquisar: o nó necessário pode ser adicionado a um grafo em branco.
3. Importar: o fluxo de trabalho original reconhece seus tipos necessários.
4. Entrada: uma fonte curta é carregada com as dimensões e quadros esperados.
5. Saída: o vídeo salvo é reproduzido integralmente com o cronograma e áudio pretendidos.
6. Repetir: uma segunda execução tem sucesso após reabrir o fluxo de trabalho de teste salvo.

Exemplo existente de movimento e áudio para verificação de ciclo completo de vídeo

Este exemplo de mídia Seedance existente ilustra o que inspecionar em imagens em movimento. Não constitui evidência de que tenhamos reproduzido ou reparado seu ambiente ComfyUI.

Por exemplo, se o carregamento for bem-sucedido, mas a exportação falhar, mantenha o carregador funcional e investigue a etapa de saída. Se ambos funcionarem no teste de utilitário, mas o fluxo de trabalho generativo falhar, retorne aos diagnósticos de modelo e amostragem. O menor teste bem-sucedido cria um limite útil entre funcionalidade reparada e um problema distinto.Salve o JSON bem-sucedido com um breve manifesto de ambiente. Inclua ComfyUI, revisões de pacotes, Python e as configurações de saída. Assim que os clipes individuais funcionarem, o guia de fluxo de trabalho em lote para vídeos pode ajudá-lo a dimensionar o processo sem transformar um único item com falha em um lote completo repetido.

Mantenha a produção em andamento enquanto você realiza a correção

Mantenha uma trilha de correção e uma trilha de entrega quando houver um prazo crítico. A trilha de correção é responsável pelo nó exato, pelo erro de inicialização, pelo ambiente e por uma reprodução mínima do problema. A trilha de entrega é responsável pela descrição criativa, pelas referências de origem, pelas cenas aprovadas e pelas edições pendentes. Isso evita que a solução de problemas de infraestrutura apague decisões criativas já consolidadas.

O ComfyUI local continua sendo útil quando modelos personalizados e controle preciso do grafo fazem parte da tarefa. Um fluxo de trabalho hospedado é útil quando sua necessidade imediata é um clipe aprovado e ninguém precisa reproduzir o grafo original. As saídas e controles podem diferir; portanto, compare-os com base na mesma descrição, em vez de presumir que são intercambiáveis.

Seedance Agent fornece um local para organizar referências, planejar cenas, revisar resultados e solicitar revisões focadas. Trata-se de uma rota alternativa de produção, não uma ferramenta de correção para importações Python. Transfira a ação exigida, a proporção de aspecto, a identidade da referência, a duração e os critérios de aceitação; reavalie o resultado gerado antes de inseri-lo na edição.

Conclusão

Corrija os nós de vídeo ComfyUI que não aparecem identificando o proprietário exato do nó, verificando o ambiente ativo, lendo os erros de importação e confirmando um ciclo curto de teste com vídeo. Mantenha separados os pesos ausentes e as pré-visualizações em branco dos códigos de nós ausentes; salve então a configuração funcional antes de restaurar um grafo grande. Se sua prioridade imediata for concluir a cena, crie um vídeo com Seedance enquanto isola o problema local.