# Deno Custom Nodes [English](../README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [Español](README.es.md) | [Português](README.pt-PT.md) | [Português (Brasil)](README.pt-BR.md) | [Bahasa Indonesia](README.id.md) [YouTube Channel](https://www.youtube.com/@Denoise-AI) ![Deno Custom Nodes banner](images/deno-custom-nodes-banner.jpg) Nós práticos de ComfyUI para preparar imagens e vídeos, carregar modelos e organizar o canvas. [GPL-3.0](../LICENSE) - **Preparar e comparar imagens:** [Resize Box, carregadores e nós de comparação](#deno-resize-box). - **Criar workflows de geração:** [MiniMax H3](#deno-minimax-h3-multi-reference-image-loader), [LTX](#deno-ltx-model-loader) e [LLM locais](#deno-local-llm-loader--deno-local-llm-reviewer). - **Organizar o canvas e os resultados:** [Visual Fold](#deno-visual-fold), [Floating Tools](#deno-floating-tools) e [ferramentas no navegador](#web-tools). ## Quick Start Começa com o ComfyUI já instalado. 1. Abre o ComfyUI Manager e procura `Deno Custom Nodes`. 2. Instala o pacote e reinicia o ComfyUI. 3. Faz duplo clique numa zona vazia do canvas, procura `(Deno) Resize Box` e adiciona-o. 4. Escolhe `Preset Ratio` e os megapíxeis para definir `width` / `height` de saída. 5. Adiciona `Load Image`, seleciona ou carrega uma imagem e liga a saída `IMAGE` à entrada `image` do Resize Box. Liga a saída `image` do Resize Box a `Preview Image` e clica em `Run` para ver o resultado. [Todos os nós](#included-nodes) · [Ferramentas web](#web-tools) · [Visual Fold](#deno-visual-fold) · [Floating Tools](#deno-floating-tools) · [Instalação manual](#install) · [Licença](#license) A maioria dos nós Deno inclui um pequeno botão verde `i` para consultar ajuda rápida sem sair do canvas do ComfyUI. Se existir uma nova versão do Deno Custom Nodes, o botão fica amarelo e mostra um pequeno emblema `!`. ## Web Tools Ferramentas que podes executar diretamente no navegador. - [Deno Video Compare](https://deno2026.github.io/comfyui-deno-custom-nodes/video-compare/) - compara dois vídeos renderizados com slider, lado a lado, diferença e toggle. - [Deno Video to GIF/WebP](https://deno2026.github.io/comfyui-deno-custom-nodes/video-to-gif/) - corta, recorta, redimensiona e exporta clips curtos como GIF ou WebP mais leve. - [Deno Compressão de vídeo / imagem para Discord](https://deno2026.github.io/comfyui-deno-custom-nodes/video-to-discord/) - reduz vídeos ou imagens e guarda-os, quando possível, com menos de 10 MB para partilha no Discord. A interface está disponível apenas em coreano. ## Deno Visual Fold [![Deno Visual Fold](images/deno-visual-fold-preview.webp)](images/deno-visual-fold.webp) Deno Visual Fold é uma ajuda visual para organizar grandes grafos do ComfyUI. Dobrar nós ou grupos não altera a lógica do workflow. Ao selecionar dois ou mais nós, aparece um botão verde `Fold` na barra de seleção nativa do ComfyUI. Ao clicar, os nós selecionados ficam compactados num grupo visual e podem ser restaurados com `Unfold`. Ao selecionar um grupo normal do ComfyUI, `Fold Group` dobra os nós dentro desse grupo; com vários grupos selecionados aparecem também ações de alinhamento. Ao contrário do Subgraph, Visual Fold não move os nós para um grafo filho. É apenas organização visual, útil quando queres manter nós `Get` / `Set` ou a estrutura pai-filho visível no grafo principal. ## Deno Floating Tools Deno Floating Tools é um assistente opcional em `Settings > DENO > Tools`. Está desativado por predefinição. Quando ativado, adiciona um pequeno ícone Deno arrastável ao ecrã do ComfyUI. O painel pode libertar VRAM através do endpoint de limpeza de memória integrado do ComfyUI, mostrar em modo só de leitura o estado da versão atual e mais recente do ComfyUI Stable, e abrir um relatório Error Help quando uma execução falha. Error Help cria um relatório preparado para GPT / Gemini com o workflow atual, executável e tipo de ambiente Python, versões de pacotes, GPU, contexto recente de traceback / log e resumo de custom nodes. É só de leitura, abre primeiro uma janela de relatório e só copia ao clicar em `Copy Report`. Segredos comuns como tokens, cookies, passwords, private keys e credenciais em URLs são ocultados antes da cópia. Floating Tools não instala, atualiza, reinicia, repara nem modifica workflows. ## Included Nodes ### `(Deno) Ideogram Director` Construtor visual de prompts para Ideogram 4, destinado a captions JSON estruturados e layouts bbox dentro do canvas do ComfyUI. [![Ideogram Director — Demo](images/ideogram-director-video-thumbnail.jpg)](https://youtu.be/Z8s27skkIDM) - Desenha e edita regiões bbox; desativa temporariamente cada caixa sem a eliminar nem alterar a ordem. - Faz duplo clique numa bbox para editar junto ao ponteiro, ou usa `Alt`+clique repetidamente numa sobreposição para percorrer as caixas por baixo. - Importa prompts JSON do Local LLM Loader ou de outra fonte STRING, confirma antes de substituir um board e rejeita claramente JSON inválido. - As entradas STRING opcionais Summary e Background substituem esses campos do board durante a execução; sem ligação, é usado o texto guardado. - Usa galerias de presets de estilo/layout e Language view para editar descrições no teu idioma. A saída final mantém-se em inglês pronto para o modelo e as palavras de caixas TEXT, como letreiros, logótipos e títulos, são preservadas exatamente. - Saídas: `prompt`, `width`, `height`, `seed`, `bboxes`. - `bboxes` liga-se tanto a `BBOX` padrão como a entradas `BOUNDING_BOX`, por exemplo `Ideogram4_MultiLora_BoundingBoxNode_Fedor`. O número de linhas de regiões desse nó acompanha as caixas ativas do Director sem acrescentar campos guardados ao Director. A sincronização atual apenas conta caixas e não acompanha a sua identidade: revê as atribuições LoRA depois de eliminar ou reordenar uma caixa intermédia. ### `(Deno) Resize Box` Nó de resolução e redimensionamento de imagem para ComfyUI. ![Deno Resize Box](images/resize-box.jpg) Funcionalidades principais: `Preset Ratio` / `Manual Input`, presets de proporção, cálculo por megapíxeis, alinhamento `divisible_by`, `Center Crop (Fill)`, `Crop Position (Fill)` com zoom e proporção fixa, `Fit (Letterbox/Pillarbox)`, interpolação `lanczos` por predefinição e saídas `image`, `width`, `height`. `Crop Position (Fill)` mostra a imagem de origem completa. Arrasta a moldura de recorte para a reposicionar ou qualquer canto para ajustar o zoom, mantendo fixos a proporção e os megapíxeis de saída. ### `(Deno) Multi Image Loader` Carregador de várias imagens pensado para workflows de guia por batch. ![Deno Multi Image Loader](images/multi-image-loader.jpg) Funcionalidades principais: galeria de altura fixa, reordenação por arrastar, upload, drag-and-drop, colar imagem, navegação pela pasta `input`, suporte a subpastas, ordenação por data recente, redimensionamento por proporção/preset/manual, saídas `multi_output`, `width`, `height`. ### `(Deno) MiniMax H3 Multi Reference Image Loader` Carregador de imagens de referência com uma única ligação para o workflow nativo MiniMax H3 Reference to Video do ComfyUI. Mantém a mesma experiência de upload, paste, drag-and-drop, Input Folder, reordenação de cartões e limpeza de `(Deno) Multi Image Loader`. Envia até 9 referências ordenadas através de um socket `ref_images`, preservando separadamente as dimensões e proporções originais de cada imagem, sem resize, crop ou padding. A ordem dos cartões corresponde a ``, `` e seguintes; as mesmas imagens também são expostas como `image_list` para ligação direta à entrada `image` de `(Deno) Local LLM Loader`. O nó incluído `(Deno) MiniMax H3 Reference to Video` apenas reúne as imagens numa entrada; mantém as entradas Autogrow nativas de vídeo de referência, áudio associado ao vídeo e áudio independente. Estes dois nós MiniMax H3 exigem ComfyUI 0.30.0 ou posterior. Consulta o [workflow de exemplo MiniMax H3 com múltiplas referências](workflows/minimax-h3-multi-reference.json). ### `(Deno) MiniMax H3 Acc LoRA Loader` Carrega diretamente os [MiniMax-H3-Acc-LoRAs](https://huggingface.co/alibaba-pai/MiniMax-H3-Acc-LoRAs) oficiais da Alibaba PAI, sem converter nem duplicar o ficheiro safetensors. 1. Descarrega o ficheiro oficial `Acc-8Step.safetensors` de FL2VA ou Ref2VA e coloca-o na pasta habitual `ComfyUI/models/loras/` ou na pasta dedicada `ComfyUI/models/minimax_h3_acc_loras/`. 2. Liga a `model` um modelo de difusão nativo MiniMax H3 compatível; são aceites modelos completos e variantes `*_pruned_*` da Comfy-Org. 3. Seleciona o Acc-LoRA correspondente: FL2VA para FL2VA/T2VA ou Ref2VA para Ref2VA. 4. Liga a única saída `model` do nó ao percurso habitual do guider. 5. Constrói o percurso de amostragem com nós padrão do ComfyUI. Recomenda-se começar com `BasicScheduler: simple, steps: 8` e `KSamplerSelect: euler`, ligados a `SamplerCustomAdvanced`. O nó aplica os pesos LoRA estáticos e as 32 cabeças de saída PDD dependentes do tempo do checkpoint. Durante a amostragem, lê os limites sigma reais fornecidos pelo ComfyUI e funde automaticamente as cabeças PDD para esses intervalos. Assim, o sampler, o scheduler e os passos continuam a ser controlados nos nós habituais do ComfyUI. A configuração oficial Simple/Euler de 8 passos continua a ser a recomendada e a usada no treino. Podes selecionar de 4 a 12 passos no Simple Scheduler sem mudar este loader; outros schedules descendentes ou passagens sigma divididas para workflows de ampliação de latentes estão disponíveis para experimentar, sem garantia de melhoria da qualidade. Mantém os desvios sigma nativos de vídeo/áudio do MiniMax H3 em `12.0 / 3.0` e a força LoRA em `1.0`. Os modelos completos sem poda, incluindo as variantes INT8 nativas do ComfyUI, aplicam o adaptador completo através do percurso LoRA do ComfyUI compatível com quantização. Para um modelo curve-pruned, o loader procura um checkpoint MiniMax H3 completo compatível já instalado em `models/diffusion_models/`, lê apenas a pequena secção FP32 time-embedder e calcula em memória uma ponte que adapta todas as 50 atualizações AdaLN LoRA de largura completa à curva podada de largura 8. Não carrega o checkpoint completo para este cálculo. Se não existir um checkpoint completo compatível, continua utilizável em modo de compatibilidade: avisa uma vez, ignora essas 50 atualizações AdaLN e aplica todas as restantes atualizações LoRA e cabeças PDD. Os workflows UI padrão com o loader de três saídas de v0.7.92–v0.7.94 ativo são migrados quando abertos no canvas do ComfyUI. As ligações do modelo mantêm-se e as antigas ligações sampler e sigmas passam para nós padrão editáveis `KSamplerSelect: euler` e `BasicScheduler: simple, steps: 8`. Guarda o workflow UI uma vez depois de o abrir. Os workflows atuais de uma saída não mudam. Nós silenciados ou em bypass, disposições personalizadas desconhecidas e grafos malformados ficam intactos. O JSON de prompts API não executa esta migração frontend; exporta-o novamente a partir do workflow UI migrado. Se o ficheiro já tiver sido guardado depois de perder as ligações sampler/sigmas, volta a ligar manualmente esses nós padrão. O Deno Custom Nodes não inclui pesos LoRA nem workflows para este loader. Descarrega os pesos da Alibaba e cria ou adapta o teu próprio workflow nativo do ComfyUI. ### Workflow MiniMax H3 R2V com referência de áudio O [workflow de referência de áudio para iniciantes](workflows/minimax-h3-r2v-audio-reference.json) mantém o caminho de áudio de referência nativo do MiniMax H3 e acrescenta uma linha automática de direção de prompts. - `(Deno) Audio Transcript`: usa OpenAI Whisper local para criar letras ou diálogo, tempos por segmento, idioma detetado e resumo de confiança. Se o utilizador inserir letras ou diálogo, esse texto tem prioridade. - `(Deno) Audio Analysis Finalizer`: conserva apenas os campos documentados de análise acústica do resultado ComfyUI `TextGenerate` e pode descarregar o modelo CLIP usado na análise depois da execução. - `(Deno) Local LLM Loader`: recebe a transcrição e o relatório acústico pela entrada STRING opcional `audio_context`. O AUDIO original não é enviado para o LLM local e a análise automática é tratada como dados de referência, não como instruções. - A secção escolhida do áudio original serve simultaneamente como referência `