Resolver ComfyUI Manager que não reconhece Custom Nodes instalados

Você instalou custom nodes no ComfyUI, eles estão bem ali na sua pasta custom_nodes, mas o ComfyUI Manager teimosamente os mostra como "não instalados". Você clica em instalar novamente e ele cria duplicatas. Ou você tenta atualizar, mas ele diz que não há nada para atualizar, mesmo sabendo que existem novas versões.

Resposta rápida: O ComfyUI Manager não reconhecer nodes instalados geralmente resulta de dessincronização do banco de dados, métodos de instalação inadequados ou conflitos de metadados em cache. A correção geralmente envolve limpar o cache do banco de dados de nodes do Manager, garantir que os nodes foram instalados através do Manager em vez de git clone manual, e verificar se a estrutura de pastas corresponde às expectativas do Manager. Um reinício do Manager ou reconstrução do banco de dados resolve a maioria dos casos em minutos.

Este problema está entre as frustrações mais comuns do ComfyUI relatadas pelos usuários. É particularmente irritante porque seus nodes funcionam perfeitamente nos workflows. Eles carregam bem, executam sem erros, mas o Manager acha que não existem. Vamos corrigir isso sistematicamente.

Por que o ComfyUI Manager não reconhece nodes?

Entender a causa raiz ajuda você a corrigir isso corretamente e prevenir recorrência.

Como o Manager rastreia instalações

O ComfyUI Manager não apenas olha para a sua pasta custom_nodes. Ele mantém um banco de dados interno rastreando o que instalou, de onde e qual versão. Este banco de dados reside na estrutura de diretórios do próprio Manager.

Quando você clona manualmente um repositório de nodes usando git, o node funciona porque o ComfyUI em si apenas escaneia arquivos Python em custom_nodes. Mas o Manager não sabe disso porque nada atualizou o banco de dados do Manager.

O inverso também acontece. Se o banco de dados do Manager diz que algo está instalado, mas a pasta foi excluída ou movida, o Manager mostra como instalado quando na verdade está faltando.

Causas comuns de dessincronização

Operações git manuais são a causa principal. Clonar, fazer pull ou remover pastas de nodes sem passar pelo Manager quebra seu rastreamento.

Instalações falhadas podem deixar entradas parciais no banco de dados. O Manager tentou instalar algo, falhou no meio do caminho, mas registrou como instalado antes da falha.

Mover ou copiar instalações do ComfyUI frequentemente deixa o banco de dados do Manager apontando para caminhos errados ou com informações desatualizadas sobre o sistema anterior.

Atualizações do Manager ocasionalmente introduzem mudanças no esquema do banco de dados. Formatos de banco de dados antigos podem não ser analisados corretamente após atualizar o próprio Manager.

Interferência de antivírus às vezes exclui arquivos durante a instalação, mas depois que o Manager registra a instalação como completa. O Manager acha que teve sucesso, mas os arquivos desapareceram.

A camada de cache

O Manager também faz cache de metadados de nodes como atualizações disponíveis e informações do repositório. Este cache pode ficar desatualizado ou corrompido, mostrando status desatualizados ou incorretos mesmo quando o banco de dados subjacente está correto.

Problemas de cache causam sintomas como "atualização disponível" nunca aparecendo, ou números de versão incorretos sendo exibidos na interface do Manager.

Como você corrige problemas de reconhecimento de nodes?

Comece com as soluções mais simples e escale se necessário.

Solução 1: Reiniciar o ComfyUI completamente

Às vezes o Manager só precisa de uma nova inicialização. Feche o ComfyUI completamente - não apenas atualizar, mas parar o processo Python.

Espere alguns segundos para os handles de arquivo serem liberados, então inicie o ComfyUI novamente. O Manager reinicializa na inicialização e pode detectar nodes que perdeu durante uma sessão de longa duração.

Este passo simples corrige o problema cerca de 20% das vezes sem nenhum risco.

Solução 2: Forçar reconstrução do banco de dados do Manager

