Guia do usuário CLI

O que é o NadouPro CLI?

✈️ A ponte que leva a IA para o seu fluxo criativo

De uma única ideia e algumas imagens de referência até storyboards e nós de vídeo, você só precisa descrever o objetivo em linguagem natural. O assistente de IA chama as capacidades criativas disponíveis do NadouPro pelo NadouPro CLI e confirma com você nas etapas-chave. O NadouPro oferece Canvas, mesa de trabalho, Agent e outros pontos de entrada de criação; a cobertura real do CLI depende da versão atual.

Pense na produção de um filme como uma colaboração de set: você fornece a intenção criativa e toma as decisões-chave, o assistente de IA quebra as tarefas, invoca ferramentas e acompanha os resultados, e o NadouPro fornece modelos, ativos, espaços e o Canvas. O NadouPro CLI é o canal de trabalho entre os três.

O valor não está em ensinar comandos aos usuários. Está em permitir que o assistente de IA execute de verdade: escolher um modelo atualmente disponível, ler ativos de referência, enviar geração de imagem ou vídeo, esperar os resultados e entregá-los a um espaço pessoal, um espaço de equipe ou um Canvas especificado.

Para quem é?

• Criadores de cinema, vídeo e conteúdo: Querem que um assistente de IA cuide do design de personagem, storyboards, geração de planos e organização de ativos.

• Equipes criativas: Precisam que os resultados fiquem em um espaço de equipe ou Canvas para revisão, colaboração e iteração.

• Usuários de ferramentas de IA como Claude Code e Cursor: Querem chamar o NadouPro diretamente na conversa, em vez de trocar de página e copiar ativos de um lado para o outro.

1. 📦 Instalação rápida

Opção 1: Instalação em um clique com um assistente de IA

Envie o seguinte ao seu assistente de IA:

Please install NadouPro CLI: npm install -g @iqiyi-intl-nadoupro/nadou-cli. After installation, run nadou version --json to verify (requires Node.js 16 or later)

O instalador faz três coisas:

1. Instala o build do Nadou CLI que corresponde ao sistema operacional e à arquitetura de CPU atuais.

2. Verifica se o CLI inicia corretamente e imprime a versão, o commit e a hora do build.

3. Sincroniza o Nadou Skill oficial correspondente com os agents globais suportados nesta máquina.

Critério de sucesso da instalação

nadou version --json retorna informações de versão, e a versão do Skill em nadou skill read --json coincide com a versão do CLI.

Opção 2: Instalação manual

Passos da instalação manual

Se preferir operar no terminal você mesmo, execute:

npm exec --yes --registry=https://registry.npmjs.org/ --package=@iqiyi-intl-nadoupro/nadou-cli@latest -- nadou-install
nadou version --json
nadou skill install --json
nadou skill read --json

Se tiver certeza de que esta máquina nunca teve um Nadou CLI mais antigo instalado, também pode instalar o pacote npm diretamente:

npm install -g @iqiyi-intl-nadoupro/nadou-cli
nadou version --json
nadou skill install --json
nadou skill status --json

O instalador atual oferece Windows x64, Linux x64/arm64 e macOS x64/arm64. Ainda não há pacote pré-compilado para Windows arm64.

Autorização e login pela primeira vez

Antes de executar operações que exigem conta, o Agent deve checar o status de login primeiro para evitar abrir o navegador repetidamente:

nadou auth status --no-interactive --json

Se você não estiver logado, então execute:

nadou auth login --timeout 10m --json

1. O CLI tenta abrir o navegador padrão do sistema. Se o ambiente atual não puder abrir um navegador automaticamente, o mesmo URL de autorização é impresso na saída.

2. Na página de login internacional, clique em “Continue to international sign in” e conclua o login da conta do site internacional conforme as instruções.

3. Depois que a autorização for bem-sucedida, o CLI verifica o status de login automaticamente. O Agent pode continuar a tarefa original; você não precisa executar outro comando de login.