O Manager tem uma função integrada para reconstruir seu banco de dados de nodes a partir do estado do sistema de arquivos.

Abra o Manager no ComfyUI clicando no botão Manager. Navegue até configurações ou opções avançadas. Procure por uma opção rotulada "Reconstruir Banco de Dados" ou "Reescanear Nodes".

Clicar nisso força o Manager a escanear o diretório custom_nodes novamente e reconstruir seus registros de instalação. Quaisquer nodes presentes serão detectados e registrados corretamente.

Após reconstruir, reinicie o ComfyUI para que as alterações tenham efeito total.

Solução 3: Limpar o cache do banco de dados de nodes

Se reconstruir não ajudar, limpe os arquivos de cache manualmente. Navegue até o diretório de instalação do ComfyUI.

Encontre a pasta ComfyUI-Manager dentro de custom_nodes. Dentro da pasta do Manager, procure por arquivos nomeados como node_db.json, cache.json, ou arquivos de banco de dados similares.

Exclua estes arquivos de cache. Não se preocupe, eles serão recriados automaticamente quando o Manager reiniciar. O novo banco de dados refletirá com precisão suas instalações atuais.

Reinicie o ComfyUI após excluir os arquivos de cache. O Manager levará um pouco mais de tempo no primeiro carregamento enquanto reconstrói tudo do zero.

Solução 4: Reinstalar nodes problemáticos através do Manager

Para nodes que você clonou manualmente, a correção mais limpa é reinstalar através do Manager.

Primeiro, exclua a pasta clonada manualmente de custom_nodes. Não apenas renomeie, pois isso pode causar outros problemas.

Então use a interface de Instalar Custom Nodes do Manager para instalar o mesmo node. O Manager irá cloná-lo corretamente e registrá-lo em seu banco de dados.

Esta abordagem garante que o Manager tenha rastreamento completo e possa lidar com atualizações, dependências e remoção corretamente no futuro.

Solução 5: Verificar nomes de pastas

O Manager espera nomes de pastas específicos que correspondam aos nomes dos repositórios. Se você renomeou uma pasta de node, o Manager não pode correspondê-la à sua entrada no banco de dados.

Verifique se os nomes das pastas correspondem ao que o Manager espera. O repositório ComfyUI-Impact-Pack deve ter uma pasta nomeada exatamente ComfyUI-Impact-Pack, não Impact-Pack ou algo abreviado.

Se você renomeou pastas, ou renomeie-as de volta ou reinstale através do Manager para obter os nomes corretos automaticamente.

Solução 6: Verificar status do repositório Git

O Manager usa git para rastrear versões e atualizações. Se a pasta .git dentro de um node está faltando ou corrompida, o Manager não pode determinar o status de instalação.

Navegue até a pasta de um node problemático e verifique se há um diretório .git. Se estiver faltando, o node não será rastreado corretamente.

Você pode tentar executar git init seguido de definir o remote para o repositório original, mas reinstalar através do Manager geralmente é mais simples.

Solução 7: Verificar instalações duplicadas

Às vezes o mesmo node é instalado duas vezes com pequenas variações de nome. O Manager pode estar rastreando um enquanto o ComfyUI carrega o outro.

Pesquise sua pasta custom_nodes por duplicatas. Procure pastas com nomes similares ou funcionalidade de node idêntica. Remova duplicatas, mantendo apenas o instalado através do Manager.

Padrões comuns de duplicação incluem ter tanto o nome original do repositório quanto uma versão renomeada, ou tanto uma branch de release quanto uma branch de desenvolvimento do mesmo node.

E se os nodes mostrarem números de versão errados?

Problemas de detecção de versão são relacionados, mas distintos da detecção de instalação.

Mecanismo de rastreamento de versão

O Manager verifica tags e commits do git para determinar versões. Se um repositório de node não usa versionamento adequado, o Manager exibe versões "desconhecidas" ou incorretas.

Isso não é algo que você pode corrigir para nodes que você não criou. O desenvolvedor do node precisa usar tags git corretamente.

Obsolescência do cache