Este guia usa o CLI público internacional, que se conecta ao ambiente de produção internacional por padrão. Esta distribuição oferece apenas o ambiente de produção.

Login em um servidor ou contêiner

Se o CLI estiver sendo executado em um servidor, em um contêiner Docker/Claw ou em um ambiente sem interface gráfica, sem acesso ao navegador ou ao armazenamento de credenciais do sistema, execute:

nadou auth login --server

O CLI exibe uma URL de login e um código de verificação e aguarda a autorização. Abra a URL em um navegador de qualquer dispositivo, insira o código, faça login e confirme a conta que será usada no CLI. Para usar outra conta, selecione “Trocar de conta”.

Após o login, as credenciais são salvas em um arquivo privado no diretório de estado atual do CLI. Os próximos comandos do CLI no mesmo contêiner ou que usem o mesmo diretório de estado podem reutilizá-las diretamente. Se o contêiner for destruído sem que esse diretório tenha sido persistido, será necessário fazer login novamente.

O comando padrão nadou auth login continua usando o fluxo de autorização pelo navegador e o armazenamento de credenciais do sistema existentes.

2. 📹 Por que se encaixa na produção de cinema e vídeo

O NadouPro CLI hoje foca em texto, imagem, vídeo, espaços e Canvas. Pode concluir uma geração isolada ou organizar um pipeline de produção com vários ativos e várias etapas em torno do mesmo projeto.

Capacidade	Trabalho típico
Texto	Exploração de ideias, esboços de roteiro, descrições de storyboard, prompts e copy; os resultados de texto são devolvidos diretamente.
Imagem	Texto para imagem, imagem para imagem com referências, inpaint, panoramas e três vistas de sujeito.
Vídeo	Texto para vídeo, vídeo multi-referência, geração de primeiro/último quadro, edição semântica de vídeo e controle de movimento.
Canvas	Criar ou ler um canvas, organizar nós e arestas de texto, imagem e vídeo, e gerar em nós especificados.
Espaços e entrega	Salvar resultados gerados em um espaço pessoal ou em um espaço de equipe especificado para continuar a colaboração e a gestão.
Processamento local de vídeo	Inspecionar informações de vídeo, gravar legendas e concatenar clipes compatíveis sem recodificar.

Vantagens criativas

1. Expandir de um único ativo para um pipeline completo de produção

2. Ferramentas comuns de geração são melhores em concluir um pedido. A produção de cinema e vídeo precisa passar informação de um lado para o outro entre ideias, personagens, cenários, storyboards e planos. O NadouPro CLI deixa o assistente de IA continuar trabalhando rumo ao mesmo objetivo criativo e colocar os resultados de cada etapa em um lugar claro.

3. Ativos de referência têm papéis mais claros

4. Referências de personagem, figurino, cenário, estilo, primeiro quadro, último quadro e movimento cada uma serve a um propósito diferente. Desde que você descreva em linguagem natural como cada ativo deve ser usado, o assistente de IA pode escolher o método de geração correspondente e reduzir erros como tratar uma imagem comum de referência como primeiro quadro.

5. O processo pode ser confirmado em etapas

6. Geração de imagem e vídeo consome pontos. O assistente de IA pode mostrar o modelo, as especificações, os pontos estimados e o local de salvamento antes de enviar, para você julgar a direção primeiro e então decidir se gera. Para resultados em etapas como storyboards e visuais-chave, você também pode revisar primeiro e continuar depois.

7. O Canvas preserva relações a montante e a jusante

8. Quando uma tarefa envolve vários storyboards, vários planos ou várias rodadas de revisão, o Canvas pode expressar dependências com nós e arestas. O assistente de IA trabalha em um canvas e um nó especificados, e os resultados voltam ao nó correspondente, o que facilita o ajuste posterior e a colaboração.

3. 🫧 Começar

Fale com o Agent em linguagem natural

Depois da instalação e do login, você não precisa memorizar parâmetros do CLI. Pode simplesmente dizer:

• “Gere um pôster cinematográfico de uma rua chuvosa à noite com neon.”