Mais comumente, versões erradas resultam de metadados em cache. Limpe o cache do Manager como descrito acima para forçar verificações de versão atualizadas.

Após limpar o cache, o Manager busca o status atual do repositório do GitHub ou GitLab. Isso leva um momento, mas fornece informações de versão precisas.

Problemas de rede

Se o Manager não consegue alcançar os hosts dos repositórios, ele mostra versões desatualizadas. Verifique sua conectividade de rede e quaisquer regras de firewall bloqueando operações git.

Redes corporativas frequentemente bloqueiam protocolos git. Se você está em uma rede restrita, o Manager não pode atualizar seu conhecimento de versões disponíveis.

Como você previne este problema no futuro?

Boas práticas mantêm o Manager e seus nodes sincronizados permanentemente.

Sempre instalar através do Manager

Mesmo quando você tem uma URL do GitHub e conhece git, use a interface do Manager. Cole a URL no campo de instalação personalizada do Manager em vez de clonar manualmente.

Isso garante registro adequado no banco de dados desde o início. Clonagem manual só deve acontecer ao depurar ou desenvolver nodes.

Usar o Manager para atualizações

Quando os nodes têm atualizações disponíveis, use a função de atualização do Manager em vez de executar git pull você mesmo.

A atualização do Manager lida com atualizações de dependências, rastreamento de versão do banco de dados e hooks pós-atualização que pulls manuais pulam.

Evitar manipulação direta de pastas

Não exclua, renomeie ou mova pastas de nodes manualmente. Use a função de desinstalação do Manager para remover nodes de forma limpa.

Se você deve manipular pastas diretamente, espere reconstruir o banco de dados do Manager depois.

Atualizações regulares do Manager

Mantenha o próprio Manager atualizado. Versões mais novas corrigem bugs de manipulação do banco de dados e melhoram a detecção de nodes.

Atualize o Manager primeiro ao solucionar problemas de nodes, pois a correção pode já existir em uma versão mais nova do Manager.

Para usuários que querem capacidades do ComfyUI sem gerenciar estes detalhes técnicos, Apatero.com fornece infraestrutura mantida profissionalmente. Os nodes estão sempre corretamente instalados, atualizados e configurados sem nenhuma dessas dores de cabeça de sincronização.

E os problemas específicos de reconhecimento de nodes?

Alguns nodes têm problemas únicos de reconhecimento que vale a pena abordar especificamente.

Reconhecimento do Impact Pack

ComfyUI-Impact-Pack é complexo com muitas dependências. Problemas de reconhecimento frequentemente derivam de problemas de submódulo.

Garanta que a pasta impact_pack_models existe e contém os arquivos necessários. O Impact Pack não aparecerá como corretamente instalado se seus arquivos de modelo estiverem faltando, mesmo que o código esteja presente.

Use o instalador integrado do Impact Pack para suas dependências em vez da instalação genérica do Manager. Isso lida com os arquivos de modelo corretamente.

Problemas do pré-processador ControlNet

ComfyUI-ControlNet-AUX requer downloads de modelo após a instalação. O Manager o marca como instalado imediatamente, mas ele não está realmente pronto até os modelos serem baixados.

Se os nodes de pré-processamento dão erro, execute os scripts de download de modelo ou deixe-os baixar no primeiro uso. O node está instalado segundo o Manager, apenas incompleto.

Reconhecimento do Video Helper Suite

VideoHelperSuite tem dependências específicas de ffmpeg que afetam o reconhecimento. Se o ffmpeg não está acessível corretamente, o Manager pode mostrar status de instalação parcial.

Verifique se o ffmpeg está no PATH do seu sistema e acessível pela linha de comando. Então reconstrua o banco de dados do Manager.

Perguntas frequentes

Por que o Manager mostra "Atualizar" para um node que acabei de instalar?

Isso acontece quando você instalou de uma branch de desenvolvimento, mas o Manager verifica a branch principal para atualizações. Os números de versão não correspondem, então o Manager vê uma atualização disponível. Geralmente é seguro ignorar ou você pode atualizar para sincronizar com a branch principal.

Posso usar tanto o Manager quanto clones git manuais juntos?

Tecnicamente sim, mas clones manuais não aparecerão na interface do Manager. Eles funcionarão no ComfyUI, mas o Manager não os rastreará. Para a experiência mais limpa, escolha um método e mantenha-o.

Reconstruir o banco de dados vai quebrar meus workflows?

Não, a reconstrução do banco de dados afeta apenas o rastreamento do Manager. Seus workflows, prompts salvos e configurações de nodes permanecem intocados. Tudo funcionará exatamente como antes, apenas com status preciso do Manager.

Por que alguns nodes aparecem múltiplas vezes na lista do Manager?

Isso indica múltiplas instalações, frequentemente de tentativas de instalação falhadas que deixaram entradas parciais no banco de dados. Limpe o banco de dados, exclua todas as cópias do node duplicado, então reinstale uma vez através do Manager.

Como sei se um node foi instalado através do Manager ou manualmente?

Nodes instalados pelo Manager aparecem na lista de Nodes Instalados com informações apropriadas de versão e atualização. Nodes clonados manualmente ou não aparecem de todo ou mostram versão "Desconhecida" sem capacidade de atualização.

Isso afeta minha capacidade de usar os nodes em workflows?

Não, problemas de reconhecimento de nodes são puramente um problema do Manager. O ComfyUI em si escaneia a pasta custom_nodes independentemente e carrega o que encontra. Seus workflows funcionarão independentemente do status de reconhecimento do Manager.

Por que o Manager diz "nenhum node instalado" quando tenho dezenas?

Isso indica corrupção ou perda completa do banco de dados. Seus nodes estão bem e funcionando. Limpe os arquivos de cache do Manager completamente e reconstrua o banco de dados do zero. Tudo será detectado.

Posso fazer backup do banco de dados do Manager antes de solucionar problemas?

Sim, copie os arquivos json da pasta do Manager antes de excluí-los. Se algo der errado você pode restaurá-los. No entanto, como estes arquivos são exatamente o que você está solucionando, restaurá-los restauraria o problema também.

E se o mesmo problema continuar recorrendo?

Problemas recorrentes geralmente indicam um problema de workflow como reinstalar nodes manualmente entre reconstruções do Manager. Verifique seus hábitos e garanta que está usando o Manager consistentemente para todas as operações de nodes.

Devo reportar bugs de reconhecimento ao GitHub do Manager?

Se você tentou todas as soluções e o problema persiste, sim. Inclua sua versão do ComfyUI, versão do Manager, sistema operacional e nodes específicos afetados. Os desenvolvedores podem identificar se é um bug conhecido ou novo problema.

Conclusão e estratégia de prevenção

Os problemas de reconhecimento de nodes do ComfyUI Manager derivam quase inteiramente da dessincronização entre seu banco de dados e seu sistema de arquivos atual. A correção é direta, pois você precisa forçar a sincronização através da reconstrução do banco de dados e limpeza do cache.

Comece com um reinício simples. Se isso não funcionar, reconstrua o banco de dados. Para problemas persistentes, limpe todos os arquivos de cache e deixe o Manager recriá-los novamente.

Daqui para frente, comprometa-se a usar o Manager para todas as operações de nodes. Instale através do Manager, atualize através do Manager e remova através do Manager. Isso mantém tudo sincronizado permanentemente.

Os poucos minutos gastos solucionando problemas agora economizam horas de frustração futura. Uma vez que o banco de dados do seu Manager reflita com precisão suas instalações, as atualizações funcionam suavemente, as dependências se resolvem corretamente e você pode confiar nos indicadores de status do Manager.

Para usuários que preferem não lidar com estas tarefas de gerenciamento técnico, Apatero.com lida com toda a instalação e manutenção de nodes automaticamente. Você obtém acesso a nodes corretamente configurados sem preocupações de sincronização de banco de dados ou solução manual de problemas.

Mantenha o Manager atualizado, use-o consistentemente, e estes problemas de reconhecimento se tornarão coisa do passado.