• “Use esta imagem de referência para gerar um vídeo de 5 segundos. Me diga primeiro o modelo, os parâmetros e o custo estimado.”

• “Envie esta imagem local e coloque-a no canvas que eu indicar.”

• “Leia a estrutura atual deste canvas, adicione um nó de texto à direita e conecte-o ao nó de imagem.”

• “O vídeo anterior ainda não terminou. Continue esperando no ID original da tarefa. Não envie de novo.”

O Agent deve primeiro confirmar informações ambíguas que não podem ser adivinhadas, como conta, espaço, canvas, nó de destino, papéis de primeiro/último quadro ou um intervalo de lote de alto custo; depois chamar o NadouPro CLI.

4. ✏️ Cenários típicos de produção

Cenário 1: De uma ideia a rascunhos de plano

A produção inicial costuma começar com um único conceito. Peça ao assistente de IA para organizar personagens, cenários e clima primeiro, depois gerar fichas de personagem, quadros de atmosfera ou rascunhos de storyboard. Depois que a direção visual estiver confirmada, passe para o vídeo.

Você pode dizer:

I want to make a cinematic Latin dance short set in a rainy night. First, I'll organize a brief creative overview, character, and scene settings, and then generate 4 storyboard drafts in 16:9. The overall vibe is high-contrast neon lighting, with character outfits matching the rainy night street. Let me know the model, quantity, and estimated points before generating.

Cenário 2: Manter personagem e arte consistentes com imagens de referência

Quando uma produção precisa de um visual estável de personagem e de estilo visual, envie várias imagens de referência e especifique o papel de cada imagem. O assistente de IA escolhe modelos disponíveis com base nas funções de referência de personagem, figurino, cenário e outras. Os resultados gerados não são colocados no Canvas automaticamente.

Você pode dizer:

Please use the 3 reference images I uploaded with this message to independently generate 3 consecutive cinematic storyboards: image 1 should reference only the heroine’s facial features and hairstyle, image 2 should reference only the cut and fabric of the red fringe dance dress, and image 3 should reference only the neon lighting and color of the rainy night street. All three storyboards should be 16:9 and keep the same character, costume, and scene. Do not add new characters. Before generating, tell me the model, how the references are assigned, the generation count, and the estimated points. Save the results to my personal space. Do not create a Canvas.

Cenário 3: Transformar um storyboard em um plano de vídeo

Quando você já tem um storyboard claro, especifique-o como o primeiro quadro do vídeo e adicione ação do personagem, movimento de câmera, duração e especificações de quadro. O assistente de IA escolhe o método de geração de vídeo correspondente com base no papel de primeiro quadro, em vez de tratar o storyboard como uma referência comum de estilo.

Você pode dizer:

Please use the storyboard I uploaded with this message as the first frame, and independently generate a 5-second, 16:9, 720p video. The two dancers in the frame complete one Latin dance spin, and the camera slowly pushes from a wide shot to a medium shot. Keep the characters’ looks, costumes, rainy night street, and neon tones from the first frame. Do not add new people. Before generating, tell me the model, video parameters, and estimated points. Save the results to my personal space. Do not create a Canvas.

Cenário 4: Organizar um curta no Canvas

Quando uma produção inclui um briefing, design de personagem, cenários, storyboards e vários planos de vídeo, use o Canvas para organizar ativos e suas relações a montante/a jusante. O assistente de IA confirma primeiro o local de salvamento e a estrutura do canvas, depois cria nós e executa a geração.

Você pode dizer:

I want to plan a “coastal highway chase” short on Canvas. First read my personal space directories and let me confirm where the canvas will be saved. After confirmation, create a Canvas with the same name, and plan a creative brief, male and female lead designs, a coastal highway scene, 4 storyboard image nodes, and matching video nodes. Also connect the upstream and downstream relationships. Show only the canvas structure and node generation plan first. Do not generate immediately. After I confirm, submit one node at a time, and tell me the model, parameters, and estimated points before each submission.

Cenário 5: Entregar resultados no lugar certo

Para projetos de equipe, especifique o espaço da equipe e o diretório de destino no início. O assistente de IA verifica primeiro o espaço e o diretório reais, depois gera e entrega os resultados, para os ativos não serem salvos no lugar errado.

Você pode dizer:

Please independently generate 3 “autumn outdoor brand ad” storyboards. The frames should show a golden grassland, an outdoor model, and warm cinematic lighting, in 16:9. Deliver the results to the “2026 Autumn Campaign” directory in the “Brand Visuals” team space. Do not create a Canvas. If there are multiple spaces or directories with the same name, list the candidates and let me choose. Do not switch on your own. After confirming the target location, tell me the model, generation count, and estimated points. Submit generation only after I confirm.

5. 💗 Boas práticas

• Declare o objetivo criativo primeiro. Você não precisa procurar comandos primeiro. Descreva a imagem, o plano ou o projeto que você quer. O assistente de IA descobre as capacidades atualmente disponíveis a partir da versão atual.

• Dê a cada ativo de referência um trabalho claro Ao enviar vários ativos, especifique se cada um é referência de personagem, figurino, cenário, composição, estilo, primeiro quadro, último quadro ou movimento. Não diga só “use estas imagens como referências”.

• Especifique juntas as especificações de saída e o local de salvamento Quantidade de imagens e proporção, duração e resolução do vídeo, se o áudio é necessário, e se o destino é um espaço pessoal, um espaço de equipe ou o Canvas devem ser confirmados antes do envio.

• Revise os pontos e o plano de ação antes de gerar Antes da geração de imagem e vídeo, peça ao assistente de IA para mostrar o modelo, os parâmetros-chave, os pontos estimados, o saldo atual, o local de salvamento e se ativos locais precisam ser enviados ou resultados baixados. Uma estimativa não trava o preço. A dedução final segue o resultado enviado.

• Continue esperando em tarefas longas. Não envie de novo. A geração de vídeo ou o preenchimento de nós pode levar tempo. Um timeout de espera ou uma página que ainda não atualizou não significa falha. Continue checando a tarefa original. Enviar de novo pode consumir pontos outra vez e produzir resultados duplicados.

• Trabalhe no Canvas com ler–modificar–ler de novo Ao mudar nós ou arestas em um canvas existente, o assistente de IA deve ler a estrutura atual primeiro, concluir uma modificação confirmada e depois ler de novo para verificar. Isso reduz sobrescrever o trabalho de outras pessoas ou gerar no nó errado.

6. 🙋 Observações importantes e perguntas frequentes

O que o CLI atual não expõe

Geração independente de áudio, edição profissional complexa, cópia entre projetos e render/exportação de timeline da plataforma não confirmada não estão documentados no momento como capacidades CLI diretamente utilizáveis. Mesmo que o produto web tenha entradas correspondentes, trate as capacidades atualmente devolvidas pelo CLI como a fonte da verdade.

O navegador fica em branco ou em uma página escura depois do login

Volte à conversa original do assistente de IA e cheque o status de login. Se você já estiver logado, pode fechar a página e continuar. Se não estiver logado, verifique se a página de login internacional ainda está esperando “Continue to international sign in”, ou se mostra um erro de inicialização. Mantenha o comando original de login em execução e conclua o login conforme as instruções. Não trate a cor da página como prova de autorização bem-sucedida, e não inicie o comando de login de novo.

O canvas já tem nós, mas não há resultado gerado

Isso costuma significar que só a estrutura do canvas foi criada. Peça ao assistente de IA para checar o prompt, o modelo e os parâmetros necessários de cada nó, mostrar os pontos estimados, obter confirmação e então enviar a geração do nó.

Permissão negada, ou o diretório de destino não pode ser encontrado

Confirme primeiro a conta atual, depois verifique se o destino é um espaço pessoal ou um espaço de equipe específico, e se a conta tem acesso de escrita ao diretório de destino. Não deixe o assistente de IA adivinhar diretórios pelo nome ou trocar de espaço de equipe sem confirmação.