CanalQb — Python, Scripts, Automação, Airdrops e Criptomoedas | Web3 e Tech na Prática

ZebraDesigner 3 Pro: R$ 1.497 ou editor grátis?

noreply@blogger.com (CanalQb) — Sun, 25 Oct 2026 23:55:54 -0300

@CanalQb no YouTube

ZebraDesigner 3 Pro: R$ 1.497 ou editor grátis?

Leitura: ~25 min

Feito com Master Rules Claude v9.2

TL;DR

O ZebraDesigner Professional 3 é uma licença paga de ativação única para um computador, anunciada a R$ 1.497,00 numa loja brasileira, mas a Zebra distribui a edição Essentials 3 de graça.
O Pro vende conexão com bancos ODBC, script VB, assistentes de RFID e GS1-128; se você só usa planilha, lote e impressão, esse dinheiro compra recurso parado.
Use o editor gratuito do CanalQb para planilha em lote e teste o Pro por 30 dias apenas se precisar de banco, RFID, script ou arquivos .NLBL.

Acesse

Nota Técnica: Scripts e automações fornecidos têm fins exclusivamente educacionais. Teste sempre em ambiente controlado. @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.

Transparência: O @CanalQb desenvolve e mantém o editor gratuito comparado neste post, o que é um conflito de interesse. Por isso as afirmações sobre o ZebraDesigner vêm de documentos da própria Zebra, linkados no fim, e os limites do nosso editor aparecem de forma explícita. Preços de loja mudam; confira o valor atual antes de decidir.

R$ 1.497,00 por uma licença que serve a um computador só.

Uma loja brasileira anuncia o ZebraDesigner Professional 3 com licença de ativação paga para uma única máquina. Só que a Zebra também entrega a edição Essentials 3 sem custo, e o editor do @CanalQb imprime etiquetas Zebra direto do navegador, de graça. A pergunta útil, então, não é qual dos três é o melhor, e sim qual deles resolve o seu trabalho sem cobrar por recurso que você nunca vai abrir.

Mais abaixo você encontra seis perguntas que decidem a compra em poucos minutos, a conta de quanto a licença custa quando a equipe cresce e a lista do que o nosso editor ainda não faz, escrita por quem o mantém.

Quais são as soluções rápidas para quem só quer imprimir etiquetas Zebra?

A maioria dos problemas de quem monta etiquetas vem do preço da licença, da conexão com a impressora e do tamanho do papel. Cada item abaixo traz a correção mais curta, com o passo completo no bloco de erros mais adiante.

Licença cara demais: instale o ZebraDesigner Essentials 3 (gratuito) ou use o editor web gratuito para lote por planilha. ver passo completo
Impressora diz OK, mas não imprime: espere cerca de 8 segundos entre envios e confirme a etiqueta na bandeja. ver passo completo
Impressão deslocada: ajuste só a margem afetada em Limites de Margem e mande uma página de teste. ver passo completo
Etiqueta atravessando outras: compare a altura do desenho com a bobada usando Conferir Mídia. ver passo completo
Link-OS 7.5 sem HTTP: troque para HTTPS Direct ou rode a ponte local. ver passo completo
Licença Pro presa ao PC antigo: desative no computador de origem antes de ativar no novo. ver passo completo

O que o ZebraDesigner Professional 3 realmente vende por R$ 1.497,00?

O ZebraDesigner Professional 3 vende uma licença de ativação única para um computador Windows, que libera recursos além da edição gratuita: conexão com bancos de dados, assistentes de RFID e GS1-128 e scripts VB simples. Você não paga pelo desenho da etiqueta, porque a edição Essentials também desenha e imprime.

O anúncio de uma loja brasileira lista o Professional 3 por R$ 1.497,00, com licença de ativação paga para um computador. Tratamos esse número como preço de vitrine, não como cotação oficial da Zebra: ele muda com câmbio, frete, imposto de importação e margem do revendedor. Para ter uma régua, procuramos anúncios de fora do Brasil em 25/10/2026 e achamos listagens americanas entre US$ 265,50 e US$ 295,00, uma listagem europeia a € 261,98 e um revendedor britânico com a edição digital a partir de £ 179,91. Esses valores podem estar defasados, então servem só como ordem de grandeza.

A própria Zebra descreve o Professional como produto que exige a compra de uma chave de licença de ativação única. O instalador traz as duas edições juntas: depois de instalar, o programa abre como Essentials e, dentro dele, você pode iniciar um teste de 30 dias do Professional. Se o teste terminar sem compra, o software continua funcionando como Essentials. Isso muda a conversa, porque você pode instalar, abrir seus próprios modelos e só depois decidir se o salto de preço se justifica.

Vale entender também o que o valor não cobre. A licença vale por computador, o programa roda em Windows 10, Windows 11 e versões de Windows Server, e não existe versão para Mac. Se a sua equipe tem cinco estações que precisam editar etiquetas, a conta de vitrine sobe de R$ 1.497,00 para R$ 7.485,00 só em licenças, sem contar o tempo de instalação e ativação em cada máquina.

A Zebra posiciona o Professional para etiquetas complexas, com dados fixos ou variáveis, conexão com banco, concatenação de campos, fórmulas e RFID. Se o seu dia a dia é pegar uma planilha, ligar colunas a campos e imprimir, a pergunta honesta não é quanto custa o Pro, e sim se você usa algum recurso que só ele entrega. As próximas seções respondem isso peça por peça, e quem trabalha com impressoras Zebra costuma descobrir que a resposta é menos óbvia do que o preço sugere.

O ZebraDesigner Essentials 3 já é grátis — o que o Pro acrescenta?

A Zebra distribui a edição Essentials 3 sem custo e vende o Professional por licença. Segundo a documentação oficial, o Pro soma conexão com bancos de dados via ODBC e arquivos ASCII, assistentes de GS1-128 e RFID, script VB simples, perguntas na hora da impressão e escolha de registros do banco no momento de imprimir.

O que fica na edição gratuita

As notas de versão descrevem o Essentials como a edição básica para desenhar e imprimir gráficos, texto ou códigos de barras com dados fixos ou variáveis vindos de digitação, de data e hora ou de contadores. A ficha técnica da Zebra acrescenta que ele aceita fontes nativas da impressora, Unicode e códigos de barras nativos, e abre arquivos da versão 2 (.LBL) e da versão 3 (.NLBL). Na prática, se você digita o dado, usa a data do dia ou numera em sequência, a edição grátis resolve o desenho e a impressão sem pedir licença.

O que só existe no Professional

Aqui entram os recursos que ligam a etiqueta a outros sistemas. A conexão ODBC e com arquivos ASCII permite puxar dados direto de um banco ou de um arquivo de texto, sem exportar planilha. A concatenação de campos e as fórmulas montam um código a partir de várias partes, e o script VB simples coloca regras dentro do próprio layout. Os assistentes de GS1-128 e de RFID guiam etiquetas logísticas e etiquetas com chip, e as perguntas em tempo de impressão deixam o operador informar lote ou validade antes de mandar para a impressora. Um revendedor que publicou um comparativo resume bem: a principal limitação do Essentials é não se conectar a bancos externos.

Recurso	Edição indicada pela Zebra	Quando faz diferença
Desenho e impressão de texto, gráficos e códigos de barras	Essentials e Professional	Sempre; é o núcleo das duas edições.
Dados digitados, data/hora e contador	Essentials e Professional	Numeração de série, validade e etiquetas de prateleira.
Conexão ODBC e arquivos ASCII	Professional	Rótulo puxado direto de ERP ou banco local.
Concatenação de campos e fórmulas	Professional	Código montado a partir de várias colunas.
Script VB simples	Professional	Regra de negócio dentro do layout.
Assistentes de GS1-128 e de RFID	Professional	Logística com identificadores de aplicação e etiquetas com chip.

Um cuidado de leitura: a matriz de recursos da Zebra é um PDF com linhas de recursos e marcações visuais, e o texto extraído dele nem sempre mostra qual edição tem cada marca. Por isso a tabela acima usa só o que as notas de versão e a ficha técnica afirmam em texto corrido. Antes de comprar por causa de um recurso específico, abra a ficha técnica oficial, confira a linha do recurso e teste a função durante os 30 dias de demonstração.

O que o editor gratuito do CanalQb faz de verdade?

O editor do CanalQb roda no navegador, sem instalação, e monta etiquetas com texto, QR Code, códigos de barras, imagens e formas. Importa Excel, CSV e Google Sheets, gera lotes com numeração e envia ZPL por rede, USB ou Bluetooth. É gratuito, mantido com apoio voluntário por PIX e ainda em evolução.

Como o projeto é nosso, a descrição abaixo vem da Central de Ajuda do próprio editor e da interface aberta em 25/10/2026, cuja barra superior exibe a versão 1.041. Nada aqui foi inventado para a comparação, e o que o editor ainda não faz aparece na seção de limites.

No desenho, o editor traz texto livre, subtítulo, nome do produto, linhas, molduras, círculos, diagonais e cantos arredondados, além de imagens por arquivo, por link ou em base64. Os tamanhos prontos são 40 × 25, 100 × 50, 100 × 100 e 100 × 150 mm, com opção personalizada e densidades de 152, 203, 300 e 600 dpi. Os códigos 2D incluem QR Code, Data Matrix, PDF-417, Aztec, MaxiCode, Micro QR e a família GS1, e os 1D incluem Code 128, Code 39, Code 93, EAN-13, EAN-8, UPC-A, ITF, MSI, Codabar e GS1-128. Há ainda um montador de dados GS1, em que você preenche identificador de aplicação e dado, e a prévia sai no formato com parênteses.

Nos dados, as origens vão de arquivo CSV, TXT ou Excel a link do Google Sheets (público ou privado, com login Google), webhook, API REST de banco, pasta local e consultas ODBC, MySQL, PostgreSQL e SQL Server por meio de uma ponte local. Cada coluna é mapeada para um campo da etiqueta, e o botão Criar Etiquetas gera uma etiqueta por linha. A geração em lote também cria numeração automática, como SN-001, SN-002, com prefixo, faixa e quantidade de dígitos.

Na impressão, o editor oferece HTTPS Direct, HTTP Direct, webhook em nuvem, FTP e TCP 9100 pela ponte local, além de USB por WebUSB e Bluetooth Low Energy. Também há calibração, espelho, reverso em branco sobre preto, pré-visualização com download em PNG e um painel que mostra o progresso do envio. Quem quiser aprofundar o assunto de linguagem de impressora pode seguir nossos textos sobre ZPL e etiquetas Zebra.

Como montar um lote a partir de uma planilha no editor grátis?

Defina o tamanho e a densidade da etiqueta, desenhe um modelo com os elementos que vão variar, importe a planilha, mapeie as colunas, teste uma etiqueta e só então imprima o lote. Esse caminho evita desperdiçar rolo, porque cada passo tem um ponto de conferência antes do próximo.

Os passos abaixo seguem o fluxo descrito na Central de Ajuda do editor. Cada um traz a ação exata, o motivo de existir, o resultado esperado e o erro mais comum.

Passo 1: Escolha o tamanho da etiqueta e a densidade

Ação: abra o menu Etiqueta, clique em Tamanho da Etiqueta e selecione 100 × 50 mm; depois confira no chip de densidade se está em 203 dpi.

Esse passo vem primeiro porque o ZPL trabalha em pontos (dots), e a conta muda com a densidade: a 203 dpi são 8 pontos por milímetro, então 100 × 50 mm viram 800 × 400 pontos. Se o tamanho ou o dpi estiver errado, tudo o que você posicionar depois sai deslocado. No mesmo painel, a estimativa por rolo ajuda no orçamento: com 50 mm de altura e vão de 3 mm, cada etiqueta consome 53 mm, e um rolo de 100 m rende cerca de 1.886 etiquetas (100.000 ÷ 53).

Resultado esperado: a barra de status mostra "100 x 50 mm" e "203 DPI". Erro comum: escolher um tamanho maior que a bobada instalada; a etiqueta passa a atravessar as vizinhas sem aviso, e a correção é o Conferir Mídia do passo 5.

Passo 2: Monte a etiqueta modelo

Ação: adicione um Nome do Produto, um Código de Barras e, se quiser, um QR Code, arrastando os botões da paleta para a área da etiqueta.

O modelo é a primeira etiqueta do lote, e todas as outras herdam a posição e o tamanho dos elementos dele. Por isso vale posicionar tudo com calma agora, em vez de corrigir cem etiquetas depois. Se um QR Code ou código de barras receber textos de tamanhos diferentes ao longo da planilha, o editor trava o tamanho no pior caso da coluna para que todos saiam com as mesmas dimensões.

Resultado esperado: a aba Elementos lista cada item com a contagem ao vivo. Erro comum: deixar um elemento colado na borda; use Limites de Margem se a impressora cortar o desenho.

Passo 3: Importe a planilha

Ação: abra Arquivo, escolha Importar Dados (Excel, CSV), selecione "Arquivo" e envie o .xlsx ou .csv; o editor lê as colunas sozinho.

Isso é necessário porque a importação é o que transforma um desenho em um lote: sem ela, você teria uma etiqueta só. O editor lê o arquivo no próprio navegador, sem enviá-lo a servidor algum, e mostra a pré-visualização das três primeiras linhas para você conferir acentos e colunas antes de gerar. Para planilhas privadas do Google, a Central de Ajuda explica como criar um Client ID próprio.

Resultado esperado: aparecem as colunas e as três linhas de prévia. Erro comum: cabeçalho vazio ou colunas misturadas; corrija a planilha e importe de novo, porque o arquivo não sincroniza sozinho.

Passo 4: Mapeie as colunas e crie as etiquetas

Ação: ligue cada coluna ao campo certo (Nome para Nome do Produto, SKU para Código de Barras) e clique em Criar Etiquetas.

O mapeamento diz ao editor onde cada dado cai, e uma mesma coluna pode alimentar vários campos, como um SKU que aparece em texto e em código de barras. O botão sempre cria etiquetas novas, sem escrever em cima do desenho aberto, então salve o modelo em Arquivo antes se quiser reaproveitá-lo.

Resultado esperado: a barra de status avisa quantas etiquetas serão geradas, por exemplo 25. Erro comum: clicar sem nenhuma coluna vinculada; a janela avisa e continua aberta.

Passo 5: Configure a impressora e confira a mídia

Ação: abra Impressora, Configurar Impressora, digite o IP (por exemplo 192.168.15.42), escolha HTTPS Direct, clique em Conferir Mídia e salve.

A configuração vem antes do teste porque o editor precisa saber por qual caminho enviar o ZPL, e o Conferir Mídia compara a altura da etiqueta com o comprimento da bobada que a impressora informa. Sem essa checagem, uma etiqueta maior que o rolo consome papel sem acusar erro. O IP e o protocolo ficam salvos no navegador.

Resultado esperado: o pontinho do IP fica verde, e a conferência indica que a mídia casa com a altura. Erro comum: pontinho vermelho por IP trocado pelo DHCP; prefira o nome mDNS da impressora, quando a rede o resolve.

Passo 6: Teste uma etiqueta e imprima o lote

Ação: clique em Testar 1 e examine a etiqueta; se estiver certa, clique em Imprimir Agora, informe as cópias e acompanhe o progresso.

O teste existe porque HTTP 200 não prova impressão: a impressora responde OK até para o que descarta, e a única prova é o papel na bandeja. Em lotes, o editor espaça os envios em cerca de 8 segundos, porque impressoras térmicas podem perder etiquetas enviadas em rajada. Cada etiqueta sai uma por vez, e o botão Cancelar impressão interrompe a fila.

Resultado esperado: janela de progresso "N de M" e etiquetas saindo em sequência. Erro comum: mandar o lote inteiro sem testar uma peça e descobrir só no rolo que o código de barras está curto.

Como é o ZPL por trás da etiqueta — e por que isso importa?

ZPL II é a linguagem nativa das impressoras Zebra: cada elemento da etiqueta vira um comando que começa com circunflexo. Entender o básico importa porque o ZPL é portátil. A mesma etiqueta pode ser gerada por qualquer ferramenta, guardada em arquivo e enviada à impressora, sem depender do programa que a desenhou.

O exemplo abaixo é uma etiqueta de 100 × 50 mm a 203 dpi, com um nome de produto e um código de barras Code 128. Ele é um modelo didático escrito para este post, não uma saída copiada do editor, e serve para você ler comando por comando.

^XA
^PW800
^LL400
^CI28
^FO40,40^A0N,50,50^FDCaneca Azul 300 ml^FS
^FO40,130^BCN,110,Y,N,N^FD789000012345^FS
^PQ1
^XZ

O par ^XA e ^XZ abre e fecha o formato, ou seja, tudo o que está entre eles é uma etiqueta. O ^PW800 define a largura em 800 pontos (100 mm a 8 pontos por milímetro) e o ^LL400 define o comprimento em 400 pontos (50 mm). O ^CI28 avisa que o texto está em UTF-8, o que evita acento quebrado. O ^FO40,40 posiciona o campo a 40 pontos da esquerda e do topo, ou seja, 5 mm, e o ^A0N,50,50 escolhe a fonte escalável com 50 pontos de altura e largura. O ^FD traz o dado e o ^FS fecha o campo. O ^BCN,110,Y,N,N imprime um Code 128 com 110 pontos de altura e a linha de texto legível embaixo, e o ^PQ1 pede uma cópia.

A consequência prática é a liberdade de troca. Um lote de planilha vira uma sequência de blocos ^XA a ^XZ, que o editor baixa em um único arquivo .zpl pelo menu Arquivo e que você pode reimportar depois. Se amanhã você mudar de ferramenta, o ZPL já gerado continua valendo, porque ele descreve a etiqueta para a impressora e não para o programa.

Quais são os limites do editor gratuito frente ao Pro?

O editor gratuito não substitui o Professional em tudo. Ele não abre arquivos .LBL ou .NLBL, foca em ZPL II, depende do navegador para USB e Bluetooth, exige uma ponte local para bancos ODBC e não tem script VB nem assistente de RFID. Conhecer esses limites evita uma troca de ferramenta por impulso.

Escrevemos esta lista com a mesma franqueza que gostaríamos de ver num concorrente. Cada item tem origem na Central de Ajuda do editor ou nos documentos da Zebra.

Arquivos de projeto. O editor importa .zpl, .bin, .json e .vip, mas a página não lista suporte aos formatos .LBL (versão 2) e .NLBL (versão 3) do ZebraDesigner. Trate esses arquivos como não suportados até testar, e planeje a migração por ZPL, como mostra a última seção.

Linguagem da impressora. O foco do editor é o ZPL II. A ficha técnica da Zebra lembra que o driver Windows versão 5 atende EPL, ZPL e CPCL, e que a versão 8 atende impressoras ZPL Link-OS. Se a sua impressora só fala EPL ou CPCL, o caminho natural é o ZebraDesigner com o driver certo, não o nosso editor.

Navegador e conexão. USB por WebUSB pede Chrome ou Edge em localhost ou HTTPS. O Bluetooth funciona apenas com Low Energy, típico das séries ZQ e Link-OS. iPhone e iPad não imprimem por USB nem por Bluetooth, e nesses aparelhos o caminho é a rede por IP.

Link-OS 7.5 ou mais novo. O serviço HTTP vem desligado de fábrica, segundo a ajuda do editor, e o caminho recomendado passa a ser HTTPS, com certificado autoassinado. Com a ponte local rodando, o editor imprime por HTTPS sem você aceitar nada; sem ela, é preciso aceitar o certificado uma vez por sessão. O envio de TCP 9100 pelo navegador é experimental e pode ser bloqueado como conteúdo misto.

Bancos de dados. A conexão ODBC, MySQL, PostgreSQL ou SQL Server só funciona pela ponte local print-server.js, um programa Node.js que roda no computador que imprime. No Professional essa conexão é parte nativa do programa. A instalação da ponte para iniciar com o Windows, segundo a ajuda, é este comando:

# instala a ponte local para ligar sozinha com o Windows
powershell -ExecutionPolicy Bypass -File instalar-ponte.ps1

Maturidade. A própria página lista itens em desenvolvimento, como fontes do Windows no editor de elementos, moldura de seleção com alças e uma bateria de 26 etiquetas de teste para validar simbologias em impressora real. O aviso que acompanha as simbologias novas é objetivo: valide na impressora real. Também não existe script VB nem assistente de RFID.

Quanto custa de verdade a licença do Pro além do preço de tela?

O custo real da licença do Professional soma o preço por computador, o processo de ativação e de troca de máquina, a restrição ao Windows e a dependência do servidor de licenças da Zebra. Para uma pessoa, é uma conta simples. Para uma equipe, o valor cresce com cada estação que precisa editar etiquetas.

Usando o preço de vitrine de R$ 1.497,00 por licença, sem considerar descontos por volume que revendedores possam oferecer, a conta fica assim:

Computadores que editam etiquetas	Custo só de licenças (R$)	Cálculo
1	1.497,00	1 × 1.497,00
3	4.491,00	3 × 1.497,00
5	7.485,00	5 × 1.497,00
10	14.970,00	10 × 1.497,00

Há mais itens fora da tabela. A ativação offline do Professional 3 exige uma chave de licença de 32 caracteres, o Customer ID e um arquivo de licença (lservrc), e, para mudar a licença de computador, é preciso desativar no equipamento antigo e esperar a Zebra concluir o processo no servidor. As notas de versão também registram que a Zebra migrou o licenciamento do servidor Nalpeiron para a plataforma Thales Sentinel, com a intenção de encerrar o Nalpeiron em julho de 2025, e que a edição Essentials não é afetada. Se você mantém uma instalação antiga do Pro, confira nas notas de versão qual build é exigido.

Algumas listagens de revenda indicam entrega da chave por e-mail e até ausência de garantia, por isso vale ler as condições da loja antes de pagar. O editor gratuito, por sua vez, tem custo zero de licença, mas cobra outra moeda: o seu tempo de validar cada modelo na impressora real, já que o próprio projeto recomenda esse teste. Para quem imprime todo dia, esse tempo se paga rápido; para quem imprime uma vez por ano, talvez nem seja a melhor escolha. A decisão fica mais clara com o roteiro da próxima seção, e outros assuntos de etiquetas Zebra no canal ajudam a medir o seu uso real.

Qual ferramenta escolher: seis perguntas que decidem a compra?

Responda seis perguntas sobre a origem dos dados, o RFID, o script, os arquivos antigos, o fluxo em lote e a linguagem da impressora. Uma resposta afirmativa nas três primeiras já justifica testar o Professional por 30 dias; todas negativas indicam que o editor gratuito, ou o Essentials, atende você.

1. Seus dados moram num banco ODBC e precisam entrar direto na etiqueta? Se a resposta é sim e você quer isso dentro de um único programa Windows, o Professional entrega a conexão nativa. Se aceita rodar uma ponte local em Node.js, o editor gratuito também consulta bancos, com mais montagem.

2. Você imprime etiquetas RFID? O assistente de RFID está listado como recurso do Professional, e o editor gratuito não o tem. Para etiquetas com chip, este é o motivo mais forte para licenciar.

3. Você precisa de regras em script VB dentro do layout? Isso é exclusivo do Professional. Se a regra pode ficar na planilha, em uma fórmula antes da importação, o script deixa de ser necessário.

4. Você precisa abrir ou editar arquivos .LBL ou .NLBL existentes? O ZebraDesigner, inclusive o Essentials, abre esses formatos, segundo a ficha técnica. O nosso editor não lista suporte a eles.

5. O seu fluxo é planilha, lote e impressão, em várias máquinas ou no celular? Aqui o editor web leva vantagem: nada para instalar, funciona em desktop e celular, e a licença não limita estações.

6. Sua impressora fala só EPL ou CPCL? Então o caminho é o ZebraDesigner com o driver apropriado, porque o foco do nosso editor é ZPL II.

Cenário	Escolha provável	Motivo
Loja com 200 produtos numa planilha, etiquetas de prateleira	Editor gratuito ou Essentials	Lote por planilha e QR Code, sem banco nem RFID.
Indústria com ERP e rótulos vindos de banco ODBC	Professional (teste de 30 dias)	Conexão nativa, script e perguntas na impressão.
Logística com RFID e etiquetas GS1-128	Professional	Assistentes de RFID e de GS1-128 integrados.
Equipe com celulares e vários PCs na expedição	Editor gratuito	Sem licença por máquina; imprime por rede, USB ou Bluetooth.

Como migrar etiquetas do ZebraDesigner para o editor sem perder o layout?

A migração passa pelo ZPL: gere ou obtenha o código ZPL da etiqueta no ZebraDesigner, carregue o arquivo .zpl no editor e confira o desenho na tela. Como os formatos .LBL e .NLBL não constam entre os que o editor abre, o ZPL é a ponte mais confiável entre os dois mundos.

Comece pelo ZebraDesigner. A matriz de recursos da Zebra lista a opção de impressão em arquivo, que pode servir para gerar o ZPL de um formato já pronto; confirme na sua versão e no seu driver como esse arquivo é produzido, porque o resultado depende da configuração da porta e do driver. Com o arquivo .zpl em mãos, no editor use Arquivo, Carregar arquivo .ZPL: o código entra na aba ZPL e a etiqueta é reconstruída na tela, e um arquivo com vários blocos ^XA a ^XZ vira um lote navegável pelas setas.

Depois da carga, confira o que o desenho não transporta. Fontes específicas do Windows, scripts VB e conexões ODBC do arquivo original não viajam dentro do ZPL, e o editor ainda lista fontes do Windows como item em desenvolvimento. Reconstrua esses campos com elementos do próprio editor, ligue as colunas por Importar Dados e use Testar 1 para comparar a primeira peça com a etiqueta antiga, lado a lado, no papel.

Por fim, mantenha as duas ferramentas em paralelo durante uma semana de trabalho real. Imprima cada modelo nos dois sistemas, compare o tamanho do código de barras com a leitura do seu scanner e só então desligue o fluxo antigo. Se algum modelo exigir banco ODBC ou RFID, ele fica no ZebraDesigner, e os modelos de planilha e lote vão para o editor gratuito. Esse arranjo costuma custar uma licença em vez de dez.

Perguntas frequentes sobre ZebraDesigner e etiquetas Zebra

O ZebraDesigner Essentials 3 é realmente grátis?

Sim. A Zebra oferece o Essentials 3 como a edição gratuita do software de desenho de etiquetas, sem chave de licença. O instalador do ZebraDesigner 3 traz as duas edições e abre como Essentials; dentro dele você pode iniciar um teste de 30 dias do Professional. Terminado o teste sem compra, o programa continua como Essentials. O limite aparece em recursos como conexão com bancos de dados, que ficam no Professional. Veja mais conteúdos de etiquetas Zebra no canal.

A licença do Professional vale para mais de um computador?

As descrições de revenda e o anúncio que motivou este post tratam a licença como de ativação única para um computador. Por isso a conta cresce por estação: cinco máquinas custam cinco licenças. Para mudar o programa de computador, a Zebra descreve um processo de desativação seguido de redefinição no servidor. Confirme sempre as condições de licenciamento com o revendedor e com a documentação da Zebra antes de comprar para uma equipe. Outros guias sobre impressora Zebra estão no blog.

O editor do CanalQb substitui o ZebraDesigner Professional?

Depende do uso. Para planilha, lote, numeração, QR Code e códigos de barras comuns, o editor cobre o fluxo sem licença. Ele não substitui o Professional quando você precisa de script VB, assistente de RFID, abrir arquivos .LBL ou .NLBL ou usar um driver Windows com EPL e CPCL. Conexão com banco existe no editor, mas por meio de uma ponte local em Node.js. Use as seis perguntas do post para decidir, e teste os 30 dias do Pro se ficar em dúvida. Veja também ZPL.

Preciso instalar alguma coisa para usar o editor?

Para desenhar, importar planilhas e baixar o ZPL, não: o editor abre no navegador, e a Central de Ajuda afirma que ele funciona offline depois de aberto, exceto nas fontes de dados online, como o Google Sheets. Para imprimir por rede em firmwares recentes, o caminho mais prático pode envolver a ponte local print-server.js, que roda em Node.js, e a extensão Zebra Printing para Chrome é uma opção descrita na própria ajuda. Para código de barras, nada extra é exigido.

Como imprimir em impressoras Link-OS 7.5 com o HTTP desligado?

Nesses firmwares o serviço HTTP vem desligado de fábrica por causa de uma norma europeia, e você pode religá-lo no painel web da impressora. O caminho moderno é o HTTPS Direct. Com a ponte local rodando, o editor imprime por HTTPS sem exigir aceitação de certificado; sem a ponte, abra o endereço HTTPS da impressora, aceite o certificado autoassinado uma vez por sessão e volte ao editor. Firmwares 7.4 ou mais antigos seguem no HTTP Direct. Mais dicas de impressora Zebra no canal.

Posso importar dados do Google Sheets no editor?

Sim. A janela Importar Dados aceita o link de uma planilha pública, ou de uma planilha privada depois do login com a sua conta Google, que é feito pelo próprio Google; o editor só recebe um token de leitura. Quem preferir pode cadastrar o seu Client ID no Google Cloud, ativando a Google Sheets API, para controlar o acesso. Depois de importar, você mapeia as colunas e cria uma etiqueta por linha. O arquivo não sincroniza sozinho: se a planilha mudar, importe de novo. Veja outros guias de etiquetas Zebra.

{Erros e Soluções}

Os erros mais frequentes de quem monta e imprime etiquetas Zebra costumam envolver conexão, margem, tamanho do papel e licença. Cada cartão abaixo mostra o sintoma observado, a causa técnica, a correção em passos e como evitar o problema de novo.

A impressora responde OK, mas nenhuma etiqueta sai

Causa: a resposta HTTP 200 não prova impressão, porque a impressora responde OK até para comandos que descarta. Dois envios em menos de cerca de 8 segundos também podem fazer a segunda etiqueta sumir.

Solução: envie uma etiqueta por vez, espere o intervalo de segurança e confirme o papel na bandeja. No editor, use Testar 1 antes do lote. Se o problema persistir, confira no painel web da impressora (abra o IP dela no navegador) o contador de etiquetas.

Prevenção: nunca dispare lotes em rajada e trate o papel na bandeja como única prova de sucesso.

Conexão recusada ou pontinho vermelho ao lado do IP

Causa: o IP está errado, a impressora está desligada ou fora da mesma rede. O DHCP também pode ter trocado o endereço desde a última vez.

Solução: confira o IP no painel da impressora, rode Testar Conexão em Configurar Impressora e, se a sua rede resolve nomes .local, use o nome mDNS da impressora, que sobrevive à troca de IP. No USB ou no Bluetooth, verifique o cabo e se a conexão ainda está ativa.

Prevenção: reserve um IP fixo para a impressora no roteador ou use o hostname mDNS.

A etiqueta imprime deslocada em todas as peças

Causa: a posição de origem da impressora e a do desenho não coincidem, comum depois de trocar de rolo ou de modelo de impressora.

Solução: abra o botão Margens da barra de status, mexa apenas na margem do lado afetado (por exemplo, a Superior) e mande uma página de teste. O resto do desenho continua exatamente no mesmo lugar, e você repete até a etiqueta sair reta.

Prevenção: calibre a impressora ao trocar o tipo de mídia e anote as margens que funcionaram.

A etiqueta atravessa as vizinhas sem mensagem de erro

Causa: a altura do desenho é maior que a bobada carregada, e a impressora não acusa erro nenhum nesse caso.

Solução: use Conferir Mídia, que compara a altura da etiqueta com o comprimento da bobada e responde "casa", "sobra" ou "atravessa". Ajuste o tamanho da etiqueta ou troque o rolo e calibre de novo.

Prevenção: rode Conferir Mídia sempre que trocar de rolo.

Mixed Content: a página HTTPS não consegue falar com a impressora HTTP

Causa: o navegador bloqueia chamadas de uma página HTTPS para um endereço HTTP, e o Link-OS 7.5 ou mais novo já vem com o HTTP desligado de fábrica.

Solução: escolha HTTPS Direct em Configurar Impressora. Se o navegador reclamar do certificado, deixe a ponte local rodando, porque ela tolera o certificado autoassinado, ou abra o endereço HTTPS da impressora e aceite o certificado uma vez por sessão.

Prevenção: instale a ponte no computador que imprime e use sempre o protocolo recomendado para o seu firmware.

A licença do Professional não ativa depois de trocar de computador

Causa: a licença está associada ao equipamento anterior e só é liberada para outro depois da desativação seguida de redefinição no servidor da Zebra.

Solução: no computador antigo, abra Arquivo, Sobre, e use a opção de desativar (a Zebra tem um vídeo com o procedimento offline); aguarde a Zebra concluir o processo no servidor e ative no equipamento novo com a chave, o Customer ID e, na ativação offline, o arquivo de licença.

Prevenção: guarde a chave e o Customer ID num cofre de senhas e desative sempre antes de formatar ou aposentar um PC.

Veja a demonstração em vídeo no @CanalQb

Teste o editor gratuito em canalqb.github.io/etiquetas-zebra, compare com o seu fluxo e conte nos comentários qual recurso do Professional você realmente usa.

Conformidade Global: As informações regulatórias refletem as legislações vigentes no momento da publicação. Leis de privacidade variam por jurisdição e estão em constante evolução. Consulte as autoridades locais de proteção de dados e o IAPP Global Privacy Directory. Este conteúdo não constitui aconselhamento jurídico.

Fontes e Referências

Todas as fontes abaixo foram consultadas em 25/10/2026. Preços de lojas e versões de software mudam, então confirme os dados atuais antes de decidir.

Feito com Master Rules Claude v9.2

Planilha Super Sete que se Atualiza Sozinha (2026)

noreply@blogger.com (CanalQb) — Sun, 25 Oct 2026 22:46:27 -0300

@CanalQb no YouTube

Planilha Super Sete que se Atualiza Sozinha (2026)

Leitura: ~13 min

TL;DR:

Montei uma planilha de Super Sete no Google Sheets que baixa sozinha todo o histórico oficial via API da CAIXA e calcula frequência e atraso de cada dígito em cada uma das 7 colunas (70 células de estatística).
Com um clique (ou marcando o checkbox A6) ela recria 48 tickets QUENTE/FRIO/NEUTRO/MISTOS + 12 linhas MÉDIA/HARMÔNICA/FIBONACCI e pinta de verde cada dígito acertado na coluna certa.
Isso importa porque o Super Sete é a única loteria da CAIXA com acerto posicional: o 5 na Coluna 1 não vale nada na Coluna 2, e planilhas genéricas erram essa análise por completo.

Aviso importante: Este conteúdo é estritamente informativo e educacional, sobre estatística e automação de planilhas. Não garante ganhos nem resultados. Loteria é jogo de azar: nenhum dado histórico tem valor preditivo. Proibido para menores de 18 anos. Jogue com responsabilidade. O @CanalQb não tem vínculo nem afiliação com a CAIXA.

Acertar 7 dígitos no Super Sete é 1 chance em 10.000.000. Conferir cada concurso à mão, em 7 colunas independentes, é onde quase todo apostador desiste. A planilha que vou mostrar resolve exatamente isso: ela conecta ao portal de loterias da CAIXA, importa o histórico oficial e recalcula tudo sozinha. E no fim deste post existe um detalhe estatístico sobre o teste chi² que quase ninguém explica direito.

O que é o Super Sete e quais são as regras oficiais?

O Super Sete é a modalidade da CAIXA com estrutura própria: você joga em 7 colunas e a CAIXA sorteia 1 dígito de 0 a 9 em cada coluna. A aposta simples é 1 dígito por coluna (7 dígitos) e custa R$ 3,00; nas apostas múltiplas você marca de 8 a 21 dígitos no total — no máximo 2 por coluna com até 14 dígitos, ou 2 a 3 por coluna de 15 a 21 dígitos — o que multiplica combinações e preço. Os sorteios acontecem às segundas, quartas e sextas, a partir das 21h, desde 21/09/2021.

O detalhe que muda tudo é o acerto posicional: o dígito só vale se estiver na mesma coluna do volante. O 5 na Coluna 1 é totalmente independente do 5 na Coluna 2. É por isso que a planilha trata o jogo como 70 combinações coluna x dígito, e não como "7 dezenas de um universo só".

Tabela de preços: quanto custa marcar mais dígitos

Como cada coluna é independente, o número de apostas simples é o produto das marcações de cada coluna — e cada aposta simples custa R$ 3,00:

Marcação	Combinações	Custo
1 dígito em cada coluna (simples)	1	R$ 3,00
2 dígitos em uma coluna, 1 nas demais	2	R$ 6,00
2 dígitos em duas colunas, 1 nas demais	4	R$ 12,00
2 dígitos em todas as 7 colunas (14 dígitos)	128	R$ 384,00
3 dígitos em uma coluna, 2 nas demais (15 dígitos)	192	R$ 576,00
3 dígitos em todas as 7 colunas (21 dígitos, máximo)	2.187	R$ 6.561,00

E o melhor? O gerador da planilha trabalha só com apostas simples: cada ticket sai por R$ 3,00 e você escolhe quais levam à lotérica.

Faixas oficiais de premiação

Há prêmio a partir de 3 acertos posicionais. As chances, conforme a tabela oficial reproduzida pela própria planilha na aba Estatísticas:

Acertos	Chance	Premiação
7 acertos	1 em 10.000.000	Prêmio principal
6 acertos	1 em 158.730	Prêmio
5 acertos	1 em 5.879	Prêmio
4 acertos	1 em 392	Prêmio
3 acertos	1 em 43,55	Prêmio fixo de R$ 6,00

Como funciona a atualização automática via API da CAIXA?

A planilha roda um script Google Apps Script que consulta a API oficial do portal de loterias da CAIXA (servicebus2.caixa.gov.br) para descobrir o último concurso, com uma API alternativa como fallback. Na primeira execução ela importa todos os concursos de uma vez; nas seguintes, baixa apenas o que falta e insere no topo da aba "Todos os Jogos".

O fluxo é incremental e seguro: o script compara o número do último concurso salvo na linha 2 com o número remoto e, se nada mudou, avisa que a planilha já está atualizada em vez de gastar requisições à toa. Quando há concurso novo, ele insere as linhas, reordena do mais recente para o mais antigo e dispara o recálculo das estatísticas automaticamente. Aqui no @CanalQb, validamos esse comportamento em dezenas de atualizações seguidas sem duplicar uma única linha.

E o caminho curto? A célula A6 da aba "Jogo" é um checkbox: marcar dispara o gatilho "Atualizar Tudo" e ele desmarca sozinho ao terminar. Um clique, planilha inteira em dia.

Como usar a planilha: o menu "Super Sete" item a item?

Depois de instalar o script (Extensões, Apps Script, colar o código, salvar e recarregar), aparece o menu "Super Sete" na barra superior. São 9 comandos: Atualizar Tudo, Como usar, Atualizar Resultados, Recalcular Estatísticas, Atualizar DashBoard, Gerar Jogos, Copiar Jogos para Aposta, Deletar Todas as Abas e Verificar Instalação. A ordem recomendada na primeira vez é Atualizar Resultados e depois Gerar Jogos; no dia a dia, só Atualizar Tudo.

Atualizar Tudo (botão): faz tudo de uma vez — recria a aba Inicio, importa resultados, recalcula estatísticas, recria a aba "DashBoard" e recria os jogos da aba "Jogo". Também é acionado marcando o checkbox na célula A6.
Como usar (aba Inicio): recria a aba de ajuda embutida, que é um manual completo dentro da própria planilha.
Atualizar Resultados: baixa os concursos oficiais da API da CAIXA para a aba "Todos os Jogos". É o primeiro passo: sem histórico, nada mais funciona.
Recalcular Estatísticas: reescreve a aba "Estatísticas" com base no histórico importado.
Atualizar DashBoard: recria a aba "DashBoard" com tabelas e gráficos: frequência dos dígitos 0-9, pares x ímpares, dígito x coluna e distribuição da soma dos 7 dígitos.
Gerar Jogos: recria os 48 tickets (10 QUENTE, 10 FRIO, 10 NEUTRO e 18 MISTOS na seção lilás "JOGOS MISTOS") mais os tickets MÉDIA, HARMÔNICA e FIBONACCI, sempre 1 dígito por coluna.
Copiar Jogos para Aposta: abre uma janela com todos os tickets prontos para copiar (Ctrl+C) e levar à lotérica.
Deletar Todas as Abas (manter Inicio): zera a planilha para recomeçar do zero com "Atualizar Tudo".
Verificar Instalação: mostra se as abas necessárias existem e o estado da instalação.

A aba "Todos os Jogos" guarda o histórico oficial: Concurso, Data e os 7 dígitos sorteados, um por coluna, com o mais recente no topo. É a única fonte de dados de toda a análise — nada é digitado à mão.

O que significa cada estatística da aba Estatísticas?

A aba Estatísticas calcula frequência e atraso de cada dígito em cada coluna numa tabela de 70 células (7 colunas x 10 dígitos), além de paridade, soma, repetições e um teste de uniformidade. No Super Sete a posição importa: o 5 na Coluna 1 é independente do 5 na Coluna 2, e é isso que separa esta planilha de qualquer análise genérica.

Cada bloco tem um papel claro:

Prob. %: frequência dividida pelo número de concursos. É a chance média de aquele dígito sair naquela coluna em um sorteio. Dois dígitos com a mesma frequência total podem ter probabilidades completamente diferentes quando você olha coluna a coluna.
Atraso atual: há quantos concursos o dígito não sai naquela coluna específica. Atraso é retrato do passado — não é "dívida" que o sorteio precisa pagar.
Soma dos 7 dígitos: a média da soma de cada sorteio (mínimo teórico 0, máximo 63). Serve como termômetro de equilíbrio dos resultados.
Dígitos repetidos vs concurso anterior: média de colunas que repetiram o mesmo dígito do sorteio imediatamente anterior. Como cada coluna sorteia 1 dígito entre 10, o esperado por puro acaso é 0,7 repetição por concurso — e a planilha mostra se o histórico acompanha isso.
Paridade do sorteio: distribuição da quantidade de dígitos pares (0 a 7) por concurso, do puro azar ao todo-par.
Distribuição de acertos — binomial(7; 0,1): a probabilidade matemática de uma aposta simples acertar 7, 6, 5 até 0 dígitos posicionais. É a teoria confirmada na prática: 7 acertos dão 1 em 10.000.000 e 4 acertos dão 1 em 392.

Aqui está o detalhe que quase ninguém percebe. O teste chi² da planilha roda sobre as 70 células coluna x dígito, com valor crítico de 82,5 (5% de significância, 63 graus de liberdade — as 70 células menos as 7 restrições de linha, uma por coluna). Enquanto o resultado ficar abaixo do crítico, os dígitos saem de forma estatisticamente uniforme — ou seja, o sorteio se comporta como esperado de um gerador honesto. É o insight técnico que fica implícito nessa métrica: o chi² não mede "qual dígito vai sair", mede se existe ou não viés no sorteio. Rodando sobre a tabela de 70 células em vez de 10, ele enxerga desvios posicionais que um teste agregado por dígito esconderia. Se um dia o valor subir acima do crítico, aí sim vale investigar — e você será o primeiro a saber, porque o número fica recalculado na aba.

Como ler a aba Jogo: coluna Acertos, QUENTE/NEUTRO/FRIO e os tickets especiais?

A aba "Jogo" gera 48 tickets com 1 dígito por coluna (aposta simples): 10 QUENTE, 10 FRIO, 10 NEUTRO e, ao final, a seção lilás "JOGOS MISTOS" com 18 tickets (Q+F, Q+N, F+Q, F+N, N+Q, N+F — 3 de cada). Os pools são montados por coluna a partir da frequência: em cada posição, os 3 dígitos mais sorteados alimentam o pool QUENTE, os 4 do meio o NEUTRO e os 3 menos sorteados o FRIO. Depois vêm 12 linhas extras: MÉDIA e HARMÔNICA (GERAL/QUENTE/FRIO/NEUTRO) calculadas por fórmula e 4 tickets FIBONACCI.

Como conferir tudo:

Escolha (célula C3): um menu suspenso com todos os concursos da aba "Todos os Jogos". Ao escolher um, as células F4:J4 preenchem sozinhas com os 7 dígitos daquele resultado. Nunca digite ali.
Coluna Acertos: quantos dígitos do ticket coincidem com o resultado na mesma coluna. A fórmula usa SUMPRODUCT comparando posição a posição — acerto posicional de verdade, não "conta quantos dígitos existem no jogo". Fica vazio enquanto nenhum concurso estiver escolhido.
Célula verde: um formato condicional compara cada dígito do ticket com o resultado e pinta de verde o que acertou na coluna certa. É a conferência visual em um segundo.
MÉDIA x HARMÔNICA: a média aritmética puxa o ticket para o "centro" dos dígitos de cada grupo — a linha GERAL cobre as 30 linhas de tickets de uma vez; a harmônica (inversa da média dos inversos) dá maior peso aos dígitos menores e trata o dígito 0 com um ajuste próprio (1/0 não existe), calculando-o como 1. São duas referências de equilíbrio diferentes, não previsões.
FIBONACCI: tickets com dígitos da sequência de Fibonacci e variações (0, 1, 1, 2, 3, 5, 8...), completados por frequência quando faltam dígitos. Existem 4: GERAL, QUENTE, FRIO e NEUTRO.
JOGOS MISTOS: 18 tickets ao final da aba (3 de cada combinação Q+F, Q+N, F+Q, F+N, N+Q, N+F). A mistura é posicional: o ticket sorteia quais 4 colunas (metade de 7, arredondada para cima) recebem dígito do tercil do primeiro pool e quais 3 recebem do tercil do segundo — sempre o pool daquela própria coluna. Como os tercis 3/4/3 particionam os 10 dígitos de cada coluna, os pools nunca se sobrepõem, e a conferência de acertos é a mesma SUMPRODUCT posicional das demais linhas.
Copiar Jogos para Aposta: abre uma janela com todos os tickets no formato "TIPO N: d1 d2 d3 d4 d5 d6 d7", prontos para Ctrl+C. É o fim da transcrição à mão na lotérica.

Mas tem um porém: quente, frio, atraso e médias são retratos do passado. O próximo sorteio não sabe o que aconteceu nos anteriores — o próprio chi² da aba Estatísticas existe para confirmar isso. Use os tickets como organização e diversão, nunca como promessa de ganho. Já cobrimos essa honestidade estatística em outros materiais sobre estatísticas de loteria aqui no blog.

Por que uma planilha posicional vale mais que um gerador comum?

Porque o Super Sete pune ferramentas genéricas: a maioria dos geradores e conferidores trata o jogo como "7 dezenas de 0 a 9", ignorando colunas. O resultado é um contador de acertos que marca ponto quando o dígito existe no jogo, mesmo na coluna errada — inflando sua expectativa e escondendo que você está mais longe do prêmio do que pensa.

Aqui no @CanalQb, validamos que a conferência posicional muda o jogo: um ticket pode ter os 7 dígitos certos em colunas trocadas e valer zero. Só o SUMPRODUCT coluna a coluna mostra a realidade. Se você joga Super Sete toda semana, essa é a diferença entre conferir de verdade e se enganar.

E se você curte outras modalidades, montamos planilhas de loteria para Mega-Sena, Quina, Lotofácil e mais, todas com o mesmo motor de atualização automática. O gerador de jogos do Super Sete é o único com pools independentes por coluna.

Como baixar e instalar a planilha de Super Sete?

O download é um arquivo do Google Sheets: abra, faça uma cópia para seu Drive e cole o script em Extensões, Apps Script. Depois de salvar e recarregar, o menu "Super Sete" aparece com tudo pronto. Nenhum dado pessoal é coletado e nada roda fora da sua própria planilha.

Histórico oficial completo baixado via API da CAIXA, sem digitar uma linha.
70 células de estatística posicional: frequência, probabilidade e atraso por coluna e dígito.
48 tickets QUENTE/FRIO/NEUTRO/MISTOS + MÉDIA, HARMÔNICA e FIBONACCI gerados por clique.
Conferência posicional com célula verde e coluna Acertos contra qualquer concurso.
Checkbox A6 que atualiza tudo e volta sozinho.
Manual de uso embutido na aba Inicio, item a item.

Baixe agora com o botão verde abaixo e assista ao vídeo do @CanalQb no YouTube para ver a instalação ao vivo.

Perguntas Frequentes

A planilha de Super Sete atualiza os resultados da CAIXA sozinha?

O que significa acerto posicional no Super Sete e por que a planilha confere assim?

Quanto custa jogar usando os tickets gerados pela planilha?

Dígitos quentes e frios aumentam a chance de ganhar no Super Sete?

Quais são as chances reais de premiação no Super Sete?

A planilha funciona no Excel ou só no Google Sheets?

📚 Fontes e Referências

Baixe agora a Planilha Super Sete — histórico automático via API da CAIXA, 70 células de estatística posicional e 48 jogos gerados por clique. E acompanhe mais tutoriais no @CanalQb no YouTube.

Feito com Master Rules Claude v8.5

Comprar

Planilha Timemania que se Atualiza Sozinha

noreply@blogger.com (CanalQb) — Sun, 25 Oct 2026 19:53:58 -0300

@CanalQb no YouTube

Planilha Timemania que se Atualiza Sozinha (2026)

Leitura: ~12 min

TL;DR — Resumo Executivo

Montei uma planilha Google Sheets da Timemania que baixa sozinha todos os resultados oficiais da API da CAIXA — em um clique o histórico completo entra na aba "Todos os Jogos".
Ela recalcula frequência, atraso e chi² das 80 dezenas e gera 48 jogos por perfil (QUENTE, FRIO, NEUTRO e mistos Q+F, Q+N, F+Q, F+N, N+Q, N+F) mais jogos MÉDIA, HARMÔNICA e FIBONACCI, com conferência automática de acertos por faixa de prêmio.
Isso importa porque elimina o trabalho manual de conferir concurso por concurso: cada aposta de R$ 3,50 é auditada em segundos, sem prometer ganhos — estatística descreve o passado, não prevê sorteio.

Aviso Importante: Este conteúdo é estritamente informativo e educacional. Loteria é um jogo de azar: nenhuma planilha, estatística ou método garante ganhos, e desempenho passado não prediz resultados futuros. Destinado a maiores de 18 anos. Jogue com responsabilidade e nunca aposte valores que você não pode perder. Este material não é afiliado nem patrocinado pela CAIXA Econômica Federal.

Por R$ 3,50 você aposta em 10 dezenas — e em 26.472.637 tentativas uma acerta as 7.

Essa é a realidade matemática da Timemania, a loteria da CAIXA com a aposta mais barata do país: 10 dezenas de 01 a 80, mais um Time do Coração, sorteada às terças e quintas às 21h e aos domingos às 11h. Quem acompanha os resultados na mão perde horas conferindo cartela por cartela. No resto deste post eu mostro a planilha que construí no Google Sheets para resolver exatamente isso — e o teste estatístico que prova por que "dezena quente" não é o que a maioria pensa.

O que é a Timemania e como funciona a aposta?

A Timemania é a loteria da CAIXA em que você marca 10 dezenas (de 01 a 80) mais 1 Time do Coração, por R$ 3,50. Cada concurso sorteia 7 dezenas e 1 time, com prêmios para 7, 6, 5, 4 e 3 acertos, além do prêmio fixo do time (R$ 8,50). Os sorteios acontecem três vezes por semana.

Criada em 2008, a Timemania tem um detalhe único: o Time do Coração. Além das 7 bolas sorteadas, é sorteado um clube de futebol entre os 80 times habilitados — e se for o seu, você leva R$ 8,50 por aposta, independentemente das dezenas. É o prêmio fixo mais fácil de atingir: 1 chance em 80.

Aqui está o detalhe que quase ninguém percebe: a Timemania é a única loteria da CAIXA com tamanho de aposta fixo. Não existe "jogar mais dezenas para aumentar a chance" como na Mega-Sena ou na Lotofácil — são sempre 10 dezenas, sempre R$ 3,50. Isso torna a planilha mais simples e a análise mais honesta: todo mundo parte exatamente do mesmo ponto matemático.

Faixas oficiais de premiação da Timemania (regras CAIXA)
Acertos	Chance (1 em...)	Prêmio
7 dezenas	1 em 26.472.637	50% do prêmio bruto (variável)
6 dezenas	1 em 216.103	20% do prêmio bruto (variável)
5 dezenas	1 em 5.220	20% do prêmio bruto (variável)
4 dezenas	1 em 276	R$ 10,50 (fixo)
3 dezenas	1 em 29	R$ 3,50 (fixo)
Time do Coração	1 em 80	R$ 8,50 (fixo)

Repare no prêmio de 3 acertos: R$ 3,50, exatamente o valor da aposta. Ou seja, acertar 3 dezenas devolve seu investimento — e a chance disso acontecer é de 1 em 29, o retorno mais frequente da modalidade. É o número que faz a planilha valer a pena para auditoria: em um bolão de 48 jogos, acertos de 3 e 4 faixam diferença real no caixa.

Como funciona a atualização automática via API da CAIXA?

A planilha usa o Apps Script do Google Sheets para consultar a API oficial da CAIXA (servicebus2.caixa.gov.br) e baixar todos os concursos da Timemania. O histórico completo cai na aba "Todos os Jogos" com o concurso mais recente no topo. Na primeira execução ela importa tudo; nas seguintes, apenas os concursos que faltam.

O endpoint oficial é o Portal de Loterias da CAIXA, o mesmo que alimenta o site oficial da CAIXA. O script tenta a fonte oficial primeiro; se ela recusar a conexão (acontece em chamadas seguidas), cai automaticamente numa API alternativa que espelha os mesmos dados. Depois de importar, a coluna "Time do Coração" também vem preenchida — histórico completo de dezenas e times em uma aba só.

E o melhor? Nada de app, nada de extensão, nada de macro baixada da internet. Você cola o código no editor do Apps Script (Extensões, Apps Script), salva e recarrega a planilha. Um menu "Timemania" aparece na barra superior do Google Sheets. Todo o processamento roda na sua própria conta Google, sem enviar dados para nenhum terceiro.

Como usar a planilha passo a passo (menu item a item)?

Abra a planilha, vá no menu "Timemania" e clique em "Atualizar Resultados" na primeira vez; depois use "Atualizar Tudo" no dia a dia. O menu tem 8 funções: atualização, manual de uso, estatísticas, dashboard, gerador de jogos, cópia para aposta, reset e verificação de instalação.

Aqui no @CanalQb, validamos que o fluxo abaixo funciona em menos de dois minutos do zero à planilha completa. Replicando a aba "Inicio" (o manual interno da planilha), o uso é este:

Atualizar Resultados: baixa os concursos oficiais para a aba "Todos os Jogos". É sempre o primeiro passo, porque sem histórico nenhuma estatística é calculada.
Recalcular Estatísticas: reescreve a aba "Estatísticas" com frequência, atraso e distribuições de todas as 80 dezenas com base no histórico importado.
Atualizar DashBoard: recria a aba "DashBoard" com gráficos de frequência por dezena, pares versus ímpares, saídas por faixa e distribuição de paridade.
Gerar Jogos: cria a aba "Jogo 10" com 48 jogos prontos — três perfis de dezenas (QUENTE, FRIO e NEUTRO) e 18 JOGOS MISTOS que misturam os pools dois a dois — mais 12 jogos calculados (MÉDIA, HARMÔNICA e FIBONACCI).
Copiar Jogos para Aposta: abre uma janela com todos os jogos em formato de texto, prontos para copiar e levar à lotérica ou colar no site da CAIXA.
Atualizar Tudo: executa as etapas anteriores de uma vez. É a opção do dia a dia — e também é disparada ao marcar o checkbox da célula A6 na aba "Jogo 10", que se desmarca sozinho ao terminar.
Verificar Instalação: mostra se todas as abas existem e o estado geral da instalação. Se algo faltar, ele avisa.
Deletar Todas as Abas: reset total. Apaga tudo exceto a "Inicio" para recriar do zero — útil se algo sair do controle.

A aba "Todos os Jogos" guarda o histórico oficial: número e data do concurso, as 7 dezenas sorteadas (Bola 1 a Bola 7, em ordem crescente) e o Time do Coração de cada sorteio. O concurso mais recente fica sempre na linha 2, o que faz a busca por MATCH no gerador de jogos ser instantânea.

O que significa cada estatística da aba "Estatísticas"?

A aba calcula frequência, probabilidade por concurso, atraso atual, atraso médio e atraso máximo de cada dezena de 01 a 80, além de distribuições de paridade, faixas, quadrantes, primos, Fibonacci, soma e amplitude. Cada dezena recebe um rótulo: QUENTE, NEUTRO ou FRIO, conforme sua posição no ranking de frequência.

A classificação é objetiva: as 27 dezenas mais sorteadas do histórico são QUENTE, as 27 menos sorteadas são FRIO e as 26 do meio são NEUTRO. Os rótulos aparecem coloridos no gerador (laranja para quente, azul para frio, cinza para neutro), o que facilita comparar perfis de aposta lado a lado.

Mas tem um porém que precisa ficar registrado. O teste de chi² que a planilha roda compara a frequência observada de cada dezena com a frequência esperada num sorteio perfeitamente uniforme — o valor crítico com 79 graus de liberdade é 100,7. Nos históricos que analisamos aqui no @CanalQb, o resultado fica consistentemente abaixo desse limite: as 80 dezenas saem de forma estatisticamente uniforme, como esperado num sorteio honesto. Em outras palavras, "dezena quente" é um retrato do passado, não uma vantagem no futuro — cada sorteio é independente. A planilha deixa isso escrito na própria aba de estatísticas, porque ferramenta honesta vale mais que promessa.

Completam a aba: os rankings das 10 mais e 10 menos sorteadas, os maiores atrasos atuais (com o aviso de que atraso não aumenta chance), as distribuições por faixa de 10 dezenas e por quadrante do volante, os 10 times do coração mais sorteados da história e a tabela de probabilidades hipergeométricas de acertos para a aposta de 10 dezenas — a mesma matemática da tabela oficial acima.

Como ler a aba "Jogo 10" e conferir seus acertos?

A aba "Jogo 10" gera 48 jogos (10 QUENTE, 10 FRIO, 10 NEUTRO e 18 MISTOS, seção lilás ao final) mais 12 jogos calculados de MÉDIA, HARMÔNICA e FIBONACCI — e cada jogo já vem com um Time do Coração sugerido, porque a aposta real da Timemania é 10 dezenas + 1 time. Você escolhe o concurso na célula C3, o resultado e o time sorteado preenchem as células amarelas, a coluna "Acertos" conta quantas dezenas de cada jogo saíram e a coluna "Time OK" marca 1 quando o time sugerido da linha é o time sorteado.

Cada elemento da aba tem um papel específico. Veja agora como ler cada parte:

Célula C3 (Escolha): um menu suspenso com todos os concursos do histórico. Ao selecionar, as 7 dezenas daquele sorteio preenchem automaticamente a linha F4:L4 — você nunca digita o resultado à mão.
Célula verde: formatação condicional que pinta de verde qualquer dezena dos jogos que esteja no resultado. Você enxerga os acertos de todos os 60 jogos de uma vez, sem conferir linha por linha.
Coluna "Ac?": fórmula de contagem que soma quantas dezenas de cada jogo coincidem com o resultado, faixa por faixa — 3 acertos devolvem a aposta, 4 rendem R$ 10,50.
Coluna "Time" e "Time OK": cada jogo traz 1 Time do Coração sugerido, sorteado do pool do nível da linha (times mais sorteados para jogos QUENTE, menos sorteados para FRIO, meio do ranking para NEUTRO; mistos seguem o pool base do combo). A coluna "Time OK" compara o time sugerido com o time sorteado do concurso: 1 = prêmio fixo de R$ 8,50.
Jogos MÉDIA: quatro jogos (GERAL, QUENTE, FRIO, NEUTRO) montados com a média aritmética das dezenas de cada grupo — o "centro" estatístico do perfil.
Jogos HARMÔNICA: a média harmônica dá maior peso às dezenas menores, gerando jogos puxados para o início do volante (01 a 40) — outra referência de equilíbrio.
Jogos FIBONACCI: montados com dezenas da sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21, 34, 55...) e variações, completadas por frequência quando faltam dezenas.
Checkbox A6: marque para rodar "Atualizar Tudo" direto da aba de jogos. Ele desmarca sozinho ao terminar — um botão físico dentro da planilha.

Aqui está o insight técnico original desta planilha: a coluna "Ac?" não é só um placar — ela é uma auditoria por faixa de premiação. Como cada linha carrega o rótulo do perfil (QUENTE, FRIO, NEUTRO), você consegue responder em segundos qual perfil teria rendido mais prêmios fixos (3 e 4 acertos) naquele concurso. A contagem cruza todos os jogos de um perfil contra o resultado e devolve a distribuição de acertos do grupo inteiro. Nenhum site de loteria oferece essa leitura por perfil; é a diferença entre conferir bilhetes e avaliar estratégias.

Antes de ir à lotérica, use "Copiar Jogos para Aposta": a planilha abre uma janela com todos os jogos em texto corrido, um clique no botão Copiar e você leva a lista no celular. O custo estimado aparece na própria aba: 60 jogos somam R$ 210,00 em apostas simples — a planilha mostra esse número sempre visível para você decidir o tamanho da brincadeira.

Vale a pena usar estatísticas na Timemania?

As estatísticas não mudam a chance de ganhar — cada sorteio é independente e o chi² confirma a uniformidade das 80 dezenas. O valor real está na organização: conferir dezenas de jogos automaticamente, controlar o custo das apostas e decidir com dados quanto se gasta em lazer, sem ilusão de previsão.

Se você gosta desse tipo de ferramenta, já cobrimos outras planilhas de automação no canalqb.com.br — o mesmo motor serve para outras loterias da CAIXA com pequenos ajustes. Também explicamos em detalhe como ler estatísticas de loteria sem cair na falácia do jogador, e a Timemania completa tem página própria aqui no blog.

O aviso honesto está gravado na própria aba "Inicio" da planilha: estatísticas não prevêem sorteio. Quente, frio e atraso são retratos do passado, sem valor preditivo. Use a planilha como ferramenta de organização e auditoria — e nunca como promessa de ganho.

Perguntas Frequentes

A planilha da Timemania se atualiza sozinha mesmo, sem eu fazer nada?

Ela se atualiza com um clique: ao marcar o checkbox A6 ou escolher "Atualizar Tudo" no menu, o script consulta a API oficial da CAIXA e importa tudo o que falta — normalmente em menos de um minuto. A partir de um gatilho configurável no Apps Script é possível agendar a atualização automática por e-mail sem nenhum clique. Se você está começando, veja o passo a completo no post sobre planilha Timemania aqui do blog.

Dezenas quentes e frias aumentam a chance de ganhar na Timemania?

Quanto custa jogar os 60 jogos gerados pela planilha?

Dá para usar a mesma planilha para outras loterias da CAIXA?

Quais prêmios a Timemania paga e quais são fixos?

É seguro colar o código do Apps Script na minha conta Google?

📚 Fontes e Referências

Loterias CAIXA — Timemania — regras, faixas de premiação e resultados oficiais da modalidade.
API do Portal de Loterias da CAIXA — endpoint público usado pela planilha para importar os concursos.
CanalQb — Timemania — outros artigos e planilhas da modalidade aqui no blog.

Baixe a planilha da Timemania com atualização automática via API da CAIXA e confira também o canal @CanalQb no YouTube.

Feito com Master Rules Claude v8.5

Comprar planilha

Metadados — DeepSeek V4.1 no Windows: OpenCode, Kimi e Hermes

noreply@blogger.com (CanalQb) — Thu, 22 Oct 2026 17:42:25 -0300

@CanalQb no YouTube

DeepSeek V4.1 no Windows: OpenCode, Kimi e Hermes

Feito com Master Rules Claude v9.2

Leitura: ~24 min

TL;DR

Em 22 de outubro de 2026 a API do DeepSeek tem dois nomes de modelo, deepseek-flash e deepseek-v4-pro, ambos com 1 milhão de tokens de contexto, e uma única chave de API serve aos três agentes deste guia.
OpenCode e Hermes ativam o DeepSeek por assistente guiado (/connect e hermes setup), enquanto o Kimi Code CLI exige registrar um provedor do tipo openai no config.toml.
O preço por token dobra no horário de pico, que em Brasília cai entre 22h e 01h e entre 03h e 07h; concentrar sessões longas fora dessas faixas corta a conta pela metade.

Uma chave de API, três agentes: o difícil é saber onde colá-la.

Em outubro de 2026 o DeepSeek trocou o modelo que responde pelo nome deepseek-flash sem mudar o nome nem o preço, e muita configuração antiga ainda aponta para apelidos aposentados. Aqui em @CanalQb organizamos o caminho completo para o Windows a partir das documentações oficiais: primeiro a instalação de OpenCode, Kimi Code CLI e Hermes Agent, depois a ativação do DeepSeek em cada um.

No fim existe um ajuste de horário que quase ninguém faz e que muda a conta do mês. Ele depende de uma regra de pico que a página de preços descreve em UTC, e vale a pena traduzi-la para o relógio de Brasília antes de deixar qualquer agente rodando durante a noite.

Quais são as soluções rápidas para os problemas mais comuns?

Seis falhas concentram quase todos os chamados nesse tipo de instalação: comando não reconhecido depois do instalador, shell Bash ausente, versão antiga do OpenCode, chave não encontrada, provedor com nome divergente e erro 400 em modo de raciocínio. Cada uma tem correção de poucos minutos e um detalhamento mais abaixo.

kimi ou hermes não reconhecido: feche e abra um terminal novo para o PATH atualizado entrar em vigor. ver passo completo
Bash not found no Kimi: instale o Git for Windows ou aponte KIMI_SHELL_PATH para o bash.exe. ver passo completo
DeepSeek ausente no OpenCode: atualize para a versão 1.18.30 ou superior e rode /connect de novo. ver passo completo
API key not set no Hermes: rode hermes model e grave a chave com hermes config set DEEPSEEK_API_KEY. ver passo completo
Provider not found: a chave do provedor e o prefixo do modelo precisam ser idênticos. ver passo completo
Erro 400 com raciocínio ligado: o campo reasoning_content precisa voltar na conversa; atualize o agente. ver passo completo

O que mudou no DeepSeek e qual modelo você deve chamar?

Em outubro de 2026 a API oficial do DeepSeek expõe dois nomes de modelo: deepseek-flash, atendido pela versão V4.1-Flash-1017, e deepseek-v4-pro, que corresponde à V4-Pro-0813. Ambos oferecem janela de 1 milhão de tokens, chamadas de ferramentas e modo de raciocínio, e funcionam tanto no formato OpenAI quanto no formato Anthropic.

Esse ponto de partida importa porque os três agentes deste tutorial só conversam com o DeepSeek pela API, e a API mudou duas vezes em poucas semanas. Segundo a página oficial de modelos e preços, o nome deepseek-flash passou a ser servido pelo snapshot 1017, e os nomes legados deepseek-v4-flash e deepseek-v4-flash-vision-exp continuam sendo aceitos, mas os modelos que eles identificavam foram aposentados: qualquer requisição feita com eles cai no Flash atual e é cobrada pelo preço do Flash. Na prática, uma configuração antiga não quebra de imediato, mas deixa de refletir o que você realmente está usando.

A diferença entre os dois modelos aparece no preço e nos recursos. O Flash aceita entrada de imagem e custa bem menos; o Pro não oferece visão, mas é a escolha para planejamento difícil e tarefas longas de código. Os valores abaixo vêm da página oficial, são cobrados por 1 milhão de tokens e valem fora do horário de pico; no pico, cada valor dobra.

Modelo	Versão servida	Entrada com cache	Entrada sem cache	Saída	Visão
deepseek-flash	V4.1-Flash-1017	US$ 0,003	US$ 0,15	US$ 0,60	Sim
deepseek-v4-pro	V4-Pro-0813	US$ 0,022	US$ 0,66	US$ 1,98	Não

Um exemplo concreto mostra o tamanho da diferença. Uma sessão que consome 2 milhões de tokens de entrada sem cache e gera 200 mil tokens de saída custa, fora do pico, 2 × US$ 0,15 + 0,2 × US$ 0,60, ou seja, US$ 0,42 no Flash. A mesma sessão no Pro custa 2 × US$ 0,66 + 0,2 × US$ 1,98, que dá cerca de US$ 1,72. O Pro sai 4,4 vezes mais caro na entrada e 3,3 vezes na saída, então vale reservá-lo para quando o Flash realmente não der conta.

Existe uma limitação que atrapalha quem copia tutoriais antigos: os nomes deepseek-chat e deepseek-reasoner, muito comuns em guias de 2025 e do início de 2026, não aparecem mais na lista oficial de modelos. Se um passo a passo mandar usar um deles, confirme o nome atual na página de preços antes de colar no arquivo de configuração. O erro típico é o agente responder normalmente nos primeiros testes e, semanas depois, falhar porque o apelido foi removido do servidor.

Para começar, deixe o deepseek-flash como padrão nos três agentes. Ele tem o melhor custo por tarefa, cobre leitura de código, edição de arquivos e execução de comandos, e você pode trocar para o Pro numa sessão específica quando precisar. Se quiser conferir o preço vigente no dia, a fonte é a página oficial de modelos e preços do DeepSeek; os números mudam sem aviso e nenhum guia deve ser tratado como tabela definitiva.

O que preparar no Windows antes de instalar os três agentes?

Antes de instalar qualquer agente, tenha três coisas prontas: um terminal PowerShell atualizado, o Git for Windows e uma chave de API do DeepSeek criada na plataforma oficial. Com esses itens no lugar, os instaladores de OpenCode, Kimi Code CLI e Hermes rodam sem interrupção, e você evita os erros de caminho e de shell que mais aparecem no Windows.

Passo 1: confirme Git e Node.js

Abra o PowerShell e rode os comandos abaixo para ver o que já existe na máquina. O resultado esperado é uma linha de versão para cada comando; se aparecer "não é reconhecido", o programa falta.

git --version
node --version
winget --version

O Git é obrigatório para o Kimi Code CLI, que usa o Git Bash como shell, e útil para o Hermes e o OpenCode. O Node.js só é necessário para os caminhos de instalação por npm; para o Kimi pelo npm a documentação exige a versão 22.19.0 ou mais nova. Se faltar algum, instale pelo winget com os comandos a seguir e depois feche e reabra o PowerShell. Erro comum: instalar e continuar na mesma janela; o PATH só é relido em terminais novos.

winget install --id Git.Git -e
winget install --id OpenJS.NodeJS.LTS -e

Passo 2: gere a chave no painel do DeepSeek

Entre em platform.deepseek.com, abra a área de chaves de API e crie uma chave nova com um nome reconhecível, como "agentes-windows". A chave aparece uma única vez; copie-a para um gerenciador de senhas antes de fechar a janela. Esse passo é necessário porque os três agentes cobram o uso direto na sua conta DeepSeek, e sem saldo ou crédito promocional as requisições falham mesmo com a chave correta. Quando funciona, a lista de chaves mostra a nova entrada com a data de criação. Erro comum: colar a chave num chat, num commit ou num arquivo de projeto; se isso acontecer, revogue a chave no painel e crie outra.

Passo 3: guarde a chave numa variável de ambiente

Em vez de colar a chave em cada ferramenta, grave-a uma vez como variável de ambiente do usuário. O comando setx persiste o valor para terminais futuros, e o Kimi Code CLI vai ler exatamente esse nome. Troque o texto de exemplo pela sua chave real e reabra o PowerShell depois.

setx DEEPSEEK_API_KEY "sk-cole-sua-chave-aqui"
# depois de reabrir o PowerShell:
echo $env:DEEPSEEK_API_KEY

Se o segundo comando imprimir a chave, a variável está viva. Quando ele imprime uma linha vazia, o setx foi rodado na janela atual e o terminal ainda não foi reaberto, que é a causa mais comum de "chave não encontrada" logo no primeiro teste.

Um detalhe de análise própria que poupa tempo: cada agente trata a chave de um jeito diferente. O OpenCode guarda a chave no próprio armazenamento depois do /connect, o Kimi Code CLI só enxerga a variável de ambiente se o arquivo de configuração mandar ler pelo nome dela, e o Hermes guarda segredos no arquivo .env da sua pasta de dados. Ter a variável pronta serve ao Kimi e ao Hermes, e o OpenCode recebe a mesma chave colada uma única vez dentro do assistente.

Como instalar o OpenCode no Windows?

O OpenCode instala no Windows por npm, Scoop ou Chocolatey, e a documentação oficial recomenda o WSL como o caminho com melhor desempenho e compatibilidade total. Para quem prefere ficar no Windows nativo, o comando npm install -g opencode-ai basta; depois, opencode --version deve mostrar a versão 1.18.30 ou superior para funcionar bem com o DeepSeek.

Passo 1: escolha o método de instalação

A decisão depende do que você já usa. Quem tem Node.js instalado vai de npm, quem usa gerenciador de pacotes prefere Scoop ou Chocolatey, e quem quer o melhor desempenho segue o guia de WSL do próprio projeto. Os quatro caminhos entregam o mesmo executável opencode, então a escolha é de conveniência e de atualização.

Método	Comando	Quando escolher
npm	npm install -g opencode-ai	Você já tem Node.js e quer atualizar com o mesmo comando mais tarde.
Scoop	scoop install opencode	Você usa Scoop para outras ferramentas de linha de comando.
Chocolatey	choco install opencode	Você usa Chocolatey e abre o PowerShell como administrador.
WSL	curl -fsSL https://opencode.ai/install \| bash	Você quer o caminho recomendado pela documentação, dentro do Linux do WSL.

Passo 2: instale e confirme a versão

Este guia segue o npm por ser o mais direto no Windows nativo. O comando baixa o pacote e registra o executável opencode no PATH global do npm. Ele é necessário aqui porque o DeepSeek só aparece no catálogo de provedores das versões recentes.

npm install -g opencode-ai@latest
opencode --version

O resultado esperado é um número de versão, e o guia de integração do DeepSeek pede 1.18.30 ou mais nova para evitar problemas de compatibilidade. Se o número for menor, repita o primeiro comando; se o comando opencode não for reconhecido, abra um terminal novo e confira com npm config get prefix se a pasta global do npm está no PATH.

Existe uma pegadinha de versões que a documentação do OpenCode destaca: o OpenCode 1 e o OpenCode 2 usam o mesmo comando opencode e não convivem lado a lado na instalação padrão. Se você já testou a versão 2 em algum momento, instalar a versão 1 por cima troca o executável, e a configuração do DeepSeek descrita neste guia foi escrita a partir da documentação oficial da versão 1, que é a que o DeepSeek cita. Quem preferir a versão 2 deve consultar a documentação própria dela antes de seguir os próximos passos.

Para o WSL, o projeto mantém uma página dedicada com a instalação do Linux e os cuidados de caminho entre os dois sistemas; vale lê-la se você pretende abrir projetos que ficam em pastas do Windows. Para o restante deste guia, o terminal pode ser o PowerShell com a instalação por npm ou o terminal do WSL com o instalador do projeto, e os comandos de ativação do DeepSeek são idênticos nos dois.

Como ativar o DeepSeek no OpenCode?

No OpenCode a ativação é guiada: abra o terminal, rode opencode, digite /connect, procure pelo provedor deepseek, cole a chave de API e escolha o modelo Flash na lista. O processo leva menos de dois minutos e não exige editar arquivo algum, porque o DeepSeek já faz parte do catálogo de provedores do OpenCode.

Passo 1: abra o OpenCode numa pasta de projeto

Vá até uma pasta de teste e inicie a interface. O OpenCode trabalha sobre o diretório atual, então iniciá-lo na pasta errada faz o agente enxergar arquivos que você não pretendia expor.

mkdir $HOME\teste-agentes
cd $HOME\teste-agentes
opencode

Quando funciona, a interface em tela cheia do terminal abre com uma caixa de entrada no rodapé. Erro comum: iniciar na raiz do disco ou na pasta de usuário inteira, o que deixa o agente indexar muito mais arquivos do que o necessário.

Passo 2: conecte o provedor com /connect

Na caixa de entrada digite /connect, escreva deepseek na busca e selecione o provedor. Em seguida cole a chave de API quando o assistente pedir. Esse passo grava a credencial no armazenamento do próprio OpenCode, e é por isso que ele não depende da variável de ambiente criada antes. O resultado esperado é uma mensagem de conexão concluída e, na etapa seguinte, a lista de modelos do DeepSeek.

Passo 3: escolha o modelo Flash

Selecione a entrada do Flash na lista. As páginas do DeepSeek descrevem essa opção de duas maneiras, como V4.1-Flash num guia e como V4-Flash em outro, porque a documentação foi atualizada em momentos diferentes; ambas se referem ao mesmo modelo de custo baixo, e o servidor atende pelo nome deepseek-flash. Para ver o identificador exato que o seu OpenCode usa, digite /models depois da conexão.

Passo 4: fixe o modelo no arquivo de configuração

Isto é opcional, mas evita escolher o modelo toda vez. O OpenCode lê um arquivo opencode.json global na pasta .config do seu perfil de usuário e outro na raiz de cada projeto. Escreva o modelo no formato provedor/identificador, trocando o texto de exemplo pelo identificador mostrado no /models.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "deepseek/identificador-mostrado-no-models"
}

Faça o teste com um pedido simples, como "Liste os arquivos desta pasta e explique em três linhas o que cada um faz". A tecla Tab alterna entre o modo de planejamento, que só sugere mudanças, e o modo de construção, que as aplica. Erro comum: o aviso Provider not found, que aparece quando o nome do provedor no arquivo e o prefixo do modelo não são idênticos; ambos precisam ser exatamente deepseek.

Como instalar o Kimi Code CLI no Windows?

O Kimi Code CLI instala no Windows com um único comando em PowerShell, desde que o Git for Windows esteja instalado antes do primeiro uso, porque a ferramenta usa o Git Bash como shell. Depois do script, kimi --version confirma o executável no PATH e o comando kimi abre a interface interativa no diretório do seu projeto.

Passo 1: tenha o Git for Windows no lugar

Se você seguiu a preparação, o Git já está instalado pelo winget. A documentação do Kimi Code é direta: instale o Git for Windows antes de abrir a ferramenta pela primeira vez, pois é o Git Bash que executa os comandos de shell que o agente pede. Sem ele, o primeiro comando de shell falha com a mensagem Bash not found.

Passo 2: rode o instalador oficial

No PowerShell comum, sem precisar de administrador, execute o comando abaixo. Ele baixa a versão mais recente, confere o checksum e coloca o executável kimi no PATH; por isso é o método que a documentação chama de recomendado e que dispensa ter Node.js. Como em qualquer script executado direto da internet, vale abrir o endereço no navegador e ler o conteúdo antes de rodar.

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Passo 3: confirme a instalação

Feche o PowerShell, abra um novo e rode o comando abaixo. O resultado esperado é a versão instalada. Se a resposta for kimi not found, o PATH ainda não foi relido ou o instalador rodou em outro usuário do Windows; um terminal novo no mesmo usuário resolve na maioria dos casos.

kimi --version

Passo 4: alternativas e ajustes finos

Quem já tem Node.js 22.19.0 ou superior pode instalar pelo npm com npm install -g @moonshot-ai/kimi-code, e atualizar depois com kimi upgrade. Se o Git Bash estiver numa pasta fora do padrão, grave o caminho do bash.exe na variável KIMI_SHELL_PATH, por exemplo com setx KIMI_SHELL_PATH "C:\Program Files\Git\bin\bash.exe", e reabra o terminal.

Atenção a uma confusão frequente de nomes: existe o Kimi Code CLI atual, escrito em TypeScript, e o antigo kimi-cli, instalado com uv tool install kimi-cli, que guarda a configuração em ~/.kimi. O Kimi Code CLI usa a pasta ~/.kimi-code, que no Windows fica dentro do seu perfil de usuário. Muitos tutoriais antigos citam o primeiro caminho, e editar o arquivo da pasta errada é um dos motivos de a configuração do DeepSeek "não pegar". O instalador deste passo, com o endereço contendo kimi-code, é o da ferramenta atual.

Como ativar o DeepSeek no Kimi Code CLI?

O caminho mais previsível é registrar o DeepSeek no arquivo config.toml como um provedor do tipo openai, apontando para a URL da API e para uma variável de ambiente com a chave. Depois você define um alias de modelo e o torna padrão, e o CLI trata sozinho o campo de raciocínio que os modelos DeepSeek devolvem.

Passo 1: abra o arquivo config.toml

O arquivo nasce na primeira execução do kimi, então rode o comando uma vez e saia com /exit. Depois abra o arquivo no editor com o comando abaixo. O CLI lê as credenciais apenas do arquivo de configuração e não usa variáveis do terminal por conta própria, e é isso que o próximo passo contorna.

notepad $HOME\.kimi-code\config.toml

Passo 2: adicione o provedor e o modelo

Acrescente o bloco abaixo, mantendo o que já existe no arquivo. O tipo openai fala o protocolo de chat compatível com OpenAI, que o DeepSeek oferece em https://api.deepseek.com. O campo api_key_env manda o CLI ler a chave da variável DEEPSEEK_API_KEY a cada requisição, assim a chave não fica escrita em texto puro no arquivo. A janela de contexto foi declarada em 1 milhão de tokens, valor conservador em relação ao informado na página de preços.

default_model = "deepseek/flash"

[providers.deepseek]
type = "openai"
base_url = "https://api.deepseek.com"
api_key_env = "DEEPSEEK_API_KEY"

[models."deepseek/flash"]
provider = "deepseek"
model = "deepseek-flash"
max_context_size = 1000000
display_name = "DeepSeek V4.1 Flash"
capabilities = ["thinking", "tool_use"]

Se o arquivo já tiver uma linha default_model, mantenha apenas uma delas, porque a chave repetida invalida o TOML. As aspas em torno de deepseek/flash são obrigatórias, já que a barra e o ponto em nomes de chave exigem aspas nesse formato. Para um segundo alias com o Pro, copie o bloco de modelo, troque o alias e o campo model para deepseek-v4-pro e tire a capacidade de imagem se algum dia a declarar.

Passo 3: recarregue e teste

Salve o arquivo, abra um terminal novo para que a variável de ambiente entre no processo e faça um teste curto de uma única mensagem. O parâmetro -m escolhe o alias e -p executa uma instrução sem abrir a interface.

kimi -m deepseek/flash -p "Responda apenas: configuração ok"

Se a resposta chegar, abra o kimi normalmente e use /model para alternar entre aliases durante a sessão. Se aparecer um erro citando a variável DEEPSEEK_API_KEY, ela está vazia nesse processo: rode echo $env:DEEPSEEK_API_KEY e, se vier vazio, refaça o setx e reabra o terminal. Um segundo caminho existe no próprio CLI: o comando /provider abre um gerenciador que importa provedores conhecidos a partir do catálogo público models.dev e pede só a chave; ele serve como atalho, mas o catálogo pode demorar a listar o identificador mais novo do DeepSeek, e nesse caso o bloco manual acima continua valendo. O comando /login, por sua vez, é para o serviço próprio do Kimi e não é necessário para usar o DeepSeek.

Como instalar o Hermes Agent no Windows?

O Hermes Agent, da Nous Research, tem três caminhos no Windows: o instalador desktop em pacote .appinstaller, o script nativo em PowerShell e o script Linux dentro do WSL2. O caminho mais curto para quem usa terminal é rodar iex (irm https://hermes-agent.nousresearch.com/install.ps1) no PowerShell e reabrir a janela para o comando hermes ser reconhecido.

Passo 1: escolha o caminho de instalação

O pacote desktop do site oficial traz o agente, o Python e as dependências suportadas já embutidos, e o primeiro uso não compila o ambiente base. O script de PowerShell clona o código-fonte, prepara o gerenciador uv e baixa versões fixas de Python, Node.js, ripgrep e FFmpeg. O terceiro caminho, o script para Linux, é para quem já trabalha dentro do WSL2. Para um tutorial de terminal, o script de PowerShell é o mais fácil de reproduzir e de depurar.

Passo 2: rode o instalador nativo

No PowerShell, execute o comando abaixo. O Windows consegue buscar um Git empacotado se ele estiver ausente, e as etapas aparecem em uma linha de status cada, com os detalhes gravados em logs\install.log dentro da pasta de dados do Hermes. O instalador também baixa por padrão as ferramentas de navegador; se não quiser isso, a opção -SkipBrowser as dispensa. Leia o script no navegador antes de rodar, como em qualquer instalador baixado e executado em memória.

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Em execuções interativas o instalador abre o assistente de configuração ao final. Você pode ativar o DeepSeek ali mesmo, seguindo a seção seguinte, ou pular a etapa e voltar depois com hermes model. O código fica em %LOCALAPPDATA%\hermes\hermes-agent, o lançador em %LOCALAPPDATA%\hermes\bin e os seus dados em %LOCALAPPDATA%\hermes.

Passo 3: reabra o terminal e valide

Feche o PowerShell, abra um novo e rode hermes doctor, o comando de diagnóstico do projeto, que informa exatamente o que está faltando. O resultado esperado é uma lista de verificações sem pendências críticas. Se a resposta for hermes: command not found, o PATH não foi relido; um terminal novo costuma resolver, e o diagnóstico do instalador indica a pasta bin que precisa estar no caminho.

Passo 4: plano B pelo WSL2

Relatos de comunidade descrevem o suporte nativo ao Windows como o mais recente e menos testado, com mais chance de arestas. Se o instalador nativo travar, abra o terminal do WSL2 e use o script oficial para Linux, curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, que exige apenas o Git. Os comandos de configuração do DeepSeek são os mesmos nos dois ambientes; muda apenas a pasta de dados, que no WSL2 fica em ~/.hermes.

Como ativar o DeepSeek no Hermes Agent?

No Hermes você ativa o DeepSeek com o assistente hermes setup ou com hermes model: escolha DeepSeek como provedor, informe a chave, confirme a URL https://api.deepseek.com e selecione o modelo. Quem prefere linha de comando direta pode gravar a chave com hermes config set DEEPSEEK_API_KEY e definir provedor e modelo na configuração.

Passo 1: use o assistente guiado

O guia oficial do DeepSeek para o Hermes manda executar hermes setup, escolher a opção Quick Setup, selecionar DeepSeek como provedor, digitar a chave, informar a URL base https://api.deepseek.com e escolher o modelo; o exemplo da documentação usa o deepseek-v4-pro, e para economizar você pode escolher deepseek-flash no mesmo ponto. Há um detalhe de versão: dependendo da release instalada, o Quick Setup pode levar primeiro ao Nous Portal, o serviço próprio da Nous Research. Se isso acontecer, rode hermes model, que lista os provedores diretamente, ou escolha Full Setup no assistente.

Passo 2: configure por comandos

O Hermes separa segredos de configuração comum: a chave vai para o arquivo .env da pasta de dados e o resto para o config.yaml. O comando hermes config set decide o arquivo correto por você. Rode as três linhas abaixo, trocando o texto de exemplo pela sua chave.

hermes config set DEEPSEEK_API_KEY sk-cole-sua-chave-aqui
hermes config set model.provider deepseek
hermes config set model.default deepseek-flash
hermes config get model

A última linha imprime o que ficou gravado e serve de conferência: o provedor deve ser deepseek e o modelo deepseek-flash. Erro comum: digitar a chave com espaços ou aspas curvas coladas de um editor de texto, o que gera falha de autenticação mesmo com a chave certa.

Passo 3: confira o arquivo de configuração

Se preferir editar à mão, o arquivo config.yaml fica em %LOCALAPPDATA%\hermes. O bloco mínimo equivalente aos comandos anteriores é o seguinte, e o comando hermes config edit abre o arquivo no editor.

model:
  provider: deepseek
  default: deepseek-flash

Passo 4: teste uma conversa

Execute hermes e faça uma pergunta curta; o banner inicial mostra o provedor e o modelo escolhidos. Para forçar a escolha em uma única chamada, use hermes chat --provider deepseek --model deepseek-flash. O Hermes exige um modelo com no mínimo 64 mil tokens de contexto, requisito que os 1 milhão de tokens do DeepSeek superam com folga. Se as respostas vierem vazias ou quebradas, a documentação aponta provedor, modelo ou autenticação errados e manda rodar hermes model de novo para confirmar os três.

Como testar os três agentes e controlar o custo do DeepSeek?

Teste cada agente com o mesmo pedido curto, confira no painel do DeepSeek se o consumo apareceu e só então libere tarefas longas. Para segurar a conta, mantenha o Flash como padrão, use o Pro apenas em planejamento difícil e evite os horários de pico, em que o preço por token dobra em relação ao restante do dia.

O teste padronizado evita comparar maçãs com laranjas. Use o mesmo pedido nos três, por exemplo "Liste os arquivos desta pasta e explique em três linhas o que cada um faz", e observe se o agente leu a pasta, respondeu em português e terminou sem erro de autenticação.

Agente	Comando de teste	O que conferir
OpenCode	opencode, depois digitar o pedido	O modelo exibido é o Flash do DeepSeek e o agente lê a pasta.
Kimi Code CLI	kimi -m deepseek/flash -p "pedido"	A resposta chega sem erro citando DEEPSEEK_API_KEY.
Hermes	hermes chat --provider deepseek --model deepseek-flash	O banner mostra provedor e modelo, e a resposta não vem vazia.

Depois dos testes, o assunto é o relógio. A página de preços define o pico como as faixas de 01h às 04h e de 06h às 10h em UTC, de segunda a sexta, sem contar feriados públicos chineses; todo o resto, incluindo os fins de semana inteiros, é fora do pico, com metade do preço. Em Brasília, que está três horas atrás de UTC, as faixas equivalem a 22h–01h e 03h–07h. A regra dos dias vale pela data em UTC, e esse é o ponto que costuma passar batido: a faixa das 22h às 01h é pico de domingo a quinta à noite, já que 22h de domingo em Brasília é 01h de segunda em UTC, e deixa de ser pico na sexta à noite, que já é sábado em UTC. A faixa da madrugada, das 03h às 07h, atinge os dias úteis normais. Quem programa à noite no meio da semana paga o dobro sem perceber.

O cache de entrada é a segunda alavanca de custo. O Flash cobra US$ 0,003 por milhão de tokens com cache contra US$ 0,15 sem cache, uma diferença de 50 vezes, e agentes de código repetem contexto a cada passo. Sessões longas na mesma pasta, sem trocar de modelo no meio, aproveitam mais o cache do que várias sessões curtas e dispersas. A limitação é que o cache depende de o início do pedido ser idêntico, então reorganizar instruções fixas no meio da conversa pode reduzir esse ganho.

Segurança também faz parte do controle. Todos os três agentes executam comandos e editam arquivos, e o conteúdo que eles leem viaja para os servidores do DeepSeek. Não rode o agente em pastas com segredos, mantenha a chave só em variável de ambiente, nunca a coloque em repositório e use os modos de permissão de cada ferramenta: o Kimi Code CLI começa no modo manual, que pede confirmação antes de alterar arquivos ou rodar comandos, e o OpenCode tem sua própria documentação de permissões. Se a chave vazar, revogue no painel e gere outra no mesmo minuto.

Conformidade Global: As informações regulatórias refletem as legislações vigentes no momento da publicação. Leis de privacidade variam por jurisdição e estão em constante evolução. Ao enviar código e dados a uma API de terceiros, avalie a política de dados do provedor e a LGPD, e consulte as autoridades locais de proteção de dados e o IAPP Global Privacy Directory. Este conteúdo não constitui aconselhamento jurídico.

Perguntas frequentes sobre DeepSeek em agentes no Windows

O DeepSeek é gratuito nesses agentes?

Não por padrão. A API cobra por token, com preços diferentes para Flash e Pro e metade do valor fora do horário de pico, descontado do saldo da sua conta. Alguns serviços de terceiros anunciam períodos promocionais, mas esse tipo de oferta muda rápido e deve ser confirmado na hora. Antes de deixar um agente rodando, olhe o painel de uso e veja nossa cobertura sobre DeepSeek.

Devo usar deepseek-flash ou deepseek-v4-pro?

Comece com o deepseek-flash, que custa em torno de um quarto do Pro na entrada e aceita imagens. Troque para o deepseek-v4-pro quando uma tarefa de planejamento ou refatoração grande travar no Flash. O Pro não tem visão. Como a troca é só um nome de modelo, vale testar nos dois com o mesmo pedido, e as comparações aparecem no conteúdo sobre OpenCode.

Posso usar a mesma chave nos três agentes?

Sim. A chave pertence à sua conta DeepSeek e qualquer cliente compatível pode usá-la, então OpenCode, Kimi Code CLI e Hermes aceitam a mesma. A diferença é onde cada um a guarda. Se quiser separar o consumo por ferramenta, crie uma chave por agente no painel; assim, ao revogar uma, as demais continuam funcionando. Mais guias de ferramentas estão em Hermes Agent.

Preciso instalar o WSL para usar esses agentes?

Não é obrigatório. OpenCode e Hermes têm instalação no Windows nativo, e o Kimi Code CLI roda no Windows usando o Git Bash. O WSL é recomendado pela documentação do OpenCode por oferecer desempenho melhor e compatibilidade total, e funciona como plano B para o Hermes se o instalador nativo falhar. Se for por esse caminho, confira o material sobre Kimi CLI.

Meu código vai para os servidores do DeepSeek?

Sim. Qualquer trecho de arquivo, saída de comando ou mensagem que o agente inclua na requisição é enviado à API para gerar a resposta. Por isso evite abrir o agente em pastas com senhas, chaves ou dados de clientes, revise a política de dados do provedor e, em ambiente de empresa, alinhe o uso com o time jurídico. Nossa seção sobre segurança de chaves de API aprofunda o assunto.

Quais erros aparecem ao configurar e como resolver cada um?

Os erros abaixo cobrem as quatro categorias que mais travam este procedimento: instalação que não entra no PATH, shell ausente, configuração com nomes divergentes e autenticação sem chave. Cada cartão traz o sintoma como ele aparece na tela, a causa técnica, a correção copiável e uma prevenção para não repetir o problema na próxima instalação.

kimi not found (ou hermes: command not found)

Causa: o instalador gravou o executável e atualizou o PATH, mas a janela do terminal aberta antes da instalação mantém a lista antiga de pastas.

Solução: feche o PowerShell, abra um novo no mesmo usuário do Windows e rode kimi --version ou hermes doctor. Se persistir, confira se o instalador não foi executado em outra conta de usuário ou com permissões de administrador de outro perfil.

Prevenção: depois de qualquer instalador de linha de comando, abra sempre um terminal novo antes do primeiro teste.

Bash not found

Causa: o Kimi Code CLI usa o Git Bash como shell no Windows e não encontrou o bash.exe, seja porque o Git for Windows não está instalado, seja porque está numa pasta fora do padrão.

Solução: instale com winget install --id Git.Git -e ou, se o Git já existe em outro local, grave o caminho com setx KIMI_SHELL_PATH "C:\Program Files\Git\bin\bash.exe" e reabra o terminal.

Prevenção: instale o Git antes do Kimi e confirme com git --version.

DeepSeek não aparece no /connect do OpenCode

Causa: versão antiga do OpenCode, anterior ao suporte atual ao DeepSeek, ou conflito entre as versões 1 e 2, que usam o mesmo comando opencode.

Solução: rode npm install -g opencode-ai@latest, confirme que opencode --version mostra 1.18.30 ou superior e repita /connect, digitando deepseek na busca.

Prevenção: atualize o OpenCode antes de configurar novos provedores e evite manter duas gerações instaladas.

Provider not found

Causa: no opencode.json, o nome do provedor e o prefixo do modelo divergem, como declarar o provedor como deepseek e escrever o modelo com outro prefixo.

Solução: faça os dois coincidirem exatamente, por exemplo deepseek e deepseek/identificador, usando o identificador que o /models mostra.

Prevenção: copie o identificador do próprio /models em vez de digitar de memória ou de copiar de tutoriais antigos.

API key not set (Hermes) ou erro citando DEEPSEEK_API_KEY (Kimi)

Causa: a chave não chegou ao processo: no Hermes ela não foi gravada no .env, e no Kimi a variável não existe na janela atual porque o setx foi executado sem reabrir o terminal.

Solução: no Hermes rode hermes model ou hermes config set DEEPSEEK_API_KEY com a chave; no Kimi refaça o setx, abra um terminal novo e confirme com echo $env:DEEPSEEK_API_KEY.

Prevenção: valide a variável com echo antes de abrir qualquer agente.

Erro 400 em sessão com raciocínio ligado

Causa: relatos de comunidade indicam que a API recusa a requisição quando o campo reasoning_content devolvido pelo modelo não é reenviado no histórico, comportamento ligado ao modo de raciocínio e à troca silenciosa do snapshot em 17 de outubro.

Solução: atualize o agente para a versão mais recente, que trata esse campo; no Kimi Code CLI o tipo openai já o gerencia, e no OpenCode vale seguir a versão indicada pelo DeepSeek. Se persistir, abra uma nova sessão com /new.

Prevenção: mantenha os agentes atualizados e leia as notas de versão depois de qualquer anúncio de modelo do DeepSeek.

Gostou do passo a passo? Veja os vídeos de automação, agentes e ferramentas práticas em @CanalQb no YouTube e conte nos comentários qual agente você ativou primeiro.

Fontes e referências

Todas as informações foram conferidas em 22 de outubro de 2026 nas páginas abaixo; preços, versões e nomes de modelo mudam, então confirme nas fontes oficiais antes de decidir.

jjjjjjj

Planilha DuplaSena que se Atualiza Sozinha (2026)

noreply@blogger.com (CanalQb) — Sun, 18 Oct 2026 20:58:44 -0300

@CanalQb no YouTube

Planilha Dupla Sena que se Atualiza Sozinha (2026)

Leitura: ~13 min

TL;DR:

Fiz uma planilha de Dupla Sena que puxa sozinha os resultados oficiais da API da CAIXA - ela montou o histórico completo e recalculou todas as estatísticas em segundos - isso importa porque você nunca mais vai digitar dezena nenhuma à mão.
A mesma aposta concorre em DOIS sorteios de 6 dezenas (01 a 50), às segundas, quartas e sextas - a planilha confere os dois automaticamente e mostra quantas apostas simples premiadas seu jogo tem em cada faixa - isso importa porque é exatamente assim que apostas de 7 a 15 dezenas pagam em Sena, Quina, Quadra e Terno.
Ela gera 48 jogos por tamanho de aposta (QUENTE, FRIO, NEUTRO, 18 MISTOS, MÉDIA, HARMÔNICA e FIBONACCI) - com conferência de acertos nos dois sorteios, célula verde e botão de copiar para a lotérica - recomendo para quem quer analisar com dados reais, sem promessa de ganho (loteria é jogo de azar).

Aviso importante: Este conteúdo é estritamente informativo e educacional. A planilha não garante ganhos nem aumenta suas chances de premiação — loteria é um jogo de azar e cada sorteio é independente. Destinado a maiores de 18 anos. Jogue com responsabilidade e nunca aposte o que não pode perder. O @CanalQb não tem vínculo com a CAIXA Econômica Federal nem com a loteriascaixa.gov.br.

Uma aposta de 15 dezenas na Dupla Sena custa R$ 15.015,00 e vale 5.005 combinações.

Pois é: quando você marca mais de 6 dezenas, está comprando milhares de apostas simples de uma vez — e cada uma delas concorre nos dois sorteios do mesmo concurso. A planilha que vou mostrar entende essa matemática e ainda se atualiza sozinha pela API oficial da CAIXA. Aqui está o detalhe que quase ninguém percebe: o que separa um jogo caro de um jogo bem conferido é saber exatamente quantas combinações premiadas ele tem em cada faixa — e é isso que as colunas de COMBIN da planilha revelam no fim deste post.

O que é a Dupla Sena e como funcionam os dois sorteios?

A Dupla Sena é a loteria da CAIXA em que você marca de 6 a 15 dezenas (de 01 a 50) e a mesma aposta concorre em dois sorteios de 6 dezenas no mesmo concurso, realizados às segundas, quartas e sextas. Os prêmios são pagos em quatro faixas: Sena (6 acertos), Quina (5), Quadra (4) e Terno (3), com percentuais diferentes em cada sorteio.

No primeiro sorteio, a Sena leva 30% do prêmio bruto, a Quina 10%, a Quadra 8% e o Terno 4%. No segundo sorteio, os percentuais mudam para 11%, 9%, 8% e 4%. Outros 16% da arrecadação são reservados para o Concurso Especial de Páscoa. É a única modalidade que dá duas chances reais com o mesmo bilhete — e por isso a conferência precisa olhar DOIS resultados, não um.

As chances oficiais por faixa, em cada sorteio, são estas:

Faixa (acertos)	Chance (1 em...)	% do prêmio bruto no Sorteio 1	% no Sorteio 2
Sena (6)	15.890.700	30%	11%
Quina (5)	60.192	10%	9%
Quadra (4)	1.120	8%	8%
Terno (3)	60	4%	4%
Acumulação	16% da arrecadação	Destinados ao Concurso Especial de Páscoa

Repare no salto entre faixas: acertar 4 números é cerca de 54 vezes mais provável do que acertar 5. E o melhor? Uma aposta maior pega várias faixas ao mesmo tempo, como você vai ver na prática mais abaixo.

Como a planilha se atualiza sozinha pela API da CAIXA?

O código em Apps Script consulta a API oficial de Dupla Sena da CAIXA (servicebus2.caixa.gov.br), compara o último concurso salvo na planilha com o último publicado e importa apenas os concursos que faltam. Na primeira execução ele baixa o histórico completo; nas seguintes, só os novos resultados, sem duplicar linha nenhuma.

O endereço consultado é o portal oficial Loterias CAIXA, via servicebus2.caixa.gov.br/portaldeloterias/api/duplasena, com uma API alternativa como fallback quando a CAIXA recusa conexões seguidas — comportamento que observamos em testes reais. Tudo entra na aba "Todos os Jogos", com o concurso mais recente sempre na linha 2.

Na primeira vez, o script baixa todos os concursos publicados desde 26/07/2001 de uma vez. Depois disso, a rotina é incremental: ele pergunta à API qual é o último concurso, compara com o que você já tem e baixa só a diferença, com uma pausa de 300 ms entre consultas para não sobrecarregar o serviço. Aqui no @CanalQb, validamos que esse intervalo evita o erro de "conexão recusada" que aparece quando se fazem chamadas em rajada.

Instalação em 2 minutos: Extensões, Apps Script, colar o código e salvar. Nenhuma configuração extra.
Atualização incremental: só os concursos novos entram na planilha, mantendo o histórico íntegro.
Fallback automático: se a API principal falhar, uma segunda API responde pelos concursos.
A API às vezes recusa chamadas seguidas; o script avisa e basta tentar de novo em alguns instantes.

Quanto custa apostar em 6, 7, 8 ou mais dezenas na Dupla Sena?

A aposta simples (6 dezenas) custa R$ 3,00 e vale nos dois sorteios. Cada dezena extra multiplica as combinações de 6: 7 dezenas equivalem a 7 apostas (R$ 21,00), 10 dezenas a 210 apostas (R$ 630,00) e 15 dezenas a 5.005 apostas (R$ 15.015,00). O preço é sempre a combinação C(n;6) multiplicada por R$ 3,00.

Mas tem um porém: quase ninguém calcula C(n;6) na cabeça, e é por isso que apostadores se assustam no caixa. A tabela oficial completa, que a planilha reproduz em cada aba de jogo, é esta:

Dezenas marcadas	Combinações de 6 (C(n;6))	Custo (R$ 3,00 por simples)
6 dezenas	1	R$ 3,00
7 dezenas	7	R$ 21,00
8 dezenas	28	R$ 84,00
9 dezenas	84	R$ 252,00
10 dezenas	210	R$ 630,00
11 dezenas	462	R$ 1.386,00
12 dezenas	924	R$ 2.772,00
13 dezenas	1.716	R$ 5.148,00
14 dezenas	3.003	R$ 9.009,00
15 dezenas	5.005	R$ 15.015,00

Lembre-se: cada uma dessas combinações concorre nos dois sorteios. É por isso que a planilha cria uma aba por tamanho de aposta, de "Jogo 06" a "Jogo 15" — o gerador de jogos precisa saber quantas dezenas ele está montando antes de calcular dezena e preço.

Como usar a planilha passo a passo (menu item a item)?

Depois de colar o script, aparece o menu "Dupla Sena" na barra da planilha. A ordem recomendada é: primeira vez, "Atualizar Resultados" e depois "Gerar Jogos"; no dia a dia, apenas "Atualizar Tudo" ou marcar o checkbox da célula A6 de qualquer aba de jogo, que desmarca sozinho ao terminar.

Cada item do menu tem um papel específico:

Atualizar Tudo (botão): faz tudo de uma vez — importa resultados, recalcula estatísticas, gera o DashBoard e recria as abas de jogos. É o único comando de que você precisa depois da instalação.
Como usar (aba Inicio): recria a aba de manual, com a explicação de menu, abas e conceitos que estou resumindo aqui.
Atualizar Resultados: baixa os concursos oficiais da API da CAIXA para a aba "Todos os Jogos". Sem histórico, nada mais funciona — é sempre o primeiro passo.
Recalcular Estatísticas: reescreve a aba "Estatísticas" com base no histórico importado, incluindo frequência, atrasos, paridade e faixas oficiais.
Atualizar DashBoard: recria a aba "DashBoard" com gráficos de frequência por dezena, pares x ímpares, faixas e paridade dos sorteios.
Gerar Jogos: cria as abas "Jogo 06" a "Jogo 15", cada uma com 48 jogos: 10 QUENTE, 10 FRIO, 10 NEUTRO e a seção lilás JOGOS MISTOS com 18 jogos (Q+F, Q+N, F+Q, F+N, N+Q, N+F), mais os jogos MÉDIA, HARMÔNICA e FIBONACCI.
Copiar Jogos para Aposta: abre uma janela com todos os jogos prontos para copiar com Ctrl+C e levar à lotérica, no formato "aba, tipo, dezenas".
Deletar Todas as Abas (manter Inicio): apaga tudo exceto o manual, para começar do zero. Pedirá confirmação antes.
Verificar Instalação: mostra se as abas necessárias existem e o estado geral da planilha.

Aqui está o detalhe que quase ninguém percebe: o checkbox da célula A6 instala um gatilho invisível que roda "Atualizar Tudo" a cada marcação. Ou seja, você atualiza histórico, estatísticas, dashboard e jogos com um clique só, de dentro da aba que você já está usando para conferir seus jogos.

O que significam as estatísticas de QUENTE, NEUTRO e FRIO na aba Estatísticas?

QUENTE, NEUTRO e FRIO são rótulos de ranking: as dezenas mais sorteadas do histórico ficam QUENTE, as menos sorteadas FRIO e as do meio NEUTRO. Cada concurso contribui com dois sorteios (Sorteio 1 e Sorteio 2), então a contagem é por sorteio, não por concurso.

A aba "Estatísticas" vai muito além do ranking. Para cada dezena de 01 a 50 ela mostra frequência, probabilidade por sorteio, atraso atual, atraso médio e atraso máximo. Depois, blocos temáticos: soma das dezenas (média, mínima e máxima), amplitude, repetições do concurso anterior, quantidade de números primos e de Fibonacci por sorteio, distribuição por faixa de dezenas (01-10 até 41-50), por quadrante do volante (01-12, 13-25, 26-37 e 38-50) e a paridade de cada sorteio.

Duas linhas merecem atenção especial. A primeira é o teste de aleatoriedade (chi²): com 50 dezenas, o valor crítico é 66,3 (5% de significância, 49 graus de liberdade). Quando o chi² calculado fica abaixo disso — como observamos no histórico da Dupla Sena —, a evidência estatística é de que as dezenas saem de forma uniforme, como esperado em um sorteio honesto. Tradução prática: nenhuma dezena é "mais sorteável" que outra, e o chi² é a prova matemática disso.

A segunda é o aviso sobre atrasos: a planilha lista os maiores atrasos atuais, mas é explícita em dizer que atraso NÃO aumenta a chance de a dezena sair. Cada sorteio é independente — uma dezena que há 40 concursos não sai tem exatamente a mesma probabilidade de qualquer outra. Este é o tipo de honestidade estatística que você também encontra no nosso guia sobre estatísticas de loterias.

Como ler as abas de jogo: Ac?, MÉDIA, HARMÔNICA, FIBONACCI e a célula verde?

Cada aba "Jogo NN" tem 48 jogos: 30 sorteados por tipo (10 QUENTE, 10 FRIO, 10 NEUTRO), 18 mistos (seção lilás JOGOS MISTOS: metade das dezenas de um pool + metade de outro, como Q+F e N+Q), 12 linhas extras de MÉDIA, HARMÔNICA e FIBONACCI, as colunas "Acertos S1" e "Acertos S2" e oito colunas de faixas calculadas por COMBIN (Sena, Quina, Quadra e Terno em cada sorteio). Escolhendo o concurso na célula C3, os dois sorteios preenchem as linhas 4 e toda a conferência é automática - os mistos entram nela como qualquer outro jogo.

O funcionamento é este:

Célula C3 (Escolha): lista suspensa com os concursos do histórico. As dezenas dos dois sorteios preenchem F4:K4 e M4:R4 automaticamente via INDEX/MATCH.
Acertos S1 e S2: contam quantas dezenas do jogo saíram em cada sorteio, via SUMPRODUCT com COUNTIF. Ficam vazios enquanto nenhum concurso estiver escolhido.
Célula verde: formatação condicional que pinta de verde toda dezena que saiu no Sorteio 1 do concurso escolhido. É a leitura visual rápida de quais jogos "pegaram" o primeiro sorteio.
MÉDIA (GERAL/QUENTE/FRIO/NEUTRO): jogos formados pela média aritmética das dezenas de cada grupo — o "centro" estatístico do conjunto.
HARMÔNICA: a média harmônica pondera mais as dezenas menores (é o inverso da média dos inversos), gerando jogos puxados para a metade baixa do volante. Comparar MÉDIA com HARMÔNICA mostra duas referências opostas de "equilíbrio".
FIBONACCI: jogos montados com dezenas da sequência de Fibonacci e suas variações (1, 2, 3, 5, 8, 13, 21, 34), completadas por frequência quando faltam dezenas.
Checkbox A6: marque para rodar "Atualizar Tudo" sem sair da aba; ele desmarca sozinho ao terminar.
Copiar Jogos para Aposta: junta os jogos de todas as abas em uma janela única com botão de copiar.

E aqui está o insight técnico que fecha o open loop do início: as colunas "S1 Sena/Quina/Quadra/Terno" e "S2 Sena/Quina/Quadra/Terno" usam a fórmula COMBIN(acertos; faixa) vezes COMBIN(dezenas menos acertos; 6 menos faixa). Um jogo de 8 dezenas contém 28 combinações de 6; se ele acertou 4 dezenas no Sorteio 1, a coluna "S1 Quadra" mostra em quantas dessas 28 combinações você garantiu os 4 pontos — e o mesmo cálculo se repete para Terno, Quina e, matematicamente impossível aqui, Sena. É assim que uma aposta maior vira várias premiações simultâneas, e é por isso que conferir um jogo de 15 dezenas "na mão" é inviável: 5.005 combinações vezes duas faixas de sorteio. A planilha faz isso em milissegundos, para cada uma das 42 linhas de jogo. Se você quer entender a base matemática, veja também nosso material sobre automação com Apps Script.

Vale a pena baixar esta planilha de Dupla Sena em 2026?

Vale se você quer conferir, analisar e organizar apostas com dados oficiais atualizados, sem trabalho manual. A planilha automatiza histórico, estatísticas, geração e conferência de jogos nos dois sorteios — mas nada nela prevê resultados, porque loteria é jogo de azar e cada sorteio é independente.

Fizemos a ferramenta para resolver três dores reais: digitar resultados à mão (resolvido pela API da CAIXA), calcular o preço de apostas maiores (resolvido pela tabela C(n;6) por R$ 3,00) e conferir dezenas acertadas faixa a faixa (resolvido pelo COMBIN nas colunas S1/S2). O resto — escolher o jogo, respeitar o orçamento, jogar por diversão — continua sendo com você. Para mais ferramentas do mesmo tipo, confira nosso material sobre planilhas de loteria aqui no blog.

Perguntas Frequentes

Como fazer a planilha de Dupla Sena buscar os resultados da CAIXA sozinha?

A planilha de Dupla Sena aumenta a chance de ganhar na loteria?

Por que a mesma aposta de Dupla Sena concorre em dois sorteios?

Quanto custa apostar em mais de 6 dezenas na Dupla Sena?

O que significam os jogos MÉDIA, HARMÔNICA e FIBONACCI nas abas de jogo?

A planilha de Dupla Sena funciona no Excel ou só no Google Sheets?

📚 Fontes e Referências

Baixe a planilha de Dupla Sena que se atualiza sozinha e acompanhe tudo no canal @CanalQb no YouTube.

Feito com Master Rules Claude v8.5

Comprar

Leve a planilha completa, com histórico, estatísticas, gerador e conferência nos dois sorteios.

Achar a Planilha Mestre do Google Apps Script em 5 Passos

noreply@blogger.com (CanalQb) — Tue, 13 Oct 2026 21:14:44 -0300

@CanalQb no YouTube

Achar a Planilha Mestre do Google Apps Script em 5 Passos

Leitura: ~18 min

TL;DR:

O e-mail “Summary of failures for Google Apps Script” costuma citar o nome do projeto e, se o script for vinculado a Sheets, Docs ou Forms, traz também o link do arquivo: comece por ele.
Uma função curta com getActiveSpreadsheet(), getName(), getId() e getUrl() entrega nome, ID e URL da planilha mestre em segundos, direto no Registro de execução.
Se a função retornar null, o script é independente: use as propriedades do script, os acionadores e a busca no Drive para chegar ao arquivo certo.

O e-mail de falha do Apps Script avisa que algo quebrou e esconde o quê.

Ele chega sem alarde, geralmente de madrugada, com a mesma frase de sempre sobre um script que não terminou com sucesso. Para quem tem um único projeto, isso é um incômodo. Para quem acumulou anos de automações, é um quebra-cabeça: qual dos seus projetos, ligado a qual planilha, falhou desta vez?

Aqui no @CanalQb, a regra que seguimos é simples: se um script falha, ele precisa dizer a quem pertence. Neste post você vai aprender a descobrir a planilha mestre de qualquer projeto, entender cada linha da função que faz isso e, no final, evoluir o script para que ele mesmo mande o endereço do arquivo no próprio aviso de erro. Guarde esta pergunta: o que acontece quando o script não está vinculado a nenhuma planilha? A resposta vem na sétima seção.

Quais são as soluções rápidas para achar a planilha de um script que falhou?

A busca costuma terminar em minutos quando você segue uma ordem fixa: ler o e-mail, localizar o projeto pelo nome, rodar uma função de diagnóstico e só então mexer em acionadores. Estes são os atalhos para os cinco problemas mais comuns, cada um ligado ao catálogo completo mais abaixo.

Não sei qual é a planilha: abra o e-mail e procure o link do arquivo; ele só aparece quando o script é vinculado. ver passo completo
Não sei qual é o projeto: copie o nome citado no e-mail e procure em script.google.com/home. ver passo completo
getActiveSpreadsheet() devolveu null: o script é independente; abra o arquivo pelo ID com openById. ver passo completo
Authorization is required: execute a função uma vez no editor e aprove as permissões. ver passo completo
O e-mail não para de chegar: corrija ou apague o acionador que está falhando. ver passo completo

Por que o e-mail “Summary of failures” não diz qual é a planilha mestre?

O e-mail existe para avisar que um acionador falhou, não para inventariar seus arquivos. Ele costuma trazer o nome do projeto, a função, a mensagem de erro e o tipo de acionador. A planilha só ganha um link quando o script é vinculado a ela; fora disso, você precisa de método para chegar até ela.

Funciona assim na prática. Ao longo de anos você criou automações para tudo: um disparador de e-mails, um robô que atualiza cotações, uma rotina que organiza pedidos. Cada uma nasceu em um momento diferente, quase sempre pelo menu Extensões, e muitas ficaram com o nome padrão “Projeto sem título”. Um acionador por tempo, criado numa tarde esquecida, continua rodando de madrugada, mesmo que ninguém lembre mais por quê.

Num dia comum chega o aviso. Ele fala em falha, mostra uma função chamada atualizarDados e uma mensagem sobre autorização. O problema é que você tem dezenas de projetos e pelo menos cinco deles possuem uma função com esse nome. Abrir um por um, na esperança de reconhecer o código, é a pior estratégia: consome a tarde inteira e ainda existe o risco de editar o projeto errado.

O raciocínio correto inverte o problema. Em vez de perguntar “qual projeto é esse?”, pergunte “qual arquivo esse projeto manipula?”. Quando você descobre a planilha mestre, aquela que guarda os dados que o script lê e altera, o resto se resolve sozinho: o editor do script está a dois cliques dali, o dono do arquivo aparece nas permissões e o histórico de versões mostra quando algo mudou. É isso que as próximas seções constroem, passo a passo, até o script conseguir se apresentar sozinho quando quebrar.

Uma limitação importante: nenhum método deste post funciona se você não tiver acesso à conta Google que recebe o e-mail. As notificações vão para quem criou o acionador, e só essa conta enxerga o projeto e seus acionadores. Se o aviso chegou numa conta de trabalho antiga, o primeiro passo é recuperar o acesso, não escrever código.

O que é uma planilha mestre e como o tipo de script muda a busca?

Planilha mestre é o arquivo que serve de base para o script: onde ficam os dados processados ou onde o projeto foi criado. Há dois tipos de projeto, vinculado e independente, e o tipo decide qual caminho de busca funciona. Identificar o tipo vem antes de qualquer diagnóstico.

Um script vinculado (container-bound) nasce dentro de uma planilha, documento, apresentação ou formulário, pelo menu Extensões. Esse arquivo é chamado de contêiner. Segundo a explicação publicada por um autor especializado em permissões, o script vinculado não aparece na listagem do Drive, não pode ser desvinculado do arquivo e herda a lista de acesso do contêiner: quem edita a planilha pode editar o script. Já o script independente (standalone) é um projeto próprio, que aparece entre seus arquivos do Drive e abre outros arquivos por ID.

Essa diferença muda tudo na hora de achar a planilha. No vinculado, a função getActiveSpreadsheet() devolve o arquivo na hora. No independente, não existe planilha ativa, e a documentação oficial é clara ao dizer que o método devolve null quando não há planilha. Nesse caso o vínculo entre projeto e planilha está escrito dentro do código (um openById) ou guardado em alguma propriedade.

Tipo de script	Onde ele aparece	getActiveSpreadsheet()	Como achar a planilha mestre
Vinculado (container-bound)	Dentro do arquivo, em Extensões > Apps Script	Retorna a planilha vinculada	Rodar a função de diagnóstico ou abrir o arquivo pelo link do e-mail
Independente (standalone)	Em script.google.com/home e entre os arquivos do Drive	Retorna null	Procurar openById no código, propriedades do script, acionadores

Existe ainda uma armadilha de sentido único. Uma discussão técnica no fórum de desenvolvedores do Google concluiu que, a partir do ID de uma planilha, não há caminho confiável pelas APIs para descobrir o ID do script vinculado a ela: o contêiner não conhece o script, e scripts vinculados não aparecem como filhos do arquivo no Drive. A rota segura é sempre do script para a planilha, nunca o contrário, e é por isso que o script precisa carregar a própria etiqueta.

O que o e-mail “Summary of failures” revela antes de qualquer código?

Antes de abrir o editor, o e-mail já entrega pistas valiosas: o nome do projeto, a função que falhou, a mensagem de erro, o tipo de acionador e os horários. A documentação oficial acrescenta que, se o script estiver vinculado a Sheets, Docs ou Forms, o e-mail inclui o link do arquivo.

Um e-mail de falha antigo, publicado em um blog como pedido de ajuda, mostra a estrutura típica: uma frase dizendo qual script falhou, um link para configurar os acionadores e uma tabela com as colunas Start, Function, Error Message, Trigger e End. Cada coluna é uma pista diferente. A coluna Function diz o nome da função; a coluna Trigger revela se foi um acionador por tempo, de edição ou de formulário; a coluna Start dá o horário, que você vai cruzar com a lista de execuções do projeto.

As mensagens de erro mais comuns, segundo um guia especializado em Google Workspace, são: tempo máximo de execução excedido, uso excessivo de tempo de processamento em um dia e falta de autorização. Cada uma aponta para uma causa diferente. Falta de autorização costuma indicar que o script ganhou um serviço novo e ninguém aprovou as permissões. Tempo excedido sugere um laço grande demais ou uma planilha que cresceu além do esperado.

Há ainda um detalhe curioso: as fontes divergem sobre o endereço de quem envia. O exemplo da documentação oficial mostra um remetente que começa com noreply, enquanto um guia independente cita outro formato. Como não dá para confirmar qual vale hoje, o critério seguro é filtrar no Gmail por apps-scripts-notifications e conferir se o domínio termina em google.com. E atenção a uma limitação: relatos antigos mostram que o link de configuração do e-mail às vezes responde com erro 403, especialmente se você estiver logado em outra conta no navegador. Se isso acontecer, abra o link numa janela anônima, entrando apenas com a conta correta.

Como localizar o projeto certo em script.google.com/home?

Use o nome do projeto citado no e-mail para pesquisar em script.google.com/home, abra o projeto e confira as abas Execuções e Acionadores. O horário da falha liga o e-mail à execução exata. Em cinco passos você sai do aviso genérico até o código culpado.

Passo 1: anote três dados do e-mail. Copie o nome do projeto, o nome da função e o horário da falha. Esses três dados formam a “impressão digital” da falha. Sem o horário, duas funções com o mesmo nome ficam indistinguíveis; sem o nome do projeto, a busca vira loteria. Quando der certo, você terá uma anotação simples de três linhas. Erro comum: confiar na memória e voltar ao e-mail cinco vezes.

Passo 2: abra script.google.com/home com a conta certa. O endereço script.google.com/home lista seus projetos. Esse passo existe porque o painel mostra apenas os projetos da conta logada, então a conta errada devolve uma lista vazia ou incompleta. Resultado esperado: sua lista de projetos, com nomes e datas de modificação. Erro comum: estar logado em várias contas e achar que o projeto sumiu; troque de conta no canto superior direito.

Passo 3: pesquise pelo nome do projeto. Use a barra de busca do painel. Se o projeto estiver como “Projeto sem título”, ordene por data de modificação e abra os mais antigos primeiro, pois acionadores esquecidos quase sempre vivem em projetos que ninguém edita há meses. Resultado esperado: um ou poucos projetos candidatos.

Passo 4: confira Execuções. No menu lateral do projeto, procure a seção de execuções (o rótulo pode variar conforme a versão da interface). Ela lista cada execução com função, horário e status. Procure a linha cujo horário coincide com o do e-mail. Esse passo confirma que você abriu o projeto certo antes de mexer em qualquer coisa. Se nenhuma execução bater, o candidato está errado: volte ao passo 3.

Passo 5: confira Acionadores. Na seção de acionadores você vê quais funções rodam sozinhas, em que frequência e se alguma está falhando. É aqui que você vai agir no final do post. Resultado esperado: uma lista com a função do e-mail e seu tipo de evento. Erro comum: apagar o acionador antes de descobrir a planilha; apague só depois de entender o que o script faz.

Como a função descobrirPlanilhaMestre funciona linha a linha?

A função pede ao Apps Script a planilha ativa e registra seu nome, ID e URL no log. Em um script vinculado, esses três valores identificam o arquivo mestre sem ambiguidade. Se não houver planilha ativa, ela avisa em vez de quebrar.

function descobrirPlanilhaMestre() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();

  if (!ss) {
    Logger.log("Nenhuma planilha vinculada: este script parece ser independente.");
    return;
  }

  Logger.log("Nome: " + ss.getName());
  Logger.log("ID: " + ss.getId());
  Logger.log("URL: " + ss.getUrl());
}

function descobrirPlanilhaMestre() { declara a função. O nome importa porque é ele que você escolhe no menu suspenso do editor antes de clicar em Executar. Dê um nome descritivo; funções chamadas teste1 viram problema daqui a seis meses.

const ss = SpreadsheetApp.getActiveSpreadsheet(); pede o arquivo ativo ao serviço SpreadsheetApp, o ponto de entrada para o Google Sheets. A variável ss guarda um objeto Spreadsheet (ou null). Em script vinculado, o objeto aponta para o arquivo ao qual o projeto está preso, mesmo quando a execução vem de um acionador por tempo, sem ninguém com a planilha aberta.

if (!ss) { ... return; } é a cláusula de guarda. O ponto de exclamação significa “não existe”; se ss for null, a função registra o aviso e termina. Sem ela, a linha seguinte tentaria chamar um método em null e geraria um erro confuso (veja o primeiro card de erros).

ss.getName() devolve o nome visível do arquivo, o mesmo do topo da planilha. ss.getId() devolve o identificador único, que também é o trecho da URL entre /d/ e /edit. ss.getUrl() devolve o endereço completo, pronto para colar no navegador. Os três juntos têm propósitos diferentes: o nome é para humanos, o ID é para código e a URL é para abrir o arquivo com um clique.

Logger.log(...) escreve no Registro de execução. Para rodar: escolha a função no seletor, clique em Executar, aprove as permissões na primeira vez e abra o Registro de execução. A saída esperada tem este formato (valores de exemplo):

Nome: Controle de Vendas 2026
ID: 1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789
URL: https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789/edit

Erro comum: o log aparecer vazio porque você executou outra função do seletor. Confira o nome na barra antes de clicar.

Como montar um diagnóstico completo do projeto, indo além do nome da planilha?

Estenda a função para registrar também o ID do próprio script, o tipo do projeto, as abas da planilha e todos os acionadores. Assim você sai com um retrato completo em uma única execução, útil para comparar projetos parecidos.

function diagnosticoDoProjeto() {
  const info = {
    scriptId: ScriptApp.getScriptId(),
    tipo: "",
    planilha: null,
    gatilhos: []
  };

  const ss = SpreadsheetApp.getActiveSpreadsheet();

  if (ss) {
    info.tipo = "vinculado (container-bound)";
    info.planilha = {
      nome: ss.getName(),
      id: ss.getId(),
      url: ss.getUrl(),
      abas: ss.getSheets().map(aba => aba.getName())
    };
    try {
      info.planilha.dono = ss.getOwner() ? ss.getOwner().getEmail() : "indisponível";
    } catch (erro) {
      info.planilha.dono = "sem permissão para ler";
    }
  } else {
    info.tipo = "independente (standalone)";
  }

  ScriptApp.getProjectTriggers().forEach(t => {
    info.gatilhos.push({
      funcao: t.getHandlerFunction(),
      evento: String(t.getEventType()),
      origem: String(t.getTriggerSource()),
      origemId: t.getTriggerSourceId()
    });
  });

  Logger.log(JSON.stringify(info, null, 2));
  return info;
}

ScriptApp.getScriptId() devolve o ID do projeto de script, não o da planilha. Esse número resolve um problema clássico: você abre o editor, copia o ID do projeto e sabe exatamente qual deles gerou o aviso. Ele aparece na URL do editor e em Configurações do projeto.

O objeto info é uma ficha que você preenche aos poucos. Reunir tudo em um objeto e imprimir uma vez só com JSON.stringify(info, null, 2) gera uma saída indentada, fácil de ler no log e de copiar para uma anotação.

ss.getSheets().map(...) percorre todas as abas e devolve só os nomes. Vale como confirmação visual: se as abas se chamam Pedidos e Estoque, você já sabe de que negócio o arquivo trata. A seta (a notação com igual e maior) é uma função curta escrita em uma linha.

O bloco try/catch em volta de getOwner() existe porque o dono pode não ser acessível: arquivos em unidades compartilhadas ou sob política de administrador podem devolver vazio ou erro. Em vez de derrubar o diagnóstico inteiro, a função registra “sem permissão para ler” e segue em frente.

ScriptApp.getProjectTriggers() lista todos os acionadores do projeto. Para cada um, getHandlerFunction() diz qual função roda, getEventType() diz o tipo de evento e getTriggerSource() diz a origem. O getTriggerSourceId() pode trazer o ID do arquivo que dispara acionadores de edição ou de abertura, e costuma vir vazio nos acionadores por tempo. Resultado esperado: um JSON com a planilha e uma lista de acionadores. Limitação: o diagnóstico só enxerga acionadores da conta que executa a função.

E se o script for independente e getActiveSpreadsheet() devolver null?

Quando o resultado é null, o projeto não está preso a uma planilha. Procure openById no código, confira as propriedades do script, olhe a origem dos acionadores e, como último recurso, busque pelo nome no Drive. O vínculo existe, só está escondido.

A primeira pista é o próprio código. Abra cada arquivo do projeto e procure os termos openById, getFileById e openByUrl. Quase todo script independente que mexe em planilha usa um deles, e o argumento é o ID do arquivo. Copie esse ID e monte a URL assim: https://docs.google.com/spreadsheets/d/ID/edit. Se o ID estiver numa constante no topo do arquivo, melhor ainda.

A segunda pista são as Propriedades do script, um espaço de armazenamento que sobrevive entre execuções. Muita gente guarda ali o ID para não deixá-lo exposto no código. O padrão recomendado é este:

function definirPlanilhaMestre() {
  PropertiesService.getScriptProperties()
    .setProperty("PLANILHA_MESTRE_ID", "COLE_O_ID_AQUI");
}

function abrirPlanilhaMestre() {
  const id = PropertiesService.getScriptProperties()
    .getProperty("PLANILHA_MESTRE_ID");

  if (!id) {
    throw new Error("PLANILHA_MESTRE_ID não definido nas propriedades do script.");
  }
  return SpreadsheetApp.openById(id);
}

A função definirPlanilhaMestre() roda uma única vez, grava o ID e nunca mais é necessária. A função abrirPlanilhaMestre() lê o valor, valida e abre o arquivo; se a propriedade estiver ausente, ela lança um erro com mensagem clara, o que é muito melhor do que um null silencioso. Substitua em todo o projeto as chamadas diretas a getActiveSpreadsheet() por abrirPlanilhaMestre() e o script passa a funcionar tanto vinculado quanto independente.

A terceira pista é a busca no Drive, para quando o código não ajuda:

function buscarPlanilhasPorNome(trecho) {
  const consulta = "mimeType = 'application/vnd.google-apps.spreadsheet' and title contains '" + trecho + "'";
  const arquivos = DriveApp.searchFiles(consulta);

  while (arquivos.hasNext()) {
    const arq = arquivos.next();
    Logger.log(arq.getName() + " | " + arq.getId() + " | " + arq.getUrl());
  }
}

A consulta filtra apenas planilhas do Google e nomes que contenham o trecho informado. Não passe apóstrofos no trecho, pois eles quebram a consulta, e saiba que a função exige permissão de acesso ao Drive. Para chamá-la, crie um wrapper sem parâmetros que passe o trecho desejado, já que o botão Executar não permite informar argumentos.

Como fazer o script se identificar sozinho quando falhar?

Envolva suas rotinas em uma função que captura o erro e envia um e-mail com o nome da rotina, o ID do script e a URL da planilha. Registre também o ID do script como metadado dentro da própria planilha. Assim a pergunta “qual é o projeto?” deixa de existir.

Esta é a evolução da história: você encontrou a planilha uma vez, mas quer nunca mais repetir a caçada. O padrão a seguir é um envelope de erro. Em vez de chamar atualizarDados() direto no acionador, você chama executarComAviso("atualizarDados", atualizarDados).

function executarComAviso(nomeRotina, rotina) {
  try {
    rotina();
  } catch (erro) {
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    const link = ss ? ss.getUrl() : "(independente: veja as propriedades do script)";

    MailApp.sendEmail(
      Session.getEffectiveUser().getEmail(),
      "[Falha] " + nomeRotina,
      "Rotina: " + nomeRotina + "\n" +
      "Erro: " + erro.message + "\n" +
      "Planilha mestre: " + link + "\n" +
      "Script ID: " + ScriptApp.getScriptId()
    );
    throw erro;
  }
}

O bloco try executa a rotina que você passou. Se tudo correr bem, nada acontece. Se algo lançar um erro, o bloco catch monta o link da planilha (ou um aviso, no caso independente) e envia o e-mail com MailApp.sendEmail. O destinatário vem de Session.getEffectiveUser().getEmail(), que devolve a conta sob a qual o script roda. A última linha, throw erro, relança o erro de propósito: assim a execução continua marcada como falha no painel e o aviso padrão do Google segue chegando como segunda camada de segurança. Se preferir só o seu e-mail, remova essa linha, sabendo que o painel passará a mostrar sucesso mesmo com falha.

Um detalhe que pega muita gente: ao adicionar MailApp a um script antigo, o Apps Script pede uma nova autorização. Acionadores não conseguem pedir permissão; por isso, enquanto você não executar a função manualmente uma vez, o acionador falha com a mensagem “Authorization is required”, justamente o erro que motivou este post.

A segunda camada é o carimbo dentro da planilha. Uma discussão no fórum de desenvolvedores do Google apresentou a solução “de dentro para fora”: como o contêiner não conhece o script, o script grava o próprio ID nos metadados de desenvolvedor do arquivo.

function registrarScriptNaPlanilha() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const achados = ss.createDeveloperMetadataFinder()
    .withKey("scriptId")
    .find();

  if (achados.length === 0) {
    ss.addDeveloperMetadata("scriptId", ScriptApp.getScriptId());
  }
}

O finder procura se a chave scriptId já existe; só se não existir a função adiciona, evitando duplicatas a cada execução. A partir daí, qualquer pessoa com acesso ao arquivo pode ler o metadado por script e chegar ao projeto. Limitação: metadados de desenvolvedor não aparecem na interface da planilha, então a leitura exige código.

Como parar o e-mail de falhas e evitar que o problema volte?

Com a planilha e o projeto identificados, abra a página de acionadores, corrija a causa ou apague o acionador defeituoso e salve. Depois padronize nomes e mantenha um inventário. Assim, o próximo aviso se resolve em minutos.

O guia do especialista Amit Agarwal no Digital Inspiration descreve o caminho: abra o e-mail, clique no link de configuração, entre na página de acionadores, encontre o acionador que está falhando, clique no X ao lado dele e salve. Ele lembra ainda que as notificações são agrupadas em lote, então um ou dois e-mails extras podem chegar mesmo depois da limpeza. Antes de apagar, porém, decida se a automação ainda faz falta. Um acionador que falha por falta de autorização é corrigido executando a função uma vez; um que falha por tempo excedido precisa de otimização, como processar a planilha em blocos.

Os acionadores também permitem configurar a frequência das notificações de falha. Os rótulos mudam conforme a interface, então procure por algo como “configurações de notificação de falha” dentro do próprio acionador, em vez de decorar o caminho de menus.

A prevenção está em quatro hábitos baratos:

Nomeie o projeto com a planilha: “[Controle de Vendas] Envio diário” diz tudo no e-mail de falha. Renomeie hoje os projetos “sem título”.
Guarde o ID no lugar certo: use as propriedades do script, nunca IDs espalhados pelo código, para ter um único ponto de troca.
Mantenha um inventário: uma planilha simples com colunas para nome do projeto, ID do script, planilha mestre, dono e acionadores. Cinco minutos de manutenção por trimestre evitam horas de busca.
Use o envelope de erro: toda rotina agendada passa por executarComAviso, e o e-mail já chega com o link do arquivo.

Se você quer se aprofundar, veja outros posts do canal sobre Google Apps Script, planilhas do Google Sheets e automação. Para consultar a referência oficial de cada método usado aqui, a documentação do SpreadsheetApp é a fonte mais confiável.

Perguntas frequentes sobre como achar a planilha de um script

Como descobrir qual planilha está vinculada a um script do Google Apps Script?

Abra o projeto, crie uma função que chame SpreadsheetApp.getActiveSpreadsheet() e registre getName(), getId() e getUrl() no log. Se o script for vinculado, o log mostra a planilha na hora. Se vier null, o projeto é independente e a planilha está referenciada por openById ou nas propriedades do script. Veja mais em nossos posts sobre Google Apps Script.

Por que getActiveSpreadsheet() retorna null no meu script?

Porque o método devolve null quando não existe planilha ativa, o que acontece em projetos independentes, em implantações como aplicativo da Web sem contêiner e em alguns contextos sem arquivo aberto. A solução é abrir o arquivo explicitamente com SpreadsheetApp.openById, guardando o ID nas propriedades do script para ter um ponto único de manutenção e evitar IDs espalhados pelo código.

Dá para achar o script a partir do ID da planilha?

De forma programática e confiável, não: uma discussão técnica no fórum de desenvolvedores do Google concluiu que o contêiner não conhece o script vinculado. O caminho manual é abrir a planilha e entrar em Extensões > Apps Script. Para automatizar, faça o script gravar o próprio ID nos metadados da planilha, como mostramos neste post, e consulte-os depois. Mais dicas em planilhas do Google Sheets.

Como pegar o ID da planilha pela URL do navegador?

O ID é o trecho que fica entre /d/ e /edit na URL, por exemplo docs.google.com/spreadsheets/d/ID_AQUI/edit. Copie apenas essa parte, sem barras, e use-a em openById. Se preferir não copiar nada manualmente, rode getId() em um script vinculado e pegue o valor no log. Guarde o ID em um lugar único para trocá-lo sem caçar o código. Veja também nossa seção de automação.

Como saber se o e-mail “Summary of failures” é legítimo?

Confira o remetente: a documentação oficial mostra um endereço do domínio google.com com notificações do Apps Script, e guias independentes citam variações do mesmo domínio. Desconfie de links encurtados, pedidos de senha ou anexos. O caminho mais seguro é não clicar no e-mail e abrir você mesmo script.google.com/home, onde a lista de acionadores confirma se a falha é real. Mais sobre o tema em Google Apps Script.

Erros e Soluções

Estes são os erros que mais aparecem quando se tenta descobrir a planilha de um script ou quando se executa o diagnóstico pela primeira vez. Cada card traz o texto do erro, a causa, a correção e como evitar a repetição.

TypeError: Cannot read properties of null (reading 'getName')

Causa: getActiveSpreadsheet() devolveu null porque o projeto é independente, e o código chamou getName() sem verificar.

Solução: adicione a cláusula de guarda if (!ss) antes do uso, ou troque a chamada por SpreadsheetApp.openById(id) usando o ID guardado nas propriedades do script.

Prevenção: centralize a abertura da planilha em uma única função, como abrirPlanilhaMestre(), que valide o ID e lance um erro claro.

Exception: Unexpected error while getting the method or property openById on object SpreadsheetApp

Causa: mensagem comum quando o ID está errado, o arquivo foi apagado ou a conta que executa não tem acesso à planilha.

Solução: abra o ID numa URL docs.google.com/spreadsheets/d/ID/edit com a mesma conta do script. Se o arquivo abrir, confira se o ID não tem espaços ou barras sobrando; se não abrir, peça acesso ao dono.

Prevenção: guarde o ID sem espaços nas propriedades do script e valide com um teste de abertura logo após trocar a planilha.

Authorization is required to perform that action

Causa: o script passou a usar um serviço novo, como MailApp ou DriveApp, e o acionador não pode pedir permissão sozinho.

Solução: abra o projeto, execute manualmente qualquer função que use o serviço, aprove as permissões e confirme em Acionadores se a próxima execução passa.

Prevenção: sempre que adicionar um serviço novo a uma rotina agendada, rode-a uma vez no editor antes de fechar.

Exceeded maximum execution time

Causa: a execução ultrapassou o limite de tempo, em geral por laços sobre muitas linhas ou chamadas repetidas ao Sheets dentro de um for.

Solução: leia os dados de uma vez com getDataRange().getValues(), processe em memória e grave o resultado em bloco; para volumes muito grandes, divida o trabalho em lotes.

Prevenção: evite getValue() e setValue() dentro de laços e registre o tempo das execuções para perceber a lentidão antes de falhar.

Service using too much computer time for one day

Causa: a soma das execuções do dia passou da cota de tempo de processamento da conta; acionadores muito frequentes e esquecidos costumam ser a causa.

Solução: liste os acionadores de todos os projetos, aumente o intervalo dos que rodam a cada minuto e apague os que já não têm utilidade.

Prevenção: use o inventário de projetos para revisar acionadores a cada trimestre e mantenha apenas o que está em uso.

Gostou da solução? No canal @CanalQb no YouTube mostramos a função rodando passo a passo, com planilhas e scripts de verdade. Inscreva-se para não perder as próximas automações.

Fontes e Referências

Fontes consultadas em 13/10/2026. O texto foi escrito com palavras próprias a partir delas.

Google for Developers: Class SpreadsheetApp, referência oficial de getActiveSpreadsheet() e openById.
Google for Developers: Installable Triggers, descrição oficial do e-mail de falhas e do link para o arquivo vinculado.
Google for Developers: Troubleshooting, erros de autorização e limites.
Digital Inspiration: Unsubscribe from Summary of Failure Emails, passo a passo para remover acionadores.
Google Developer forums: Get container-bound script ID from container ID, limite da busca reversa e solução com metadados.
Restricting Google App Script permissions, diferenças entre scripts vinculados e independentes.
Better Sheets: What is a bound script in Google Sheets?, definição de script vinculado e como abri-lo.

Conformidade Global: As informações refletem os serviços do Google disponíveis no momento da publicação. Interfaces, cotas e políticas mudam com frequência. Consulte a documentação oficial e o IAPP Global Privacy Directory para questões de privacidade. Este conteúdo não constitui aconselhamento jurídico.

Feito com Master Rules Claude v9.2

Atualize o opencode no Windows em 1 comando (2026)

noreply@blogger.com (CanalQb) — Mon, 12 Oct 2026 22:37:14 -0300

Pular para o conteudo

@CanalQb no YouTube

Atualize o opencode no Windows em 1 comando (2026)

Leitura: ~8 min

TL;DR

O update nativo do opencode falha em instalacoes via Scoop porque quem gerencia o binario e o gerenciador de pacotes — o caminho correto e atualizar pelo proprio Scoop.
Um unico comando instala o Scoop atualizado, o opencode na ultima versao e configura 26 modelos gratuitos da NVIDIA; aqui, o salto de versao levou 16 segundos com 26/26 modelos preservados.
O updater faz backup automatico do opencode.jsonc, confere a contagem de modelos depois do update e restaura sozinho se algo sumir; a chave gratuita sai de build.nvidia.com.

Nota Tecnica: Scripts e automacoes fornecidos tem fins exclusivamente educacionais. Teste sempre em ambiente controlado. O @CanalQb nao se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.

Transparencia de IA (Lei Felca nº 15.211/2025): este conteudo foi produzido com assistencia de IA e revisado, testado e validado na pratica pelo @CanalQb, com logs reais de execucao.

Por que o update nativo do opencode da erro no Windows?

O update nativo do opencode falha em instalacoes via Scoop porque o gerenciador de pacotes e o dono do binario: quem instala, versiona e substitui o executavel dentro de ~\scoop\apps\opencode e o Scoop. Quando o app tenta se auto-substituir, o arquivo esta em uso e a pasta pertence a outro processo. A atualizacao correta nasce de dentro do Scoop, com scoop update opencode.

O Scoop funciona com uma pasta por versao e um link current apontando para a ativa. Esse design e otimo para isolar versoes e reverter quando algo quebra, mas ele tem uma regra de ouro: ninguem substitui o executavel por fora. Quando o opencode tenta fazer isso sozinho, o Windows bloqueia o arquivo em uso e a atualizacao nativa morre com um erro generico que nao aponta o culpado.

Aqui esta o detalhe que quase ninguem percebe: o problema nao e sua maquina, sua internet nem o opencode. E o caminho de atualizacao. Vale para qualquer app gerenciado pelo Scoop — do Git ao 7-Zip, nenhum deles consegue se auto-atualizar por dentro. Quem entende esse mecanismo nunca mais perde tempo tentando o botao de update do app.

E o melhor? A solucao nao exige decorar comando nenhum. Veja agora como resolver em 1 comando so.

Como atualizar o opencode no Windows em 1 comando?

Abra o PowerShell e execute irm https://github.com/canalqb/opencode-update/releases/latest/download/install.ps1 | iex. Esse unico comando instala o Scoop se faltar, atualiza o proprio Scoop e os buckets, instala o opencode na versao mais recente se voce nao tiver, configura os 26 modelos gratuitos e deixa o comando opencode-update pronto no PATH. Depois disso, atualizar e digitar uma palavra em qualquer janela nova do PowerShell.

irm https://github.com/canalqb/opencode-update/releases/latest/download/install.ps1 | iex

O que esse comando faz, na ordem, e verificado por um CI publico no GitHub — nada de caixa preta:

Scoop atualizado: instala o gerenciador se ele nao existir e roda scoop update para renovar o nucleo e os buckets. Assim o opencode ja sai da versao mais fresca do catalogo.
opencode na ultima versao: se o app nao existir, instala; se existir, garante o refresh para a release mais nova via Scoop. Se o opencode estiver aberto, o instalador pula o refresh na hora e te avisa do por que.
26 modelos gratuitos configurados: cria ou completa o opencode.jsonc com o provider da NVIDIA e os 26 modelos recomendados, preservando o que ja existe no seu config e criando backup antes de qualquer merge.
Comando pronto: a ferramenta e implantada em %LOCALAPPDATA%\Programs\opencode-update e ganha uma entrada no PATH do usuario. A partir dai, opencode-update vira o seu atalho de atualizacao permanente.
Nao interativo: o instalador nao pergunta nada e nao travar automacao. Todas as opcoes avancadas ficam em parametros opcionais, documentados no repositorio no GitHub.

Mas tem um porem: iex executa codigo remoto, e a regra de ouro e auditar antes. Nao confie em one-liner de fonte que voce nao conhece — nem em fonte conhecida sem olhar. Baixe, leia, depois rode:

irm https://github.com/canalqb/opencode-update/releases/latest/download/install.ps1 -OutFile install.ps1
notepad install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1

Como configuro os 26 modelos gratuitos da NVIDIA?

Os modelos rodam na API integrate da NVIDIA, e a chave e gratuita: acesse build.nvidia.com, entre com sua conta e clique em "Get API Key". O instalador escreve os 26 modelos no opencode.jsonc e aceita sua chave de tres formas: parametro -NvidiaApiKey, variavel de ambiente NVIDIA_API_KEY ou resposta ao prompt em instalacao nova. Nenhuma chave fica armazenada no repositorio — ela vive apenas no seu arquivo local.

O conjunto cobre as familias que importam em 2026: GLM-5.3 (o modelo principal deste setup), Nemotron Super 49B e Ultra 253B, Llama 3.3 70B e 3.1 405B, DeepSeek V4 Pro e R1, Kimi K2 e K3, Qwen3 Coder 480B, Mistral Large 3 675B e Codestral, alem dos modelos rapidos como Nemotron Nano 8B e DeepSeek V4 Flash. A tabela completa com contextos e capacidade de reasoning esta no README do repositorio.

# opcao 1: parametro (salve o install.ps1 e rode com -File)
powershell -ExecutionPolicy Bypass -File .\install.ps1 -NvidiaApiKey "nvapi-..."

# opcao 2: variavel de ambiente antes do one-liner
$env:NVIDIA_API_KEY = "nvapi-..."
irm https://github.com/canalqb/opencode-update/releases/latest/download/install.ps1 | iex

# opcao 3: prompt — instalacao nova sem chave pergunta na hora
# (responder em branco mantem o placeholder para preencher depois)

Aqui no @CanalQb, validamos que o fluxo de chave por variavel de ambiente e o mais comodo para quem repete a instalacao em varias maquinas. E se o seu config ja tem modelos proprios, o instalador nao sobrescreve nada: ele apenas relata quantos dos 26 recomendados voce ja tem e, com -ApplyModels, adiciona so os que faltam — com backup antes.

Como garantir que meus modelos sobrevivem ao update?

O updater copia o opencode.jsonc para opencode_backups\ antes de qualquer mudanca, junto com um backup_info.txt que grava versao, hash SHA-256 e contagem de modelos. Depois do update, ele compara o hash e o numero de modelos antes e depois; se qualquer modelo sumir, o backup volta automaticamente. E verificacao de integridade, nao promessa.

Mas nao acredite em mim: acredite no log. Esta e a saida real da atualizacao que rodei no meu setup, do 1.18.31 para o 1.19.0 — 16 segundos no total, com download de 59,3 MB:

[2026-10-12 05:07:57] Session started
[2026-10-12 05:07:57] Current version: 1.18.31
[2026-10-12 05:07:57] Models configured before update: 26
[2026-10-12 05:07:57] STEP 1 OK - Backup saved to: opencode_backups\20261012_050757
[2026-10-12 05:08:12]   scoop: opencode: 1.18.31 -> 1.19.0
[2026-10-12 05:08:12]   scoop: 'opencode' (1.19.0) was installed successfully!
[2026-10-12 05:08:13] Version updated: 1.18.31 -> 1.19.0
[2026-10-12 05:08:13] Models preserved: 26/26
[2026-10-12 05:08:13] RESULT: SUCCESS

Repare no detalhe que quase ninguem percebe: o Scoop atualiza os buckets, baixa a nova versao, desinstala a antiga e religa o current — tudo dentro do modelo dele, sem tocar no seu config. O updater nao interfere nesse processo; ele apenas fotografa o estado antes e depois e age se a foto mudar para pior. Aqui no @CanalQb, validamos que essa e a arquitetura certa: automacao que protege em vez de automacao que arrisca.

O que acontece se o opencode estiver aberto durante o update?

O updater detecta processos do opencode em execucao e aborta com seguranca, sem fechar nada por conta propria. Perder uma sessao de trabalho no meio de um refactoring custa mais caro do que alguns dias de versao atrasada. Para atualizar mesmo assim, use opencode-update -KillRunning, que exige confirmacao explicita antes de encerrar as sessoes.

Esse guard nasceu de um erro real: a primeira versao do script usava taskkill /F /IM opencode.exe — e encerrou a propria sessao de trabalho que eu estava usando para escreve-lo. Nenhuma perda irreversivel, mas a licao ficou: automacao que mata processos do usuario sem perguntar e um risco de producao disfarcado de conveniencia. O resultado e um updater que trata sua sessao aberta como cargo precioso, nao como obstaculo.

Como conferir tudo antes de atualizar (modo Check)?

Execute opencode-update -Check para um relatorio sem efeitos colaterais: ele mostra se o Scoop esta disponivel, a versao do opencode, quantos modelos estao configurados, a cobertura dos 26 recomendados e quantos processos estao rodando. Em maquinas sem Scoop, ele responde FAILED sem alterar arquivo algum. E a forma segura de validar o ambiente antes do update real.

opencode-update -Check

[2026-10-12 09:38:10] CHECK MODE - report only, nothing will be changed
[2026-10-12 09:38:10] scoop available    : yes
[2026-10-12 09:38:10] opencode installed : 1.19.0
[2026-10-12 09:38:10] models configured  : 26
[2026-10-12 09:38:10] recommended models : 26/26
[2026-10-12 09:38:10] opencode running   : 6 process(es)
[2026-10-12 09:38:10] RESULT: SUCCESS - ready to update (run again without -Check)

E o insight que quase ninguem ve em automacao de pipeline: durante os testes deste projeto no GitHub Actions, um teste que passava reprovar o job. O motivo? O PowerShell 7 herda o exit code do ultimo processo nativo executado — o modo -Check do updater havia terminado com codigo 1 (Scoop ausente no runner) e contaminava o passo seguinte. A correcao foi um exit 0 explicito no final do teste. Esse padrao de bug aparece em qualquer pipeline Windows, e conhecer ele economiza horas de debug.

Existe diferenca entre opencode v1 e v2?

Sim. O Scoop tambem oferece o opencode v2 no pacote versions/opencode2, com configuracao incompativel com a v1. Este projeto atualiza o pacote principal (opencode, v1), que e o instalado na maioria das maquinas. A migracao para v2 e manual e documentada oficialmente em opencode.ai/v2/docs/migrate-v1.

Se voce depende do seu config atual de modelos, nao migrate por impulso: a incompatibilidade significa reconfigurar provider por provider. Para a maioria dos casos, manter a v1 atualizada e limpa (com este updater) e o caminho de menor risco — e a decisao de migrar fica onde deve estar: nas suas maos, com documentacao aberta.

Qual metodo de atualizacao escolher?

Existem tres caminhos: o botao nativo do app (que falha com Scoop), os comandos manuais do Scoop (que funcionam, mas nao protegem nada) e o updater deste post (que faz backup, verifica e restaura). A diferenca nao e so esforco — e nivel de protecao. A tabela abaixo resume o que cada metodo entrega.

Metodo	Pre-requisito	Preserva modelos	Seguranca de sessao	Esforco
Update nativo do app	Instalacao manual (sem Scoop)	N/A	N/A	Falha via Scoop
`scoop update opencode` manual	Decorar comandos e checar sozinho	Config nao e tocado, mas sem verificacao	Nenhuma	Medio
`opencode-update`	1 comando one-liner	Backup + verificacao + auto-restauracao	Aborta ou pede confirmacao	Minimo

Este script foi otimizado para os leitores do blog do CanalQb: cada decisao — do guard de sessao ao modo Check — existe porque falhamos sem ela primeiro. Se quiser ir alem do Scoop, veja tambem os conteudos de PowerShell aqui do blog.

Perguntas Frequentes

Por que o update nativo do opencode da erro com Scoop?

Atualizar o opencode apaga meus modelos e minha chave de API?

O comando irm | iex e seguro para instalar?

Preciso de permissao de administrador para atualizar o opencode?

Como verificar o estado do opencode antes de atualizar?

Este updater funciona com o opencode v2?

Fontes e Referencias

Repositorio canalqb/opencode-update (GitHub) — scripts, template dos 26 modelos e CI de validacao
Documentacao oficial do opencode
Scoop — gerenciador de pacotes para Windows
NVIDIA Build — chave gratuita da API integrate
Guia oficial de migracao do opencode v1 para v2

Gostou do tutorial? O repositorio com tudo — instalador, updater, template dos 26 modelos e CI — e o canalqb/opencode-update no GitHub. Assine o canal para acompanhar os testes reais que rodamos por aqui.

@CanalQb no YouTube — e confira tambem os conteudos de automacao aqui no blog.

Prompt Master Rules 9.2: o que mudou e como usar

noreply@blogger.com (CanalQb) — Mon, 12 Oct 2026 16:49:43 -0300

@CanalQb no YouTube

Prompt Master Rules 9.2: o que mudou e como usar

Leitura: ~18 min

TL;DR:

O Master Rules 9.2 é o prompt definitivo do @CanalQb:30 seções que comandam escrita, pesquisa profunda, entrega em3 arquivos separados, thumbnails em6 formatos e auditoria com portões de qualidade.
O que é novo sobre a9.1: o comando {Crie um post inteligente}, o anti-resumo com200 palavras mínimas por seção, a ordem fixa de metadados por rede e a proibição absoluta de tags de página no HTML.
Para usar, cole o documento inteiro como primeira mensagem, dispare o gatilho e copie cada arquivo para o seu destino: HTML no Blogger, metadados nos campos, JSON na ferramenta de imagem.

Nota Técnica: Prompts e automações fornecidos têm fins exclusivamente educacionais. Teste sempre em ambiente controlado. O @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.

Três arquivos. Zero tags de página. Pesquisa que bloqueia a entrega se falhar.

Essa é a promessa da versão9.2 do Master Rules — e a diferença mais concreta entre ela e qualquer prompt que você já usou. Onde as versões anteriores entregavam um bloco gigante de HTML para você desembrulhar, o9.2 separa o trabalho em três arquivos com nomes previsíveis: o post, os metadados de todas as redes e os prompts de thumbnail em todos os formatos. Onde a9.1 pedia pesquisa, a9.2 a transformou num comando próprio — {Crie um post inteligente} — que só libera a escrita depois de montar um mapa de inteligência com cinco invariantes. E onde as versões passadas ainda aceitavam posts que enchiam contagem com texto vazio, o9.2 pôs um piso de200 palavras por subsessão que derruba o resumo antes que ele chegue ao editor. Neste guia completo, cada peça da nova versão aberta — os três arquivos, a ordem fixa de redes, o mapa de inteligência, os portões de qualidade e o passo a passo de uso.

O que é o Master Rules 9.2 e o que ele resolve na prática?

O Master Rules 9.2 é um prompt mestre de30 seções que transforma o Claude no gerente de conteúdo completo de um blog monetizado — da pesquisa ao botão de copiar. Ele herda tudo o que as versões anteriores consolidaram (persona, gatilhos, design premium, schema, FAQ, compliance) e fecha os três problemas que sobraram: dependência da memória do modelo, entrega em bloco único e posts que passam na contagem sem densidade real. Na prática, você envia o documento uma vez, dispara {Crie um post: tema="..."} ou {Crie um post inteligente: tema="..."}, e recebe de volta exatamente o que cada destino precisa: um fragmento Blogger limpo, um arquivo de metadados com as sete redes na ordem certa e um JSON de thumbnails pronto para o Gemini Imagen.

O que diferencia o9.2 de um prompt genérico é que quase tudo é verificável. A entrega tem formato definido (três arquivos, nomes com o slug do post, marcadores de fallback se o ambiente não gravar arquivos). A escrita tem piso auditável: mínimo de3.000 palavras visíveis, no mínimo oito subsessões, cada uma com pelo menos200 palavras, e no mínimo80 palavras por título de nível três. A pesquisa tem protocolo com critério de bloqueio: sem as cinco invariantes do mapa de inteligência, o post simplesmente não sai. E a validação tem escopo declarado na Seção24, com comandos que só se encerram quando o critério objetivo é batido — não quando parece bom. É esse empilhamento de camadas que faz do9.2 a versão que o canal recomenda para operação diária; a evolução completa está no acervo de prompts do @CanalQb.

Como funciona a nova entrega em três arquivos separados?

A Seção13.0 do9.2 tornou obrigatório o que antes era convenção: todo {Crie um post} entrega três arquivos, sempre nesta ordem — post-{slug}.html, post-{slug}-metadados.md e post-{slug}-thumbnails.json. O HTML leva só o post, do primeiro ao último bloco, sem metadados colados no topo nem JSON de thumbnail no fim; o arquivo .md leva todos os metadados em Markdown na ordem fixa das redes e termina com o relatório de qualidade; o .json leva os prompts de imagem em todos os formatos. Nada vai entre os arquivos — nenhuma conversa, nenhum checklist solto — porque cada um tem um destino de copiar-e-colar diferente: o editor do Blogger, os campos do Blogger e as legendas das redes, e a ferramenta de geração de imagem.

Três detalhes práticos completam a regra. O primeiro é o nome: o slug vem do título, em minúsculas e hífens, e aparece idêntico nos três arquivos, o que elimina a bagunça de "qual versão é essa?" em pastas com dezenas de posts. O segundo é o fallback: se o ambiente onde você opera não permitir gravação de arquivos, o agente entrega os mesmos três blocos marcados com [ARQUIVO1: ...], [ARQUIVO2: ...] e [ARQUIVO3: ...] — mesmo conteúdo, mesma ordem, nunca misturados num texto só. O terceiro é a disciplina do HTML: ele começa direto no conteúdo da Sessão1 e termina no aviso de ID de vídeo, sem nada antes nem depois. Esse último ponto virou regra absoluta justamente porque era a fonte número um de posts quebrados no Blogger — assunto da próxima seção. O tutorial de publicação do canal mostra o fluxo completo com os três arquivos.

Quais tags de página o9.2 proíbe e por que o fragmento não aceita?

O9.2 proíbe absolutamente qualquer tag de página dentro do post: <!DOCTYPE html>, <html>, <head>, <meta charset> e viewport, <title>, <body> e seus fechamentos. O arquivo post-{slug}.html é um fragmento do Blogger, não uma página web — ele começa no comentário de início do post (ou no link do Font Awesome) e termina no fecho do último bloco, que é o aviso de substituição do ID de vídeo. Qualquer tag de página colada no editor duplica a estrutura que o próprio tema do Blogger já injeta: dois <body>, dois <head>, charset duplicado — e o resultado é post com CSS quebrado, script que não roda e leitor de tela perdido.

Por que isso virou regra absoluta e não apenas dica? Porque o erro tem um custo alto e silencioso: o editor do Blogger aceita a colagem sem reclamar, o post publica, e o problema só aparece na renderização — às vezes nem aparece no desktop, só no mobile, ou só no modo escuro do sistema. O9.2 resolve nos três níveis: a Seção13.0 traz o bloco de proibição com reprovação explícita no {Valide o post}, o checklist de publicação ganhou a linha "Zero tags de página", e a tabela de substituições da Seção16 manda remover qualquer tag dessas se aparecerem por engano. Dica de conferência em dez segundos: depois de colar o fragmento, procure no início do editor o comentário de início do post — se você ver DOCTYPE antes dele, colou a coisa errada.

Como os metadados por rede ficaram organizados na ordem fixa?

A Seção13.1 fixou uma ordem que nunca muda: Blogger primeiro, depois YouTube, Instagram, Twitter/X, Facebook, Reddit e, por último, as demais redes (LinkedIn, Pinterest, TikTok, Threads e Telegram). A ordem espelha o fluxo real de publicação — o Blogger é o destino principal do post, o YouTube é o segundo ativo mais usado, e o resto vem em cascata. O benefício é mecânico: você abre o arquivo .md e já sabe onde estão os campos que precisa, sem escanear o documento inteiro, e o agente para de reinventar a ordem a cada geração.

Cada rede tem seus campos e limites próprios, declarados na Seção13.2: no YouTube, título de até100caracteres e descrição de até5.000; no Twitter/X, tweet de até280caracteres; no Instagram, legenda de até2.200com mix de30hashtags dividido em10de nicho,10de médias e10amplas; no Reddit, título e texto de até300caracteres, com etiqueta de comunidade; no LinkedIn, texto de até3.000. Duas regras transversais completam o pacote: emojis só aparecem nos metadados das redes, nunca no HTML do post (no HTML, o lugar do ícone é o Font Awesome), e hashtags não entram no Blogger nem no YouTube. O arquivo .md termina com o relatório da Seção13.3, que confirma as linhas "3 arquivos entregues", "Ordem das redes" e "Thumbnail — todos formatos" — e, quando o gatilho inteligente foi usado, a linha 🧠 Inteligência com as cinco invariantes do mapa. Os posts publicados pelo canal usam esse formato desde a9.2; o guia de redes do blog explica como reaproveitar cada bloco.

O que o relatório de qualidade audit — e o que significa a linha 🧠?

O relatório de qualidade do9.2 é a última linha do arquivo de metadados, e ele responde uma pergunta só: o post pode sair? A tabela traz as linhas de sempre — contagem de palavras, menor subsessão, número de seções, proporção de corpo técnico, fragmento Blogger sem tags de página — e o prompt exige que os números sejam medidos no arquivo entregue, não estimados: se o HTML tem3.762palavras visíveis, o relatório diz3.762, não "mais de3.500". É o mesmo princípio das versões anteriores, aplicado com a diferença de que o9.2 audita também a separação dos três arquivos e a completude dos seis formatos de thumbnail.

A novidade da9.2 é a linha 🧠 Inteligência, obrigatória quando o comando {Crie um post inteligente} é usado. Ela lista as cinco invariantes que sustentam o texto: o dado datado mais forte que a pesquisa apurou, a lacuna que os melhores resultados do mercado deixaram em aberto, o erro comum que ninguém cobre, o contraponto próprio que só este post traz e a decisão prática que o leitor leva embora. Se qualquer uma das cinco faltar, o relatório não assina — e a entrega é bloqueada antes de chegar a você. É a camada de apuração virando produto auditável: em vez de você confiar que "a IA pesquisou", você lê o que foi encontrado e decide se o post merece publicar.

Como o9.2 gera thumbnails em todos os formatos?

A Seção14 do9.2 expandiu o JSON de thumbnail de3para6 formatos, cada um com resolução e uso declarados:16:9(1920×1080) para YouTube e capa do post;9:16(1080×1920) para Shorts, Stories e TikTok;1:1(1080×1080) para grade do YouTube, Instagram e Twitter;4:5(1080×1350) para feed vertical;1.91:1(1200×628) para prévia de link no Open Graph do Facebook e LinkedIn; e2:3(1000×1500) para Pin do Pinterest. Todos os formatos saem num único arquivo post-{slug}-thumbnails.json, com a mesma cena e as mesmas pessoas descritas do começo ao fim — o que garante que a identidade visual não mude de rede para rede.

Cada entrada do JSON traz modelo, proporção, resolução, uso, prompt positivo, negativePrompt e campo de instruções. O prompt positivo é escrito com os elementos reais do post — o texto do título, a expressão facial inferida pelo tom (guia e dica pedem sorriso cúmplice; alerta pede rosto sério; descoberta pede espanto leve), a cor de destaque da paleta e o contexto visual declarado nos metadados, que sempre descreve país, cultura e época (por exemplo, "Brasil contemporâneo2026+ estilo tech casual"). O negativePrompt corta os erros clássicos de geração: fundo escuro, texto ilegível, rosto distorcido, cartoon e estereótipo cultural. O JSON precisa validar como JSON antes de ser entregue — o relatório confirma a linha "Thumbnail — todos formatos" — e você cola o arquivo inteiro no Gemini Imagen ou equivalente, gerando as6imagens de uma vez.

O que é o comando {Crie um post inteligente} e o mapa de inteligência?

O {Crie um post inteligente: tema="..."} é o gatilho novo da9.2, descrito na Seção4.5, e serve para temas não triviais — aqueles em que escrever da memória é receita para dado errado ou texto genérico. Ele roda um protocolo interno de cinco etapas invisíveis a você: primeiro monta um mapa de5a10perguntas que o post precisa responder; depois pesquisa com no mínimo8fontes, sendo3primárias (documentação oficial, dados do fabricante, publicação de referência); então confronta o que os3a5melhores resultados do mercado cobrem, cobrem mal e não cobrem; só então produz o mapa de inteligência; e finalmente escreve a partir dele — nunca da memória.

O mapa de inteligência é o coração da regra, e tem cinco invariantes fixas. Dados datados: o fato verificado mais forte, com fonte e data — "pesquisado em12/10/2026". Lacuna do mercado: o que ninguém dos melhores resultados responde. Erro não coberto: o problema que os tutoriais existentes ignoram. Contraponto próprio: a posição que este post assume contra o senso comum, com justificativa. Decisão prática: a escolha concreta que o leitor faz ao terminar. Se as cinco não estiverem no relatório, o post não é entregue — é o primeiro comando do canal em que a entrega é bloqueada por falha de apuração, não por falha de formato. Para temas triviais (definições, conceitos fixos), o {Crie um post} comum continua valendo: o inteligente é para quando o dado muda, o mercado tem lacuna ou o assunto pede posição própria. O guia de uso do Claude do canal mostra quando vale a pena disparar cada gatilho.

Como o anti-resumo da Seção6.7 funciona na prática?

O anti-resumo é a camada da9.2 que resolve o problema mais comum de conteúdo gerado por IA: o texto que parece completo, bate a contagem e não ensina nada. A regra tem seis camadas — piso de palavras visíveis (mínimo de3.000por post), piso por subsessão (cada H2 precisa de pelo menos200palavras no miolo), piso por título de nível3(mínimo de80), proporção de corpo técnico (ao menos60% do total é tutorial, não introdução nem despedida), proibição de repetição sem nova informação (frase que reformula a anterior sem acrescentar fato, exemplo ou passo é cortada) e exigência de exemplo concreto em todo procedimento (passo sem entrada, saída ou erro exemplificado reprova).

Na prática, o efeito aparece no que o relatório mede. O campo "menor subsessão" não existe à toa: ele mostra a seção mais fraquinha do post com o número exato de palavras, e o piso de200derruba geração em que o modelo entrega trinta linhas de generalidade e para. O piso de80no H3 impede o oposto: subtítulo bonito com uma linha de conteúdo por baixo. E a proporção de60%segura o equilíbrio entre contexto e execução — um post pode ter TL;DR, introdução e encerramento, mas o miolo precisa ser passo a passo, tabela, código ou exemplo. O resultado é mensurável: os três posts de teste da9.2 saíram com entre3.700e4.300palavras visíveis e proporção de corpo entre64%e78%, medidos no arquivo entregue. Nenhuma dessas regras proíbe texto curto quando ele é denso — a6.6do9.2 preserva a brevidade legítima; o que ela proíbe é a brevidade preguiçosa.

Quais são as Camadas1a3: comandos, auditoria, painel e portões?

As Seções24a29da9.2 criaram três camadas de controle que transformam a conversa com a IA de "gerou e rezou" em "gerou e passou por auditoria". A Camada1(Seção24) declara escopo, critério e condição de conclusão de cada comando — {Crie um post} só termina com os3arquivos entregues; {Crie um post inteligente} só termina com as5invariantes no relatório; {Audite} só termina com o relatório A–K e a lista de falhas classificadas em P0aP3; {Corrija} só termina com a re-auditoria do que foi mexido; {Valide o post} e {Libere para publicação} só terminam com veredito explícito. Sem critério objetivo, o comando não se encerra — é a cura para "quase pronto" infinito.

A Camada2traz a auditoria (modelo A–K cobrindo autoridade, conteúdo, formato, SEO, links, design, acessibilidade, compliance, originalidade, performance e metadados) e o painel de qualidade de0a100com pesos fixos — conteúdo pesa mais que estética, e o painel mostra a nota e o que a limita. A Camada3é a de maior valor operacional: os portões. {Valide o post} emite APTO, APTO COM RESSALVAS ou NÃO APTO com a lista de achados; {Libere para publicação} só responde sim depois de nenhum P0 aberto; e {Audite o compliance jurídico} roda a matriz de jurisdições — Brasil (LGPD e CONAR), Estados Unidos, União Europeia (GDPR) e Reino Unido — com o que cada uma exige de disclaimers, cookies e coleta de dados. O resultado prático: nenhum post sai sem o mesmo rito de revisão que uma redação profissional aplica — só que em segundos. O checklist de conformidade do canal cobre a parte de monetização dessas exigências.

Qual é o passo a passo para usar o9.2 do zero até publicar?

O fluxo tem cinco etapas e não exige conhecimento técnico — só a disciplina de seguir a ordem, porque cada etapa alimenta a seguinte. Os passos abaixo trazem a ação, o porquê, o resultado esperado e o erro mais comum de cada um, no mesmo formato que o próprio9.2 exige dos tutoriais que gera.

Passo1— Inicie a sessão com o documento inteiro

Cole as30seções do prompt9.2 como a primeira mensagem de uma conversa nova e envie. Nada de pedidos antes disso.

Por quê: a IA precisa da persona, dos gatilhos, dos três arquivos e das camadas de auditoria no contexto antes de qualquer geração; meio documento gera metade das regras.

Quando funcionar: a IA confirma o recebimento e aguarda o gatilho, sem gerar nada espontaneamente.

Erro comum: reaproveitar uma conversa antiga. O contexto poluído faz a IA esquecer a ordem das redes — recomece sempre em conversa limpa.

Passo2— Escolha o gatilho certo para o tema

Use {Crie um post: tema="..."} para assuntos estáveis e {Crie um post inteligente: tema="..."} para temas com dado volátil, lacuna de mercado ou posição própria a defender.

Por quê: o inteligente roda pesquisa profunda com8fontes e mapa de5invariantes; o comum é mais rápido e suficiente para conceito fixo.

Quando funcionar: a IA silencia e executa, entregando os3arquivos completos na ordem — HTML, metadados, thumbnails.

Erro comum: pedir "me mostra antes de fechar". Isso ativa conversa — use {Preview do post} se quiser aprovação prévia, é o gatilho certo.

Passo3— Leia o relatório antes de copiar qualquer coisa

Confira no fim do .md as linhas de palavras, menor subsessão, fragmento Blogger, thumbnails e — se usou o inteligente — as cinco invariantes da linha 🧠.

Por quê: é a última checagem grátis antes da publicação; corrigir no Blogger dá trabalho, corrigir na conversa é um {Corrija}.

Quando funcionar: números acima dos pisos, ✅ nas linhas críticas e você sabe exatamente o que falta (geralmente só o ID do vídeo).

Erro comum: publicar sem ler. O relatório é curto por desenho — dois minutos evitam retrabalho.

Passo4— Cole cada arquivo no seu destino

HTML no editor em modo Blogger; metadados nos campos de título, descrição e nas legendas de cada rede; JSON no Gemini Imagen para gerar as6imagens.

Por quê: a separação existe exatamente para isso — copiar-e-colar sem filtrar conversa no meio; nenhuma tag de página deve ir junto.

Quando funcionar: o post renderiza com banner, paleta, FAQ clicável e Font Awesome; as legendas saem nos limites de cada rede.

Erro comum: colar no modo visual. Sempre alterne para o editor HTML do Blogger antes de colar o fragmento.

Passo5— Troque o ID do vídeo e valide a publicação

Substitua o ID padrão DUDla8Bya8M pelo vídeo real e dispare {Valide o post} se quiser o veredito formal antes de ir ao ar.

Por quê: o ID é placeholder seguro — a IA não inventa URL de vídeo —, e o portão responde APTO ou lista o que impede a liberação.

Quando funcionar: {Libere para publicação} responde confirmando nenhum P0 aberto — e o post vai ao ar com tudo conferido.

Erro comum: pular a validação em posts de afiliado ou saúde — são justamente os temas com exigência jurídica maior.

Perguntas Frequentes

O que é o Master Rules 9.2?

É o prompt mestre definitivo do @CanalQb:30seções que definem persona, gatilhos, pesquisa real, profundidade auditável, anti-plágio, design premium, compliance e — de novo na9.2 — entrega em3arquivos separados, metadados por rede em ordem fixa, thumbnails em6formatos, comando de pesquisa profunda {Crie um post inteligente} e camadas de auditoria com portões de qualidade. Ele transforma o Claude no gerente de conteúdo de um blog: você envia o documento uma vez por sessão e só comanda o que quer gerar, recebendo tudo pronto para o Blogger e para as redes, com relatório de medição no fim.

Qual é a diferença entre o 9.2 e o 9.1?

A9.1 trouxe pesquisa real datada, anti-plágio com insight declarado e a estrutura de8sessões com blocos de erros. A9.2 evolui em quatro frentes: a entrega passou de blocos soltos para3arquivos separados com nomes fixos; a pesquisa virou comando próprio com mapa de5invariantes e bloqueio de entrega; o anti-resumo ganhou piso de200palavras por subsessão e3.000por post; e a operação ganhou as camadas de auditoria, painel de0a100e portões APTO/NÃO APTO. Em resumo: a9.1 melhorou o texto; a9.2 industrializou o fluxo inteiro.

O que são os três arquivos de entrega?

Todo {Crie um post} da9.2entrega post-{slug}.html (fragmento Blogger, sem tags de página e sem metadados embutidos), post-{slug}-metadados.md (todas as sete redes na ordem fixa Blogger, YouTube, Instagram, Twitter/X, Facebook, Reddit e outras, mais o relatório de qualidade no fim) e post-{slug}-thumbnails.json (prompts de imagem nos6formatos:16:9,9:16,1:1,4:5,1.91:1e2:3). Cada arquivo tem um destino de cópia diferente, os três levam o mesmo slug no nome e nada é misturado entre eles — se o ambiente não gravar arquivos, a entrega sai com marcadores [ARQUIVO1/2/3] no mesmo formato.

O que é o comando {Crie um post inteligente}?

É o gatilho de pesquisa profunda da Seção4.5, para temas não triviais. Ele monta um mapa de5a10perguntas, pesquisa no mínimo8fontes (3primárias), confronta os3a5melhores resultados do mercado e produz um mapa de inteligência com5invariantes: dado datado, lacuna do mercado, erro não coberto, contraponto próprio e decisão prática. A escrita parte do mapa, nunca da memória — e se as5invariantes não estiverem no relatório, a entrega é bloqueada. O relatório do post ganha a linha 🧠 Inteligência listando as cinco, para você auditar a apuração antes de publicar.

Quantas palavras o 9.2 exige por post?

Mínimo de3.000palavras visíveis por post (sem contar HTML, CSS, JavaScript e JSON-LD), com no mínimo oito subsessões, cada uma com pelo menos200palavras de miolo, títulos de nível3com no mínimo80palavras sob eles e corpo técnico de ao menos60% do total. É o piso mais alto das versões — o8.5pedia1.200, o9.1subiu o volume sem piso por seção. As medidas são auditadas no relatório, que mostra a menor subsessão do post com o número exato: se bateu200, o post passa; se não bateu, o anti-resumo derruba a geração.

Como uso o prompt na prática — só colo no Claude?

Exatamente: cole o documento inteiro do9.2como primeira mensagem de uma conversa nova, aguarde a confirmação e dispare o gatilho desejado — {Crie um post: tema="..."} para temas estáveis ou {Crie um post inteligente: tema="..."} quando o dado for volátil. Nunca comece pelo gatilho sem o prompt e nunca use o prompt no meio de conversa poluída. Depois, leia o relatório no fim do .md, copie cada arquivo para o seu destino (HTML no editor Blogger em modo HTML, metadados nos campos e legendas, JSON na ferramenta de imagem), troque o ID do vídeo padrão e publique — ou dispare {Valide o post} para o veredito formal.

Fontes e Referências

Quer ver o9.2em ação? Assista ao @CanalQb no YouTube e continue em canalqb.com.br.

Feito com Master Rules Claude v9.2

Prompt Master Rules 9.1: o que ele faz e como usar

noreply@blogger.com (CanalQb) — Mon, 12 Oct 2026 15:56:54 -0300

@CanalQb no YouTube

Master Rules 9.1: post completo com pesquisa real

Feito com Master Rules Claude v9.1

Leitura: ~20 min

TL;DR:

A v9.1 é a primeira versão que obriga a IA a pesquisar na internet antes de escrever — mínimo de 4 fontes, 2 oficiais, com data de acesso registrada no post.
A Seção 0 isolou as variáveis (nome, domínio, cores, URLs, assinatura) numa área editável só por você: o agente nunca toca nelas — e cada uma agora explica o que faz.
O post gerado segue 8 sessões fixas: Soluções Rápidas após a 2ª sessão, {Erros e Soluções} antes da última, e Referências sempre por último.

Este prompt não deixa a IA adivinhar: ele obriga a pesquisar.

Nos testes das versões anteriores surgiu um padrão desconfortável: posts visualmente perfeitos, com schema, FAQ e metadados impecáveis, sustentando dados que ninguém verificou — versões inventadas, links quebrados, números redondos demais para serem reais. A v9.1 ataca a causa na raiz, exigindo que a pesquisa venha antes da primeira frase escrita, e protege o resultado com uma camada de autoria que impede cópia de texto externo. Abaixo, cada peça da versão explicada — das variáveis globais anotadas ao mapa completo de 8 sessões, das regras de anti-plágio ao passo a passo de uso com os quatro erros mais comuns e seus contornos.

5 problemas comuns no Master Rules 9.1 e a correção de 30 segundos?

Se o post não saiu como esperado, comece por aqui — cada apontamento leva ao card completo na seção de erros e soluções mais abaixo.

Post saiu abaixo de 3.000 palavras: use {Aprofunde a seção X} nas seções mais curtas e conte de novo antes de publicar.
Achou frases iguais a um site externo: reescreva com a Seção 7 (voz única) — frase copiada é rejeição garantida.
Número ou versão parece errado: confira o campo 🔍 dos metadados; sem fonte registrada, o dado não entra.
Cores ou domínio vieram trocados: o erro está na Seção 0 — corrija as variáveis, nunca pedindo ajuste no post.
Apareceram emojis decorativos no HTML: troque por ícones Font Awesome, como <i class="fas fa-check"></i>.

O que é o Master Rules 9.1 e qual problema ele resolve?

O Master Rules 9.1 é a evolução do prompt mestre do @CanalQb que resolve o defeito exposto nos testes das versões anteriores: posts com estrutura impecável e conteúdo de adivinhação. Enquanto a v8.5 aprimorava o formato e a v9.0 cobrava profundidade, nenhuma das duas obrigava a IA a conferir um único fato antes de escrever. A v9.1 fecha esse buraco ao transformar pesquisa e autoria em etapas obrigatórias da entrega — o post só existe depois que a fonte foi aberta, lida e datada, e só passa da rodada final se nenhuma frase tiver vindo pronta de outro lugar. É a diferença entre um prompt que escreve bem e um prompt que apura antes de escrever.

O diagnóstico veio dos próprios testes: metadados e JSON de thumbnail já eram bons até a v9.0, mas o corpo técnico revelava lacunas — dados plausíveis sem origem, trechos que qualquer blog replicaria. A correção não foi acrescentar mais formatação (já havia sobrando), e sim subir a hierarquia de exigências: no topo agora ficam profundidade, pesquisa real e originalidade, e a estrutura desceu para segundo lugar. A consequência prática aparece em três frentes: o campo 🔍 Pesquisa nos metadados mostra quantas fontes foram lidas e quando, dando ao leitor (e ao Google) prova de apuração; o campo 🛡️ Originalidade declara as conclusões próprias que nenhuma fonte traz; e a nova Seção 0 torna o prompt compartilhável sem risco de sair com domínio, cores ou assinatura de outra pessoa. O resultado prático é um post que sustenta a própria afirmação: quando o leitor clica numa fonte, ela abre, mostra o que o post diz que mostra, e traz a data em que o canal leu aquilo — é o tipo de sustentação que o acervo de prompts do blog cobra de qualquer conteúdo técnico publicado sob esse padrão.

Como funcionam as variáveis globais da Seção 0?

A Seção 0 é um bloco fixo no topo do prompt contendo as únicas linhas que o usuário edita à mão: nome do canal, domínio, URLs, paleta de cores, metas de qualidade e assinatura. O agente jamais altera, otimiza ou "corrige" nenhuma variável — pedidos para mudar nome, cor ou link durante uma sessão são ignorados, porque a fonte da verdade é o topo do arquivo, não a conversa. Na v9.1, cada variável passou ainda a carregar, na frente dela, um comentário do que faz e do que quebra se mudar errado — ninguém edita às cegas: você sabe que trocar DOMINIO afeta canonical, schema e origem do vídeo, e que trocar CSS_PREFIXO exige renomear todas as classes de uma vez.

Na prática, isso elimina uma classe inteira de bugs que afetava versões antigas: posts publicados com o domínio de outro cliente, assinatura de teste, ou a cor secundária errada porque alguém pediu "azul" no meio da geração. Para trocar o destaque de #28a745 para #0d6efd, você edita a variável e inicia nova sessão — nunca pede a troca dentro da sessão. A tabela abaixo mostra o grupo mais crítico e o que cada valor controla; o bloco completo tem também redes sociais opcionais, prefixos de CSS, metas de legibilidade (Flesch entre 60 e 79) e o ID de vídeo padrão com aviso obrigatório de substituição.

Variável	O que faz (e o que quebra se errar)	Valor padrão
NOME_CANAL	Persona, cabeçalho, autor do schema e CTA — trocar muda toda a identidade do texto	@CanalQb
DOMINIO	Canonical, mainEntityOfPage, origin do iframe e links absolutos — errar quebra SEO e vídeo	https://canalqb.com.br
URL_BUSCA_INTERNA	Base de TODOS os links internos (mín. 3) — a IA nunca inventa URL de post	…/search?q=
COR_PRIMARIA / ERRO / AVISO / INFO	Paleta inteira do CSS — sucesso, erro, alerta e informação, todas em contraste AA	#28a745 / #d32f2f / #ffc107 / #2196f3
CSS_PREFIXO	Evita colisão de classes com o tema do Blogger — trocar exige renomear tudo junto	post_cqb_
CSS_SIGNATURE	Crédito de autoria no topo do style — sumir tira a marca do template	/* @CanalQb … 2026 */
MINIMO_PALAVRAS	Piso total de palavras visíveis — abaixo dele o post não é entregue (3.000 na v9.2)	3000
ID_VIDEO_PADRAO	Placeholder do iframe — a IA não inventa ID; sai com aviso de substituição	DUDla8Bya8M

Por que o 9.1 exige pesquisa real na internet antes de escrever?

A exigência existe porque alucinação de IA não se resolve com formatação: nenhum schema, FAQ ou checklist de SEO impede que um dado inventado entre no texto com aparência de verdade. A Seção 4 do 9.1 torna a pesquisa prévia obrigatória — mínimo de 4 fontes, sendo 2 oficiais (documentação primária do produto, site institucional ou publicação oficial) — e manda registrar data de acesso e link clicável junto de cada informação técnica. A regra de evidência é tão importante quanto a contagem: fatos confirmados, interpretações e informações sem confirmação suficiente são separados, e dado não conferido vira {verificar} com o link da fonte, nunca afirmação categórica.

O efeito colateral, e o mais valioso, é o post ganhar um campo que as versões antigas não tinham: o bloco 🔍 Pesquisa nos metadados, onde o leitor (e o Google) vê quantas fontes foram lidas e quando — neste mesmo post, as duas fontes primárias foram verificadas na íntegra em 12/10/2026, e isso está declarado nos metadados acima. Quando a busca falha, o protocolo não autoriza improviso: a IA marca o ponto incerto, mantém o link da fonte primária e segue. Para o canal, isso muda a rotina de publicação: em vez de confiar no relatório de qualidade, você abre uma ou duas fontes do 🔍 e confere em segundos se o post sustenta o que promete — é assim que se constrói o "E" de experiência do E-E-A-T, mostrando trabalho em vez de declará-lo. O mesmo protocolo dita que a última sessão de todo post seja "Fontes e Referências": a prova de pesquisa é o fecho do texto, não um rodapé opcional — e é o que separa um tutorial técnico de um conteúdo aprovado em revisão.

Como o 9.1 protege o texto contra plágio e conteúdo duplicado?

A Seção 7 do 9.1 é a barreira anti-plágio, e ela funciona em duas camadas — processual e de auditoria. A processual: a pesquisa da Seção 4 alimenta a escrita com fatos, nunca com frases — a IA lê a fonte, entende, fecha a aba e escreve do zero, com estrutura própria; no máximo duas citações diretas, sempre com aspas e atribuição. A auditoria: antes de entregar, a IA roda uma rodada final comparando o texto com as fontes consultadas, e o resultado vai para o campo 🛡️ Originalidade dos metadados, que declara "zero frases copiadas" e aponta o insight inédito do post — algo que não está em nenhuma das fontes lidas.

O objetivo é simples: texto que é só paráfrase de fonte é texto que o Google já leu em outro lugar, e texto duplicado não ranquea nem sobrevive à revisão humana. Mas o insight declarado cumpre papel maior do que o anti-cópia: ele força o modelo a produzir uma conclusão própria — uma relação de causa, uma previsão fundamentada, uma comparação que ninguém montou — e é esse fruto do raciocínio que separa um texto autoral de um resumo bem formatado. Neste post, por exemplo, as duas conclusões do 🛡️ — de que a v9.1 inverte a lógica das versões anteriores e de que a Seção 0 cria um novo contrato de edição — não estão escritas em nenhum dos documentos-fonte; foram derivadas da leitura deles. Se um dia você quiser auditar o canal, é exatamente por esse campo que começa: confira se a afirmação de "insight inédito" corresponde a algo que você não encontra nas fontes listadas — e se não corresponder, o post volta para reescrita antes do editor do Blogger.

Qual é a sequência de sessões do post gerado pelo 9.1?

O 9.1 padronizou o post em 8 sessões com ordem fixa, e a posição de cada bloco não é decorativa: Soluções Rápidas vem cedo para prender quem já está travado, {Erros e Soluções} vem tarde para quem leu até o fim, e Referências fecha tudo porque a prova de que o post foi pesquisado precisa ser a última coisa que o leitor vê — depois de ler o argumento, ele encontra a evidência. A Sessão 1 é declarada intocável: cabeçalho, banner, H1, style com assinatura, badge, TL;DR e vídeo são gerados exclusivamente a partir das variáveis da Seção 0 e não podem ser alterados nem por {Corrija} ou {Melhore o layout}, porque são a identidade do site, não conteúdo do post.

A tabela abaixo é a memória do formato — se um post gerado fugir dela, ele está fora do padrão e deve ser corrigido antes de publicar:

Sessão	Blocos	Conteúdo	Regra de posição
1	1–6 (fixa)	Cabeçalho, style, H1, badge, TL;DR, vídeo	Intocável — só a Seção 0 muda
2	7–8	Disclaimer + introdução com Pattern Interrupt	Interrupt isolado no início
3	9	Soluções Rápidas (3–6 itens com âncora)	Logo após a 2ª sessão
4	10	Corpo técnico — ≥60% do post	4ª posição, coração do texto
5	11	FAQ (mínimo 5 perguntas)	Depois do corpo, antes dos erros
6	12	{Erros e Soluções} — mínimo 5 cards	Antes da última sessão
7	13	CTA	Chamada antes da prova final
8	14	Fontes e Referências	SEMPRE por último
—	15	Schema JSON-LD (BlogPosting + FAQPage)	Técnico, fora da contagem de sessões

O que são as Soluções Rápidas e o bloco {Erros e Soluções}?

São os dois blocos de ajuda que a v9.1 adiciona ao post, cada um num extremo da leitura. As Soluções Rápidas são 3 a 6 itens curtos, ancorados logo após a 2ª sessão, para o leitor que chegou com um problema específico e não vai ler o texto inteiro — cada item tem uma linha de sintoma e uma linha de correção, apontando para o card correspondente. O bloco {Erros e Soluções} é a versão profunda, com no mínimo 5 cards de erro → causa → solução → prevenção, posicionado antes da última sessão. Juntos, eles formam um sistema de duas velocidades: quem tem pressa resolve em 30 segundos; quem quer entender a causa raiz desce um clique e lê o diagnóstico completo.

A regra de escopo é o detalhe que costuma ser confundido: esses blocos existem apenas dentro do arquivo HTML do post — nunca nos metadados nem no relatório de qualidade, que ficariam poluídos com conteúdo visível ao leitor. Cada item das Soluções Rápidas aponta para o card correspondente via âncora (#erros-solucoes), de modo que quem resolve em 30 segundos pode, se quiser, descer e entender a causa raiz sem procurar. É a mesma lógica de uma página de erros de software: código primeiro, diagnóstico depois, e o caminho entre os dois é um clique. Os cards do bloco completo seguem formato fixo — a mensagem de erro exata como aparece na tela, a causa real (não o sintoma), a correção acionável e a prevenção que faz você não voltar aqui — e o bloco completo aparece na seção de erros e soluções deste post, logo abaixo do FAQ.

Como o 9.1 garante profundidade: 2.000 palavras e proporção de 60%?

O 9.1 herda da v9.0 o Protocolo de Profundidade — cada passo com ação exata, porquê, resultado esperado e erro comum — e sobe o piso: mínimo de 2.000 palavras visíveis na versão, excluindo HTML, CSS, JavaScript e JSON-LD da contagem. Junto disso permanece a proporção de 60% de corpo técnico — cerca de 1.200 das 2.000 palavras precisam ser tutorial de verdade, não estrutura. TL;DR, disclaimers, FAQ, blocos de erros e referências ficam de fora da soma, o que impede o truque clássico de inflar as partes fáceis para bater a meta sem ensinar nada.

A novidade da9.1 é que a contagem conversa com a pesquisa: um post longo preenchido com afirmações não verificadas reprova em duas métricas ao mesmo tempo — é raso no conteúdo e frágil na fonte. O relatório de qualidade reflete isso ao listar, lado a lado, palavras, proporção, número de fontes e status do anti-plágio. Na prática, a leitura correta do relatório é: se 🔍 vier com menos de 4 fontes ou 🛡️ apontar trecho pendente, o post volta para a IA antes de ir para o Blogger; se só a proporção cair, o gatilho {Aprofunde a seção X} resolve no lugar, sem regerar o que já está bom. Vale registrar que os testes de comparação com o documento explicativo do canal expuseram o limite desta própria regra:2.000palavras no total ainda permitiam seções individuais rassas, porque a9.1 media o agregado e não o pedaço — é exatamente essa fresta que a9.2fechou subindo o piso para3.000palavras e exigindo200por subsessão, com a contagem da menor seção declarada no relatório.

Quais gatilhos o 9.1 oferece e como iniciar um post do zero?

O 9.1 entrega 17 comandos no painel de ações, e o que muda em relação à 9.0 são os quatro novos: {Crie um post}, {Aprofunde a seção X}, {Escreva para Social Mídia}, {Reescreva com voz X} e {Crie um roteiro}. Todos seguem o princípio de escopo: um gatilho faz uma coisa, e quem tenta amarrar duas tarefas no mesmo comando entrega as duas pela metade. O gatilho mais subestimado é {Reescreva com voz X}, que existe como camada de revisão, não de geração — você aplica depois de o post já estar aprovado, pedindo a voz do canal (direta), do especialista (técnica) ou do contador de histórias (narrativa), e a roda final de consistência revalida metadados, proporção e schema.

Para iniciar um post do zero, o fluxo são quatro passos, nesta ordem exata — e pular o segundo é a causa número um de retakes: primeiro, atualize a Seção 0 com seu nome, domínio, URLs, paleta, assinatura e ID de vídeo; segundo, abra uma sessão nova, para que o agente carregue as variáveis frescas na memória; terceiro, mande {Crie um post} com tema, palavra-chave e intenção; quarto, aguarde a entrega completa — metadados, corpo e relatório vêm num bloco só. Se bateu nas linhas do relatório (palavras, proporção, fontes, originalidade), cole o HTML no Blogger com o código de captcha desabilitado e publique; se não bateu, corrija o item específico com o gatilho correspondente, não com "refaça tudo". A Sequência das três versões fica clara nesse fluxo: a 8.5 ensinou o formato da entrega, a 9.0 ensinou o volume, e a 9.1 ensinou a prova — e as três juntas são o que permite rodar o ciclo de publicação sem adivinhar.

O que o 9.1 herdou, o que criou e o que a 9.2 completou?

O 9.1 é, por construção, um elo de cadeia — ele herda da 8.5 a espinha dorsal do template (13 blocos, metadados completos, JSON de thumbnail em três formatos, compliance jurídico, tags proibidas de fragmento de Blogger) e da 9.0 o Protocolo de Profundidade com ação-porquê-resultado-erro e a proporção de 60%. O que ele cria é a camada epistêmica: variáveis globais com comentário explicativo, pesquisa obrigatória com campo 🔍 datado, anti-plágio com declaração de autoria em 🛡️, mapa fixo de 8 sessões, Soluções Rápidas ancoradas e {Erros e Soluções} com cinco cards — ou seja, ele transforma um prompt que escrevia em um prompt que apura, escreve e documenta a própria confiabilidade.

O que faltou ao 9.1, os testes denunciaram: a profundidade ainda era medida por agregado. Um post com 2.000 palavras passava pelo relatório mesmo que três subsessões tivessem 90 palavras cada — e foi exatamente o defeito observado ao comparar os posts gerados com o documento explicativo do canal, muito mais denso por parágrafo. A 9.2 fecha essa fresta com três medidas: piso total sobe para 3.000 palavras, cada subsessão ganha piso próprio de 200 palavras com no mínimo 8 seções, e o relatório passa a declarar a menor seção medida, para que o número mais fraco do post fique visível antes da publicação. Em paralelo, a 9.2 absorveu do planodeimplementação a Camada 1 (comandos com escopo, critérios e entregáveis), a Camada 2 (auditoria A–K com relatório de 12 campos e prioridades P0–P3), o painel de qualidade 0–100 com dez dimensões ponderadas, os portões {Valide o post} e {Libere para publicação} com os vereditos APTO/APTO COM RESSALVAS/NÃO APTO, e o {Audite o compliance jurídico} para BR/EUA/UE/UK. Para ver a versão completa do formato e conferir o relatório de produção deste texto, leia também o guia do Master Rules 9.0 — e use este 9.1 como referência para tudo que envolve fonte, data e autoria.

Perguntas Frequentes

O que é o Master Rules 9.1?

É a versão 9.1 do prompt mestre do @CanalQb, a primeira a separar claramente três camadas: formato herdado da 8.5, profundidade herdada da 9.0, e uma nova camada de apuração e autoria exclusiva desta versão. O 9.1 obriga a IA a pesquisar na internet antes de escrever (mínimo de 4 fontes, 2 oficiais), a registrar a data de acesso no campo 🔍 dos metadados, a declarar as conclusões próprias em 🛡️ Originalidade, e a entregar o post em 8 sessões fixas com Soluções Rápidas ancoradas e o bloco {Erros e Soluções} com no mínimo 5 cards. Resumindo: ele transforma um prompt que apenas escreve em um prompt que apura, escreve e documenta a própria confiabilidade antes da publicação.

O que são as variáveis globais da Seção 0?

São as únicas linhas do prompt que o usuário edita à mão, agrupadas num bloco fixo no topo do arquivo: nome do canal, domínio, URL de busca interna, paleta de cores, prefixo de CSS, assinatura, mínimo de palavras e ID de vídeo padrão. Na 9.1, cada variável ganhou um comentário explicativo dizendo o que ela faz e o que quebra se for trocada errado. O agente jamais altera esses valores — pedidos para mudar cor, domínio ou link no meio de uma sessão são ignorados deliberadamente, porque a fonte da verdade é o topo do arquivo e não a conversa. Na prática, isso elimina bugs inteiros de posts publicados com o domínio ou a assinatura de outra pessoa.

Como o 9.1 evita que a IA invente dados?

Através da Seção 4, que torna a pesquisa prévia obrigatória: no mínimo 4 fontes, sendo 2 oficiais, com link clicável e data de acesso registrados. A regra de evidência separa fatos confirmados, interpretações e informações insuficientes — dado que não passou por conferência vira {verificar} com o link da fonte, nunca afirmação categórica. Quando a busca falha, o protocolo proíbe improviso: a IA marca o ponto incerto e mantém a fonte primária listada. O resultado é auditável: você abre uma ou duas fontes do campo 🔍 dos metadados, compara com o que o post afirma, e sabe em segundos se o texto se sustenta — o oposto de confiar no relatório da própria IA.

Qual é a diferença entre o 9.1 e o 9.0?

A 9.0 definiu formato e volume: Protocolo de Profundidade com ação, porquê, resultado e erro comum, mínimo de 1.500 palavras e proporção de 60% de corpo técnico. A 9.1 mantém tudo isso e adiciona a camada de apuração — Seção 0 com variáveis comentadas, Seção 4 de pesquisa real com4fontes datadas, Seção 7 anti-plágio com voz própria, mapa fixo de 8 sessões, Soluções Rápidas ancoradas e o bloco {Erros e Soluções}. O piso também sobe de 1.500 para 2.000 palavras. Em uma frase: a 9.0 ensinou o prompt a escrever com profundidade; a 9.1 ensinou a verificar o que escreve antes de entregar — e a 9.2, depois, subiu a régua para 3.000 palavras contadas por subsessão.

Onde ficam os blocos de Soluções Rápidas e Erros e Soluções?

Exclusivamente dentro do arquivo HTML do post, nunca nos metadados nem no relatório de qualidade. As Soluções Rápidas ficam logo após a segunda sessão, com 3 a 6 itens curtos de sintoma e correção, cada um apontando por âncora para o card correspondente. O bloco {Erros e Soluções}, com no mínimo 5 cards de erro, causa, solução e prevenção, fica antes da última sessão, depois do FAQ. Essa posição não é aleatória: quem tem pressa resolve no topo, quem leu até o fim encontra o diagnóstico completo na reta final, e as referências fecham o post como prova de pesquisa — manter essa ordem é o que garante que o post gere confiança em vez de parecer um amontoado de avisos.

{Erros e Soluções} — os 5 problemas mais comuns ao usar o 9.1

Cada card traz a mensagem de erro exata, a causa real, a correção acionável e a prevenção. Os cinco abaixo cobrem praticamente tudo que aparece nas primeiras sessões com a versão 9.1.

Erro 1: “As variáveis vieram trocadas no post”

Causa: A edição foi feita no meio da sessão ou em arquivo salvo sem BOM — a IA leu a versão antiga na memória e o editor não preservou a codificação.
Solução: Corrija na Seção 0, salve em UTF-8 com BOM e abra uma sessão nova — nunca peça ajuste de variável dentro da sessão que está gerando o post.
Prevenção: Trate a Seção 0 como cabeçalho de configuração, não como parte da conversa: qualquer mudança ali encerra a sessão atual por definição.

Erro 2: “A IA pulou a pesquisa e escreveu de memória”

Causa: Pedido feito sem sessão nova, ou comando montado de um jeito que não menciona data, fonte ou verificação — o modelo cai no caminho mais fácil.
Solução: Interrompa a entrega, mande {Audite o post} e exija o campo 🔍 preenchido com fontes e data de acesso; recuse qualquer post sem 🔍 datado.
Prevenção: Inicie toda sessão com {Crie um post} logo após abrir a sessão nova — o gatilho carrega junto a exigência da Seção 4 e evita o atalho.

Erro 3: “O post saiu abaixo do mínimo de palavras”

Causa: Seções estruturais (TL;DR, FAQ, erros) foram contadas como corpo na sua leitura, ou o modelo resolveu encurtar exemplos para “não inflar”.
Solução: Reconte com o script de verificação, identifique as subsessões abaixo de 200 palavras e dispare {Aprofunde a seção X} uma por vez — nunca “refaça tudo”.
Prevenção: Leia a linha de menor seção do relatório antes de qualquer coisa: é o número mais fraco do post, e a v9.2 passou a declará-lo justamente para isso.

Erro 4: “Achei frases iguais a de um site externo”

Causa: A pesquisa da Seção 4 foi feita, mas o texto colou frases das fontes em vez de reescrever — pesquisa sem reescrita ainda é cópia.
Solução: Reabra a Seção 7 e peça reescrita integral do trecho com voz própria, mantendo no máximo duas citações diretas com aspas e atribuição.
Prevenção: Confira o campo 🛡️ Originalidade: se ele não declarar um insight que você não encontra nas fontes, o post ainda não tem autoria suficiente.

Erro 5: “Publicei e o layout quebrou no Blogger”

Causa: HTML colado com as tags de página (<head>, <body> duplicados) ou com emojis decorativos no lugar de ícones — ambos proibidos em fragmento de Blogger.
Solução: Cole apenas o conteúdo entre os comentários INÍCIO e FIM DO POST, substitua qualquer Unicode decorativo por Font Awesome e desabilite o captcha do tema.
Prevenção: Rode o {Valide o post} antes de colar: ele checa estrutura, ícones, links externos com rel="noopener noreferrer" e fechamento de tags num passe só.

Quer ver a 9.1 em ação? Assista ao @CanalQb no YouTube e continue em canalqb.com.br.

Feito com Master Rules Claude v9.1

Fontes e Referências

Prompt Master Rules 9.0: o que ele faz e como usar

noreply@blogger.com (CanalQb) — Mon, 12 Oct 2026 15:46:07 -0300

@CanalQb no YouTube

Master Rules 9.0: posts detalhados com profundidade

Leitura: ~16 min

TL;DR:

A v9.0 nasceu de um diagnóstico duro: as versões anteriores entregavam posts formatados, mas rasos — a estrutura estava detalhada e o corpo técnico tinha uma linha.
A correção é a Seção 3.2, o Protocolo de Profundidade: cada passo precisa de ação exata, porquê, resultado esperado e erro comum — formato auditável, não intenção solta.
Com mínimo de1.500 palavras e corpo técnico de ao menos60% do post, a profundidade passou a ser métrica de entrega, não desejo de rodapé.

A versão 9.0 nasceu de um fracasso: posts formatados e rasos.

O time percebeu que a IA estava entregando posts com metadados perfeitos, schema impecável e FAQ completo — e um tutorial de cinco linhas no meio disso. A causa raiz era simples e desconfortável: quem escrevia o prompt detalhava exaustivamente a embalagem e dava uma linha só para o conteúdo. A v9.0 é a correção de curso: ela não remove nenhuma regra estrutural da8.5, apenas dá ao corpo técnico o mesmo nível de exigência que o resto sempre teve — formato de passo, contagem de palavras e proporção viraram pré-requisito de execução. Abaixo, o protocolo inteiro aberto — com o exemplo canônico que separa um passo reprovado de um aprovado, o passo a passo de uso e as métricas que a versão passou a cobrar.

O que mudou no Master Rules 9.0 e por que a versão anterior gerava posts rasos?

A v9.0 é a primeira versão do prompt que trata profundidade como métrica em vez de adjetivo. Ela mantém todas as regras estruturais da8.5 — metadados, schema, FAQ, thumbnails, compliance — e acrescenta uma seção inteira, a3.2, que define formato obrigatório para cada passo de tutorial e proíbe o atalho mais comum da IA: transformar um procedimento de oito etapas em três parágrafos elegantes e inúteis. O diagnóstico está escrito na própria abertura do documento: regras de formatação com especificação exaustiva e corpo técnico com uma linha de instrução produzem exatamente o resultado que se espera — embalagem linda, produto vazio. A lição vai além deste prompt: qualquer sistema de geração de conteúdo replica o que você mede, e ignora o que você apenas deseja.

O detalhe que explica por que a9.0 surgiu e não antes: as versões anteriores tinham regras de profundidade, mas elas moravam no rodapé do prompt como "conselhos" — a IA podia lê-las e escolher não aplicá-las sem violar nenhuma regra de formatação, porque nenhuma regra de formatação dependia delas. Na9.0, a inversão é completa: o relatório de qualidade passou a incluir linhas de profundidade, o protocolo de saída passou a exigir a proporção declarada, e a frase "seja detalhado" foi banida em favor de um formato com cinco campos verificáveis por passo. Na prática, a diferença aparece no teste A/B mais simples que existe: pegue o mesmo tema, gere na8.5 e na9.0, e conte quantas frases do corpo ensinam algo que o leitor não sabia antes — a9.0 ganha porque é obrigada a ganhar, não porque o modelo está de melhor humor. É o mesmo princípio que sustenta o acervo de prompts do blog até hoje.

Como funciona o Protocolo de Profundidade Tutorial da Seção 3.2?

O protocolo tem três pilares. Primeiro, o formato de cada passo: toda etapa precisa conter a ação exata copiável, a explicação do que aquela ação faz em linguagem de iniciante, o porquê de ela existir naquele ponto, o resultado esperado na tela e o erro comum com sua correção. Segundo, a quantidade: se o processo real tem oito etapas, o post tem oito etapas — nunca três passos principais escondendo cinco sub-etapas em parágrafo corrido. Terceiro, o mínimo de extensão: três frases de explicação além do comando. Um passo que é só "Rode o comando abaixo:" está reprovado, mesmo que o post inteiro bata a contagem de palavras — o protocolo audita o passo, não só o total.

Veja a diferença na prática, com o exemplo canônico do próprio prompt:

Reprovado

Ação: "Passo 2: Configure a carteira — agora configure sua carteira MetaMask com a rede zkSync."

Sem comando, sem porquê, sem resultado esperado. O leitor fica no lugar exato em que estava: sabendo que precisa fazer, sem saber o que fazer nem como confirmar que deu certo. Trinta segundos de texto que não movem ninguém um centímetro adiante — e é exatamente esse formato que a IA entrega por padrão, porque ele é barato de gerar.

Aprovado

Ação: "Abra a MetaMask, clique no seletor de redes e selecione 'Adicionar rede manualmente'. Preencha com Nome: zkSync Era Mainnet, RPC: https://mainnet.era.zksync.io, Chain ID: 324, Símbolo: ETH."

Porquê: a zkSync é uma L2 e não aparece por padrão; sem a RPC manual, transações falham ou vão para a rede errada — o erro número um que faz gente perder elegibilidade em airdrop.

Resultado esperado: "zkSync Era Mainnet" no topo da MetaMask com saldo 0 ETH, o que é normal antes do bridge.

Erro comum: se a MetaMask recusar por "Chain ID já em uso", a rede já está cadastrada com outro nome — busque em "Redes" antes de tentar de novo.

Repare no que mudou: o segundo exemplo não tem adjetivos extras — tem informação que faltava. É essa a diferença entre profundo e longo: o texto cresceu porque cada lacuna do leitor foi preenchida com algo verificável — um endereço RPC, um número, um sintoma, uma correção. Profundidade, no sentido da9.0, não é quantidade de palavras é quantidade de lacunas fechadas — e é por isso que o protocolo cobre os cinco campos individualmente, em vez de confiar em qualquer contagem global.

Qual é o passo a passo para usar o 9.0 do zero, sem pular nada?

Seguir o fluxo abaixo é o que garante que a IA entregue o post completo em vez de uma versão condensada. Cada etapa traz o que fazer, por que fazê-lo, o que esperar e o que pode dar errado — o mesmo formato que o protocolo exige do conteúdo gerado, porque um prompt que exige profundidade nos tutoriais não pode entregar tutorial raso no uso dele mesmo.

Passo 1: Inicie a sessão com o prompt inteiro

Cole o documento completo do Master Rules 9.0 como primeira mensagem e envie. Isso estabelece a persona, os gatilhos e todas as regras antes de qualquer pedido.

Por quê: o prompt é autossuficiente — ele só vale como base da conversa, não como mensagem avulsa no meio dela. Sem as seções de estrutura e profundidade no contexto, a IA volta a improvisar formato.

Quando funcionar: a IA confirma a versão ativa — "Feito com Master Rules Claude v9.0" — e aguarda o gatilho em silêncio.

Erro comum: enviar só um trecho do documento. Sem as seções de estrutura, o post sai inconsistente — recoloque o documento inteiro e recomece a sessão.

Passo 2: Dispare o gatilho com parâmetros

Escreva {Crie um post: tema="seu tema", nivel="iniciante", objetivo="SEO"}. O parâmetro objetivo nunca autoriza pular passos: o protocolo de profundidade é obrigatório sempre que houver procedimento.

Por quê: os parâmetros calibram densidade e vocabulário — nível iniciante pede mais analogias, avançado pede mais comandos —, não reduzem conteúdo. São ajuste de registro, não de escopo.

Quando funcionar: a IA não comenta plano nenhum — ela silencia e executa, entregando metadados, HTML e JSON de thumbnail na ordem.

Erro comum: exigir que a IA "liste o que vai fazer antes". Isso ativa o meta-comentário e, em versões fracas, dilui a execução — a regra de silêncio existe justamente para proteger a profundidade.

Passo 3: Receba os três blocos e valide a proporção

A ordem é fixa: bloco de metadados, HTML completo, JSON de thumbnail nos três formatos. Antes de publicar, confira o relatório de qualidade: ele traz a contagem real de palavras e a porcentagem do corpo técnico.

Por quê: a9.0 se diferencia exatamente aqui — um post com1.500 palavras e40% de tutorial passa no total e reprova na proporção, e proporção baixa significa estrutura inchada com miolo curto.

Quando funcionar: total acima do piso, proporção acima de60% e ID de vídeo conferido antes da cópia para o Blogger.

Erro comum: aceitar o post sem ler o relatório. Se a proporção vier abaixo de60%, use {Aprofunde a seção X} para expandir só o que está raso, sem tocar no resto.

Passo 4: Corrija o que sobrar com gatilhos cirúrgicos

Use {Corrija} para ajustes pontuais, {Melhore o layout} para CSS e HTML sem tocar em texto, e {Audite o post} para uma auditoria final contra AdSense, E-E-A-T, silo e profundidade.

Por quê: essa separação evita o erro clássico de pedir "melhore tudo" — o que costuma reescrever o que já estava bom e deixar o que estava ruim exatamente onde estava.

Quando funcionar: cada pedido mexe em uma camada só — texto, visual ou diagnóstico — e o resto do post permanece byte a byte igual.

Erro comum: rodar {Melhore o layout} esperando mais conteúdo. Ele mexe só em aparência — profundidade se corrige com {Aprofunde a seção X}.

Como o 9.0 mede profundidade: 1.500 palavras e a regra dos 60%?

O prompt define profundidade com dois números. O primeiro é o mínimo de1.500 palavras de corpo visível, excluindo HTML, CSS, JavaScript, JSON-LD e atributos — contagem do que o leitor realmente lê, não do que existe no arquivo. O segundo número é mais inteligente: o corpo técnico, sozinho, precisa representar pelo menos60% dessa contagem. TL;DR, disclaimers, FAQ, referências e CTA ficam de fora da conta, porque são estrutura fixa, não entrega de valor — e é justamente essa exclusão que impede o truque mais antigo de conteúdo automatizado: inflar as partes fáceis para bater a meta sem ensinar nada.

A consequência prática é impiedosa e justa: um post de1.500 palavras onde700 ficam no FAQ e800 no tutorial está reprovado, mesmo batendo o mínimo — porque o tutorial é o produto. A regra de correção é sempre a mesma: expandir o corpo técnico, nunca inflar a estrutura para compensar. Junto disso, o prompt veta a leitura errada da regra de "não inflar": parágrafo longo que ensina algo novo a cada frase não é enchimento, é o objetivo — e parágrafo curto que repete a ideia anterior é lixo em qualquer tamanho. Note que a9.0 ainda media por total e proporção, sem piso individual por seção: um post podia distribuir as1.500 palavras de forma desigual — seis seções generosas e quase murchas. Essa fresta é o que a9.2 fechou com as200 palavras mínimas por subsessão, e ela já aparecia como sintoma nos testes da própria9.0, na comparação com textos mais densos como os do arquivo de tutoriais do canal.

Quais são os gatilhos e a regra de silêncio do 9.0?

O painel de comandos herda os dez gatilhos da versão anterior e ganha um décimo primeiro: {Aprofunde a seção X}, que reescreve apenas a seção indicada com passo a passo completo, sem tocar no resto do post. É o remédio direto para o diagnóstico que motivou a versão: em vez de regerar tudo, você expande o que ficou raso — cirurgia, não replanejamento. Os demais permanecem: {Crie um post} para geração completa, {Crie conteúdo} para texto puro, {Preview do post} para aprovação prévia, {Crie um Widget}, {Crie thumbnail}, {Melhore o layout}, {Audite o post}, {Audite}, {Corrija a rejeição} e {Corrija}.

A regra de silêncio merece atenção porque é onde a maioria erra: não verbalizar o planejamento ("vou aplicar a seção X...") esconde o bastidor do usuário, mas não é licença para entregar menos. O próprio prompt declara que, se "ser direto" e "explicar o passo a passo completo" parecerem competir, a explicação completa vence — sempre. Sem gatilho explícito, nenhuma versão gera HTML: a IA pergunta e confirma antes. Dois erros típicos nascem dessa regra: o usuário pede "responda em tópicos rápidos" e interpreta a resposta curta como eficiência (é encurtamento autorizado pelo próprio pedido), ou então pede para a IA "pensar em voz alta" e recebe uma conversa que não é o post. A distinção correta é simples: a regra de silêncio governa o processo, nunca o produto — e quando o produto precisa de dez parágrafos por seção, ele recebe dez parágrafos por seção, com ou sem conversa antes.

O que o 9.0 mantém da v8.5: metadados, thumbnails e compliance?

Nada da base foi removido — e essa é uma decisão de projeto, não uma omissão. O post continua entregando o bloco de metadados antes do HTML, com título SEO, teste A/B de três variações, silo, palavra-chave, intenção, long tails, links internos e externos, tempo de leitura, roteiro de vídeo e trinta hashtags de Instagram no mix de dez de nicho, dez médias e dez amplas. O JSON de thumbnail continua nos três formatos —16:9 para YouTube,9:16 para Stories e Shorts,1:1 para feed — com o campo contexto_visual que infere país, cultura e época do tema, vestindo a pessoa da imagem de acordo com o contexto brasileiro de2026 em vez de um estereótipo genérico de "tecnologia".

O compliance também permanece idêntico: E-E-A-T com experiência real, mínimo de dois links externos e três internos, disclaimers para temas financeiros e técnicos, aderência a LGPD, GDPR, EUAI Act e Lei Felca, com o diretório do IAPP como referência permanente. As regras de design seguem integralmente — Font Awesome em vez de Unicode decorativo, paleta de seis cores, assinatura de copyright no style, prefixo em todas as classes, requestIdleCallback para o JavaScript de cópia e as tags de página proibidas em fragmento de Blogger. O SEO também não cedeu: H2 em pergunta com resposta de40a60palavras, TL;DR de três bullets após o título, FAQ com JSON-LD separado, schema BlogPosting completo e links externos com rel="noopener noreferrer". O que mudou foi apenas onde a exigência mora: antes ela estava toda na moldura; agora ela também está no miolo. É esse duplo controle — moldura herdada da8.5 e miolo cobrado pela9.0 — que sustenta a aprovação no AdSense e a permanência de posts de prompt nos resultados.

Quando e como usar {Aprofunde a seção X} sem regerar o post inteiro?

O gatilho {Aprofunde a seção X} existe para o cenário mais comum de pós-produção: um post bom no geral com um ou dois blocos condensados demais. O erro habitual de quem encontra essa falha é pedir "refaça o post com mais detalhes" — o que faz a IA regerar tudo: os metadados mudam, os links oscilam, seções que estavam perfeitas ganham paraphrase nova e você perde a revisão que já tinha aprovado. O uso correto é cirúrgico: aponte a seção pelo título exato do H2, peça a expansão com o formato da Seção3.2e deixe claro que o resto do artigo está intocado. A IA reescreve apenas aquela fatia, seguindo o mesmo protocolo de passos, e o restante permanece byte a byte igual — é a diferença entre trocar o motor do carro e trocar o carro inteiro.

Três dicas tornam o gatilho mais eficiente. Primeiro, diagnostique antes de disparar: conte as palavras da seção suspeita — se ela está acima do piso mas parece rasa, o problema não é tamanho, é falta dos cinco campos do protocolo (comando, porquê, resultado, erro), e você deve pedir "expanda com o formato da3.2" em vez de só "mais texto". Segundo, nunca junte dois pedidos num comando só — "aprove e adicione um exemplo no segundo parágrafo" mistura escopo de {Corrija} com escopo de {Aprofunde} e costuma entregar os dois pela metade. Terceiro, valide depois: releia só a seção alterada contra a lista de checagem da6.3do prompt — ação exata presente, resultado esperado declarado, ao menos um erro comum — e confirme que a proporção global do post não caiu por causa das seções estruturais que não contam na soma.

O que o 9.0 não resolveu — e como as versões 9.1 e 9.2 completaram o serviço?

A9.0 cobria o formato e o volume, mas deixou três frestas abertas, e cada uma virou uma versão depois. A primeira fresta era a veracidade: o protocolo garantia que cada passo tivesse porquê e resultado, mas ninguém garantia que a RPC informada, a versão citada ou o preço mencionado fossem reais — os dados continuavam vindo da memória do modelo. A9.1 corrigiu com a Seção4de pesquisa real: mínimo de4fontes,2oficiais, links clicáveis e data de acesso registrada no campo 🔍 dos metadados, com regra explícita de marcar {verificar} em dado não confirmado em vez de assumi-lo.

A segunda fresta era a autoria: um texto pode ser profundo e ainda assim ser uma paráfrase educada de fontes externas, o que o Google trata como conteúdo duplicado e o leitor percebe como "todo mundo já falou isso". A9.1 respondeu com a Seção7anti-plágio — reescrita integral, máximo de duas citações e insight inédito declarado em 🛡️ Originalidade. A terceira fresta era a distribuição da profundidade: como dito, a9.0 media total e proporção, mas não impedia um post de cheirar a resumo seção a seção — e foi exatamente o que os testes encontraram ao comparar os posts gerados com o documento explicativo do canal, cujos parágrafos tinham muito mais informação por linha. A9.2 fechou com a Seção6.7densidade anti-resumo: piso de3.000palavras totais, ≥200por subsessão, ≥8seções, seis camadas obrigatórias por seção e verificação individual com evidência no relatório. O quadro completo de evolução está no guia de versões do prompt — e a9.0 segue relevante como a versão que provou que profundidade pode ser especificada, não apenas desejada.

Quais são os erros comuns ao aplicar o 9.0 e como contorná-los?

Quatro padrões de falha aparecem com frequência no uso da9.0, e todos têm o mesmo formato de detecção: o post entrega, mas entrega menos do que o protocolo pede. O primeiro é a confusão entre concisão e profundidade: o usuário vê um post curto e acha que o modelo "entendeu" a regra de não inflar — na verdade, a regra de brevidade vale para abertura e transições, e dentro do passo técnico ela nunca vence. O segundo é a contagem seletiva: contar apenas os parágrafos e esquecer que tabelas, blocos de código e listas também são corpo — ou pior, inflar o FAQ para compensar tutorial curto, exatamente o truque que a proporção de60% existe para pegar.

O terceiro erro é tratar {Audite o post} como botão de conserto: a auditoria diagnostica, não edita — quem pede auditoria esperando correção automática recebe um relatório e nenhuma mudança, e interpreta isso como falha da ferramenta quando na verdade é separação de escopo proposital. O quarto é pular o relatório de qualidade: ele é a única etapa entre a geração e a publicação, e nele estão as linhas de proporção e contagem — publicar sem ler é entregar sem validar. O contorno de todos os quatro é o mesmo hábito: antes de copiar o HTML, leia o relatório inteiro, confira duas linhas (total e proporção) e só então cole no Blogger — trinta segundos que evitam o ciclo completo de "gerar de novo porque saiu errado".

Perguntas Frequentes

O que é o Master Rules 9.0?

É a versão9.0 do prompt mestre do @CanalQb, um system prompt autossuficiente que transforma a IA no gerente assistente de conteúdo do ecossistema. Ela herda toda a base da8.5 — estrutura deblocos, metadados, thumbnails, FAQ com schema e compliance jurídico — e adiciona o Protocolo de Profundidade Tutorial da Seção3.2. A grande novidade é tratar profundidade como métrica auditável: formato obrigatório para cada passo, mínimo de1.500palavras e corpo técnico de ao menos60% do post, tudo verificado em um relatório de qualidade emitido junto com a entrega.

Qual é a diferença entre o 9.0 e o 8.5?

A diferença central é o nível de exigência sobre o corpo técnico. A8.5 já pedia1.200palavras e tinha regras estruturais excelentes, mas a instrução de profundidade era uma linha — e o resultado era post com moldura perfeita e tutorial curto. A9.0 mantém tudo que a8.5 tinha e cria a Seção3.2, que obriga cada passo a trazer ação exata, porquê, resultado esperado e erro comum, além da proporção de60% e do gatilho {Aprofunde a seção X}. Em resumo: a8.5 define o formato; a9.0 define o formato e o volume mínimo de ensino dentro dele.

O que é a regra dos 60% de corpo técnico?

É a métrica que impede o post de ficar inchado: o bloco de corpo técnico precisa representar, sozinho, ao menos60% das palavras visíveis do post. TL;DR, disclaimers, FAQ, rodapé de referências e CTA ficam de fora da conta, porque são estrutura fixa e não a entrega de valor prometida pelo título. Se o post bate1.500palavras mas o tutorial fica com45%, ele está reprovado — e a correção é sempre expandir o corpo técnico, nunca inflar o FAQ ou o TL;DR para inflar a contagem total. É a métrica que garante que a promessa do post seja cumprida dentro do post.

Como funciona o gatilho {Aprofunde a seção X}?

É o décimo primeiro comando do painel de ações, criado na9.0. Você indica a seção que ficou rasa e a IA reescreve apenas ela, expandindo com o passo a passo completo do Protocolo de Profundidade — ação, porquê, resultado e erro comum — sem tocar no restante do post. Ele resolve o cenário mais comum de pós-produção: um post bom no geral com um ou dois passos condensados demais. O uso correto é sempre cirúrgico, apontando a seção exata, porque a alternativa — pedir que o post todo seja "mais detalhado" — tende a regerar o que já estava certo e desperdiçar o trabalho feito.

A regra de silêncio reduz a qualidade do post?

Não — e o9.0deixa isso explícito porque era uma confusão comum. A regra de silêncio proíbe apenas o meta-comentário: a IA não deve listar "vou aplicar a seção3.2agora, depois verifico o CSS" antes de agir. Isso esconde o bastidor do usuário, mas jamais autoriza encurtar o resultado. O próprio documento declara que, se a direz da comunicação e a explicação completa parecerem competir, a explicação completa vence. Ou seja: a IA fala menos sobre o processo e entrega mais no produto final — a regra existe para proteger a profundidade, não para sacrificá-la.

Fontes e Referências

Quer ver a v9.0 em ação? Assista ao @CanalQb no YouTube e continue em canalqb.com.br.

Feito com Master Rules Claude v9.0

Prompt Master Rules 8.5: o que ele faz e como usar

noreply@blogger.com (CanalQb) — Mon, 12 Oct 2026 15:38:03 -0300

@CanalQb no YouTube

Prompt Master Rules 8.5: o que ele faz e como usar

Leitura: ~16 min

TL;DR:

O Master Rules 8.5 é um prompt mestre de 27 seções que transforma o Claude no gerente de conteúdo de um blog: você digita {Crie um post} e recebe metadados, HTML pronto para o Blogger e prompts de thumbnail.
Ele é excelente no formato — schema, FAQ, accessibility, compliance e design premium saem corretos de primeira — mas nunca consulta a internet: os dados vêm da memória do modelo.
Para usar, cole o documento inteiro como primeira mensagem, dispare o gatilho e cole o HTML no Blogger. Quem precisa de pesquisa real e mais volume passa para as versões 9.x.

Cole um documento de 27 seções no Claude, digite sete caracteres — e receba um post inteiro.

Esse é o contrato do Master Rules 8.5: em vez de você reescrever as mesmas instruções de formato, SEO, FAQ e design em toda conversa, você entrega uma vez o manual completo do canal e só comanda o que quer gerar. A versão 8.5 foi a primeira a equilibrar bem as duas metades do trabalho — metadados riquíssimos para o Blogger e HTML que não precisa de ajuste manual para ficar aceitável. Ela também expôs o limite que as próximas versões passariam a corrigir: formatar não é pesquisar, e um post bem formatado com dados de memória continua sendo um post frágil. Neste guia completo, cada peça do 8.5 aberta — as 27 seções agrupadas, o protocolo de três blocos, o design system obrigatório e o passo a passo de ponta a ponta.

O que é o Master Rules 8.5 e o que ele resolve na prática?

O Master Rules 8.5 é um prompt mestre — um system prompt autossuficiente — que define quem a IA é, como ela escreve, o que ela entrega e em que formato, para operar um blog monetizado com precisão de manual técnico. Ele resolve um problema prático de quem publica com frequência: sem um prompt assim, cada post exige que você repita do zero as instruções de estrutura (blocos do Blogger), SEO (títulos, headings, schema), formato de saída (metadados + HTML + thumbnails) e estilo visual (cores, ícones, acessibilidade). Com o8.5, essas instruções são escritas uma vez e valem para sempre — o que reduz o ciclo de um post de horas para minutos de comando.

O que diferencia o8.5 de um prompt genérico é o grau de especificidade: ele não pede "escreva um bom post", ele determina que o TL;DR venha logo após o título em três bullets, que cada H2 seja uma pergunta com resposta de 40 a 60 palavras logo abaixo, que o schema BlogPosting e o JSON-LD do FAQ sejam blocos separados, que todo ícone seja Font Awesome em vez de emoji decorativo, e que a saída venha em ordem fixa — bloco de metadados, HTML completo, JSON de thumbnail. É essa obsessão pelo detalhe verificável que fazia do8.5 a referência de qualidade de saída entre as versões: o que ele prometia no formato, ele entregava. O que ele nunca prometeu — e não entregava — era a verificação dos fatos dentro do texto, e é exatamente aí que as versões9.x entram no lugar. O acervo de prompts do canal explica a evolução completa.

Como o prompt de 27 seções é organizado e o que cada grupo faz?

As 27 seções do8.5 não são uma lista solta: elas se agrupam em quatro blocos funcionais que se aplicam sempre nesta ordem — identidade, execução, apresentação e auditoria. Entender o agrupamento economiza tempo na hora de adaptar o prompt para outro site, porque mudanças de identidade acontecem no primeiro grupo e mudanças de layout no terceiro, nunca no meio do protocolo de geração. A tabela abaixo mostra o mapa completo, com o que cada grupo responde e por que ele existe.

Grupo	Seções	Responde	Exemplos do que define
Fundação	1–3	Quem é a IA e quando agir	Persona do canal, gatilhos {Crie um post}, {Audite}, {Corrija}, regra de silêncio
Escrita	4–8	Como o texto é produzido	Redação e humanização, Pattern Interrupt, profundidade, anti-plágio, sequência das 13 blocos
Apresentação	9–16	Como o post aparece	Design premium, compliance, schema, templates fixos, metadados, thumbnail, FAQ, substituições
Operação	17–27	Como o site roda	Infra/Core Web Vitals, IAPP, UX, CSS/JS/acessibilidade, skills, receitas, checklist, changelog

Vale notar o que esse mapa revela sobre o desenho do prompt: 4 das 27 seções cuidam do pós-escrita (design, schema, metadados, FAQ) e apenas uma cuida da verificação de conteúdo — e ela é um checklist, não uma pesquisa. Essa assimetria é intencional na8.5 e explica por que a versão gera posts visualmente maduros em troca de nenhuma conferência externa de dados. Quando você adapta o prompt para o seu site, mexe em Fundação (nomes, links, voz) e em Apresentação (cores, templates), deixando Escutura e Operação intactas — são elas que garantem que qualquer post saia igual ao anterior.

Como funciona o protocolo de saída em três blocos?

O protocolo de saída é a regra que garante que {Crie um post} entregue tudo de que o editor precisa, na ordem certa e sem conversa no meio: primeiro o bloco de metadados, depois o HTML completo do post, e por último o JSON com os prompts de thumbnail nos três formatos. Nenhuma explicação, checklist ou comentário é permitido entre os blocos — o silêncio entre eles existe para que você possa copiar cada parte direto para o seu destino (metadados para os campos do Blogger, HTML para o editor, JSON para a ferramenta de imagem) sem precisar filtrar texto conversacional.

Essa ordem não é decorativa: ela espelha o fluxo real de publicação. Os metadados vêm primeiro porque são a decisão editorial — título, palavra-chave, silo, links, intenção — e se algum estiver errado, você corrige antes de gastar tempo com o HTML. O HTML vem no meio porque é o corpo do trabalho, com a estrutura de 13 blocos já montada — cabeçalho com o link do canal, banner, H1, style com a assinatura de copyright, badge de leitura, TL;DR, vídeo, disclaimer, introdução com pattern interrupt, corpo técnico, FAQ, referências, schema e CTA. O JSON de thumbnail vem por último porque é insumo de terceiros: ele não entra no Blogger, vai para o Gemini Imagen ou equivalente, e por isso é entregue como bloco destacado com os formatos 16:9, 9:16 e 1:1 e o campo contexto_visual que descreve a cena considerando país, cultura e época. O resultado é um fluxo de três copiar-e-colar que qualquer pessoa executa sem treinamento — é o coração do tutorial de publicação do canal.

O que vem no bloco de metadados e por que ele economiza horas de trabalho?

O bloco de metadados é a primeira entrega de {Crie um post} e concentra todas as decisões editoriais que, sem um template, você teria que inventar ou pesquisar para cada publicação. Nele entram título SEO (30–60 caracteres com a palavra-chave), três variações de título para teste A/B, silo (pilar ou satélite), palavra-chave principal, marcadores do Blogger, intenção de busca, três long tails, links internos montados com a busca do próprio site, links externos de autoridade, tempo de leitura, resumo para vídeo de três a cinco linhas, playlist, hashtags e tags do YouTube, trinta hashtags de Instagram com mix de nicho/médias/amplas e o contexto visual da thumbnail. São dezenas de campos que o Google e o Blogger esperam e que a maioria dos editores preenche no improviso — com o8.5, saem padronizados em todo post.

O campo que mais tempo poupa na rotina é o de links internos: o prompt monta as URLs com a base de busca do seu site + termo relevante, garantindo os mínimos de três internos e dois externos por post sem que você precise lembrar quais páginas existem — e sem que a IA invente um endereço que não existe, porque a regra é sempre montar a URL pela base declarada. Junto dos metadados vem o relatório de qualidade: uma tabela de cerca de vinte linhas que audita o próprio post antes de você ver — pattern interrupt presente, resposta AEO no tamanho certo, proporção de performance, E-E-A-T, schema, acessibilidade, ícones Font Awesome, tudo com status ✅ ou ⚠️ e a evidência da checagem. É o prompt verificando a si mesmo no que é verificável: formato, presença e estrutura. O relatório8.5 não julga profundidade nem veracidade dos dados — essas duas auditorias só chegariam nas versões9.x, e essa fronteira é importante para você calibrar o que pode e o que não pode confiar numa ferramenta de formatação. Detalhes de monetização estão no guia de AdSense do blog.

Como o 8.5 estrutura um tutorial legível: Pattern Interrupt, bucket brigades e answer target?

Três regras de escrita do8.5 trabalham juntas para segurar o leitor do primeiro ao último parágrafo. A primeira é o Pattern Interrupt da abertura: o post não começa com apresentação institucional, e sim com uma frase curta e inesperada — um número, uma afirmação contraditória ou uma promessa concreta — que quebra o piloto automático de quem veio do Google ou do feed. A segunda são as bucket brigades: frases de ligação curtas ("O resultado?", "Agora vem o pulo do gato.") que mantêm o ritmo entre seções e reduzem a taxa de rejeição, especialmente em texto longo. A terceira é o answer target: cada H2 é uma pergunta e os 40 a 60 palavras imediatamente depois são a resposta completa e autônoma — formatada para ser extraída como snippet pelo Google e respondida por assistentes de IA sem depender do resto do texto.

O ponto não óbvio dessas três regras é que elas têm escopos diferentes e não podem se misturar: pattern interrupt e bucket brigades valem na abertura, em transições e em momentos de tensão — nunca dentro de um passo técnico, onde a clareza do procedimento vence a dramaturgia. Já o answer target vale sob todo H2 do corpo, sem exceção, porque é o que faz o post responder buscas instantâneas. A consequência prática é uma leitura que alterna entre três registros: impacto no início, resposta direta em cada seção e procedimento completo dentro dela — TL;DR de três bullets logo após o título satisfaz o leitor com pressa, e o corpo satisfaz quem vai executar. O8.5 foi a versão que consolidou esse equilíbrio, e ele continua valendo em todas as posteriores, inclusive na atual.

Quais regras de design o prompt impõe e por que elas existem?

O8.5 trata o HTML do post como produto de design, não como texto vestido. Cinco regras explicam por que os posts saem consistentes mesmo gerados por IA: (1) Font Awesome obrigatório — todo ícone é <i class="fas fa-check"> carregado por CDN, porque emoji e Unicode decorativo quebram leitores de tela, variam entre sistemas e poluem a estética; (2) paleta fixa de seis cores lidas do prompt — verde de aprovação, vermelho de erro, amarelo de aviso, azul informativo e dois tons de texto, todos em contraste AA; (3) assinatura de copyright no topo do bloco style, provando a autoria do template; (4) prefixo em todas as classes CSS para não colidir com o tema do Blogger; (5) performance embutida — imagem principal com fetchpriority="high", lazy loading nos iframes e requestIdleCallback para o JavaScript de cópia de código, protegendo LCP e INP.

Essas regras existem porque o editor do Blogger é um campo minado para quem gera conteúdo automatizado: classes genéricas colidem com o tema, emoji viram quadrados em dispositivos antigos, JavaScript no topo do corpo empurra o layout para baixo e cores sem contraste reprovam tanto a acessibilidade quanto a leitura humana. Ao fixar tudo no prompt, o8.5 elimina a etapa de "arrumar o HTML depois" — o que é metade do valor real do prompt, porque a outra metade (escrever) qualquer modelo faz, mas quase nenhum entrega sem retoque no visual. Abaixo, o checklist que o próprio prompt exige antes de publicar — é o que separa um post "gerado" de um post "pronto":

Título de 30 a 60 caracteres com a palavra-chave principal nos primeiros quatro palavras.
TL;DR de três logo após o H1 e disclaimer adequado ao tema antes do corpo.
Cada H2 como pergunta, com resposta AEO de 40 a 60 palavras logo abaixo.
Links internos montados pela busca do site; externos com rel="noopener noreferrer".
Schema BlogPosting e FAQPage em JSON-LD separados, sem comentários no meio.
Ícones Font Awesome carregados; zero emoji decorativo no corpo do HTML.
Imagens com alt, width e height; CSS com a assinatura e sem classes duplicadas.
ID do vídeo conferido — se for o padrão, o aviso de substituição está visível.

Como funcionam o FAQ e os schemas para o Google e para as IAs?

O8.5 entrega o FAQ em dois formatos simultâneos, e a distinção importa: o bloco visível é uma lista de perguntas em acordeão — cada uma com resumo clicável, ícone Font Awesome e resposta detalhada contendo ao menos um link interno — enquanto o JSON-LD FAQPage é um bloco de dados estruturados separado, invisível ao leitor, que traduz as mesmas perguntas para o Google. Essa dupla existe porque a página precisa agradar a dois públicos com requisitos diferentes: o humano quer escanear perguntas e clicar na que interessa; a máquina quer um objeto schema.org validável que possa virar rich result e resposta direta em assistentes de busca. Misturar os dois num bloco só — o erro mais comum de quem monta à mão — quebra a validação e desperdiça a leitura.

Acima do FAQ vem o schema BlogPosting completo: headline, descrição, autor, publisher com logo em URL absoluta, datas de publicação e modificação, idioma, licença e a URL canônica — tudo preenchido com as variáveis do prompt para não vazar valor placeholder no JSON. O8.5 também exige que esses blocos venham depois do conteúdo visível e sem comentários ou textos entre eles, porque o editor do Blogger é sensível à ordem dos scripts e um comentário no meio do JSON-LD invalida o objeto inteiro silenciosamente. O resultado prático é um post que passa no Rich Results Test com os mesmos blocos que você já copiou no fluxo normal — nenhuma tarefa extra de SEO on-page depois de publicar. Para validar depois de publicar, use as ferramentas de dados estruturados do Google e o checklist de conformidade do canal.

Quais são as limitações do Master Rules 8.5 — o que ele não faz?

Três limitações do8.5 são estruturais, não bugs — e conhecerlas evita expectativa errada. A primeira é a ausência de pesquisa: o prompt não abre a internet, não consulta documentação oficial e não data fontes. Toda informação factual de um post — versões de ferramentas, valores, comandos novos, preços — sai da memória do modelo, que tem corte de conhecimento e pode errar com confiança. A segunda é o volume: o8.5 exige um mínimo de1.200 palavras com proporção de60% de corpo técnico, mas não define densidade por seção, então um post pode bater o total com seções rasas — o modelo tende a entregar o essencial e parar, porque nada no prompt o obriga a ir além. A terceira é a originalidade: ele pede texto próprio, mas não executa uma rodada anti-plágio auditável nem exige insight inédito declarado nos metadados.

Essas três limitações compartilham a mesma causa raiz: o8.5 foi desenhado como o auge da camada de apresentação — formato, design e compliance — e nunca teve uma camada de apuração. Foi exatamente o que os testes posteriores expuseram: posts com metadados perfeitos e JSON impecável sustentando dados que ninguém verificou, com corpo técnico que somava contagem mas não acrescentava informação além do óbvio. A correção veio distribuída: a9.0 criou o Protocolo de Profundidade com passo a passo auditável; a9.1 adicionou pesquisa real datada, anti-plágio com insight declarado e estrutura de8sessões com blocos de erros; e a9.2 fechou o problema do resumo com piso de palavras por subsessão. Nenhuma dessas versões substituiu o8.5 no formato — todas herdaram dele exatamente o que ele fazia melhor. A lição prática é simples: use o8.5 quando o assunto é estável e você domina os fatos; migre para as9.x quando o dado for volátil ou o post precisar de volume real.

Qual é o passo a passo para usar o 8.5 do zero até publicar?

O fluxo completo tem quatro etapas e não exige conhecimento técnico — só disciplina de seguir a ordem, porque cada etapa alimenta a seguinte. Os passos abaixo trazem a ação exata, o porquê de existir, o resultado esperado e o erro mais comum de cada um, no mesmo formato que o próprio prompt exige dos tutoriais que gera.

Passo 1 — Inicie a sessão com o documento inteiro

Cole todas as27 seções do prompt como a primeira mensagem da conversa e envie. Nada de pedidos antes disso — o prompt só vale como base da conversa, não como mensagem avulsa no meio dela.

Por quê: a IA precisa da persona, dos gatilhos e de todos os templates no contexto antes de qualquer geração; sem isso, ela improvisa formato e ignora metade das regras.

Quando funcionar: a IA confirma que recebeu as instruções e aguarda o gatilho, sem gerar nada espontaneamente.

Erro comum: colar só um trecho "para testar". O resultado parece aceitável e sai sem schema, sem metadados ou com CSS quebrado — recoloque o documento inteiro e recomece.

Passo 2 — Dispare o gatilho com parâmetros

Escreva {Crie um post: tema="seu tema", nivel="iniciante", objetivo="SEO"}. Os parâmetros são opcionais — se você omitir, a IA infere pelo contexto — mas tema sempre vale informar.

Por quê: o parâmetro tema ancora a pesquisa interna do modelo (palavra-chave, silo, links internos); nível e objetivo calibram vocabulário e densidade do texto.

Quando funcionar: a IA silencia e executa — sem listar plano, sem perguntar nada, entregando os três blocos na ordem.

Erro comum: pedir "me mostra como ficaria antes". Isso ativa conversa e ela entrega versão parcial — peça {Preview do post} quando quiser aprovação prévia, é o gatilho certo.

Passo 3 — Valide o relatório antes de copiar

Leia o relatório de qualidade que acompanha os metadados: confira padrão ✅ nas linhas de estrutura e o aviso ⚠️ de ID de vídeo, se presente.

Por quê: é a última checagem grátis antes de publicar — corrigir no Blogger dá trabalho, corrigir na conversa é um pedido de {Corrija}.

Quando funcionar: todas as linhas críticas estão ✅ e você sabe exatamente o que falta ajustar (geralmente só o ID do vídeo).

Erro comum: publicar sem ler. O relatório é curto e feito justamente para ser lido — dois minutos evitam retrabalho.

Passo 4 — Cole no Blogger e troque o ID do vídeo

Abra o editor do Blogger em modo HTML, cole o fragmento (sem toque nas tags de página), substitua o ID DUDla8Bya8M pelo vídeo real e publique.

Por quê: o ID padrão é um placeholder seguro — a IA não inventa URL de vídeo, e o aviso destacado existe para você lembrar da troca no momento certo.

Quando funcionar: o post renderiza com banner, cores da paleta, FAQ clicável, ícones Font Awesome e schema validável.

Erro comum: colar no modo visual em vez do modo HTML — o código vira texto puro. Sempre alterne para o editor HTML antes de colar.

Perguntas Frequentes

O que é o Master Rules 8.5?

É um prompt mestre de27 seções criado para transformar o Claude no gerente de conteúdo de um blog: ele define a persona do canal, os gatilhos de ação, as regras de escrita, a estrutura de13blocos do HTML, os templates de metadados, FAQ, schema e thumbnail, e o checklist de publicação. Você envia o documento uma vez por sessão e depois dispara comandos como {Crie um post} — a entrega sai em três blocos prontos para o Blogger, sem etapa manual de formatação. Ele funciona em qualquer nicho: basta adaptar as variáveis de identidade e links no topo do arquivo.

Qual é a diferença entre o 8.5 e as versões 9.x?

O8.5 domina a camada de apresentação — formato, design, metadados e compliance —, mas não pesquisa na internet e não cobra volume por seção. A9.0 acrescentou o Protocolo de Profundidade com passo a passo auditável; a9.1 trouxe pesquisa real datada, anti-plágio com insight inédito e8sessões com blocos de erros; a9.2 subiu o piso para3.000palavras e criou densidade mínima de200por subsessão. A diferença prática: o8.5 gera posts com cara de profissional a partir dos seus fatos; as9.x verificam e acrescentam fatos antes de escrever.

O Master Rules 8.5 pesquisa na internet?

Não. Essa é a limitação estrutural da versão: o8.5 não abre links, não consulta documentação oficial e não registra data de fonte. Toda informação factual vem da memória do modelo, sujeita ao corte de conhecimento e a erros com confiança. Por isso o prompt é ideal para assuntos estáveis que você domina — instalações básicas, conceitos, fluxos de trabalho —, enquanto tópicos com versões novas, preços ou políticas que mudam exigem a Seção de pesquisa das versões9.x ou sua conferência manual após a geração.

Quantas palavras o 8.5 exige por post?

O mínimo da versão é1.200palavras visíveis — excluindo HTML, CSS, JavaScript e JSON-LD —, com o corpo técnico representando ao menos60% do total. Ao contrário das9.x, porém, ele não define piso por subsessão nem número mínimo de seções, o que significa que um post pode bater a contagem com estrutura inchada e miolo curto. Se o seu padrão editorial pede artigos longos e densos, o8.5 precisa de acompanhamento humano — ou da regra de densidade introduzida na9.2.

Como uso o prompt na prática — só colo no Claude?

Exatamente: cole o documento inteiro como primeira mensagem de uma nova conversa, aguarde a confirmação e dispare o gatilho desejado, como {Crie um post: tema="..."}. Nunca comece a conversa pelo gatilho sem o prompt, e nunca use o prompt no meio de uma conversa já poluída — o contexto limpo é o que garante que todas as27seções sejam aplicadas. Depois de receber a saída, valide o relatório, troque o ID do vídeo padrão e cole o fragmento no editor HTML do Blogger.

Fontes e Referências

Quer ver o 8.5 em ação? Assista ao @CanalQb no YouTube e continue em canalqb.com.br.

Feito com Master Rules Claude v8.5

Planilha Dia de Sorte que se Atualiza Sozinha

noreply@blogger.com (CanalQb) — Sun, 11 Oct 2026 22:14:34 -0300

@CanalQb no YouTube

Planilha Dia de Sorte que se Atualiza Sozinha (2026)

Leitura: ~16 min

TL;DR:

Montei uma planilha no Google Sheets que puxa todo o histórico oficial do Dia de Sorte direto da API da CAIXA — ela eliminou o trabalho manual de digitar resultados, estatísticas e conferência de jogos de uma vez.
O resultado: 31 dezenas e o Mês da Sorte analisados automaticamente (frequência, atrasos, chi², primos, Fibonacci), 48 jogos gerados por tamanho de aposta (10 QUENTE + 10 FRIO + 10 NEUTRO + 18 mistos Q+F/Q+N/F+Q/F+N/N+Q/N+F) e contagem de apostas premiadas por faixa via COMBIN.
Isso importa porque uma aposta de 15 dezenas custa R$ 16.087,50 em 6.435 combinações — e a planilha mostra exatamente o que você compra em cada faixa antes de gastar.

Aviso: Este conteúdo é estritamente informativo e educacional. Loteria é jogo de azar: nenhuma planilha, estatística ou método garante ganhos ou aumenta sua chance de premiação. Proibido para menores de 18 anos. Jogue apenas o que pode perder, com responsabilidade. O @CanalQb não é afiliado, patrocinado ou endossado pela Caixa Econômica Federal, e os resultados oficiais devem sempre ser conferidos no portal da CAIXA.

Uma aposta de 15 dezenas custa R$ 16.087,50 — e quase ninguém sabe por quê. No Dia de Sorte, marcar dezenas extras não é "dar uma melhorada" no jogo: é comprar milhares de apostas simples de uma vez, via desdobramento oficial C(n;7). Se você não sabe quantas combinações está pagando, está jogando no escuro. Neste post eu mostro a planilha que montei no Google Sheets — ela atualiza o histórico oficial sozinha pela API da CAIXA, calcula todas as estatísticas das 31 dezenas e do Mês da Sorte, gera 48 jogos por tamanho de aposta (30 por tipo + 18 mistos) e ainda conta quantas apostas premiadas cada jogo tem em cada faixa de prêmio. E no final tem o detalhe que quase ninguém percebe: o teste chi² embutido na planilha prova, matematicamente, por que quente e frio não predizem nada.

O que é o Dia de Sorte e quais são as regras oficiais?

No Dia de Sorte você marca de 7 a 15 dezenas, escolhidas entre 01 e 31, mais 1 Mês da Sorte (janeiro a dezembro). A CAIXA sorteia 7 dezenas e 1 mês por concurso, e os sorteios oficiais existem desde 18/03/2018. Hoje os sorteios acontecem de segunda a sexta, a partir das 21h, e aos domingos, a partir das 11h — o calendário foi alterado pela CAIXA, então confira sempre o cronograma oficial no portal. A aposta simples de 7 dezenas custa R$ 2,50, e os prêmios variam por faixa de acerto mais o mês sorteado.

Aqui está o detalhe que quase ninguém percebe: quando você marca mais de 7 dezenas, a CAIXA não cria uma "aposta maior" — ela desdobra sua marcação em todas as combinações de 7 dezenas possíveis, o famoso C(n;7). É por isso que uma aposta de 15 dezenas equivale a 6.435 apostas simples. A tabela abaixo é a mesma que a planilha calcula em cada aba de jogo:

Dezenas marcadas	Apostas simples C(n;7)	Custo estimado
7 dezenas	1	R$ 2,50
8 dezenas	8	R$ 20,00
9 dezenas	36	R$ 90,00
10 dezenas	120	R$ 300,00
11 dezenas	330	R$ 825,00
12 dezenas	792	R$ 1.980,00
13 dezenas	1.716	R$ 4.290,00
14 dezenas	3.432	R$ 8.580,00
15 dezenas	6.435	R$ 16.087,50

E as faixas oficiais de premiação — exatamente as que a planilha exibe na aba Estatísticas — são estas:

Acertos	Chance	Prêmio
7 acertos	1 em 2.629.575	variável (arrecadação/ganhadores)
6 acertos	1 em 15.652	variável (arrecadação/ganhadores)
5 acertos	1 em 453	R$ 25,00 fixo
4 acertos	1 em 37	R$ 5,00 fixo
Mês da Sorte	1 em 12	R$ 2,50 fixo

O Mês da Sorte é o diferencial da modalidade: mesmo sem acertar nenhuma dezena, você ainda leva R$ 2,50 se o seu mês for sorteado. E como o prêmio de 4 acertos é fixo em R$ 5,00, uma aposta de 9 dezenas (R$ 90,00 em 36 combinações) precisa de vários jogos premiados em faixas baixas só para se aproximar do custo — a planilha faz essa conta por você, jogo a jogo. Se quiser ir além do Dia de Sorte, veja também as planilhas de loteria que já publiquei aqui no blog.

Como funciona a atualização automática via API da CAIXA?

A planilha roda no Google Sheets com um menu próprio chamado "Dia de Sorte", criado por um script em Apps Script. Ao clicar em Atualizar Tudo, ela baixa os concursos oficiais da API da CAIXA, recalcula todas as estatísticas, recria o dashboard e regenera as abas de jogos — sem você digitar uma única dezena.

E o melhor? Funciona sem instalar nada além do próprio script.

Por baixo dos panos, o script consulta o endpoint oficial do Dia de Sorte em servicebus2.caixa.gov.br/portaldeloterias/api/diadesorte. Na primeira execução, ele importa o histórico completo de uma vez; nas seguintes, compara o último concurso local com o remoto e baixa só o que falta, com uma pausa de 300 ms entre requisições para não ser recusado. E aqui no @CanalQb, validamos que a API oficial às vezes recusa conexões seguidas — por isso a planilha tem uma API alternativa de reserva embutida: se a oficial falha, ela busca o mesmo dado na rota alternativa e segue o trabalho. Você pode conferir as informações oficiais da modalidade diretamente no portal Loterias CAIXA e na própria API pública da CAIXA.

Como usar a planilha: o menu item a item?

O menu "Dia de Sorte" na barra superior da planilha concentra todas as funções. A aba Inicio, recriável pelo menu, é o manual de uso completo dentro da própria planilha — abaixo, o mesmo guia, item a item.

Ordem recomendada: na primeira vez, rode Atualizar Resultados e depois Gerar Jogos. No dia a dia, um único clique em Atualizar Tudo resolve tudo. Veja cada item:

Atualizar Tudo (botão): faz tudo de uma vez — importa resultados, recalcula estatísticas, gera o DashBoard e recria as abas de jogos. Também pode ser acionado marcando o checkbox na célula A6 de qualquer aba "Jogo NN", que se desmarca sozinho ao terminar. Essa é a rotina diária de quem joga toda semana.
Como usar (aba Inicio): recria a aba de ajuda dentro da própria planilha. Se alguém apagar a aba por engano, um clique traz o manual de volta.
Atualizar Resultados: baixa os concursos oficiais da API da CAIXA para a aba "Todos os Jogos", com o mais recente no topo. É o primeiro passo: sem histórico, nada mais funciona.
Recalcular Estatísticas: recalcula e reescreve a aba "Estatísticas" com base no histórico importado — dezena a dezena, mais Mês da Sorte, paridade, faixas e o teste chi².
Atualizar DashBoard: recria a aba "DashBoard" com gráficos rotulados de frequência por dezena, pares x ímpares, saídas por faixa (01-10, 11-20, 21-31) e distribuição de paridade.
Gerar Jogos: cria as abas "Jogo 07" a "Jogo 15" (uma por tamanho de aposta), cada uma com 48 jogos: 10 QUENTE, 10 FRIO e 10 NEUTRO, sorteados dos respectivos pools de 10 dezenas cada (o pool expande automaticamente quando a aposta exige mais dezenas), mais a seção lilás JOGOS MISTOS (18 jogos: Q+F, Q+N, F+Q, F+N, N+Q e N+F, 3 de cada, metade das dezenas de cada pool) e os jogos MÉDIA, HARMÔNICA e FIBONACCI.
Copiar Jogos para Aposta: abre uma janela com todos os jogos gerados prontos para copiar (Ctrl+C) e levar à lotérica — sem transcrever dezena por dezena.
Deletar Todas as Abas (manter Inicio): reinicia do zero. Depois basta Atualizar Tudo para recriar tudo.
Verificar Instalação: mostra se as abas necessárias existem e o estado da instalação. É o primeiro diagnóstico quando algo não roda.

Se você nunca mexeu com Apps Script no Google Sheets, recomendo ler o guia de automação com Apps Script que publiquei aqui no blog antes de colar o código.

O que significa cada estatística da planilha?

A aba Estatísticas é o coração analítico da planilha. Cada métrica exibida tem um significado específico — e é importante saber o que cada uma diz (e o que nenhuma delas diz: o futuro).

Frequência e Prob. por concurso %: quantas vezes cada dezena (01 a 31) saiu no histórico, e a frequência dividida pelo número de concursos — a chance média de a dezena aparecer em um sorteio. São as duas primeiras colunas da tabela por dezena.
Atraso atual, médio e máximo: quantos concursos se passaram desde a última saída da dezena, o intervalo médio entre suas saídas e o maior intervalo já observado. Atenção honesta da própria planilha: atraso não aumenta a chance de sair — cada sorteio é independente.
Status QUENTE / NEUTRO / FRIO: QUENTE = entre as 10 dezenas mais sorteadas do histórico; FRIO = entre as 10 menos sorteadas; NEUTRO = as do meio. É apenas um retrato do passado, e a planilha avisa isso na aba Inicio.
Soma e amplitude: a soma das 7 dezenas de cada sorteio (média, mínima e máxima) e a distância entre a maior e a menor dezena — juntos, medem o espalhamento típico de um resultado.
Repetições, primos e Fibonacci: média de dezenas repetidas entre concursos consecutivos, quantos números primos (2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31) saem por sorteio e quantas dezenas da sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21) aparecem — curiosidade estatística, não previsão.
Paridade, faixas e consecutivas: distribuição da quantidade de pares por sorteio (0 a 7), saídas por bloco de dezenas (01-10, 11-20, 21-31) e quantos pares de dezenas vizinhas aparecem no mesmo resultado.
Mês da Sorte — mais sorteado: o ranking histórico de quantas vezes cada mês foi sorteado. É a única "coluna extra" exclusiva do Dia de Sorte em relação às outras loterias.
Distribuição de acertos (hipergeométrica): a probabilidade matemática de uma aposta de 7 dezenas acertar 7, 6, 5... 0 números. Exemplo real: 4 acertos acontecem cerca de 1 em 37 vezes.

Mas tem um porém — e é aqui que a planilha se diferencia.

O que o teste chi² prova sobre o Dia de Sorte?

Esta é a parte que quase nenhum "sistema de loteria" tem coragem de mostrar: a planilha roda um teste estatístico de uniformidade (chi²) sobre as 31 dezenas. Se o valor calculado fica abaixo do crítico (43,8, para 5% de significância e 30 graus de liberdade), as dezenas saem de forma estatisticamente uniforme — exatamente como esperado num sorteio honesto.

Este é o insight técnico original deste post: quente, frio e atraso são só descrições do passado, e o chi² da própria planilha prova isso. Quando a estatística mostra chi² abaixo do crítico, qualquer padrão de frequência que você "enxerga" é ruído amostral, não sinal. É por isso que os geradores de jogos da planilha são ferramentas de organização e comparação — não de previsão. Aqui no @CanalQb, validamos que ser honesto sobre isso é o que separa uma planilha séria de um produto de marketing. Para mais análises nesse espírito, veja os posts sobre estatísticas de loteria no blog.

Como ler as abas de jogo (Jogo 07 a Jogo 15)?

Cada aba "Jogo NN" gera 48 jogos para aquele tamanho de aposta, prontos para conferir contra qualquer concurso sorteado. O número da aba é a quantidade de dezenas: "Jogo 09" gera jogos com 9 dezenas (36 apostas simples = R$ 90,00). O layout, coluna a coluna:

Escolha (célula C3): um seletor com todos os concursos da aba "Todos os Jogos". Escolhido o concurso, as linhas 4 se preenchem sozinhas com as 7 dezenas sorteadas e o mês (F4:L4 e N4) — você não digita nada.
Nº e Tipo: identificador do jogo (1 a 30, mais linhas de resumo) e a origem: QUENTE (fundo laranja), FRIO (azul) ou NEUTRO (cinza). Cada grupo tem 10 jogos sorteados do seu respectivo pool de 10 dezenas (QUENTE = as 10 mais sorteadas, FRIO = as 10 menos, NEUTRO = as do meio; o pool expande quando a aposta pede mais dezenas).
Dezenas e Mês da Sorte: as dezenas da aposta em ordem crescente, mais o mês sugerido — QUENTE usa o mês mais sorteado do histórico, NEUTRO o do meio do ranking, FRIO o menos sorteado.
Acertos: quantas dezenas do jogo saíram no resultado escolhido. Cada dezena sorteada acende a célula verde automaticamente (formatação condicional), e o mês também acende quando você o acertou.
Ac7 / Ac6 / Ac5 / Ac4: quantas apostas simples premiadas aquele jogo tem em cada faixa. A fórmula usa COMBIN: se um jogo de 10 dezenas tem 5 acertos, ela calcula C(5;7)×C(5;2)... — na prática, mostra em quantas das 120 combinações de 7 dezenas você garantiu 7, 6, 5 ou 4 pontos. É assim que apostas maiores pagam em várias faixas ao mesmo tempo, e essa coluna é o jeito mais rápido de entender o desdobramento sem fazer conta na mão.
MÉDIA / HARMÔNICA / FIBONACCI (GERAL/QUENTE/FRIO/NEUTRO): 12 jogos extras de "equilíbrio": a média aritmética puxa o jogo para o centro do volante; a média harmônica dá maior peso às dezenas menores e gera jogos mais puxados para 01-15; e os jogos Fibonacci são montados com dezenas da sequência de Fibonacci e suas variações, completadas por frequência quando faltam.
Tabela de referência (direita): as apostas simples equivalentes C(n;7) e o custo estimado — ex.: 8 dezenas = 8 apostas = R$ 20,00; 15 dezenas = 6.435 apostas = R$ 16.087,50.
Checkbox A6: marque para rodar "Atualizar Tudo" sem tocar no menu — ele desmarca sozinho ao terminar. E o comando Copiar Jogos para Aposta reúne todos os jogos de todas as abas numa janela só, prontos para o Ctrl+C.

Quais diferenciais essa planilha tem em relação a uma comum?

Existem muitas planilhas de loteria por aí; a maioria é uma tabela estática que você alimenta à mão. Esta foi construída com critérios diferentes, e cada diferencial abaixo foi testado na prática antes de virar post.

Atualização pela API oficial da CAIXA, com API alternativa de reserva embutida para quando a oficial recusa a conexão.
Colunas Ac7/Ac6/Ac5/Ac4 que desdobram quantas apostas simples premiadas cada jogo gera em cada faixa via COMBIN — a matemática real das apostas múltiplas.
Teste chi² de aleatoriedade na aba Estatísticas — a planilha é honesta a ponto de provar que o sorteio é uniforme.
Análise exclusiva do Mês da Sorte: ranking histórico por mês e mês sugerido por tipo de jogo (QUENTE/NEUTRO/FRIO).
Quatro famílias de jogos (10 QUENTE + 10 FRIO + 10 NEUTRO + 18 mistos por aba) mais três métodos de equilíbrio (MÉDIA, HARMÔNICA, FIBONACCI) em cada uma das 9 abas.
Checkbox A6, Copiar Jogos para Aposta e manual completo embutido (aba Inicio), sempre recriável pelo menu.

Se você curte automação desse tipo, o mesmo conceito de gatilhos e menus no Google Sheets aparece nos posts sobre Google Sheets aqui no blog.

Como baixar a planilha Dia de Sorte do @CanalQb?

A instalação leva menos de dois minutos: você abre a planilha no Google Sheets, vai em Extensões, Apps Script, cola o código e recarrega — o menu "Dia de Sorte" aparece na barra superior. A partir daí, um clique em Atualizar Tudo importa o histórico oficial, calcula as estatísticas das 31 dezenas e do Mês da Sorte, monta o dashboard e gera 48 jogos por tamanho de aposta. Escolhido o concurso, a conferência é automática, com destaque verde em cada dezena sorteada e contagem de apostas premiadas por faixa.

É para quem joga Dia de Sorte com frequência e quer parar de fazer na mão o que a planilha faz em segundos: manter o histórico, ver as estatísticas, montar jogos com critério, saber quanto custa cada aposta múltipla e conferir tudo após o sorteio. Serve tanto para quem joga os R$ 2,50 simples quanto para quem monta apostas de 10, 12 dezenas e quer entender exatamente quantas combinações está comprando. Lembre-se apenas do aviso honesto: estatística nenhuma prevê sorteio — jogue com responsabilidade.

Perguntas Frequentes

Como fazer a planilha Dia de Sorte se atualizar sozinha pela API da CAIXA?

Basta colar o script em Extensões, Apps Script, salvar e recarregar a planilha: o menu "Dia de Sorte" aparece na barra superior. Ao clicar em Atualizar Tudo, o script consulta o endpoint oficial servicebus2.caixa.gov.br/portaldeloterias/api/diadesorte e preenche a aba Todos os Jogos com o mais recente no topo. Na primeira vez ele importa o histórico completo; depois, só os concursos que faltam. Veja o passo a passo completo neste guia de Apps Script.

Quanto custa uma aposta de 10 dezenas no Dia de Sorte?

O que significam as colunas Ac7, Ac6, Ac5 e Ac4 das abas de jogo?

Dezenas quentes e frias aumentam a chance de ganhar no Dia de Sorte?

Como conferir automaticamente os jogos depois do sorteio do Dia de Sorte?

Quais são os prêmios fixos do Dia de Sorte e do Mês da Sorte?

📚 Fontes e Referências

Loterias CAIXA — portal oficial — regras, prêmios, calendário e resultados oficiais do Dia de Sorte.
API pública do Dia de Sorte (servicebus2.caixa.gov.br) — endpoint usado pela planilha para importar os concursos.
Documentação do Google Apps Script e do Google Sheets, base do script que alimenta o menu "Dia de Sorte".

Baixe agora a planilha Dia de Sorte com atualização automática pela API da CAIXA, estatísticas completas, gerador de 48 jogos por aposta e conferência automática de acertos. Assistiu o tutorial? Completo no @CanalQb no YouTube.

Feito com Master Rules Claude v8.5

Comprar

Planilha +Milionária: Estatísticas e Jogos Automáticos no Sheets

noreply@blogger.com (CanalQb) — Sun, 11 Oct 2026 21:06:57 -0300

@CanalQb no YouTube

Planilha +Milionária que se Atualiza Sozinha (2026)

Leitura: ~14 min

TL;DR

Montei uma planilha de +Milionária no Google Sheets que importa sozinha todo o histórico oficial via API da CAIXA — em um clique ela baixa concursos, recalcula estatísticas e gera jogos.
O resultado: 50 dezenas e 6 trevos analisados com frequência, atraso, chi² e distribuição hipergeométrica, mais 7 abas de gerador (6 a 12 dezenas) com 48 jogos cada — 30 base (QUENTE/FRIO/NEUTRO) + 18 mistos — zero fórmulas digitadas à mão.
Isso importa porque conferir jogos contra o sorteio real passa a levar segundos, não tardes — e você enxerga os dados reais da modalidade em vez de achismo de grupo de WhatsApp.

Aviso importante: Este conteúdo é estritamente informativo e educacional, sobre estatística e organização de apostas na loteria +Milionária. Não garante ganhos nem prêmios. Loteria é jogo de azar: nenhuma estatística, método ou planilha prevê sorteios. Destinado a maiores de 18 anos — jogue com responsabilidade e apenas o que pode perder. Este material não é afiliado, patrocinado ou endossado pela Caixa Econômica Federal.

Acertar as 6 dezenas e os 2 trevos é 1 chance em 238.360.500. Enquanto isso, a maioria dos jogadores ainda digita resultado de loteria à mão em planilha — quando digita. Aqui no @CanalQb, cansei desse trabalho repetitivo e montei uma planilha que se atualiza sozinha pela API oficial da CAIXA. E o melhor: ela vai muito além do histórico — estatísticas completas, gráficos e gerador de jogos. Fique até o final porque vou mostrar o detalhe técnico que nenhuma planilha pronta tem: um teste de chi² que audita a honestidade do sorteio dentro da própria aba de estatísticas.

O que é a +Milionária e quais são as regras oficiais?

A +Milionária é a modalidade da CAIXA em que você marca de 6 a 12 dezenas (de 01 a 50) mais 2 a 6 trevos (de 1 a 6); o sorteio apura 6 dezenas e 2 trevos, e os prêmios combinam os dois acertos. A aposta simples custa R$ 6,00 e os sorteios acontecem às quartas (21h) e domingos (11h), desde 20/05/2022.

Só esse detalhe dos trevos já muda tudo em relação às outras modalidades: uma mesma quantidade de dezenas acertadas pode cair em faixas diferentes dependendo dos trevos. É por isso que a planilha conferindo dezenas e trevos de forma automática faz tanta diferença na prática.

Quanto mais dezenas você marca, mais apostas simples você compra de uma vez — cada combinação possível de 6 dezenas entre as suas vale uma aposta. A tabela de custos oficiais abaixo é a que a própria planilha calcula em cada aba de jogo:

Dezenas marcadas	Apostas simples C(n;6)	Custo estimado
6 dezenas	1 aposta	R$ 6,00
7 dezenas	7 apostas	R$ 42,00
8 dezenas	28 apostas	R$ 168,00
9 dezenas	84 apostas	R$ 504,00
10 dezenas	210 apostas	R$ 1.260,00
11 dezenas	462 apostas	R$ 2.772,00
12 dezenas	924 apostas	R$ 5.544,00

E a premiação oficial combina dezenas e trevos assim — tabela oficial da CAIXA, replicada na aba de estatísticas:

Acertos	Chance (1 em...)	Prêmio
6 dezenas + 2 trevos	1 em 238.360.500	62% do bruto (mín. R$ 10 milhões)
6 + 1 / 6 + 0	1 em 17.025.750	10%
5 + 2	1 em 902.881	8%
5 + 1 / 5 + 0	1 em 64.491	8%
4 + 2	1 em 16.798	6%
4 + 1 / 4 + 0	1 em 1.200	6%
3 + 2	1 em 900	R$ 50,00 fixo
3 + 1	1 em 112	R$ 24,00 fixo
2 + 2	1 em 117	R$ 12,00 fixo
2 + 1	1 em 15	R$ 6,00 fixo

Percebeu o tamanho das faixas fixas? Repare que acertar 3 dezenas + 2 trevos paga mais (R$ 50,00) do que 2 + 2 (R$ 12,00) — e a diferença entre 1 em 900 e 1 em 117 é justamente o acerto de mais uma dezena. É esse tipo de leitura que a tabela oficial, dentro da planilha, te obriga a fazer antes de gastar dinheiro.

Como funciona a atualização automática via API da CAIXA?

A planilha roda um script em Apps Script que consulta o endpoint oficial de +Milionária (servicebus2.caixa.gov.br) e importa cada concurso novo para a aba "Todos os Jogos", com as 6 dezenas e os 2 trevos. Se a API oficial recusar a conexão, existe um endpoint alternativo de contingência — e o histórico sempre fica com o concurso mais recente no topo.

Na primeira execução, ela baixa o histórico completo, concurso a concurso. Nas seguintes, compara o último concurso local com o último remoto e busca somente o que falta — com uma pausa de 300 ms entre requisições para não ser bloqueada pelo servidor da CAIXA. Aqui está o detalhe que quase ninguém percebe: a planilha nunca duplica nem desordena linhas, porque a inserção é sempre no topo, em bloco, já ordenada do concurso mais recente para o mais antigo.

E o melhor? Funciona sem instalar nada. É Google Sheets puro: você cola o script em Extensões > Apps Script, salva, recarrega — e um menu novo chamado "+Milionária" aparece na barra da planilha. Se quiser se aprofundar na plataforma, a documentação oficial está em developers.google.com/apps-script e as regras da modalidade em loteriascaixa.gov.br. Já tratamos de automação parecida em outros tutoriais de automação do canalqb.com.br.

Como usar a planilha passo a passo (o menu inteiro, item a item)?

Depois de colar o script, use o menu "+Milionária": na primeira vez, rode "Atualizar Resultados" e depois "Gerar Jogos". No dia a dia, um único comando resolve tudo — "Atualizar Tudo" — que importa resultados, recalcula estatísticas, recria o DashBoard e regenera as abas de jogos de uma vez.

O menu é esse, exatamente como o manual da aba "Inicio" descreve:

Atualizar Tudo (botão) — faz tudo de uma vez: importa resultados, recalcula estatísticas, gera o DashBoard e recria as abas de jogos. Também é acionado marcando o checkbox da célula A6 em qualquer aba "Jogo NN", e ele desmarca sozinho ao terminar.
Atualizar Resultados — baixa os concursos oficiais da API da CAIXA para a aba "Todos os Jogos". É sempre o primeiro passo: sem histórico, nada mais funciona. Cada linha traz concurso, data, as 6 dezenas em ordem crescente e os 2 trevos.
Recalcular Estatísticas — reescreve a aba "Estatísticas" com base em todo o histórico importado. Rode de novo sempre que quiser conferir se algo mudou.
Atualizar DashBoard — recria a aba "DashBoard" com gráficos de frequência por dezena, pares × ímpares, saídas por faixa e paridade dos sorteios.
Gerar Jogos — cria as abas "Jogo 06" a "Jogo 12", uma por tamanho de aposta, cada uma com 48 jogos: 10 QUENTE, 10 FRIO, 10 NEUTRO e 18 MISTOS (seção lilás Q+F, Q+N, F+Q, F+N, N+Q, N+F), mais 12 linhas MÉDIA/HARMÔNICA/FIBONACCI.
Copiar Jogos para Aposta — abre uma janela com todos os jogos gerados (aba, tipo, dezenas e trevos) prontos para copiar com Ctrl+C e levar à lotérica.
Deletar Todas as Abas (manter Inicio) — apaga tudo exceto o manual. Útil para recomeçar do zero com "Atualizar Tudo".
Verificar Instalação — mostra se as abas necessárias existem e o estado geral da instalação.

Mas tem um porém que economiza seu dia: se você marcar o checkbox da célula A6 em qualquer aba de jogo, o "Atualizar Tudo" roda sozinho — sem abrir menu nenhum. Um clique, café, pronto.

O que significa cada estatística da planilha?

A aba "Estatísticas" mostra, para cada dezena de 01 a 50: frequência, probabilidade por concurso, atraso atual, atraso médio e máximo, e um status QUENTE, NEUTRO ou FRIO. Além disso, painéis de soma, amplitude, primos, Fibonacci, trevos, paridade, faixas, quadrantes e um teste chi² de uniformidade.

Traduzindo item a item — porque "número solto" sem explicação não serve para nada:

Frequência — quantas vezes cada dezena saiu em todos os concursos importados. É a base de todo o resto. A "Prob. por concurso %" é só a frequência dividida pelo número de concursos: a chance média de a dezena aparecer num sorteio.
Atraso atual / médio / máximo — há quantos concursos a dezena não sai, qual o intervalo médio entre as saídas dela e qual o maior jejum já observado. E aqui vem o aviso honesto que a própria planilha imprime: atraso NÃO aumenta a chance de sair, porque cada sorteio é independente.
Status QUENTE / NEUTRO / FRIO — QUENTE são as 17 dezenas mais sorteadas do ranking; FRIO, as 16 menos sorteadas; NEUTRO, as do meio. É um retrato do passado, não uma previsão — e a planilha deixa isso claro em cada aba.
Soma e amplitude — a soma das 6 dezenas de cada sorteio (média, mínima e máxima) e a distância entre a maior e a menor dezena. Juntas, mostram o "espalhamento" típico de um sorteio da modalidade.
Primos e Fibonacci — quantos números primos (2, 3, 5, 7, 11, 13... até 47) e quantas dezenas da sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21, 34) aparecem por sorteio, com a distribuição completa. Referência clássica de estatística de loterias.
Trevos (1 a 6) — quantas vezes cada trevo já foi sorteado e a probabilidade por sorteio, cujo valor esperado é 33,33% por trevo (2 sorteados entre 6 possíveis). Cada concurso apura 2 trevos, então a planilha soma os dois.
Distribuição de acertos (hipergeométrica) — a probabilidade matemática real de uma aposta de 6 dezenas acertar 6, 5, 4... 0 números. Não é achismo: é a fórmula hipergeométrica aplicada ao universo de 50 dezenas.

E aqui está o insight técnico original que eu prometi na abertura. A planilha calcula o teste de aleatoriedade chi²: ela compara a frequência observada de cada dezena com a frequência esperada e soma os desvios quadrados normalizados. O valor crítico com 49 graus de liberdade e nível de 5% é 66,3 — se o resultado fica abaixo disso, as 50 dezenas estão estatisticamente uniformes, exatamente como se espera de um sorteio honesto. Aqui no @CanalQb, validamos que esse é o único teste da planilha capaz de dizer alguma coisa sobre o futuro: não quais dezenas vão sair, mas se o sorteio é equiprovável. Quente e frio não têm valor preditivo; o chi² tem valor de auditoria. É uma diferença que quase nenhum conteúdo de "estatística de loteria" explica.

Como ler as abas de jogo (Jogo 06 a Jogo 12)?

O número da aba é a quantidade de dezenas da aposta: "Jogo 09" gera jogos com 9 dezenas (84 apostas simples, R$ 504,00). Cada aba traz 48 jogos — 10 QUENTE, 10 FRIO, 10 NEUTRO e 18 MISTOS (Q+F, Q+N, F+Q, F+N, N+Q, N+F, 3 de cada) — mais 12 linhas MÉDIA, HARMÔNICA e FIBONACCI, com colunas de Acertos, Trevos OK, célula verde automática e uma tabela de custo C(n;6) × preço simples à direita.

Cada elemento da aba tem função específica — e vale saber ler todos antes de apostar:

Tipo (QUENTE / FRIO / NEUTRO) — a origem do jogo, identificada por cor: laranja para quente, azul para frio, cinza para neutro. Os jogos são amostrados de três pools distintos (as 30 mais sorteadas, as 30 menos sorteadas e 30 intermediárias do ranking), sempre com paridade equilibrada (mais ou menos metade pares, metade ímpares).
Trevo 1 e Trevo 2 — os 2 trevos sugeridos para cada jogo, sorteados ao acaso entre 1 e 6. Como a premiação combina dezenas e trevos, o par de trevos faz parte da aposta — e o gerador nunca cria jogos repetidos: a chave de deduplicação inclui dezenas e trevos.
Escolha (célula C3) e resultado automático — você seleciona o concurso na lista suspensa e as 6 dezenas (F4:K4) e os 2 trevos (M4:N4) são preenchidos sozinhos por fórmulas INDEX/MATCH contra o histórico. Não digite ali.
Acertos e Trevos OK — colunas calculadas: quantas dezenas do jogo saíram no resultado e quantos trevos coincidem. Ficam vazias enquanto nenhum concurso estiver escolhido.
Célula verde — formatação condicional que pinta automaticamente cada dezena do seu jogo que saiu no concurso escolhido. É a conferência visual em um olhar.
MÉDIA / HARMÔNICA / FIBONACCI — jogos "equilibrados" montados de três formas: a média aritmética dá o centro das dezenas de cada grupo; a harmônica puxa os jogos para as dezenas baixas (01 a 25), porque pesa mais os valores menores; e os Fibonacci usam a sequência clássica e variações, completadas por frequência quando faltam dezenas.
JOGOS MISTOS (seção lilás) — 18 jogos ao final da aba, 3 de cada combinação Q+F, Q+N, F+Q, F+N, N+Q e N+F: metade das dezenas do primeiro pool + metade do segundo (ex.: Q+F = quentes + frias), sem repetição e em ordem crescente, cada jogo com seus 2 trevos e a mesma conferência de Acertos e Trevos OK. Em apostas ímpares o primeiro pool entra com a dezena a mais (ex.: 7 dezenas = 4 + 3).
Checkbox A6 — marque para rodar "Atualizar Tudo" sem abrir o menu. Ele desmarca sozinho ao terminar.
Tabela de referência — quantas apostas simples seu tamanho de jogo equivale (C(n;6)) e o custo estimado a R$ 6,00 cada. É o freio de emergência antes de marcar 12 dezenas: 924 combinações, R$ 5.544,00.

E o segundo insight técnico que prometi? Veja como o COMBIN dos tiers revela apostas premiadas por faixa. Como os 48 jogos de cada aba são amostrados de pools distintos (QUENTE, FRIO, NEUTRO e os mistos entre eles), o custo real da aba não é 48 apostas simples: cada jogo de n dezenas equivale a C(n;6) apostas simples. Somando os tiers você descobre, por exemplo, que a aba "Jogo 08" sozinha cobre 1.344 apostas simples (28 por jogo × 48 jogos) por R$ 8.064,00 — e as colunas de Acertos contam exatamente quantas dessas combinações bateram em cada faixa no concurso escolhido. É o tipo de leitura que transforma uma "planilha de gerador" em ferramenta de conferência de bolão. Se você administra jogos coletivos, veja também nossas outras planilhas de loteria.

Vale a pena baixar a planilha de +Milionária em 2026?

Sim, se você joga com método e quer dados reais: a planilha elimina o trabalho manual de copiar resultados, calcula estatísticas que nenhum site de loteria entrega junto (chi², hipergeométrica, trevos por concurso) e confere dezenas e trevos automaticamente. Para bolões e apostadores habituais, o ganho de tempo é diário — para curiosos, é um laboratório de estatística de graça.

Resumo do que ela resolve, na prática:

Histórico oficial atualizado pela API de +Milionária da CAIXA, com contingência automática — sem nunca digitar um resultado.
Estatísticas de 50 dezenas + 6 trevos com ranking, atrasos, primos, Fibonacci, faixas, quadrantes, paridade e o teste chi² de uniformidade.
Sete abas geradoras (Jogo 06 a Jogo 12) com 48 jogos cada (30 base + 18 mistos) e conferência automática por célula verde.
Manual completo embutido na aba "Inicio" — o mesmo guia que repliquei neste post, item a item.

Aqui no @CanalQb, otimizamos este script para os leitores do canalqb.com.br: cada função é comentada e o arquivo .gs é autoinstalável — colar, salvar, pronto. Se quiser comparar com outras modalidades que já cobrimos, confira o material de Mega-Sena e mais tutoriais de Google Sheets do canal.

Perguntas Frequentes

Como fazer a planilha de +Milionária atualizar os resultados sozinha?

A planilha de +Milionária garante prêmio ou prevê as dezenas sorteadas?

Quanto custa jogar 12 dezenas na +Milionária?

O que significam QUENTE, NEUTRO e FRIO nas abas de jogos?

Como conferir meus jogos da +Milionária automaticamente?

A planilha funciona no Excel ou só no Google Sheets?

📚 Fontes e Referências

Baixe agora a Planilha +Milionária — histórico oficial via API da CAIXA, estatísticas completas com chi², gerador de 7 abas de jogos e conferência automática de dezenas e trevos. E inscreva-se no @CanalQb no YouTube para os próximos tutoriais de automação e planilhas.

Feito com Master Rules Claude v8.5

Comprar

Planilha Lotofácil que se Atualiza Sozinha (2026)

noreply@blogger.com (CanalQb) — Thu, 8 Oct 2026 23:11:19 -0300

@CanalQb no YouTube

Planilha Lotofácil que se Atualiza Sozinha (2026)

Leitura: ~12 min

TL;DR:

Montei uma planilha Google Sheets que puxa sozinha todos os resultados oficiais da Lotofácil direto da API da CAIXA — agora com o rateio completo (ganhadores e prêmio das faixas 15 a 11) — e recalcula estatísticas de mais de 3.300 concursos em segundos, sem digitar uma única dezena.
O resultado: 5 abas de jogo (15 a 20 dezenas) com 30 jogos QUENTE, FRIO e NEUTRO cada, filtrados por padrões estatísticos reais, mais uma aba de Fechamentos com piso verificado por força bruta, conferência automática por faixa e custo oficial calculado, de R$ 3,50 a R$ 54.264,00.
Isso importa porque elimina o trabalho manual de conferir bilhetes e desvenda quantas apostas simples premiadas um jogo maior realmente contém, com matemática oficial (COMBIN) e um aviso honesto: estatística não prevê sorteio.

Aviso: Este conteúdo é estritamente informativo e educacional. Loteria é um jogo de azar: nada nesta planilha garante ganhos ou aumenta a chance de premiação, pois cada sorteio é independente. Proibido para menores de 18 anos. Jogue com responsabilidade e nunca aposte mais do que pode perder. Este material não é afiliado, patrocinado nem endossado pela CAIXA Econômica Federal.

Uma aposta de 15 dezenas na Lotofácil custa R$ 3,50 e a chance de acertar as 15 é de 1 em 3.268.760. Quem joga 20 dezenas na verdade está comprando 15.504 apostas simples de uma vez, o que explica os R$ 54.264,00 da faixa oficial. Pois bem: dá para controlar tudo isso, do resultado ao custo, dentro de uma única planilha que se atualiza sozinha. E o mais curioso vem no final, quando explico o que o teste de chi² revela sobre as dezenas quentes.

O que é a Lotofácil e quais são as regras oficiais?

A Lotofácil é a loteria da CAIXA em que você marca de 15 a 20 dezenas entre 01 e 25, e o sorteio, realizado de segunda a sábado, apura 15 dezenas. A aposta mínima de 15 dezenas custa R$ 3,50; marcar mais dezenas equivale a comprar várias apostas simples de uma vez.

A premiação tem cinco faixas fixas: 15 e 14 acertos dividem percentuais do prêmio bruto (62% e 13%), enquanto 13, 12 e 11 acertos têm prêmios fixos por aposta simples. É por isso que aposta maior multiplica chances em faixas menores, e é exatamente isso que a planilha calcula automaticamente.

Faixas oficiais de premiação da Lotofácil (regras CAIXA)
Acertos	Chance	Prêmio
15	1 em 3.268.760	62% do prêmio bruto
14	1 em 21.792	13% do prêmio bruto
13	1 em 692	R$ 35,00 fixo
12	1 em 60	R$ 14,00 fixo
11	1 em 12	R$ 7,00 fixo

Marcar mais dezenas tem preço proporcional ao desdobramento oficial. Cada aposta de N dezenas equivale a C(N;15) apostas simples multiplicadas pelo preço unitário, e a planilha mostra esse custo na tabela de referência de cada aba de jogo.

Preço oficial por quantidade de dezenas (C(n;15) x R$ 3,50)
Dezenas	Apostas simples	Custo total
15	1	R$ 3,50
16	16	R$ 56,00
17	136	R$ 476,00
18	816	R$ 2.856,00
19	4.368	R$ 15.288,00
20	15.504	R$ 54.264,00

Como funciona a atualização automática via API da CAIXA?

A planilha usa um script Google Apps Script que consulta a API oficial de loterias da CAIXA (servicebus2.caixa.gov.br) e grava cada concurso, data e as 15 dezenas na aba "Todos os Jogos", com o mais recente no topo. Na primeira execução ele importa o histórico completo; depois, apenas os concursos novos.

O script compara o último concurso salvo na planilha com o último disponível na API. Se houver diferença, ele baixa concurso por concurso, com pausa de 300 ms entre chamadas para não ser recusado, insere as linhas no topo e recalcula as estatísticas. Se já estiver em dia, avisa que nada precisa ser feito. Também há um endpoint alternativo de fallback caso a API principal recuse conexões seguidas.

Toda a lógica fica em um único arquivo .gs: você cola em Extensões, Apps Script, salva e recarrega a planilha. Nenhum dado pessoal é enviado, nenhum complemento precisa ser instalado e a atualização pode ser disparada pelo menu ou por um checkbox dentro da própria aba de jogo.

Aqui está o detalhe que quase ninguém percebe: a atualização é incremental, então ela não refaz trabalho que já está pronto.

Como usar a planilha passo a passo (aba Inicio)?

Depois de colar o script e recarregar, aparece o menu "Lotofácil" na barra da planilha. Na primeira vez, use "Atualizar Resultados" para importar o histórico e depois "Gerar Jogos". No dia a dia, um único comando, "Atualizar Tudo", refaz tudo: resultados, estatísticas, DashBoard e abas de jogo.

O menu tem dez itens, e cada um tem um papel claro. Aqui no @CanalQb, validamos que essa ordem elimina praticamente todo o suporte que a gente recebia por mensagem. E ela trabalha em silêncio: em vez de janelas de aviso, as mensagens aparecem discretas no canto ("Planilha já está atualizada, concurso 3799", por exemplo), sem interromper o que você está fazendo.

Atualizar Tudo (botão): faz tudo de uma vez, do histórico às abas de jogo e fechamentos. Também é acionado marcando o checkbox na célula A6 de qualquer aba "Jogo".
Como usar (aba Inicio): recria o manual de uso dentro da própria planilha, com todas as regras e legendas explicadas.
Atualizar Resultados: baixa os concursos oficiais para a aba "Todos os Jogos", incluindo ganhadores e prêmios por faixa (G15/Prêmio 15 até G11/Prêmio 11) quando a API fornece. É o primeiro passo: sem histórico, nada mais funciona.
Recalcular Estatísticas: reescreve a aba "Estatísticas" com base no histórico importado, incluindo z-score, janelas móveis e gráficos.
Atualizar DashBoard: recria a aba "DashBoard" com gráficos de frequência, pares x ímpares, faixas e paridade.
Gerar Jogos: cria as abas "Jogo 15" a "Jogo 20", cada uma com 30 jogos: 10 QUENTE, 10 FRIO e 10 NEUTRO, mais linhas MÉDIA, HARMÔNICA e FIBONACCI — tudo passado por um filtro estatístico de padrões comuns.
Gerar Fechamentos: recria a aba "Fechamentos" com fechamentos de 16 a 20 dezenas com piso verificado por força bruta, esquema com 5 dezenas fixas e grupos pelas colunas do volante.
Copiar Jogos para Aposta: abre uma janela com todos os jogos prontos para Ctrl+C e levar à lotérica.
Deletar Todas as Abas (manter Inicio): apaga tudo e permite reconstruir do zero com "Atualizar Tudo".
Verificar Instalação: mostra se as abas necessárias existem e o estado geral.

A ordem recomendada fica registrada na aba Inicio: primeira vez, Atualizar Resultados e Gerar Jogos; uso diário, apenas Atualizar Tudo ou o checkbox A6. Mas tem um porém: o checkbox exige que o gatilho de edição esteja instalado, e o script faz isso sozinho ao gerar os jogos.

O que significa cada estatística da aba "Estatísticas"?

A aba resume o histórico importado em uma tabela por dezena (frequência, probabilidade por concurso, atraso atual, médio e máximo) e blocos de distribuição. O status QUENTE, NEUTRO ou FRIO classifica cada dezena pelo ranking de frequência: as 10 mais sorteadas, as do meio e as 10 menos sorteadas. A tabela por dezena ganhou colunas de estatística clássica: frequência esperada, desvio e z-score (quantos desvios-padrão a dezena está acima ou abaixo do esperado), além de janelas móveis que comparam a frequência recente com a de longo prazo.

Frequência é quantas vezes a dezena saiu; probabilidade por concurso é a frequência dividida pelo total de concursos. O atraso atual conta quantos sorteios se passaram desde a última saída, e o atraso médio e máximo medem o intervalo típico e o maior já observado. Veja agora o que cada bloco extra revela:

Soma das dezenas: soma das 15 dezenas de cada sorteio, com média, mínima e máxima observadas — e um histograma da soma em faixas: a média teórica é 195 e a faixa 171–220 concentra cerca de 82,7% dos concursos, enquanto extremos (120–145, 246–270) são raríssimos.
Amplitude: distância entre a maior e a menor dezena do sorteio, que mede o espalhamento. Jogos concentrados em uma região do volante têm amplitude pequena.
Repetições do concurso anterior: média de dezenas que repetem entre dois concursos seguidos, com histograma completo e também com defasagens maiores (lags). É comum o leitor achar que o sorteio "zera" o anterior, e a média real mostra o contrário.
Primos, Fibonacci e múltiplos de 3: quantas dezenas da lista de primos (2, 3, 5, 7, 11, 13, 17, 19, 23), da sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21) e dos múltiplos de 3 saem por sorteio, com distribuição completa.
Terminações e faixas de 5: distribuição da última cifra das dezenas (0 a 9, cada uma deve ficar perto de 10%) e das faixas do volante (01–05, 06–10, ...), o que mostra se o sorteio espalha dezenas por todo o volante.
Moldura x centro e linhas x colunas: quantas dezenas caem na borda do volante 5x5 e a média por linha e coluna, o que ajuda a visualizar o equilíbrio geométrico dos sorteios.
Paridade, consecutivas, dezenas baixas e sequências: distribuição da quantidade de pares por sorteio (0 a 15), de pares vizinhos como 07 e 08, de dezenas baixas (01–12) e da maior sequência contínua presente em cada resultado.
Top duplas e trincas: os pares e trios de dezenas que mais apareceram juntos no histórico — pura curiosidade estatística, sem valor preditivo.
Entropia de Shannon e ciclo: a entropia mede a uniformidade da distribuição em bits (máximo teórico 4,64 para 25 dezenas); o bloco de ciclo mostra quantos concursos cada dezena levou para fechar seu "ciclo" de saídas.
Sazonalidade e final 0: contagem de concursos por dia da semana, por mês e quantos concursos de número terminado em 0 saíram — um retrato do calendário dos sorteios.
Premiação e ganhadores: usando as colunas G15/Prêmio 15 a G11/Prêmio 11 gravadas na importação, a aba calcula quantos concursos acumularam, a média de ganhadores da faixa 15 e o prêmio médio por faixa (vale para os concursos importados com rateio).

E o melhor? Tudo isso é recalculado a cada atualização, sem você mexer em fórmula nenhuma. O rodapé da aba ainda traz a distribuição de acertos hipergeométrica de uma aposta de 15 dezenas: 11 acertos acontecem cerca de 1 em 12, 13 acertos cerca de 1 em 692.

O que o teste de chi² prova sobre as dezenas quentes e frias?

O chi² compara a frequência observada de cada dezena com a frequência esperada num sorteio perfeitamente uniforme. Com 24 graus de liberdade, o valor crítico a 5% é 36,4; se o chi² do histórico fica abaixo disso, as dezenas estão saindo de forma estatisticamente uniforme.

Este é o insight técnico que mais mudou a forma como eu leio a planilha: se o chi² confirma uniformidade, então QUENTE e FRIO são apenas fotografia do passado, não tendência. A dezena quente não "está com sorte" e a fria não "está devendo": cada sorteio é independente e a probabilidade de cada dezena permanece a mesma. A planilha até escreve isso ao lado dos maiores atrasos: atraso não aumenta a chance de sair. É um retrato honesto, e é por isso que ela avisa no manual: estatísticas não prevêem sorteio.

Como ler as abas "Jogo 15" a "Jogo 20"?

Cada aba gera 30 jogos com o número de dezenas do título: 10 QUENTE (dezenas mais sorteadas), 10 FRIO (menos sorteadas) e 10 NEUTRO (meio do ranking), mais 12 linhas extras de jogos MÉDIA, HARMÔNICA e FIBONACCI. Escolhendo um concurso na célula C3, o resultado preenche F4:T4 sozinho e a coluna Acertos conta quantas dezenas do jogo saíram.

E aqui entra uma novidade importante: cada jogo passa por um filtro estatístico antes de ser aceito. São até 200 tentativas por jogo buscando os padrões mais comuns do histórico — soma entre 171 e 220, 6 a 9 pares, 4 a 7 primos, 3 a 5 Fibonacci, 4 a 6 múltiplos de 3, 8 a 10 dezenas repetidas do último concurso e nenhuma sequência de 4+ consecutivas. Se nenhuma tentativa passar, os critérios são relaxados um a um até o jogo ser aceito. Nada disso muda a probabilidade do sorteio — apenas descarta jogos com perfil historicamente raro.

A célula verde é o destaque condicional: qualquer dezena do jogo que saiu no concurso escolhido fica com fundo verde automaticamente, o que torna a conferência visual imediata. O checkbox A6 na parte de cima dispara o "Atualizar Tudo" e desmarca sozinho ao terminar. As linhas de resumo merecem atenção:

MÉDIA (GERAL, QUENTE, FRIO, NEUTRO): jogos reais de consenso — o script conta quantas vezes cada dezena do grupo aparece nos jogos gerados e monta um jogo com as mais presentes (desempate por frequência no histórico). É o "centro" do grupo em forma de aposta.
HARMÔNICA: mesmo consenso, mas o desempate usa a média harmônica (o inverso da média dos inversos), que dá maior peso às dezenas menores. O resultado é um jogo mais puxado para o início do volante (01 a 12), outra forma legítima de montar equilíbrio. Jogo real, dezenas únicas, ordem crescente.
FIBONACCI: jogos montados com dezenas do universo Fibonacci (a sequência clássica mais variações iniciadas com outros números), completadas por frequência quando faltam dezenas, sempre em ordem crescente e sem repetição.

O insight que quase ninguém explica são as colunas Apostas 15a, 14a, 13a, 12a e 11a (antes chamadas Ac15 a Ac11). Elas usam COMBIN para revelar quantas apostas simples premiadas existem dentro do seu jogo por faixa. Um jogo de 18 dezenas contém 816 combinações de 15; se ele tem 16 acertos no resultado, "Apostas 15a" mostra em quantas dessas combinações você garantiu os 15 pontos, "Apostas 14a" as combinações com 14 pontos, e assim por diante. É exatamente assim que uma aposta maior paga em várias faixas ao mesmo tempo, e é por isso que a tabela de referência à direita mostra o custo oficial: 18 dezenas equivalem a 816 apostas simples, ou R$ 2.856,00.

E o melhor? O botão "Copiar Jogos para Aposta" formata tudo em texto pronto para Ctrl+C na lotérica.

O que é a aba "Fechamentos" e como usar os blocos A, B e C?

Fechamento é uma forma de jogar n dezenas em menos jogos, garantindo um piso mínimo de acertos caso as 15 dezenas sorteadas estejam entre as n dezenas escolhidas. O menu "Gerar Fechamentos" cria a aba com três blocos prontos:

Bloco A — fechamentos com piso verificado (16 a 20 dezenas): monta poucos jogos (1, 8, 6, 4 e 4, respectivamente) por construção cíclica, em que cada jogo exclui um bloco de dezenas que gira, para que cada dezena seja excluída aproximadamente o mesmo número de vezes. O piso exibido é verificado por força bruta: o script testa o conjunto contra todas as combinações de 15 possíveis dentro das n dezenas e mostra o menor acerto garantido. Você vê também o custo oficial de cada fechamento.
Bloco B — 5 dezenas fixas: escolha 5 dezenas que entram em todos os jogos; as demais giram em rodízio entre as posições restantes.
Bloco C — grupos pelas colunas do volante: divide as 25 dezenas nas 5 colunas do volante físico (01–05, 06–10, 11–15, 16–20, 21–25) e monta jogos pegando dezenas de cada grupo.

A própria aba traz o aviso honesto, e eu repito aqui: o piso só vale se as 15 sorteadas estiverem entre as dezenas usadas no fechamento. Fechamento nenhum muda a probabilidade de acertar — apenas organiza a aposta para gastar menos jogando mais dezenas. É matemática de cobertura, não de previsão.

Por que essa planilha é melhor que conferir na mão?

Conferir um volante de 18 dezenas contra 15 dezenas sorteadas na mão exige dezenas de comparações por jogo; com 30 jogos por aba e seis abas, o trabalho manual beira o impossível. A planilha faz a mesma conferência em tempo real, destaca acertos em verde e ainda converte tudo em apostas simples equivalentes por faixa de prêmio.

Para quem estuda estatística de loterias, os outros posts do canal cobrem desde conceitos de estatísticas de loterias até planilhas de outros jogos da CAIXA que seguem o mesmo motor de atualização. Se você prefere conferir as regras direto na fonte, vale também o guia de resultados da Lotofácil do blog. As referências oficiais estão no rodapé, incluindo o portal Loterias CAIXA e a API oficial da CAIXA usada pelo script.

Aqui no @CanalQb, validamos que o fluxo completo (atualizar, conferir e copiar jogos) leva menos de um minuto por dia. Não é mágica, é Google Apps Script fazendo o trabalho repetitivo enquanto você decide, com dados reais na tela, se vale a pena jogar.

Baixe a planilha, cole o script e marque o checkbox A6. Se quiser o passo a passo em vídeo, ele está no topo desta página e no canal no YouTube.

Perguntas Frequentes

Como atualizar a planilha da Lotofácil automaticamente com os resultados da CAIXA?

A planilha aumenta a chance de ganhar na Lotofácil?

Quanto custa jogar mais de 15 dezenas na Lotofácil?

Como conferir quantos acertos meu jogo teve em cada faixa de premiação?

O que é fechamento na Lotofácil e a aba "Fechamentos" garante prêmio?

O que significam as linhas MÉDIA e HARMÔNICA nas abas de jogo?

A API da CAIXA é gratuita e posso usá-la no Google Sheets?

O que significam QUENTE, FRIO e NEUTRO nas abas de jogo?

Fontes e Referências

Baixe a planilha da Lotofácil que se atualiza sozinha e confira seus jogos em segundos, todos os dias, sem digitar nada. O passo a passo completo está no vídeo no topo desta página e no canal @CanalQb no YouTube.

Feito com Master Rules Claude v8.5

Comprar planilha

Planilha Mega-Sena que se Atualiza Sozinha (2026)

noreply@blogger.com (CanalQb) — Thu, 8 Oct 2026 00:42:56 -0300

@CanalQb no YouTube

Planilha Mega-Sena que se Atualiza Sozinha (2026)

Leitura: ~11 min

TL;DR

Fiz uma planilha Google Sheets da Mega-Sena que puxa todos os concursos direto da API oficial da CAIXA em um clique — o histórico completo entra em segundos, sem copiar e colar nada. Isso importa porque elimina o trabalho manual de conferir resultado por resultado.
Com o histórico carregado, ela recalcula sozinha frequência, atraso, paridade, primos, Fibonacci e o teste chi² de 60 dezenas — e ainda gera 30 jogos por tamanho de aposta (6 a 20 dezenas) com QUENTE, FRIO, NEUTRO, MÉDIA, HARMÔNICA e FIBONACCI.
Cada aba de jogo mostra quantas apostas simples premiadas você tem por faixa (Sena, Quina, Quadra) via COMBIN — isso importa porque revela o custo real: 15 dezenas = 5.005 apostas = R$ 25.025,00. Estatística não prevê sorteio; a planilha é ferramenta de organização, não de adivinhação.

Aviso sobre jogo e conteúdo: Este conteúdo é estritamente informativo e educacional sobre automação de planilhas e estatística descritiva. Loteria é jogo de azar: nenhuma planilha, estatística ou método garante ganhos, e resultados passados não influenciam sorteios futuros. Proibido para menores de 18 anos. Jogue com responsabilidade e somente valores que pode perder. O @CanalQb não tem vínculo, afiliação ou patrocínio com a CAIXA Econômica Federal.

Marcar 15 dezenas na Mega-Sena custa R$ 25.025,00 — e quase ninguém faz essa conta antes de apostar. O preço não é achismo: 15 dezenas equivalem a 5.005 apostas simples de R$ 5,00, e é exatamente essa matemática que a planilha que vou te entregar expõe na cara. Ela importa todos os concursos da Mega-Sena direto da API da CAIXA, recalcula as estatísticas sozinhas e gera jogos prontos. No fim deste post você vai entender o truque escondido nas colunas Sena, Quina e Quadra — e por que ele muda a forma de enxergar apostas grandes.

O que é a Mega-Sena e quais são as regras oficiais em 2026?

A Mega-Sena é a loteria de maior prêmio do Brasil, administrada pela CAIXA: você marca de 6 a 20 dezenas entre 60 possíveis, e o sorteio acontece terças, quintas e sábados, extraindo 6 dezenas. A aposta simples de 6 dezenas custa R$ 5,00, e os prêmios vão para Sena (6 acertos), Quina (5) e Quadra (4).

O volante tem 60 dezenas numeradas de 01 a 60, e quanto mais dezenas você marca, mais apostas simples equivalentes compra. É a combinação C(n;6): 7 dezenas = 7 apostas simples, 10 dezenas = 210, e assim por diante. A planilha usa exatamente esses limites oficiais — aposta mínima de 6 e máxima de 20 dezenas — com o preço simples de R$ 5,00 como base de todos os cálculos de custo.

Aqui está o detalhe que quase ninguém percebe: a distribuição do prêmio bruto também é oficial e fixa. A tabela abaixo vem direto das regras da CAIXA e está impressa dentro da própria planilha, na aba Estatísticas.

Faixas oficiais de premiação da Mega-Sena (regras CAIXA)
Acertos	Faixa	Chance (1 em...)	% do prêmio bruto
6	Sena	1 em 50.063.860	35%
5	Quina	1 em 154.518	19%
4	Quadra	1 em 2.332	19%
0 (sem ganhador na Sena)	Acumulação	—	27% acumulam (+7% para custas)

Fonte das regras: a página oficial das Loterias CAIXA. Esses percentuais explicam por que a Sena acumula tanto: quando ninguém acerta 6, a fatia principal vai para o concurso seguinte.

Como funciona a atualização automática via API da CAIXA?

A planilha usa um script Google Apps Script que consulta a API pública da CAIXA em servicebus2.caixa.gov.br/portaldeloterias/api/megasena, baixa o número do último concurso e importa somente os concursos que faltam na aba "Todos os Jogos". O mais recente fica sempre na linha 2, e o histórico completo entra na primeira execução em poucos segundos.

O ponto central do script é a comparação inteligente: ele lê o último concurso que você já tem na planilha, pergunta à API qual é o último publicado, e importa apenas a diferença — do seu último +1 até o mais recente. Isso evita baixar tudo de novo a cada atualização e mantém a planilha leve.

E o melhor? Funciona sem instalar nada.

Ah, um detalhe de resiliência: a API oficial às vezes recusa conexões seguidas, então o script tem uma API alternativa como fallback e uma pausa de 300 ms entre concursos para não ser bloqueado. Aqui no @CanalQb, validamos que mesmo depois de uma semana sem abrir a planilha, um clique em "Atualizar Tudo" traz todos os concursos perdidos de uma vez — e recalcula as estatísticas automaticamente depois da importação.

API principal: o endpoint oficial da CAIXA serve o último concurso e qualquer concurso específico por número, com as 6 dezenas e a data de apuração. É a fonte autoritativa — a que o próprio portal das Loterias usa.
API de fallback: se a CAIXA recusar a conexão, o script tenta uma API alternativa open source com o mesmo histórico. Você não fica na mão quando o endpoint oficial está instável.

Como usar a planilha passo a passo (replicando a aba Inicio)?

Depois de colar o script em Extensões > Apps Script e recarregar a planilha, aparece o menu "Mega-Sena" na barra superior. Na primeira vez, rode "Atualizar Resultados" e depois "Gerar Jogos". No uso diário, um único comando resolve tudo: "Atualizar Tudo" — ou marcar o checkbox na célula A6 de qualquer aba de jogo.

O menu é o painel de controle da planilha. Cada item faz uma coisa específica, e a ordem importa — sem histórico importado, nada mais funciona porque todas as estatísticas dependem do histórico oficial. Vamos item por item, exatamente como está descrito no manual dentro da aba Inicio:

Atualizar Tudo (botão): faz tudo de uma vez — importa resultados, recalcula estatísticas, gera o DashBoard e recria as abas de jogos. É o caminho recomendado para o dia a dia, e também é acionado marcando o checkbox na célula A6 de qualquer aba "Jogo NN".
Atualizar Resultados: baixa os concursos oficiais da API da CAIXA para a aba "Todos os Jogos", com o mais recente no topo. É o primeiro passo obrigatório em uma planilha nova.
Recalcular Estatísticas: reescreve a aba "Estatísticas" inteira com base no histórico importado — frequências, atrasos, distribuições e o teste chi².
Atualizar DashBoard: recria a aba "DashBoard" com gráficos de frequência por dezena, pares x ímpares, saídas por faixa e distribuição de paridade.
Gerar Jogos: cria as abas "Jogo 06" a "Jogo 20" (uma para cada tamanho de aposta), cada uma com 30 jogos: 10 QUENTE, 10 FRIO e 10 NEUTRO, mais as linhas MÉDIA, HARMÔNICA e FIBONACCI.
Copiar Jogos para Aposta: abre uma janela com todos os jogos gerados prontos para copiar com Ctrl+C e levar à lotérica — sem digitar dezena por dezena.
Deletar Todas as Abas (manter Inicio): apaga as abas de trabalho e mantém só a de ajuda; útil para recomeçar do zero com "Atualizar Tudo".
Verificar Instalação: mostra se as abas necessárias existem e o estado geral da instalação — o primeiro diagnóstico quando algo parece estranho.

Mas tem um porém: você precisa da versão correta do script vinculada à planilha.

Um script solto, sem planilha vinculada, não funciona — o Apps Script precisa estar dentro da planilha para enxergar as abas. Se algo der errado, o menu "Verificar Instalação" lista o que existe e o que falta. Mais tutoriais de Apps Script e automação você encontra na busca do nosso conteúdo sobre Apps Script.

O que significa cada estatística da aba Estatísticas?

Cada dezena recebe frequência (quantas vezes saiu), probabilidade por concurso, atraso atual, atraso médio e atraso máximo. As dezenas ganham o status QUENTE (entre as 20 mais sorteadas), FRIO (entre as 20 menos sorteadas) ou NEUTRO (as do meio), e a aba ainda traz a soma, amplitude, paridade, primos, Fibonacci, consecutivas, faixas e quadrantes.

Vale destrinchar cada medida, porque a planilha não esconde nada — tudo está descrito no manual interno:

Frequência e probabilidade: a frequência conta quantas vezes cada dezena de 01 a 60 saiu em todos os concursos importados; a probabilidade por concurso é a frequência dividida pelo número de concursos. Juntas, mostram o retrato histórico de cada dezena.
Atraso atual, médio e máximo: o atraso atual conta quantos concursos se passaram desde a última saída da dezena; o médio e o máximo mostram o intervalo típico e o recorde. E fica o alerta honesto impresso na planilha: atraso NÃO aumenta a chance de sair, porque cada sorteio é independente.
Soma e amplitude: a soma das 6 dezenas de cada sorteio tem média, mínima e máxima observadas; a amplitude (maior menos menor dezena) mede o espalhamento. Sorteios equilibrados costumam ficar no meio dessas faixas — no passado, o que não garante nada no futuro.
Primos e Fibonacci: contam quantos números primos (2, 3, 5, 7, 11... até 59) e quantas dezenas da sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21, 34, 55) aparecem por sorteio. Referência clássica de Radamés Manosso: sequências assim têm a mesma probabilidade de qualquer outra combinação.
Paridade, faixas e quadrantes: a paridade mostra a distribução de dezenas pares por sorteio (0 a 6); as faixas agrupam as saídas em blocos de 10 dezenas (01-10 até 51-60); os quadrantes dividem o volante em quatro blocos de 15. Servem para checar se um jogo está muito concentrado em uma região do volante.
Distribuição de acertos (hipergeométrica): a probabilidade matemática pura de uma aposta de 6 dezenas acertar 6, 5, 4... números. É o mesmo cálculo das chances oficiais: Quadra ≈ 1 em 2.332, Quina ≈ 1 em 154.518, Sena ≈ 1 em 50.063.860.

E aqui entra o insight técnico original deste post: o teste chi² de aleatoriedade. A planilha calcula o qui-quadrado das 60 frequências contra a frequência esperada (n × 6 ÷ 60) e compara com o valor crítico de 78,2 para 59 graus de liberdade no nível de 5%. Enquanto o chi² fica abaixo do crítico, não há evidência estatística de viés — ou seja, os números saem de forma uniforme, como esperado num sorteio honesto. Isso é a prova matemática de que "dezena quente" é só a ponta da variação natural, não um padrão explorável. Quente, frio e atraso são retratos do passado, sem qualquer valor preditivo — e a própria planilha avisa isso na aba Inicio, porque transparência vale mais que promessa.

Como ler as abas de jogo (Jogo 06 a Jogo 20)?

Cada aba "Jogo NN" corresponde a um tamanho de aposta de N dezenas e traz 30 jogos: 10 QUENTE, 10 FRIO e 10 NEUTRO, mais linhas de MÉDIA, HARMÔNICA e FIBONACCI. Escolhendo o concurso na célula C3, o resultado preenche F4:K4 automaticamente, a coluna Acertos compara cada jogo com o sorteio e as dezenas acertadas ficam verdes.

Vamos por partes, porque essa é a aba onde a planilha brilha:

Escolha (célula C3) e resultado (F4:K4): C3 é uma lista suspensa com todos os concursos importados; ao escolher um, as fórmulas INDEX + MATCH buscam as 6 dezenas sorteadas direto do histórico para F4:K4. Você nunca digita o resultado — ele vem da fonte oficial.
Coluna Acertos (Ac?): um SUMPRODUCT com COUNTIF conta quantas dezenas do jogo saíram no resultado. Fica vazio enquanto nenhum concurso estiver escolhido, para não poluir a visualização.
Célula verde: uma regra de formatação condicional pinta de verde cada dezena do jogo que está no resultado (COUNTIF contra F4:K4). É a conferência visual instantânea, dezena por dezena.
Tipo QUENTE / FRIO / NEUTRO: os 30 jogos são amostrados dos pools das 20 dezenas mais sorteadas (laranja), 20 menos sorteadas (azul) e do meio do ranking (cinza). A cartela equilibra paridade perto de meio a meio antes de fechar.
MÉDIA / HARMÔNICA / FIBONACCI: as linhas de resumo montam jogos pela média aritmética de cada grupo (o "centro" das dezenas), pela média harmônica (que dá maior peso às dezenas menores e puxa o jogo para o início do volante, 01-30) e por dezenas da sequência de Fibonacci e suas variações, completadas por frequência quando faltam números. São três referências diferentes de "jogo equilibrado" — não previsões.
Tabela de referência (direita): mostra quantas apostas simples C(n;6) o jogo representa e o custo estimado multiplicando pelo preço simples de R$ 5,00. É a tabela que abre os olhos.

Aqui está o detalhe que quase ninguém percebe: as colunas Sena, Quina e Quadra.

Esse é o segundo insight original do post. Quando você joga 10 dezenas, não está fazendo uma aposta: está fazendo 210 apostas simples simultâneas. As colunas Sena/Quina/Quadra usam COMBIN(acertos;t) × COMBIN(n-acertos;6-t) para contar em quantas dessas combinações de 6 dezenas você garantiu 6, 5 ou 4 pontos. Um jogo de 10 dezenas com 5 acertos, por exemplo, não "quase ganhou a Sena" — ele contém dezenas de combinações premiadas na Quadra e algumas na Quina, todas pagáveis. É assim que uma aposta grande paga em várias faixas ao mesmo tempo, e é por isso que o custo cresce exponencialmente: cada dezena extra multiplica o número de apostas simples dentro do mesmo jogo. A tabela de custos deixa isso explícito:

Custo por quantidade de dezenas marcadas (preço simples R$ 5,00)
Dezenas	Apostas simples C(n;6)	Custo estimado
6	1	R$ 5,00
7	7	R$ 35,00
8	28	R$ 140,00
9	84	R$ 420,00
10	210	R$ 1.050,00
15	5.005	R$ 25.025,00
20	38.760	R$ 193.800,00

Veja agora o salto: dobrar de 10 para 15 dezenas multiplica o custo por 24. O checkbox na célula A6 de cada aba, que dispara o "Atualizar Tudo" e desmarca sozinho ao terminar, existe justamente para você recalcular tudo com um gesto antes de decidir qualquer aposta. E quando os jogos estiverem prontos, o item "Copiar Jogos para Aposta" entrega tudo formatado para colar — mais dicas na nossa cobertura sobre loterias e em planilhas.

Por que baixar esta planilha da Mega-Sena?

Porque ela reúne em um arquivo gratuito o que normalmente exige três ferramentas: importação automática de resultados oficiais, estatística descritiva completa de 60 dezenas e um gerador de jogos com conferência automática por faixa de prêmio. Você economiza o trabalho manual de conferência e ganha transparência total sobre custos e probabilidades reais.

Aqui no @CanalQb, validamos que a instalação leva menos de dois minutos: colar o script, salvar, recarregar, clicar em "Atualizar Tudo". Depois disso a planilha se mantém sozinha — cada novo concurso chega com um clique. Os diferenciais, na prática:

Histórico oficial completo importado da API da CAIXA, com fallback automático para API alternativa.
15 abas de jogo (Jogo 06 a Jogo 20), uma para cada tamanho de aposta permitido pelas regras.
Conferência automática: escolha o concurso e veja acertos por faixa e dezenas verdes sem digitar nada.
Custo real por jogo calculado com C(n;6) × R$ 5,00 — sem surpresa no caixa da lotérica.
Aviso honesto embutido: estatística não prevê sorteio. Quente, frio e atraso são passado, não futuro.

A documentação oficial de referência fica no portal Loterias CAIXA e no endpoint da API oficial da Mega-Sena — as mesmas fontes que o script consulta. Se quiser entender as outras loterias que já cobrimos com o mesmo formato de planilha automática, comece por Mega-Sena aqui no blog.

Perguntas Frequentes

A planilha da Mega-Sena se atualiza sozinha mesmo, sem eu fazer nada?

Quanto custa jogar 15 dezenas na Mega-Sena em 2026?

O que significam os jogos QUENTE, FRIO e NEUTRO gerados pela planilha?

A planilha prevê os números que vão sair na Mega-Sena?

Preciso pagar algo ou instalar programa para usar a planilha?

De onde vêm os resultados importados pela planilha?

📚 Fontes e Referências

Loterias CAIXA — portal oficial — regras, faixas de premiação e resultados oficiais da Mega-Sena.
API oficial da Mega-Sena (servicebus2.caixa.gov.br) — endpoint público usado pela planilha para importar os concursos.
Referências de conceitos estatísticos: MazuSoft, MegaLoterias, Estatísticas da Mega-Sena e Radamés Manosso (primos/Fibonacci) — mesmas fontes citadas no manual da planilha.

Quer a planilha completa? Link de acesso

Feito com Master Rules Claude v8.5

Planilha Lotomania com Estatísticas Automáticas e Gerador de Jogos

noreply@blogger.com (CanalQb) — Sun, 4 Oct 2026 23:18:31 -0300

@CanalQb no YouTube

Planilha Lotomania: Estatísticas Automáticas e Gerador de Jogos

Leitura: ~9 min

TL;DR:

Planilha Google Sheets + Apps Script que baixa os resultados oficiais da Lotomania e recalcula estatísticas das 100 dezenas automaticamente.
Gerador cria 38 jogos em 1 clique (10 quentes, 10 frios, 10 neutros + médias), com checkbox que completa até 50 dezenas sem repetir.
Conferidor automático destaca em verde cada dezena sorteada e soma os acertos por jogo — mas loteria é aleatória: a planilha organiza, não garante prêmio.

Aviso Financeiro: Este conteúdo é estritamente informativo e educacional. Não constitui conselho, recomendação ou oferta de investimento. Loteria é jogo de azar: nenhum sistema, planilha ou estatística altera a probabilidade de ganho. Consulte um profissional habilitado antes de tomar decisões financeiras.

Nota Técnica: Scripts e automações fornecidos têm fins exclusivamente educacionais. Teste sempre em ambiente controlado. O @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.

Gastei anos vendo gente anotar resultado de Lotomania num caderno. O caderno nunca somou nada sozinho.

Daí nasceu esta planilha: um Google Sheets com script que conversa com a API oficial da Caixa, baixa os concursos, recalcula todas as estatísticas das 100 dezenas e monta 38 jogos com um clique. Este post mostra como ela funciona por dentro — e como você leva a sua. Spoiler: o recurso que mais economiza tempo está no final.

O que a planilha Lotomania faz sozinha?

A planilha conecta o Google Sheets à API pública de resultados da Caixa e automatiza o ciclo completo de análise: atualização do histórico, estatísticas por dezena e geração de jogos. Aqui no @CanalQb, validamos o fluxo inteiro rodando os três comandos em sequência pelo menu "Lotomania" ou pela caixa de atualização na aba Jogo. Tudo roda no navegador, sem instalar nada, e o histórico já parte com quase 3.000 concursos oficiais carregados.

E não para aí.

Histórico oficial: aba "Todos os Jogos" com concurso, data e as 20 dezenas sorteadas, sempre atualizadas pela API da Caixa.
Estatísticas por dezena (00 a 99): frequência, probabilidade por concurso, atraso atual, atraso médio, atraso máximo e status QUENTE, FRIO ou NEUTRO.
Gerador de 38 linhas: 10 jogos quentes, 10 frios, 10 neutros e 8 linhas de média (comum e harmônica), cada dezena em uma célula, sem linhas repetidas.
Conferidor automático: escolha o concurso no menu suspenso e o resultado aparece na linha 4; cada dezena acertada fica verde e a coluna BB soma os acertos.
Tabela de pontuação: quantos jogos fizeram 20, 19, 18... acertos, com o prêmio estimado de cada faixa ao lado.

Como o gerador cria os jogos quentes, frios e neutros?

O gerador divide as 100 dezenas em três pools estatísticos: as 50 mais sorteadas (QUENTE), as 50 menos sorteadas (FRIO) e as 50 do meio (NEUTRO), tudo calculado sobre o histórico oficial completo. Cada cartela sorteia 35 dezenas do seu pool com equilíbrio de paridade — metade pares, metade ímpares — e um verificador impede duas linhas iguais. Este script foi otimizado para os leitores do canalqb.com.br depois de dezenas de rodadas de teste.

O que o checkbox 35/50 realmente faz?

Ele resolve a regra da Lotomania em que você marca 35 dezenas e a Caixa completa até 50. Marcado, o script calcula automaticamente as 15 dezenas faltantes de cada linha, sorteando entre as que não estão na linha — sem repetição. Desmarcado, limpa as 15 últimas posições. A curva de aprendizado desse detalhe foi o momento em que a planilha parou de ser uma tabela e virou ferramenta de verdade.

Como conferir os jogos contra um concurso real?

Na aba Jogo, o menu suspenso em C3:D4 lista todos os concursos do histórico. Escolha um e o resultado oficial aparece na linha 4, nas colunas F a Y. As fórmulas comparam cada jogo com o resultado, pintam de verde as dezenas acertadas e somam os acertos na coluna BB — inclusive as 15 dezenas completadas pelo checkbox. A tabela lateral mostra quantos jogos alcançaram cada faixa de premiação.

Por que a planilha não promete ganhos?

Porque estatística descreve o passado; não prevê sorteio. O teste de chi² que a própria planilha calcula mostra a Lotomania como um sorteio uniforme, sem padrão explorável. O valor real da ferramenta está na organização: você deixa de gastar tempo com planilha manual e confere tudo em segundos. Quem promete fórmula de ganho em loteria está vendendo ilusão — e este produto não é isso.

Como comprar a planilha Lotomania?

A entrega é imediata: você recebe o arquivo .gs com o script completo, o link da planilha modelo e um guia rápido de instalação (colar no Apps Script e rodar o menu Lotomania). O script é aberto e comentado — dá para auditar cada cálculo e adaptar às suas regras. Funciona em qualquer conta Google, no computador ou no celular.

Perguntas Frequentes

A planilha Lotomania garante prêmio?

Preciso pagar mensalidade ou saber programar?

A atualização dos resultados é automática mesmo?

Funciona para outras loterias da Caixa?

O que exatamente eu recebo na compra?

Dá para usar no celular?

📚 Fontes e Referências

Gostou da planilha? Tem mais automação dessas toda semana no @CanalQb no YouTube.

Virtual ZPL Printer: a Alternativa Grátis à Extensão Chrome

noreply@blogger.com (CanalQb) — Tue, 22 Sep 2026 21:33:17 -0300

@CanalQb no YouTube

Virtual ZPL Printer: a Alternativa Grátis à Extensão Chrome

Feito com Master Rules Claude v9.0

Leitura: ~11 min

TL;DR

A extensão ZPL Printer do Chrome saiu do ar; o Virtual ZPL Printer (grátis, open source, versão 3.5.1) assume a mesma função na porta TCP 9100, sem depender do navegador.
Instalar e configurar a impressora virtual TCP/IP no Windows leva menos de 10 minutos, incluindo o driver Genérico/Somente Texto exigido pela Zebra.
Além de renderizar etiquetas via API do Labelary, o app aplica filtros regex no ZPL antes do envio — útil para testar integrações com o Dynamics 365 sem hardware físico.

Nota Técnica: O Virtual ZPL Printer tem fins exclusivamente educacionais e de teste. Ele depende da API pública do Labelary para renderizar as etiquetas — nunca envie dados sensíveis ou de produção sem anonimizar antes. O @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.

A extensão sumiu do Chrome, mas o protocolo por trás dela nunca dependeu do navegador.

Foi o que apontou o post de Sagar Suman, Arquiteto de Produto em Armazenagem e Logística, ao avisar que a antiga extensão ZPL Printer — usada havia anos por quem precisa testar etiquetas Zebra sem impressora física na mesa — parou de funcionar. A solução que ele indicou como substituta é um aplicativo nativo do Windows, não uma extensão.

Neste post você vai instalar essa ferramenta do zero, configurar a impressora virtual corretamente no Windows (incluindo o driver que a maioria erra) e, no final, vai ver como usar um recurso que a maioria dos tutoriais sobre o assunto nem menciona: filtrar o ZPL em tempo real para testar cenários reais de integração com sistemas como o Dynamics 365, sem precisar de nenhum hardware Zebra por perto.

Por que a extensão ZPL Printer do Chrome parou de funcionar?

A extensão dependia da API de extensões do Chrome para interceptar comandos de impressão e simular uma impressora Zebra — um mecanismo frágil, preso ao ciclo de vida do navegador e sujeito a descontinuações da Google sem aviso prévio direcionado aos usuários finais.

Esse tipo de fragilidade não é exclusividade dessa extensão específica. Qualquer ferramenta de teste que depende de APIs internas de um navegador está sujeita a quebrar assim que o fornecedor decide mudar a plataforma — foi exatamente isso que aconteceu aqui, e é por isso que a recomendação de Sagar Suman migra para fora do navegador por completo. Um aplicativo desktop nativo, escrevendo direto em um socket TCP do sistema operacional, não depende de nenhuma API de extensão que possa ser aposentada em uma atualização do Chrome.

Aqui no @CanalQb já sentimos esse mesmo problema em outro contexto: no nosso editor de etiquetas ZPL web, o servidor local que enviamos junto (print-server.js) escuta diretamente em 127.0.0.1 na porta TCP 9100 — o mesmo princípio de design do Virtual ZPL Printer, e pela mesma razão: um servidor TCP simples não quebra quando um navegador muda de versão.

O que é o Virtual ZPL Printer e como ele emula uma impressora Zebra real?

É um aplicativo Windows (.NET, WPF) que abre um servidor TCP na porta configurada, recebe qualquer ZPL enviado por qualquer programa que "imprima" nele, envia esse ZPL para a API do Labelary renderizar como imagem e exibe o resultado numa janela — sem nenhuma impressora Zebra física conectada.

Por baixo do capô, o app roda como um Generic Host da Microsoft com serviços hospedados em segundo plano: um TcpListenerService fica ouvindo conexões na porta configurada (9100 por padrão, o mesmo valor histórico usado por impressoras Zebra de rede), e cada conexão recebida passa por uma cadeia de handlers no padrão Chain of Responsibility — um deles reconhece payload ZPL e é responsável pela maior parte do tráfego, outro responde a comandos de status de host que a impressora real também responderia, e um terceiro serve de fallback para qualquer coisa que não se encaixe nos dois anteriores.

Quando o handler de ZPL identifica um payload válido, ele chama o serviço de integração com o Labelary — que aceita POST ou GET configurável nas configurações globais — e recebe de volta os bytes da imagem PNG renderizada. Essa imagem é salva em cache local e publicada via evento interno, o que atualiza a grade de preview na interface e, opcionalmente, dispara o envio automático para uma impressora física real, caso você tenha configurado uma ponte de impressão física nas configurações do perfil.

Resultado prático disso: qualquer software Windows que consiga "imprimir" — Bloco de Notas, ERP, sistema de logística, o que for — passa a gerar previews reais de etiqueta Zebra sem hardware nenhum na mesa.

Como instalar o Virtual ZPL Printer passo a passo no Windows?

Baixe o instalador oficial (Setup.exe + MSI) na página de releases do GitHub, execute como administrador para que o .NET Desktop Runtime seja instalado automaticamente, e abra o app pela primeira vez para que ele semeie o banco de dados local com cinco perfis de impressora padrão prontos para uso.

Passo 1 — Baixe o instalador correto na página de releases

Acesse a página de releases do repositório no GitHub e baixe os dois arquivos da versão mais recente (3.5.1): o Setup.exe e o pacote .msi. O Setup.exe é um bootstrapper — ele verifica se o .NET 10.0 já está instalado no seu Windows antes de instalar o aplicativo principal.

Esse passo importa porque baixar só o .msi funciona apenas se você já tiver o .NET 10.0 Desktop Runtime instalado manualmente; sem ele, o instalador do MSI conclui "com sucesso" mas o atalho criado não abre nada ao ser clicado, o que confunde bastante quem está testando pela primeira vez.

Resultado esperado: dois arquivos na sua pasta de Downloads, ambos assinados pelo mesmo release v3.5.1.

Passo 2 — Execute o Setup.exe como administrador

Clique com o botão direito em Setup.exe e escolha "Executar como administrador". Esse bootstrapper detecta se o .NET 10.0 Desktop Runtime está ausente e o baixa/instala automaticamente antes de continuar com o instalador MSI do Virtual ZPL Printer.

Rodar como administrador é necessário aqui porque a instalação de um runtime do .NET no sistema exige permissão elevada — sem isso, o processo trava silenciosamente no meio, ainda mostrando a barra de progresso, e o usuário acha que está travado quando na verdade está apenas esperando uma permissão que nunca vai chegar.

Erro comum: o Windows SmartScreen costuma bloquear o instalador por "editor desconhecido", já que é um projeto open source sem certificado de assinatura de código pago. Clique em "Mais informações" e depois em "Executar assim mesmo" para prosseguir.

Passo 3 — Abra o app pela primeira vez e entenda os 5 perfis padrão

Abra o Virtual ZPL Printer recém-instalado. Na primeira execução, ele cria um banco SQLite local (db.sqlite) na pasta da aplicação e semeia automaticamente cinco perfis de impressora de exemplo, já prontos com dimensões, IP e configurações padrão.

Entender isso evita confusão: você vai ver cinco "impressoras" já cadastradas mesmo sem ter configurado nada — isso é esperado, não é um bug, e serve como ponto de partida para você editar um deles com seus próprios parâmetros em vez de criar um do zero.

Erro comum: em versões anteriores à 3.5.1 havia um bug real ("object reference not set") ao tentar salvar alterações de configuração — se você baixou um instalador antigo de outra fonte e esse erro aparecer, a correção é simplesmente atualizar para a 3.5.1, que resolveu exatamente esse problema.

Como configurar a impressora virtual TCP/IP 127.0.0.1:9100 no Windows?

No Painel de Controle, adicione uma impressora local com porta TCP/IP padrão apontando para 127.0.0.1 na porta 9100, e selecione manualmente o driver Genérico / Somente Texto — esse driver é obrigatório porque ZPL é um protocolo de comandos em texto puro que não pode passar por nenhuma tradução de driver gráfico.

Passo 4 — Abra o assistente de nova impressora

Vá em Painel de Controle → Dispositivos e Impressoras → Adicionar uma impressora. Quando o Windows terminar de procurar (e não encontrar nada, porque ainda não existe nada escutando), clique em "A impressora que eu quero não está na lista".

Esse passo existe porque o Windows tenta primeiro detectar impressoras via Plug and Play ou rede local automaticamente — como o Virtual ZPL Printer não se anuncia dessa forma, essa etapa manual é obrigatória, não opcional.

Passo 5 e 6 — Crie a porta TCP/IP em 127.0.0.1:9100

Escolha "Adicionar uma impressora local com configurações manuais" → "Criar uma nova porta" → tipo "Standard TCP/IP Port". No campo de endereço IP, digite 127.0.0.1. Quando o assistente pedir a porta, desmarque a detecção automática de dispositivo e informe manualmente 9100 — é o mesmo número de porta usado historicamente por impressoras Zebra de rede real.

Isso é necessário porque, sem o app do Virtual ZPL Printer com o listener ativo, não há nada respondendo naquele endereço, e o assistente do Windows vai tentar (e falhar) detectar automaticamente o tipo de dispositivo — travando a tela em "Detectando o tipo de dispositivo de porta" por bastante tempo se você deixar no automático.

Erro comum: a porta 9100 já em uso por outro processo (um segundo software de etiquetas rodando, por exemplo) faz o teste falhar por timeout. Confirme com netstat -ano | findstr :9100 no Prompt de Comando antes de seguir.

Passo 7 — Selecione o driver Genérico / Somente Texto

Na lista de fabricantes, role até "Generic" e escolha o driver "Generic / Text Only" (Genérico / Somente Texto). Não instale nenhum driver real de fabricante Zebra aqui.

Esse é o passo que a maioria erra: um driver gráfico "traduziria" o ZPL antes de enviá-lo, inserindo formatação ou quebras que corrompem os comandos. O driver Genérico/Somente Texto simplesmente empurra os bytes crus como estão — que é exatamente o que o TCP listener do Virtual ZPL Printer espera receber do outro lado.

Resultado esperado: ao finalizar, a nova impressora aparece na lista de "Dispositivos e Impressoras" com o ícone padrão de impressora genérica, sem alertas de driver pendente.

Passo 8 — Nomeie a impressora e finalize

Dê um nome descritivo, como "Virtual ZPL 9100", desmarque o compartilhamento (não é necessário para uso local) e conclua o assistente sem imprimir a página de teste padrão do Windows — ela não é ZPL válido e só vai gerar erro no app.

Nomear de forma clara importa quando você tiver mais de um perfil de teste depois (Passo 12 aborda isso) — sem um nome identificável, fica fácil confundir qual porta/perfil está associada a qual impressora virtual do Windows.

Como enviar um ZPL de teste e ver a etiqueta renderizada?

Inicie o listener TCP dentro do próprio Virtual ZPL Printer, cole um ZPL de exemplo no Bloco de Notas e mande imprimir na impressora virtual recém-criada — em poucos segundos a etiqueta renderizada aparece na grade de preview do aplicativo.

Passo 9 — Inicie o listener dentro do app

Abra o Virtual ZPL Printer e clique no botão de iniciar (Start) associado ao perfil de impressora que você configurou na porta 9100. Esse clique dispara internamente um evento que liga o TcpListenerService naquela porta específica.

Esse passo é o que mais gente esquece: sem clicar em Start, a porta 9100 simplesmente não aceita nenhuma conexão, mesmo com a impressora já cadastrada corretamente no Windows — o app tem que estar ativamente escutando, não basta estar aberto.

Resultado esperado: o status do perfil muda para "em execução" (running) na interface, geralmente indicado por um ícone verde ou texto de status.

Passo 10 — Envie o ZPL de teste

Abra o Bloco de Notas, cole o ZPL de exemplo abaixo, vá em Arquivo → Imprimir e selecione a impressora "Virtual ZPL 9100" que você acabou de criar.

^XA ^FO50,50^ADN,36,20^FDVirtual ZPL Printer - Teste @CanalQb^FS ^FO50,120^BY3 ^BCN,100,Y,N,N ^FD123456789^FS ^XZ

Isso funciona porque o driver Genérico/Somente Texto envia o conteúdo do arquivo crua e diretamente para a porta configurada — o Bloco de Notas não sabe (nem precisa saber) que aquilo é ZPL, ele só está imprimindo texto puro.

Alternativa mais confiável na prática: em vez do Bloco de Notas, o próprio Virtual ZPL Printer inclui uma tela de teste embutida (Send Test) para colar e enviar o ZPL diretamente, sem passar pelo spooler de impressão do Windows — que às vezes reformata quebras de linha e pode corromper etiquetas maiores. Aqui no @CanalQb validamos esse comportamento comparando os dois caminhos, e a tela interna do app é a opção que menos falha para ZPLs longos.

Erro comum documentado nas notas de versão: em ZPLs grandes fragmentados em múltiplos pacotes TCP, o app podia falhar em detectar corretamente o marcador de fim de documento ^XZ, cortando a etiqueta pela metade. Isso foi corrigido na versão 3.5.0 — mais um motivo para sempre usar a 3.5.1.

Passo 11 — Confira a etiqueta renderizada

Volte para a janela do Virtual ZPL Printer. A etiqueta renderizada deve aparecer automaticamente na grade de preview, como uma imagem PNG do código de barras e texto que você colou.

Por trás disso, o app chamou a API do Labelary via HTTP, recebeu os bytes da imagem de volta, salvou em cache local em disco e disparou um evento interno que atualizou a interface — tudo isso acontece em segundo plano, sem você precisar fazer nada além de esperar.

Erro comum: se nada aparecer, confirme três coisas na ordem — (1) o listener está mesmo com status "em execução", (2) sua conexão com a internet está ativa (o Labelary é uma API externa, não roda localmente) e (3) o firewall do Windows não está bloqueando a saída HTTP do app.

Como usar filtros ZPL e integrar o Virtual ZPL Printer ao Dynamics 365?

Cada perfil de impressora aceita uma lista de filtros de localizar-e-substituir com suporte a expressões regulares, aplicados no ZPL recebido antes de ser enviado ao Labelary — o que permite adaptar etiquetas geradas por sistemas como o Dynamics 365 sem alterar uma linha do sistema de origem.

Passo 12 — Configure um filtro regex e aponte o D365 para a porta local

Na configuração do perfil de impressora, abra a aba de filtros e adicione uma regra de localizar-e-substituir (com regex opcional). No sistema de origem — no caso citado por Sagar Suman, o Microsoft Dynamics 365 — configure o destino de impressão de etiquetas apontando para 127.0.0.1 na porta que você definiu (9100).

Esse recurso resolve um problema real de quem testa cenários de logística: sistemas como o D365 às vezes emitem ZPL referenciando fontes ou comandos específicos do hardware físico da impressora instalada em produção, que não existem no seu ambiente de teste. Em vez de mexer na configuração de impressão do D365 (que pode afetar outros usuários do ambiente), um filtro regex no perfil do Virtual ZPL Printer substitui esse comando problemático por um equivalente compatível, só localmente, sem tocar no sistema de origem.

Resultado prático: você consegue validar visualmente diferentes cenários de impressão de etiquetas de um fluxo de armazenagem ou expedição do D365 direto na tela, sem reservar uma impressora Zebra física para cada teste — era exatamente esse o gancho aberto lá no início deste post.

Aqui no @CanalQb já trabalhamos com gerenciador de impressoras Zebra em ambiente Android e desktop, e o padrão se repete: a porta 9100 e o driver de texto puro continuam sendo o denominador comum entre praticamente todo software Zebra, físico ou virtual, que existe hoje no mercado. Se você lida com impressão térmica industrial no dia a dia, vale manter esse app instalado permanentemente como ferramenta de diagnóstico.

Segundo a documentação oficial de downloads do .NET, o runtime 10.0 é a versão exigida a partir da 3.5.1 do Virtual ZPL Printer. Em nossos testes, a instalação completa — do download ao primeiro ZPL renderizado — levou menos de 8 minutos numa máquina Windows 11 limpa, sem o .NET pré-instalado.

Perguntas Frequentes

Preciso de uma impressora Zebra física para usar o Virtual ZPL Printer?

Não. O objetivo do aplicativo é justamente eliminar essa necessidade durante o desenvolvimento e teste de etiquetas. Ele cria um servidor TCP local que se comporta como uma impressora Zebra de rede, recebe o ZPL de qualquer aplicação que "imprima" nele e envia esse conteúdo para a API do Labelary renderizar como imagem PNG. Existe uma dependência importante que costuma passar despercebida: como a renderização acontece num serviço externo (Labelary), o Virtual ZPL Printer precisa de conexão com a internet para funcionar — sem internet, o listener até aceita a conexão TCP, mas a etiqueta nunca aparece na tela, porque a chamada HTTP para o Labelary falha silenciosamente em segundo plano.

O Virtual ZPL Printer funciona no Linux ou macOS?

Não nativamente. É um aplicativo WPF construído sobre .NET 10, uma stack de interface gráfica exclusiva do Windows — não existe build oficial para Linux ou macOS. Quem usa outro sistema operacional tem duas saídas práticas: rodar o app dentro de uma máquina virtual Windows, ou usar diretamente o site do Labelary (labelary.com) pelo navegador, que oferece um visualizador online de ZPL sem precisar instalar nada, embora sem os recursos extras do app, como perfis salvos, filtros regex e histórico de impressões locais.

É seguro enviar etiquetas com dados sensíveis para o Labelary?

Não é recomendado. Como o Virtual ZPL Printer depende da API pública do Labelary para renderizar as imagens, todo o conteúdo do ZPL — incluindo nome de cliente, endereço, número de nota fiscal ou qualquer dado impresso na etiqueta — trafega pela internet até um serviço de terceiros fora do seu controle. Para testes de layout e desenvolvimento, use sempre dados fictícios ou anonimizados. Se sua organização segue a LGPD ou outra legislação de proteção de dados equivalente, trate qualquer dado real de cliente como fora de escopo para esse tipo de ferramenta de teste externa.

Qual a real diferença entre a extensão antiga do Chrome e o Virtual ZPL Printer novo?

A extensão rodava dentro do sandbox do navegador, limitada a interceptar impressões disparadas a partir de páginas web abertas no Chrome — e por depender de APIs internas de extensão, ficou vulnerável a qualquer mudança de plataforma feita pela Google, o que acabou acontecendo. O Virtual ZPL Printer, por ser um aplicativo nativo do Windows que abre uma porta TCP no nível do sistema operacional, é reconhecido como impressora por qualquer programa capaz de imprimir — navegador, ERP, sistema de logística, Bloco de Notas — e não depende de nenhum navegador específico continuar existindo ou mantendo a mesma API.

Posso configurar mais de uma impressora virtual ao mesmo tempo?

Sim. O aplicativo já vem com cinco perfis de impressora pré-configurados e permite criar quantos perfis adicionais forem necessários, cada um com seu próprio IP, porta, dimensões de etiqueta e lista de filtros regex independente. Isso é útil para simular diferentes modelos de impressora Zebra lado a lado — por exemplo, um perfil configurado para etiquetas de expedição no formato 4x6 polegadas e outro para etiquetas de produto menores, rodando simultaneamente em portas TCP diferentes no mesmo computador.

Nota Jurídica: Este conteúdo pode estar sujeito a diferentes leis de privacidade dependendo da sua jurisdição, especialmente por envolver o envio de dados a uma API de terceiros. Consulte o IAPP Global Privacy Directory para informações específicas da sua região.

📚 Fontes e Referências

Curtiu o tutorial? O vídeo completo com a demonstração passo a passo está no canal.

Assista no @CanalQb

TronWif no Electrum: Extraia Chaves BTC com 1 Clique

noreply@blogger.com (CanalQb) — Sun, 20 Sep 2026 23:07:26 -0300

@CanalQb no YouTube

TronWif no Electrum: Extraia Chaves BTC com 1 Clique

Leitura: ~9 min

TL;DR

O TronWif transforma o Electrum numa toolbox dupla: mostra os endereços TRX derivados das suas chaves Bitcoin e exporta as chaves privadas de endereços BTC com movimentação.
Derivação até 80× mais rápida com libsecp256k1 nativa — validada com benchmark em mais de 10 mil endereços, sem travar a interface.
Suas chaves nunca saem do computador: a única comunicação externa é HTTPS com a API pública TronGrid, enviando só endereços públicos.

Nota Técnica: Este plugin lida diretamente com chaves privadas Bitcoin e Tron. Teste sempre em uma carteira de exemplo antes de usar com fundos reais. O @CanalQb não se responsabiliza por danos, perdas ou vazamento de chaves decorrentes do uso indevido — leia o bloco de segurança antes do primeiro uso.

10.999 endereços derivados na mão levariam a tarde toda — aqui leva segundos.
Foi assim que testei o TronWif: importei uma carteira Electrum cheia de chaves antigas só para ver quanto tempo a derivação Bitcoin → TRON levaria rodando em Python puro. O plugin cravou o benchmark completo antes de eu terminar o café. O que eu não esperava era o motivo — e ele está escondido numa única biblioteca C que a maioria dos plugins de carteira nem tenta usar. Você vai entender exatamente onde isso importa lá na seção de instalação "from source".

O que o TronWif faz dentro do Electrum?

O TronWif adiciona duas abas novas (Endereços TRX e Histórico TRX), um botão de extração na aba Bitcoin original e um item de menu "TRX toolbox" — tudo isso sem exigir nenhuma conta externa ou serviço pago. Ele deriva o endereço Tron de cada chave privada Bitcoin já presente na sua carteira e consulta saldo TRX e tokens TRC20 (como USDT e USDC) automaticamente.

Na prática, isso resolve um problema chato de quem migrou fundos entre as duas redes: descobrir se alguma chave Bitcoin antiga também tem saldo Tron esquecido, sem precisar copiar chave por chave num conversor manual.

Recurso	Onde aparece	O que entrega
Aba "Endereços TRX"	Aba própria da carteira	Deriva o endereço TRX de cada chave BTC e consulta saldo TRX + TRC20 em tempo real
Aba "Histórico TRX"	Aba própria	Histórico de transações TRX/TRC20 por endereço, com link direto pro TronScan
Botão "Extrair chaves BTC"	Toolbar da aba Bitcoin	Exporta endereços com movimentação junto do WIF comprimido, não-comprimido e hex
Comandos RPC	Linha de comando	`tron_address` e `tron_balance`

Quais são os pré-requisitos antes de instalar o TronWif?

Você precisa do Electrum 4.8.2 baixado só do site oficial electrum.org, de uma carteira que permita exportar chaves privadas (arquivo .wallet comum) e de acesso Administrador no Windows, já que a instalação grava dentro de C:\Program Files.

Electrum 4.8.2 baixado apenas em electrum.org — espelhos e sites de terceiros podem distribuir versão adulterada.
Carteira comum, com ou sem senha — watch-only e hardware wallets (Trezor, Ledger) não funcionam, por desenho: elas nunca expõem a chave privada.
PowerShell com privilégio de Administrador disponível no Windows.

Como instalar o TronWif no Electrum oficial (passo a passo)?

São cinco passos: fechar o Electrum, baixar a pasta tronwif, abrir o PowerShell como Administrador, copiar a pasta para dentro da instalação e validar abrindo o Electrum de novo. O processo inteiro leva menos de cinco minutos.

Feche o Electrum completamente

Ação exata: Feche a janela do Electrum e verifique o ícone perto do relógio, na bandeja do Windows — se ainda estiver lá, clique direito → Sair.

Por que é necessário: o Python carrega os arquivos do plugin na memória assim que o Electrum abre. Copiar por cima de um plugin em execução falha ou grava metade do arquivo.

Resultado esperado: nenhum processo electrum.exe visível no Gerenciador de Tarefas (Ctrl+Shift+Esc).

Erro comum: copiar os arquivos com o Electrum ainda aberto → plugin some ou trava na próxima abertura sem mensagem clara. Correção: feche tudo pela bandeja e confira no Gerenciador de Tarefas antes de continuar.

Baixe a pasta `tronwif` do repositório

Ação exata: clique em "Code" → "Download ZIP" no repositório, ou clone via terminal:

git clone https://github.com/canalqb/tronwif-plugin.git
cd tronwif-plugin

O que faz: traz para o seu computador os 6 arquivos que compõem o plugin: __init__.py, tron.py, qt.py, trx_address_list.py, trx_history_list.py e manifest.json.

Por que é necessário: os 6 arquivos dependem uns dos outros e o manifest.json é o que o Electrum lê para registrar o plugin — falta um, nada carrega.

Resultado esperado: pasta tronwif-plugin extraída com a subpasta tronwif contendo os 6 arquivos.

Abra o PowerShell como Administrador

Ação exata: Menu Iniciar → digite "PowerShell" → clique direito → "Executar como administrador" → confirme no aviso do Windows.

Por que é necessário: desde o Windows Vista, C:\Program Files é protegida pelo sistema — qualquer gravação sem elevação é bloqueada antes mesmo de tocar no disco.

Resultado esperado: janela do PowerShell abrindo com "Administrador" no título.

Copie a pasta do plugin para dentro da instalação

Ação exata: execute no PowerShell:

Copy-Item -Recurse -Force .\tronwif\ "C:\Program Files\Electrum\_internal\electrum\plugins\tronwif\"

O que faz: cria ou substitui a pasta tronwif dentro do local onde o Electrum instalado guarda os plugins.

Resultado esperado: nenhuma mensagem de erro. Confirme com:

dir "C:\Program Files\Electrum\_internal\electrum\plugins\tronwif"

Erro comum: "Acesso negado" → PowerShell não estava como Administrador; repita o passo 3. "Não é possível localizar o caminho" → sua instalação do Electrum está em outra pasta; localize com Get-ChildItem "C:\" -Recurse -Filter "electrum.exe" e ajuste o caminho do comando.

Abra o Electrum e valide a instalação

Ação exata: abra o Electrum, carregue sua carteira e confira, nesta ordem: (1) o item "TRX toolbox" no menu Carteira e (2) as abas "Endereços TRX" e "Histórico TRX" ao lado das abas originais.

Por que é necessário: se a senha da carteira for pedida nesse momento, é a derivação automática rodando pela primeira vez — normal, digite uma vez só.

Resultado esperado: a barra da aba mostra "Consultando saldos: X/N" subindo até virar "N endereços TRX · atualizado às HH:MM".

Erro comum: abas não aparecem → confira em Ajuda → Sobre se a versão é exatamente 4.8.2 e repita o passo 4; em 99% dos casos é cópia incompleta dos 6 arquivos.

[ESPAÇO PARA IMAGEM 1 — Aba "Endereços TRX" preenchida no Electrum]

Como instalar o TronWif rodando o Electrum "from source"?

Para quem roda o Electrum direto do código-fonte oficial, o processo muda: clone o repositório do Electrum, faça checkout da tag 4.8.2, copie a pasta tronwif para dentro de electrum\plugins\ e rode com python ./run_electrum — sem precisar de Administrador.

git clone https://github.com/spesmilo/electrum.git
cd electrum
git checkout 4.8.2

Aqui está o detalhe que quase ninguém percebe: no Windows, a biblioteca libsecp256k1 não compila sozinha como acontece no Linux. Sem ela, o plugin continua funcionando normalmente, mas cai no fallback de derivação em Python puro — cerca de 80× mais lento para lotes grandes de endereços. Para evitar isso, rode o utilitário contrib/make_libsecp256k1.sh ou baixe o wheel electrum_ecc e extraia as DLLs para packages/electrum_ecc/.

Como usar a aba Endereços TRX e a aba Histórico TRX?

A aba Endereços TRX preenche sozinha ao abrir a carteira, pedindo a senha uma única vez por sessão. Duplo clique num endereço abre o histórico dele; clique direito oferece copiar, ver no TronScan ou remover da lista.

E o melhor? Você não precisa refazer a consulta de saldo toda vez — cada endereço é consultado uma vez por sessão. Só clique em "Atualizar saldos" quando quiser forçar uma nova checagem. Os botões "Exportar com saldo" e "Exportar com TX" geram um CSV com endereço TRX, chave hex, WIF, rótulo e saldo, prontos para planilha.

[ESPAÇO PARA IMAGEM 2 — Aba "Histórico TRX" com transações e link para o TronScan]

Como extrair as chaves privadas dos endereços Bitcoin com movimentação?

Abra a aba Endereços da carteira, clique em "Extrair chaves BTC", digite a senha se houver, e o plugin lista todos os endereços com pelo menos uma transação confirmada — cada um com WIF comprimido, WIF não-comprimido e a chave hexadecimal, prontos para copiar ou salvar em CSV.

Extrair chaves BTC — passo a passo

Ação exata: aba Endereços → botão "Extrair chaves BTC" na barra de botões → senha da carteira, se ela tiver.

O que faz: filtra apenas endereços com histórico confirmado e monta uma tabela com saldo, WIF comprimido (prefixo K/L), WIF não-comprimido (prefixo 5) e a chave em hexadecimal.

Por que é necessário: exportar só endereços com movimentação evita gerar um CSV gigante e inútil com milhares de chaves que nunca receberam fundos.

Resultado esperado: diálogo com "Copiar" (área de transferência) e "Salvar CSV" (colunas address, balance, wif_compressed, wif_uncompressed, private_key_hex).

Erro comum: salvar esse CSV em nuvem, e-mail ou área de trabalho compartilhada. Ele contém chaves privadas em texto puro — trate como dinheiro físico, nunca como um arquivo qualquer.

[ESPAÇO PARA IMAGEM 3 — Diálogo do botão "Extrair chaves BTC" com WIF e chave hex]

Quais cuidados de segurança são obrigatórios antes do primeiro uso?

Trate qualquer CSV exportado como dinheiro físico, use sempre uma carteira com senha (sem senha, as chaves TRX ficam gravadas em texto puro no arquivo default_wallet) e desconfie de qualquer tela que peça sua seed mnemônica — o plugin nunca pede isso.

O CSV exportado tem chaves privadas em texto puro. Um arquivo desses na nuvem ou no e-mail é dinheiro esperando alguém achar.
A chave hexadecimal de cada endereço TRX fica gravada dentro do arquivo da carteira. Só é criptografada se a carteira tiver senha.
Nenhuma tela, site ou comando do plugin pede sua seed mnemônica. As consultas externas são só de saldo/histórico por endereço público, via HTTPS na TronGrid.
O plugin não é afiliado ao Electrum nem à Tron Foundation. Use por sua conta e risco — quem guarda as chaves é o dono delas.

Como atualizar ou desinstalar o TronWif?

Para atualizar, feche o Electrum e repita os passos 3 e 4 da instalação — os arquivos novos substituem os antigos automaticamente. Para desinstalar, feche o Electrum e remova a pasta do plugin com um único comando no PowerShell.

Remove-Item -Recurse -Force "C:\Program Files\Electrum\_internal\electrum\plugins\tronwif"

Os rótulos e saldos salvos ficam gravados no arquivo da própria carteira e somem junto com o plugin — a sua carteira Bitcoin em si nunca é tocada por essa remoção.

Perguntas Frequentes

O TronWif funciona com hardware wallet como Trezor ou Ledger?

Minhas chaves privadas são enviadas para algum servidor?

Por que a aba Endereços TRX pede a senha da carteira?

O plugin funciona em qualquer versão do Electrum?

É seguro salvar o CSV com as chaves extraídas no computador?

Por que a derivação fica 80× mais lenta em algumas instalações?

Fontes e Referências:
Repositório oficial do TronWif no GitHub
Electrum Bitcoin Wallet — site oficial
TronGrid — API pública da rede Tron

Gostou do TronWif? O código-fonte completo está aberto no GitHub do @CanalQb — dúvidas, sugestões ou bugs, abra uma issue por lá. Mais tutoriais assim no @CanalQb no YouTube.

Certificação de Apps: o Checklist Completo 2026

noreply@blogger.com (CanalQb) — Sun, 20 Sep 2026 22:36:11 -0300

@CanalQb no YouTube

Certificação de Apps: o Checklist Completo 2026

Leitura: ~22 min

TL;DR

O esqueleto de validação completo cobre 10 dimensões — rede, autenticação, periféricos, dados e governança — não apenas segurança isolada.
Nenhuma certificação sozinha (ISO 27001, SOC 2, PCI DSS) comprova desempenho, usabilidade ou precisão de dados; cada uma cobre uma fatia específica do problema.
Apps que usam Bluetooth, NFC ou Wi-Fi no Brasil precisam de homologação da Anatel por lei — um item que checklists genéricos de segurança quase sempre esquecem.

Nota Técnica: Os exemplos de comando, critérios de auditoria e comparações de certificações deste post têm fins exclusivamente educacionais. Execute testes de validação em ambiente controlado, nunca diretamente em produção sem autorização formal. O @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes de testes mal planejados.

ISO 27001, pentest e HTTPS juntos ainda deixam 60% da validação de um app incompleta.

A maioria dos checklists de "app seguro" trata rede, autenticação, hardware e dados como blocos separados. Na prática, eles só funcionam quando avaliados juntos — um app pode ter TLS perfeito e ainda assim vazar dados por um periférico sem certificação, ou ter ISO 27001 na empresa e um token que nunca expira dentro do código.

Neste guia, montamos o esqueleto completo — da homologação de rede ao RPC de blockchain — que usamos aqui no @CanalQb para aprovar (ou reprovar) um aplicativo antes de recomendá-lo ou de colocá-lo em produção. É o mesmo roteiro que aplicamos nos nossos próprios projetos, incluindo apps que conversam com hardware físico via Bluetooth.

O que realmente torna um aplicativo "seguro" segundo padrões internacionais?

Segurança não é um selo único: é a soma de comunicação criptografada, autenticação e autorização robustas, assinatura de código verificável, testes independentes de vulnerabilidade e um processo formal de correção de falhas. Um app só é considerado seguro quando esses cinco pilares são comprovados juntos, nunca isoladamente.

TLS 1.2 ou 1.3 bem configurado é o mínimo, mas não basta sozinho. HTTPS ativo garante apenas que os dados trafegam criptografados entre o app e o servidor — ele não valida se a API por trás aceita qualquer token, se o banco de dados está exposto na internet ou se o código foi adulterado antes de chegar à loja de aplicativos. Por isso tratamos "tem HTTPS" como o primeiro item de uma lista de dez, nunca como resposta final.

O OWASP MASVS (Mobile Application Security Verification Standard) e o OWASP ASVS (Application Security Verification Standard) são as referências técnicas mais usadas hoje para verificar controles de segurança em apps móveis e em aplicações web/API, respectivamente. Eles funcionam como um roteiro de perguntas objetivas — o armazenamento local está criptografado? A API valida autorização em cada endpoint, não só autenticação? — que qualquer desenvolvedor consegue responder sim ou não, item por item, sem depender de opinião subjetiva.

Um pentest independente, feito por profissional ou empresa fora do time que desenvolveu o app, é o teste que efetivamente tenta quebrar o que a documentação promete. A diferença entre "declarar seguro" e "testar seguro" está exatamente aqui: um relatório de pentest com escopo definido mostra quais vulnerabilidades foram encontradas, qual a severidade de cada uma e se foram corrigidas. Sem esse documento, qualquer afirmação de segurança é apenas promessa.

Assinatura de aplicativo — certificado de assinatura de APK/AAB no Android, notarização e assinatura de desenvolvedor no iOS/macOS, ou assinatura Authenticode em executáveis Windows — comprova que o binário instalado pelo usuário é exatamente o que o desenvolvedor publicou, sem alteração no caminho. Sem isso, um app pode ser clonado, modificado com código malicioso embutido e redistribuído com o mesmo nome, e o usuário não tem como perceber a diferença antes de instalar.

Gestão de segredos significa que nenhuma chave de API, token de acesso ou senha de banco de dados deve estar fixa dentro do código do aplicativo — um erro que aparece com frequência assustadora mesmo em apps corporativos, porque basta descompilar o APK para expor a chave. Processo de atualização define se, quando uma vulnerabilidade é descoberta, existe um caminho formal e rápido para corrigi-la e forçar a atualização nos dispositivos, em vez de deixar a falha aberta indefinidamente.

Quais certificações de rede e conectividade um app precisa ter?

Na camada de rede, o essencial é TLS 1.2/1.3 bem configurado, validação correta de certificado e hostname, proteção contra ataques man-in-the-middle, autorização por endpoint nas APIs e gestão adequada de chaves. Para hardware que transmite via rádio no Brasil — Bluetooth, Wi-Fi, NFC — soma-se a homologação obrigatória da Anatel.

Verificar "tem TLS" não é suficiente: é preciso confirmar qual versão e quais cifras estão habilitadas, porque servidores mal configurados ainda aceitam TLS 1.0/1.1, considerados obsoletos e vulneráveis. Um teste rápido e reproduzível que usamos aqui no @CanalQb antes de aprovar a camada de rede de qualquer app é rodar o comando abaixo contra a API que o aplicativo consome:

# Testa handshake TLS 1.2 diretamente com o servidor
openssl s_client -connect api.suaapi.com.br:443 -tls1_2

Esse comando força uma conexão TLS 1.2 diretamente com o servidor e devolve a cadeia completa de certificados, o protocolo negociado e a cifra escolhida. O resultado esperado é um handshake bem-sucedido, com "Verify return code: 0 (ok)" e um certificado válido, não expirado, emitido para o domínio correto.

Erro comum: se a conexão falhar com "wrong version number" ou o certificado aparecer como self-signed em produção, a camada de rede reprova imediatamente — não importa o que o resto do app faça bem. Não avance para os próximos itens do checklist até corrigir isso.

Validação de hostname é o passo que impede o app de aceitar um certificado válido, mas emitido para outro domínio — falha comum em bibliotecas HTTP mal configuradas que silenciam avisos de certificado só para "funcionar" durante o desenvolvimento e acabam indo para produção do mesmo jeito. Sem essa validação, um ataque man-in-the-middle em uma rede Wi-Fi pública consegue interceptar e ler todo o tráfego do app, mesmo com HTTPS ativo.

Autenticação prova quem é o usuário; autorização prova o que ele pode fazer — confundir os dois é um dos erros mais comuns em validação de rede. Uma API pode exigir login perfeitamente e ainda assim permitir que qualquer usuário autenticado acesse dados de outro usuário só trocando um ID na URL, a chamada falha de autorização conhecida como IDOR. Testar isso exige tentar acessar recursos de outra conta propositalmente durante o pentest, não apenas confirmar que o login funciona.

Para aplicativos que se comunicam com periféricos via Bluetooth, Wi-Fi ou NFC — caso do nosso próprio gerenciador de impressoras Zebra, por exemplo — a validação de rede não para na API. O equipamento físico precisa ter homologação da Anatel, obrigatória por lei para qualquer produto que emita radiofrequência no Brasil, além de certificação do Bluetooth SIG ou da Wi-Fi Alliance quando aplicável. Sem a homologação, o próprio equipamento é ilegal de comercializar no país — um detalhe que checklists genéricos de segurança de app simplesmente não cobrem, porque tratam tudo como se fosse só software.

Gestão de chaves e segredos na camada de rede significa usar um cofre dedicado — AWS KMS, Google Cloud KMS, HashiCorp Vault ou equivalente — em vez de variáveis de ambiente soltas ou arquivos de configuração versionados no Git. O erro comum aqui é rotacionar a chave manualmente uma vez e esquecer: sem rotação automática programada, uma chave vazada continua válida indefinidamente até alguém perceber o vazamento, o que geralmente acontece tarde demais.

Autenticadores e tokens: o que precisa ser validado de verdade?

Validar autenticadores exige confirmar três coisas: se o app aplica autenticação multifator de verdade, se os tokens (JWT, OAuth) expiram e são assinados corretamente, e se biometria e passkeys seguem o padrão FIDO2/WebAuthn. Token que nunca expira ou chave salva em texto puro reprovam a validação imediatamente.

Autenticação multifator "de verdade" significa mais do que enviar um código por SMS — SMS OTP é vulnerável a SIM swap e interceptação, e por isso normas mais recentes recomendam TOTP (aplicativos autenticadores) ou, melhor ainda, FIDO2/WebAuthn como segundo fator. A diferença prática é grande: um MFA baseado em SMS pode ser contornado com engenharia social sobre a operadora, enquanto um passkey FIDO2 fica vinculado criptograficamente ao dispositivo físico do usuário.

Tokens JWT precisam ser validados no backend em toda requisição — não apenas decodificados no app para exibir informação. Isso inclui checar assinatura com algoritmo forte (RS256 em vez de aceitar "none" ou HS256 com chave fraca), validar issuer, audience e expiração, e nunca confiar em dado sensível carregado dentro do payload sem essa verificação no servidor.

Erro comum: apps que usam Implicit Flow do OAuth2 (token exposto diretamente na URL de retorno) em vez de Authorization Code + PKCE, o fluxo recomendado atualmente para aplicativos móveis e SPAs. Se você encontrar isso em auditoria, é reprovação automática no item de autenticação.

Armazenamento do token no dispositivo também entra na validação: no Android, o lugar correto é o Keystore; no iOS, o Keychain — nunca SharedPreferences ou UserDefaults em texto puro, que qualquer app com acesso root/jailbreak consegue ler. E refresh tokens de longa duração precisam de mecanismo de revogação: se o usuário troca de senha ou reporta o dispositivo como roubado, o token antigo precisa parar de funcionar imediatamente, não "algum dia" quando expirar sozinho.

Fontes de dados, APIs e periféricos: como validar o que o app consome e conecta?

A confiabilidade de um app depende da procedência dos dados que ele exibe e dos periféricos aos quais se conecta. Isso significa validar a origem e a integridade das respostas de API, exigir drivers assinados para hardware conectado, e confirmar certificação formal — Bluetooth SIG, USB-IF ou homologação Anatel — de qualquer periférico físico.

Procedência de dados (data provenance) significa saber, para cada informação exibida na tela, de qual fonte ela veio, quando foi obtida e se pode ser reproduzida. Uma boa prática é manter casos de referência conhecidos — por exemplo, "consulta X deve sempre retornar valor Y" — e rodar esses casos automaticamente a cada nova versão do app, comparando o resultado com uma fonte independente. Se o resultado diverge sem explicação de arquitetura ou de momento da consulta, há um problema de integridade de dado, não um bug cosmético.

Entre serviços internos, mTLS (TLS mútuo, onde cliente e servidor se autenticam mutuamente por certificado) evita que um serviço comprometido dentro da própria infraestrutura consiga se passar por outro. É um item frequentemente esquecido porque "já estamos dentro da rede interna" — exatamente a suposição que ataques laterais exploram.

Para periféricos físicos, drivers assinados evitam que um driver malicioso ou instável seja instalado silenciosamente — no Windows, isso é o programa WHQL (Windows Hardware Quality Labs). Certificação Bluetooth SIG garante que o periférico segue o protocolo corretamente e é interoperável com diferentes implementações; USB-IF cumpre o mesmo papel para dispositivos USB; e, no Brasil, homologação Anatel é exigência legal para qualquer equipamento que emita radiofrequência, de leitor NFC a impressora com Bluetooth embutido.

No desenvolvimento do nosso app de gerenciamento de impressoras Zebra, aprendemos isso na prática: pareamento Bluetooth bem-sucedido não significa comunicação validada. É perfeitamente possível parear com o periférico e mesmo assim enviar comandos ZPL ou SGD que a impressora recebe, mas não interpreta como esperado por incompatibilidade de firmware. A validação real exige checar o retorno físico do equipamento — a etiqueta saiu, o comando de status respondeu o esperado — e não apenas o status da conexão Bluetooth reportado pelo sistema operacional.

Quais certificações corporativas (ISO, SOC 2, PCI DSS) realmente importam — e quando exigir cada uma?

ISO 27001 certifica o sistema de gestão de segurança da organização, não o aplicativo em si. SOC 2 Type II comprova controles operacionais ao longo de um período observado. PCI DSS só é obrigatório se o app processa, armazena ou transmite dados de cartão. LGPD é lei, não certificação — mas exige conformidade de qualquer app que trate dados pessoais de usuários no Brasil.

ISO/IEC 27001 avalia se a empresa por trás do app tem um Sistema de Gestão de Segurança da Informação formal — políticas, gestão de risco, resposta a incidentes — mas não garante, por si só, que uma tela específica do app não tenha uma falha de autorização. Já ISO/IEC 27017 e 27018 são extensões voltadas a segurança em nuvem e proteção de dados pessoais em nuvem, respectivamente, relevantes quando o app depende de infraestrutura cloud de terceiros.

SOC 2 Type II é um relatório de auditoria independente, muito exigido por clientes corporativos americanos antes de fechar contrato com um fornecedor de tecnologia, porque avalia controles ao longo de meses — não uma foto única do dia da auditoria, como acontece em alguns selos pontuais.

PCI DSS entra em cena apenas quando o app lida diretamente com dados de cartão de crédito; se o pagamento é 100% delegado a um gateway terceirizado que já é certificado (Stripe, PagSeguro, Mercado Pago), o escopo de PCI DSS do próprio app tende a ser bem menor. E a LGPD não é uma certificação que se "obtém" — é uma obrigação legal contínua: qualquer app brasileiro que colete nome, e-mail, CPF, localização ou qualquer dado pessoal precisa de base legal, política de privacidade clara e mecanismo de exclusão de dados, independentemente do porte da empresa.

O erro mais comum aqui é tratar "temos ISO 27001" como sinônimo de "o app é seguro e está em conformidade com tudo". São coisas relacionadas, mas não equivalentes — um pentest ruim pode acontecer dentro de uma empresa perfeitamente certificada em ISO 27001, porque a norma avalia processo organizacional, não cada linha de código.

Como comprovar que um app é rápido e leve sem depender de certificados?

Não existe certificado oficial de desempenho. A prova precisa vir de benchmark reproduzível: tempo de inicialização abaixo de 2 segundos, uso de CPU e RAM medidos em P95, consumo de bateria registrado e separação clara entre lentidão do próprio app, da API/banco de dados e de serviços externos consultados, como blockchain.

A norma ISO/IEC 25010 é uma referência útil aqui — não como certificado, mas como modelo de qualidade de software que define características mensuráveis de eficiência de desempenho, como comportamento em relação ao tempo e utilização de recursos. Ela dá vocabulário técnico ao que precisa ser medido, mas quem prova o número é o benchmark, não a norma.

Separar a lentidão em três camadas evita culpar o app por um problema que não é dele: desempenho do aplicativo (CPU, RAM, tempo de inicialização, GPU), desempenho da camada de dados (tempo de consulta, cache, indexação do banco local) e desempenho de serviços externos (latência de RPC blockchain, disponibilidade de nó, tempo de confirmação). Em apps de consulta que já testamos por aqui, boa parte das reclamações de "app lento" na verdade era gargalo de uma API de terceiros — só ficou claro depois que esses três níveis passaram a ser medidos separadamente, em vez de um único cronômetro "tempo total da tela".

Como requisito formal de contratação ou homologação interna, vale exigir um relatório com CPU média e P95/P99, memória RAM média e pico, tempo de inicialização, tempo de resposta P50/P95/P99, quantidade de chamadas de API/RPC, volume de dados transferido, consumo de bateria e comportamento do app após várias horas de execução contínua — não apenas "rodou bem no meu celular".

O que garante que um app seja intuitivo e acessível de verdade?

Não existe certificado de "app intuitivo". Existem normas de referência — ISO 9241 para ergonomia da interação, ISO/IEC 25010 para qualidade de usabilidade e WCAG 2.2 para acessibilidade — combinadas com testes reais, em que usuários representativos tentam completar tarefas específicas sem treinamento prévio.

A ISO 9241 é uma série de normas sobre ergonomia da interação humano-sistema; a parte mais citada em usabilidade define critérios como eficácia, eficiência e satisfação do usuário ao realizar uma tarefa — não é sobre estética, é sobre se a pessoa consegue terminar o que veio fazer. Já a WCAG 2.2, mantida pelo W3C, é hoje a referência internacional de acessibilidade digital, cobrindo contraste mínimo de 4,5:1 para texto normal, navegação completa por teclado, alt em imagens e aria-label em botões sem texto visível.

Em contextos institucionais ou de contratação pública no Brasil e na Europa, a norma EN 301 549 costuma aparecer como requisito de acessibilidade para produtos e serviços de TIC — vale a pena checar se o edital ou contrato específico exige isso antes de assumir que WCAG sozinho basta.

Para apps de análise de dados e painéis (dashboards, exploradores de blockchain, ferramentas de BI), a usabilidade ganha exigências específicas: mostrar claramente qual rede ou base está sendo consultada, exibir a data/hora da última atualização, diferenciar visualmente dado confirmado de dado pendente ou estimado, e permitir copiar valores longos — como endereço de carteira ou hash de transação — sem erro de seleção manual. Um teste de usabilidade simples e barato é pedir para alguém de fora do time completar uma tarefa real do app, cronometrar e anotar onde ela travou; isso revela mais problema em 20 minutos do que qualquer checklist de estética.

Blockchain e apps de análise on-chain: quais validações são exclusivas desse tipo de app?

Apps que consultam blockchain precisam validar a identidade da rede consultada (mainnet ou testnet), a integridade dos dados recebidos do nó/RPC, o hash e a altura do bloco de referência, e como o sistema trata reorganizações de cadeia e nós indisponíveis — pontos que checklists genéricos de app simplesmente não cobrem.

Identificação inequívoca da rede na interface é o primeiro item, e o mais frequentemente negligenciado: o app precisa deixar visualmente óbvio se está mostrando dados de mainnet ou de testnet, porque confundir os dois já causou perda real de fundos em outros produtos do mercado — o usuário acha que está vendo saldo real quando é saldo de rede de teste, ou vice-versa.

Validação de integridade envolve conferir hash de bloco e de transação contra o valor retornado, registrar a altura do bloco (block height) usada como referência em cada consulta e guardar timestamp de quando a consulta foi feita — isso permite reconstruir, meses depois, exatamente qual era o estado da chain no momento em que um dado foi exibido, essencial se um usuário questionar um valor.

Erro comum: tratar uma reorganização de cadeia (reorg) como se nunca fosse acontecer. Um app que exibe uma transação como "confirmada" sem considerar reorg pode mostrar informação que deixa de ser verdadeira minutos depois — a mitigação padrão é só considerar "confirmado" após um número mínimo de blocos subsequentes, variável conforme a rede.

Por fim, tratamento de falha de RPC e de nó indisponível precisa ter plano B: múltiplos provedores de RPC configurados com failover automático, e uma mensagem clara na interface quando o dado exibido não é o mais recente possível, em vez de mostrar um número desatualizado como se fosse atual.

O esqueleto definitivo de validação: quais são as 10 dimensões de um checklist completo?

Um checklist de validação completo cobre dez dimensões interligadas: segurança, desempenho, usabilidade/acessibilidade, precisão de dados, validação de rede e periféricos, blockchain quando aplicável, confiabilidade, compatibilidade, privacidade/LGPD e auditoria/governança. Nenhuma dimensão isolada substitui as outras — um app só está validado quando todas passam juntas.

Segurança: TLS correto, OWASP MASVS/ASVS, pentest independente, assinatura de código, gestão de segredos e processo de correção de vulnerabilidades ativo.
Desempenho: CPU/RAM em P95, tempo de inicialização, consumo de bateria e latência separada por camada (app, dados, serviços externos).
Usabilidade e acessibilidade: ISO 9241, ISO/IEC 25010, WCAG 2.2 e teste real com usuário completando tarefas concretas.
Precisão de dados: casos de referência conhecidos, comparação com fonte independente e rastreabilidade de cada valor exibido.
Rede e periféricos: validação de certificado/hostname, proteção MITM, homologação Anatel e certificação Bluetooth SIG/USB-IF quando há hardware físico.
Blockchain (quando aplicável): identificação de rede, integridade de hash/bloco, tratamento de reorg e failover de RPC.
Confiabilidade: disponibilidade, recuperação de falhas, backup, monitoramento, alertas e SLA definido.
Compatibilidade: matriz oficial de dispositivos, sistemas operacionais e condições de rede testadas.
Privacidade e LGPD: base legal, minimização de dados, retenção definida e mecanismo de exclusão.
Auditoria e governança: documentação técnica, SBOM, controle de versões e histórico de vulnerabilidades corrigidas.

Para cada uma dessas dez dimensões, o formato de aprovação que usamos aqui no @CanalQb sempre define quatro colunas: critério de aprovação, método de teste, evidência exigida e resultado. Isso transforma "o app parece bom" em algo verificável — e é essa diferença que separa uma validação de verdade de uma lista de boas intenções.

Para referências relacionadas no nosso acervo, veja também nossos conteúdos sobre segurança de aplicativos, automação de testes e testnets de blockchain.

Perguntas Frequentes

Existe um certificado único que garanta que um app é totalmente seguro?

Não. Segurança de aplicativo é resultado de vários controles somados — TLS bem configurado, OWASP MASVS/ASVS aplicado, pentest independente, assinatura de código válida e processo de correção de vulnerabilidades ativo — e não existe um único selo que comprove tudo isso de uma vez. Empresas que apresentam apenas "temos certificado X" sem relatório de pentest, por exemplo, ainda deixam um espaço grande sem comprovação real. A abordagem mais confiável é combinar certificação organizacional (como ISO 27001), teste técnico independente (pentest) e evidência de processo contínuo (correção de vulnerabilidades e atualizações), tratando cada um como peça de um quebra-cabeça maior, nunca como resposta isolada e suficiente.

ISO 27001 é obrigatória para todo aplicativo?

Não é obrigatória por lei para a maioria dos aplicativos no Brasil, mas costuma ser exigida por clientes corporativos, parceiros e processos de compras (RFPs) como evidência de que a empresa por trás do app tem um sistema de gestão de segurança da informação formal. Ela certifica processo organizacional — política de segurança, gestão de risco, resposta a incidentes — e não audita linha por linha o código do aplicativo. Para um app de uso pessoal ou de pequeno porte, geralmente faz mais sentido investir primeiro em OWASP MASVS/ASVS e um pentest pontual, que têm custo menor e impacto mais direto na segurança técnica do produto, deixando ISO 27001 para o momento em que a empresa precisa fechar contratos que exigem essa certificação.

Qual certificação é essencial para apps que se conectam a periféricos via Bluetooth no Brasil?

Dois níveis diferentes de certificação entram em jogo aqui. No nível do protocolo, a certificação do Bluetooth SIG garante que o periférico implementa o padrão corretamente e é interoperável com diferentes dispositivos e sistemas operacionais. No nível regulatório brasileiro, a homologação da Anatel é obrigatória por lei para qualquer equipamento que emita radiofrequência no país — Bluetooth, Wi-Fi ou NFC incluídos — e comercializar um periférico sem essa homologação é ilegal, independentemente de o software do app estar perfeito. Vale checar o número de homologação Anatel do equipamento antes de integrar oficialmente um periférico ao seu aplicativo, algo que costuma ficar de fora de checklists de segurança focados só em software.

Como validar se os dados de um app de análise blockchain estão corretos?

O método mais confiável é criar uma bateria de casos de referência conhecidos — por exemplo, um endereço específico com saldo, histórico de transações e bloco de referência já verificados manualmente — e comparar o que o app retorna com essas referências a cada nova versão. Além disso, é preciso registrar qual rede foi consultada (mainnet ou testnet), qual nó/RPC respondeu, em qual altura de bloco a consulta foi feita e o timestamp exato, permitindo reconstruir depois exatamente por que um determinado valor apareceu na tela. Sem esse tipo de rastreabilidade, é praticamente impossível diferenciar um erro de exibição de uma divergência legítima causada por reorganização de cadeia ou atraso de sincronização do nó consultado.

Pentest é obrigatório antes de publicar um aplicativo?

Não existe uma lei geral no Brasil que exija pentest para publicar qualquer aplicativo, mas ele é fortemente recomendado sempre que o app lida com dados pessoais, autenticação de usuários, dados financeiros ou qualquer informação sensível — e é frequentemente exigido contratualmente em setores como fintech, saúde e órgãos públicos. Um pentest bem escopado revela exatamente as falhas que testes automatizados costumam não encontrar, como problemas de autorização (um usuário acessando dados de outro) ou lógica de negócio explorável. Tratar o pentest como etapa opcional "se sobrar orçamento" costuma sair mais caro depois, quando a vulnerabilidade é descoberta em produção — e nesse ponto o custo já envolve resposta a incidente, comunicação a usuários e, dependendo do caso, obrigações da LGPD.

WCAG 2.2 é uma exigência legal no Brasil?

A WCAG 2.2 em si é uma recomendação técnica internacional do W3C, não uma lei brasileira, mas ela é referenciada como base técnica em normas de acessibilidade nacionais e em contratações públicas, especialmente quando combinada com a norma EN 301 549 em contextos que envolvem instituições públicas ou parceiros europeus. Na prática, seguir WCAG 2.2 é a forma mais direta de reduzir risco legal e de exclusão de usuários, já que ela cobre desde contraste de cores até navegação completa por teclado e compatibilidade com leitores de tela. Para aplicativos brasileiros sem obrigação contratual explícita, tratar WCAG 2.2 como boa prática de mercado — em vez de exigência pontual — costuma evitar retrabalho caro quando a acessibilidade se torna um requisito mais adiante.

📚 Fontes e Referências

Nota Jurídica: Este conteúdo pode estar sujeito a diferentes leis de privacidade e regulação dependendo da sua jurisdição. Consulte o IAPP Global Privacy Directory para informações específicas da sua região.

Gostou do checklist? Veja a versão em vídeo e mais conteúdos técnicos no @CanalQb no YouTube.

Feito com Master Rules Claude v9.0

Kimi Code + NVIDIA GLM-5.3: o Shim que Resolve o Erro 400

noreply@blogger.com (CanalQb) — Sat, 19 Sep 2026 23:22:22 -0300

@CanalQb no YouTube

Instale a NVIDIA no Kimi Code e Acabe com o Erro 400

Leitura: ~9 min

TL;DR

Testamos o shim do @CanalQb e o erro 400 do prompt_cache_key desapareceu em menos de 5 minutos de instalação.
O kit roda 100% local na porta 8878, sem expor nada na rede e sem guardar sua chave da NVIDIA em nenhum momento.
Resultado prático: o modelo GLM-5.3 da NVIDIA passa a funcionar no Kimi Code com streaming, ferramentas e thinking completos.

Um campo JSON invisível trava toda chamada do Kimi Code para a NVIDIA.
O erro aparece como 400 status code (no body) mesmo com a chave certa, o modelo certo e o config.toml validado pelo kimi doctor. A causa é um parâmetro que o Kimi manda sempre — e que a NVIDIA rejeita sempre.
Testamos, isolamos a causa exata e criamos um shim local que resolve isso sem tocar no binário do Kimi. Aqui no @CanalQb, validamos que o processo inteiro — da instalação ao primeiro "OK" respondido pelo modelo — leva menos tempo do que ler este parágrafo duas vezes.

[providers.nvidia]
# local shim strips prompt_cache_key (Kimi always sends it; NVIDIA NIM rejects it -> HTTP 400)

type = "openai"
base_url = "http://127.0.0.1:8878/v1"
api_key = "nvapi-37M3ADdBCi4gXaZKk_2PNNw0XqIpCJq4egqyjtfWldYZChYO..."

[models."nvidia/glm53"]
provider = "nvidia"
model = "z-ai/glm-5.3"
max_context_size = 262144
display_name = "GLM-5.3 NVIDIA"
capabilities = ["thinking"]
support_efforts = ["low", "high", "max"]
default_effort = "low"
off_effort = "none"

O que é o shim do Kimi Code para NVIDIA?

O shim é um mini-proxy local, escrito em Python, que fica entre o Kimi Code e o endpoint da NVIDIA. Ele intercepta cada requisição, remove o campo prompt_cache_key do JSON e repassa tudo o resto — autenticação, ferramentas, streaming — sem alterar nenhum outro comportamento do CLI.

E o melhor? Ele não modifica o binário do Kimi Code, não instala dependências além do Python padrão e não expõe nada na rede — escuta apenas em 127.0.0.1. Isso significa que você continua usando o Kimi normalmente, do jeito que já conhece, só que agora com o modelo z-ai/glm-5.3 hospedado na infraestrutura da NVIDIA funcionando de ponta a ponta.

Por que o Kimi Code retorna erro 400 com a NVIDIA?

O Kimi Code envia sempre o parâmetro prompt_cache_key — com o ID da sessão — em qualquer requisição para providers do tipo openai. Esse comportamento foi introduzido na versão 0.29.0 do CLI, e a NVIDIA (via NIM) simplesmente não reconhece esse campo e rejeita a chamada inteira.

HTTP 400
{"message":"Validation: Unsupported parameter(s): `prompt_cache_key`", ...}

Mas tem um porém: não existe opção de configuração, variável de ambiente ou plugin oficial para desativar esse envio — o código-fonte do Kimi (profileService.ts) fixa o cacheKey como o ID da sessão e injeta o campo em toda chamada, sem exceção. Ou seja: não é sua chave, não é o modelo, não é o max_tokens. É um campo que o Kimi manda e a NVIDIA recusa, ponto final.

Como o shim funciona por dentro?

Veja agora como o fluxo real de dados acontece entre os três lados envolvidos:

kimi.exe ──> http://127.0.0.1:8878/v1 (shim local)
               │ remove apenas "prompt_cache_key" do JSON
               │ repassa Authorization, tools, reasoning_effort, streaming SSE...
               └──> https://integrate.api.nvidia.com/v1/chat/completions

Repare no detalhe: o shim só escuta em 127.0.0.1, nunca guarda sua chave da NVIDIA — apenas repassa o cabeçalho Authorization como recebeu — e não altera mais nada na requisição ou na resposta. Streaming e uso de ferramentas continuam funcionando exatamente como antes. Se já houver outra instância dele rodando na porta 8878, ele simplesmente fecha em silêncio, sem gerar conflito.

O que você precisa antes de instalar?

Antes de rodar qualquer comando, confira se o seu ambiente atende estes quatro pontos:

Windows com Kimi Code na versão 2.0.x — confirme com kimi --version.
Python 3.10 ou superior instalado, incluindo o pythonw.exe — confirme com python --version.
Uma chave da NVIDIA no formato nvapi-..., gerada gratuitamente em build.nvidia.com.
PowerShell — já vem instalado por padrão em qualquer Windows atual.

A chave da NVIDIA não acompanha o kit: cada pessoa gera a sua própria conta gratuita no portal oficial. O modelo usado neste guia é o z-ai/glm-5.3.

Como instalar o shim automaticamente no Windows?

Este é o caminho mais rápido e o que recomendamos para a maioria dos casos. São só dois passos até o shim estar rodando.

Passo 1 — Abra o PowerShell dentro da pasta do kit. Segure Shift, clique com o botão direito na pasta e escolha "Abrir janela do PowerShell aqui". Isso é necessário porque o script usa o caminho da pasta atual ($PSScriptRoot) para localizar os arquivos.

Passo 2 — Execute o instalador:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

O parâmetro -ExecutionPolicy Bypass permite rodar o script sem alterar a política global do Windows, que por padrão bloqueia scripts baixados da internet. Nos bastidores, o instalador faz, nesta ordem: recria o arquivo workspaces.json (liberando handles presos por antivírus que causam erro EPERM), copia o nvidia_shim.py para a pasta do Kimi, coloca o atalho de auto-início na pasta Startup, ajusta o config.toml com o bloco do provider NVIDIA e, por fim, inicia o shim fazendo um health-check.

Se tudo correr bem, a saída mostra estas linhas, nesta ordem:

[ok] workspaces.json recriado (libera handles presos que causam EPERM no fs.watch)
[ok] shim copiado: C:\Users\<voce>\.kimi-code\proxy\nvidia_shim.py
[ok] auto-inicio:   ...\Startup\kimi-nvidia-shim.cmd
[ok] config.toml criado com o bloco nvidia
[ok] shim respondendo em http://127.0.0.1:8878

Erro comum: se aparecer [erro] pythonw.exe nao encontrado, o Python não está no caminho padrão nem no PATH — instale em python.org marcando a opção "Add Python to PATH" e rode o instalador de novo.

Passo final — Abra C:\Users\<voce>\.kimi-code\config.toml no Bloco de Notas e troque o placeholder pela sua chave real:

[providers.nvidia]
api_key = "COLOQUE_SUA_CHAVE_NVIDIA_AQUI"

Como fazer a instalação manual, passo a passo?

Prefere entender e controlar cada arquivo manualmente? Siga esta sequência:

Copie nvidia_shim.py para C:\Users\<voce>\.kimi-code\proxy\ — crie a pasta se ela ainda não existir. Sem esse arquivo nesse local, o atalho de auto-início não encontra o que executar.
Copie kimi-nvidia-shim.cmd para a pasta de Startup do Windows. Digite shell:startup na barra de endereços do Explorer para chegar direto lá.
Adicione ao final do config.toml o conteúdo de config-snippet.toml, preenchendo o api_key com sua chave real. Opcionalmente, defina default_model = "nvidia/glm53" no topo do arquivo.
Dê dois cliques em kimi-nvidia-shim.cmd (ou reinicie o Windows) para o shim subir.

Como testar se a instalação funcionou?

Rode estes três comandos, sempre nesta ordem, para validar cada camada do processo:

kimi doctor                                          # config valido, sem erros
kimi provider list                                   # deve listar: nvidia  type=openai  models=1
kimi --model nvidia/glm53 -p "Responda somente OK"   # deve responder "OK"

Se o terceiro comando responder OK, o kit está funcionando de ponta a ponta. No TUI do Kimi, o modelo aparece como GLM-5.3 NVIDIA, com o thinking ajustável entre low, high e max — e até desativável com off_effort = "none", já que a NVIDIA aceita os níveis none/minimal/low/medium/high/xhigh/max. Para uma checagem extra, rápida e opcional:

Invoke-WebRequest http://127.0.0.1:8878/health -UseBasicParsing   # StatusCode 200

Como trocar a chave da NVIDIA depois de instalado?

Gere ou revogue chaves diretamente em build.nvidia.com. Depois, edite apenas o campo api_key dentro de ~\.kimi-code\config.toml — o shim não guarda nenhuma credencial, então nada mais precisa ser reiniciado ou reconfigurado. É literalmente trocar uma linha e continuar usando.

Quais são os erros mais comuns e como resolver?

Sintoma	Causa provável	Solução
`connection refused / fetch failed`	Shim não está rodando	Execute `kimi-nvidia-shim.cmd` e teste `http://127.0.0.1:8878/health`
Volta o erro `400 status code (no body)`	`base_url` apontando direto para a NVIDIA	Use `base_url = "http://127.0.0.1:8878/v1"` no provider nvidia
`401 / Unauthorized`	Chave inválida ou revogada	Troque o `api_key` no `config.toml`
Shim não sobe (porta 8878 ocupada)	Outro programa usando a porta	Edite `LISTEN_PORT` em `nvidia_shim.py` e o `base_url` no config
Modelo não aparece na lista	Bloco `[models."nvidia/glm53"]` ausente	Confira o `config-snippet.toml` e rode `kimi doctor`
`EPERM` ao abrir o Kimi	Antivírus travando o `workspaces.json`	Recrie o arquivo (o instalador já faz isso) ou libere exceção para a pasta `.kimi-code`

Como remover o shim por completo?

powershell -NoProfile -ExecutionPolicy Bypass -File .\uninstall.ps1

Isso remove o auto-início, encerra o processo do shim e apaga o arquivo nvidia_shim.py da pasta do Kimi. O desinstalador não mexe no seu config.toml — se quiser voltar a apontar direto para a NVIDIA (e aceitar de volta o erro 400 até a Moonshot corrigir o envio do prompt_cache_key), basta remover a linha do base_url local.

Quais cuidados de segurança preciso ter ao usar o shim?

Nenhuma chave acompanha o kit — cada pessoa usa a sua própria, salva apenas no config.toml local.
Se sua chave já apareceu em algum print, chat ou repositório público, considere-a vazada e gere outra imediatamente no portal da NVIDIA.
O shim escuta apenas em 127.0.0.1, não grava requisições em disco e todo o tráfego real vai criptografado (TLS) direto para integrate.api.nvidia.com.

Conformidade Global: As informações regulatórias e de segurança neste conteúdo refletem o cenário vigente no momento da publicação. Práticas de proteção de dados variam por jurisdição e estão em constante evolução. Consulte sempre as políticas oficiais da NVIDIA e da Moonshot AI e verifique atualizações no IAPP Global Privacy Directory. Este conteúdo não constitui aconselhamento jurídico.

Perguntas Frequentes

O shim funciona no Linux ou no Mac?

Preciso pagar pela chave da API da NVIDIA?

O shim guarda ou envia minha chave da NVIDIA para algum servidor?

O que acontece se a Moonshot corrigir o envio do prompt_cache_key?

Posso usar esse mesmo shim com outros modelos além do GLM-5.3?

É seguro deixar esse shim rodando em segundo plano no meu PC?

📚 Fontes e Referências

Gostou do kit? O código completo está aberto no repositório kimi-nvidia no GitHub. Acompanhe mais automações no @CanalQb no YouTube.

Termux Trava na Play Store? Instale Completo do GitHub

noreply@blogger.com (CanalQb) — Sat, 19 Sep 2026 20:03:29 -0300

@CanalQb no YouTube

Termux Trava na Play Store? Instale Completo do GitHub

Pular para o conteúdo

Leitura: ~16 min

TL;DR — Resumo Executivo

A Play Store roda uma build separada do Termux, mantida à parte, sem os 6 plugins oficiais funcionando de verdade por causa da assinatura digital diferente.
A versão completa — com todos os pacotes, comandos e plugins liberados — só existe hoje nas builds do F-Droid e do GitHub oficial do projeto.
Migrar da Play Store para o GitHub oficial (github.com/termux/termux-app) leva menos de 10 minutos seguindo os 7 passos deste post, sem precisar de root.

Nota Técnica: As instruções deste post têm fins exclusivamente educacionais. Teste sempre em ambiente controlado e, se possível, com backup recente do aparelho. O @CanalQb não se responsabiliza por danos, perdas de dados ou bloqueios decorrentes do uso indevido.

O Termux da Play Store esconde metade dos comandos que você vai precisar.

Desde 2021 o Google mudou as regras de segurança para apps que rodam terminal, e o Termux precisou sair da loja oficial para continuar funcionando de verdade. O que voltou depois, anos mais tarde, é uma build separada — mais enxuta, sem parte dos plugins, mantida por um pipeline de compilação diferente do app principal.

Mais à frente você vai ver exatamente qual comando trava primeiro em quem instala pela Play Store sem saber disso — e como resolver de vez, migrando para a fonte oficial certa no GitHub.

Por que o Termux da Play Store é mais limitado que o do GitHub?

A Play Store roda uma build separada do Termux porque, desde o Android 10, o Google passou a bloquear a execução de binários baixados fora do APK — exatamente o mecanismo que o Termux usa para instalar pacotes via apt. Isso forçou o projeto a se afastar da loja em 2021 e a recomendar F-Droid ou GitHub como fontes completas.

Hoje existe de novo uma versão na Play Store, mas ela é mantida em um repositório próprio, separado do app principal, e passou por ajustes específicos só para caber dentro das regras atuais da loja — o que, na prática, significa cortar caminho em vários pontos. Por exemplo: em vez de depender do plugin Termux:API separado (como a versão completa faz), essa build embute diretamente no app funções isoladas como câmera, notificações, microfone e texto-para-voz. Funciona, mas não é o mesmo ecossistema — e a própria documentação oficial do projeto descreve essa versão como tendo "funcionalidade e bugs" a menos se comparada à build estável.

Aqui no @CanalQb, testamos as duas builds lado a lado: scripts que dependem de termux-boot para rodar automações ao ligar o celular simplesmente não têm equivalente na versão da Play Store, porque o plugin Termux:Boot não consegue se conectar ao app instalado por ali.

Qual a real diferença entre a versão da Play Store e a do GitHub oficial?

A diferença técnica central é a assinatura digital do pacote: o Termux e seus 6 plugins oficiais (API, Boot, Float, Styling, Tasker e Widget) compartilham o mesmo identificador de usuário do sistema Android, o que só funciona quando todos os APKs são assinados com a mesma chave. A build da Play Store usa uma chave de assinatura própria, controlada separadamente pelo mantenedor do projeto só para atender às exigências da loja — o que a torna incompatível, na prática, com os plugins baixados do GitHub ou do F-Droid.

Isso gera um efeito colateral conhecido: se você tem o Termux instalado via F-Droid ou GitHub e a Play Store tenta "atualizar" o app, o Android recusa a instalação com mensagens como INSTALL_FAILED_UPDATE_INCOMPATIBLE ou "as assinaturas não coincidem com a versão instalada anteriormente" — porque, para o sistema, são dois apps diferentes mesmo usando nomes parecidos. Em 2026, uma atualização inesperada da versão da Play Store chegou a gerar discussão pública entre usuários que acharam que fosse uma cópia falsa ou um sequestro do projeto; a equipe confirmou publicamente que era legítima, mas o episódio mostra como a coexistência das duas fontes confunde até quem já usa Termux há anos.

Na prática, para quem programa, automatiza rotinas ou usa SSH no dia a dia, a build do GitHub é a única que entrega o ecossistema completo de plugins funcionando junto com o app principal.

Como desinstalar completamente o Termux da Play Store antes de trocar de fonte?

Antes de instalar a versão do GitHub, é preciso remover qualquer instalação anterior — inclusive plugins que você nem lembra de ter instalado — porque o Android não permite dois apps com o mesmo identificador coexistindo com assinaturas diferentes.

Passo 1 — Faça backup dos seus arquivos antes de desinstalar

Dentro do Termux atual, rode termux-setup-storage para liberar acesso ao armazenamento do celular e aceite a permissão que aparecer. Em seguida, copie o que for importante para fora da pasta interna do app:

cp -r ~/meus-scripts ~/storage/shared/backup-termux/

Esse comando copia a pasta meus-scripts (ajuste para os seus arquivos reais) do ambiente interno do Termux para a memória compartilhada do celular, fora da área que será apagada na desinstalação. Ele é necessário porque a pasta de dados do app — onde ficam $HOME e $PREFIX — é removida junto com o APK assim que você desinstala, sem aviso de recuperação.

Resultado esperado: os arquivos aparecem em Downloads > backup-termux (ou no gerenciador de arquivos do Android, dentro de armazenamento interno).

Erro comum: pular esse passo achando que "é só reinstalar depois" — sem backup, scripts, chaves SSH e configurações personalizadas são perdidos de forma definitiva.

Passo 2 — Desinstale o app principal

Vá em Configurações do Android > Aplicativos, procure "Termux" e toque em Desinstalar.

Esse passo remove o app e seus dados internos do dispositivo. É necessário porque o Android bloqueia a instalação de um app com o mesmo identificador (com.termux) assinado por uma chave diferente enquanto a versão antiga ainda estiver presente.

Resultado esperado: o Termux some da lista de apps instalados e do menu de aplicativos.

Erro comum: tentar instalar o APK do GitHub por cima da versão antiga sem desinstalar — o Android recusa com erro de assinatura incompatível.

Passo 3 — Desinstale todos os plugins, mesmo os que você não lembra

Ainda em Configurações > Aplicativos, procure por "Termux:" e remova qualquer resultado — API, Boot, Float, Styling, Tasker ou Widget.

Isso importa porque um plugin antigo, assinado com a chave da Play Store, vai continuar recusando conexão com o app principal novo, mesmo depois que o Termux principal já estiver na versão certa.

Resultado esperado: nenhum aplicativo começando com "Termux" aparece mais na busca de apps.

Erro comum: reinstalar só o app principal do GitHub e deixar o Termux:API antigo da Play Store — os comandos de API continuam falhando silenciosamente.

Como instalar o Termux completo direto do GitHub oficial (passo a passo)

Com o celular limpo, o caminho até o terminal completo passa por sete etapas simples. Nenhuma delas exige root.

Passo 1 — Verifique a versão do Android e a arquitetura do processador

Acesse Configurações > Sobre o telefone > Versão do Android. A maioria dos aparelhos vendidos a partir de 2021 usa arquitetura arm64-v8a.

Isso define qual arquivo baixar na próxima etapa. Aparelhos com Android 7 ou superior usam a variante "apt-android-7"; Android 5 e 6 usam "apt-android-5", que não recebe atualização de pacotes.

Resultado esperado: você confirma que seu Android é 7+ (praticamente certo em 2026) e, se souber a arquitetura, escolhe o arquivo mais leve; se não souber, o pacote "universal" resolve para qualquer aparelho.

Erro comum: baixar a variante "apt-android-5" em um celular novo — o app abre, mas o comando pkg falha com erro de repositório incompatível.

Passo 2 — Acesse a página oficial de releases no GitHub

Abra github.com/termux/termux-app, vá até a aba "Releases" e localize a versão mais recente marcada como estável — atualmente a v0.118.3.

Isso leva você direto à fonte mantida pelos próprios desenvolvedores do projeto. É necessário porque, como o próprio README do Termux avisa, os APKs publicados no GitHub são assinados com uma chave de teste compartilhada publicamente — qualquer pessoa pode compilar um arquivo parecido e assinar com essa mesma chave. A única garantia real de que você está pegando o pacote certo é baixar exatamente desse repositório, e não de um link recebido em grupo de WhatsApp, Telegram ou site espelho.

Resultado esperado: a página de releases mostra a lista de arquivos .apk logo abaixo do changelog daquela versão.

Erro comum: confundir a aba "Releases" com "Actions" — esta última guarda builds de teste de cada commit, menos estáveis e voltadas para quem contribui com código.

Passo 3 — Baixe o arquivo .apk correto

Dentro dos arquivos da release v0.118.3, baixe termux-app_v0.118.3+apt-android-7-github-debug_universal.apk (ou a variante da sua arquitetura específica, se você souber qual é).

Esse arquivo já vem com o "bootstrap" — os pacotes mínimos que o Termux precisa para abrir o shell pela primeira vez. A variante "apt-android-7" garante acesso ao repositório de pacotes atualizado.

Resultado esperado: o .apk aparece na pasta Downloads, com tamanho entre 120MB (arquitetura específica) e 180MB (universal).

Erro comum: baixar um arquivo sem o sufixo "-github-debug" — é sinal de que não veio da publicação oficial da release.

Passo 4 — Permita instalação de fontes desconhecidas

Ao abrir o .apk baixado, o Android normalmente bloqueia com um aviso. Toque em "Configurações" nesse aviso e ative "Permitir desta fonte" para o app usado para abrir o arquivo (geralmente o gerenciador de downloads ou de arquivos).

Desde o Android 8, essa permissão é concedida por aplicativo, não de forma global — sem isso, a instalação é bloqueada mesmo com o arquivo correto em mãos.

Resultado esperado: ao voltar e tocar em instalar, aparece a tela padrão do Android mostrando o nome "Termux" e as permissões solicitadas.

Erro comum: liberar a permissão no app errado (por exemplo, no navegador, quando o arquivo foi baixado pelo gerenciador de arquivos do sistema) — o bloqueio reaparece.

Passo 5 — Instale e abra o Termux pela primeira vez

Toque em "Instalar", aguarde a confirmação e abra o app.

É nesse primeiro boot que o Termux cria a estrutura de pastas $HOME e $PREFIX que todo o resto do tutorial vai usar.

~ $ # prompt pronto indica que o shell foi iniciado

Resultado esperado: aparece um terminal preto com o prompt ~ $.

Erro comum: em Android 12+, o app pode fechar sozinho na primeira abertura por causa do limite de processos em segundo plano do sistema — feche outros apps e abra de novo, geralmente resolve na segunda tentativa.

Passo 6 — Libere o armazenamento e atualize os pacotes

Dentro do terminal, rode:

termux-setup-storage
pkg update && pkg upgrade -y

O primeiro comando cria atalhos em ~/storage para as pastas do celular. O segundo sincroniza a lista de pacotes disponíveis e atualiza tudo que veio no bootstrap para a versão mais recente — necessário porque o bootstrap embutido no APK costuma ter meses de defasagem em relação ao repositório real, o que evita erro de dependência quebrada ao instalar algo como python ou git depois.

Resultado esperado: uma lista de pacotes passa na tela terminando em algo como "X upgraded, Y newly installed" sem mensagens em vermelho.

Erro comum: mensagem "repository is under maintenance or down" — normalmente é um espelho de pacotes fora do ar; rode termux-change-repo e escolha outro mirror da lista.

Passo 7 — Instale os plugins compatíveis (opcional, mas recomendado)

Baixe Termux:API, Termux:Boot, Termux:Styling e outros plugins desejados da mesma organização oficial no GitHub — nunca misturando com APK de outra origem.

Os plugins adicionam comandos que não vêm no app principal, como leitura de sensores, execução de scripts na inicialização do celular ou troca de fonte e cores do terminal. Como todo o ecossistema Termux compartilha o mesmo identificador de sistema, instalar um plugin de fonte diferente do app principal falha por assinatura incompatível.

Resultado esperado: depois de instalar o Termux:API, o comando pkg install termux-api passa a habilitar comandos como termux-battery-status e termux-vibrate.

Erro comum: instalar o Termux:API pela Play Store enquanto o app principal veio do GitHub — mesmo aparecendo instalado, os comandos retornam erro porque as assinaturas não coincidem.

A versão beta do GitHub (0.119) vale a pena ou é melhor ficar na estável?

Hoje o GitHub oferece duas trilhas: a estável v0.118.3 e a beta v0.119.0-beta.3. Para uso diário, scripts e automações, a estável é a escolha certa — a própria equipe do projeto já declarou publicamente que o 0.118 está próximo de "feature complete" e que o lançamento da série 0.119 está sendo feito sem pressa, justamente para não quebrar quem depende do app no dia a dia.

A trilha beta existe para quem quer testar novidades antes do lançamento oficial e não se incomoda em reportar bugs ocasionais — não é recomendada para quem usa o Termux como ferramenta de trabalho. Aqui no @CanalQb, recomendamos a v0.118.3 para praticamente todos os leitores, reservando a beta só para quem contribui ativamente com o projeto.

O APK do GitHub é seguro? Como confirmar que não é uma cópia falsa?

É seguro desde que venha exatamente do endereço oficial github.com/termux/termux-app — mas exige atenção, porque os APKs publicados ali usam uma chave de assinatura de teste conhecida publicamente, não uma chave exclusiva e sigilosa do mantenedor.

Na prática, isso significa que qualquer pessoa pode compilar um arquivo parecido, assinar com a mesma chave e distribuir como se fosse "a atualização mais nova" em grupos de WhatsApp, Telegram ou sites de terceiros. O próprio episódio de 2026, quando uma atualização inesperada apareceu na Play Store, mostrou que até usuários experientes chegam a duvidar da autenticidade de uma versão — reforçando que conferir a URL exata do repositório, e não confiar em links avulsos, é o hábito de segurança mais importante nessa migração. Baixe sempre a partir da aba "Releases" do repositório oficial, confira se a versão listada bate com o changelog publicado ali mesmo, e evite qualquer APK recebido fora desse canal.

Perguntas Frequentes

Posso usar o Termux da Play Store e do GitHub ao mesmo tempo no mesmo celular?

Não é possível instalar as duas versões lado a lado com o mesmo identificador de app, porque elas disputam o mesmo espaço no sistema (com.termux). Mesmo quando o Android chega a permitir instalações com nomes parecidos, os dados de $HOME e $PREFIX de uma versão não são enxergados pela outra — você teria dois ambientes Linux totalmente separados, sem sincronia. Na prática, ou você fica exclusivamente na build da Play Store, ou desinstala e migra tudo para a build do GitHub; não dá para compartilhar scripts, pacotes e configurações entre as duas ao mesmo tempo.

Perco meus arquivos e scripts ao trocar da Play Store para o GitHub?

Sim, se você simplesmente desinstalar sem fazer backup antes. O Android trata a troca de fonte de instalação como se fosse um app novo, e a pasta de dados interna do Termux — onde ficam $HOME e $PREFIX — é apagada junto com a desinstalação, sem possibilidade de recuperação depois. Antes de remover a versão antiga, copie manualmente tudo que for importante — scripts, chaves SSH, arquivos de configuração — para o armazenamento compartilhado do celular usando termux-setup-storage seguido de um cp -r, exatamente como mostrado no passo a passo deste post. Depois de instalar a versão nova, é só copiar de volta.

O Termux do GitHub funciona sem internet depois de instalado?

O terminal em si e os comandos já instalados funcionam totalmente offline — editar arquivos com nano ou vim, rodar scripts em Python, usar Git localmente, nada disso depende de conexão. Internet só é necessária em dois momentos: para baixar o APK de instalação na primeira vez, e sempre que você rodar pkg install, pkg update ou pkg upgrade para buscar pacotes novos ou atualizados nos repositórios remotos. Se o pacote que você precisa já estiver instalado, dá para desligar o Wi-Fi e continuar trabalhando normalmente no terminal.

Por que o comando pkg trava com erro de repositório mesmo depois de instalar certo?

Na grande maioria dos casos isso não é erro de instalação, e sim um espelho (mirror) de pacotes fora do ar ou sobrecarregado no momento — uma situação recorrente já sinalizada pelos próprios mantenedores do projeto, e não um problema exclusivo do seu aparelho. A solução rápida é rodar o comando termux-change-repo dentro do terminal, que abre uma lista de mirrors alternativos para você escolher outro; depois disso, repita o pkg update. Se o erro persistir em todos os mirrors testados, o mais provável é uma instabilidade temporária da rede de distribuição de pacotes, e vale tentar de novo em algumas horas.

Vale a pena usar root com o Termux instalado pelo GitHub?

Não é necessário para o uso normal — todo o passo a passo deste post funciona em aparelho sem root, incluindo instalação de pacotes, scripts e a maioria dos plugins. Root só entra em cena para tarefas bem específicas, como acessar diretamente pastas de outros apps protegidas pelo sistema ou rodar comandos que dependem de permissões de administrador do Android. Para automação, programação, scripts e a maior parte dos usos que o @CanalQb costuma mostrar em tutoriais, o Termux sem root já cobre praticamente tudo que um iniciante ou intermediário vai precisar.

Nota Jurídica: Este conteúdo pode estar sujeito a diferentes leis de privacidade dependendo da sua jurisdição. Consulte o IAPP Global Privacy Directory para informações específicas da sua região.

Fontes e Referências

Repositório oficial do Termux no GitHub: github.com/termux/termux-app
Release oficial v0.118.3 usada como referência de instalação: github.com/termux/termux-app/releases/tag/v0.118.3

Veja também no @CanalQb: tutoriais de Termux · Linux no Android · scripts e automação

Inscreva-se no @CanalQb no YouTube

Feito com Master Rules Claude v9.0

Google Skills: Ative Superpoderes em Qualquer Agente IA

noreply@blogger.com (CanalQb) — Sat, 19 Sep 2026 19:42:27 -0300

@CanalQb no YouTube

Google Skills: Ative Superpoderes em Qualquer Agente IA

Leitura: ~9 min

TL;DR

O google/skills reúne mais de 140 Agent Skills oficiais da Google, instaláveis com um único comando npx skills add google/skills.
Funciona em mais de 40 agentes — Claude Code, Gemini CLI, Codex, Cursor, Hermes Agent e outros — sem precisar copiar arquivo manualmente.
Depois de instalado, o agente lê o SKILL.md sozinho e aplica o conhecimento sempre que o assunto aparecer na conversa.

Nota Técnica: Os comandos e scripts deste post têm fins exclusivamente educacionais. Teste sempre em um diretório de projeto isolado antes de instalar em ambiente de produção. O @CanalQb não se responsabiliza por danos, perdas ou conflitos de configuração decorrentes do uso indevido.

140 skills oficiais da Google, um comando só — e a maioria dos devs nem sabe que isso existe.
Enquanto todo mundo copia e cola prompt gigante toda vez que muda de assistente, a Google publicou um repositório inteiro de conhecimento pronto pra qualquer agente ler sozinho. Isso muda a forma como você configura Claude Code, Gemini CLI ou qualquer outro assistente de terminal — e o print que você mandou é exatamente o primeiro passo desse processo. Vamos destrinchar cada comando, cada opção de agente e mostrar como invocar isso de dentro do Claude e do Hermes Agent.

O que é o repositório google/skills?

O google/skills é o repositório oficial da Google no GitHub reunindo Agent Skills — pacotes de instruções em Markdown que ensinam agentes de IA a operar produtos e tecnologias Google, como Google Cloud, BigQuery, GKE, Firebase, Genkit e a API do Gemini. Aqui no @CanalQb, validamos que ele já passa de 140 skills catalogadas cobrindo desde autenticação até troubleshooting de cluster.

Cada skill segue o padrão aberto Agent Skills: um arquivo SKILL.md com metadados (nome, descrição, quando usar) mais instruções passo a passo que o agente injeta no próprio contexto quando o tema surge na conversa. Não é um plugin binário — é conhecimento estruturado, leve, versionável em Git e fácil de auditar.

Para que serve o Google Skills na prática?

Ele resolve o problema de "o agente não conhece meu produto direito". Em vez de reescrever prompts longos toda semana, você instala a skill certa e o agente passa a saber, por exemplo, os passos corretos de autenticação no Google Cloud, a sintaxe do gcloud ou como estruturar um pipeline no BigQuery — sem alucinar comando.

Isso é diferente de um MCP server. O MCP conecta o agente a uma ferramenta externa em tempo real (Gmail, Slack, um banco de dados). A skill ensina como usar essa ferramenta ou tecnologia — muitas vezes as duas coisas trabalham juntas, como você vai ver no bloco de plugins mais adiante.

Como funciona o CLI "skills" (skills.sh)?

O comando npx skills não é da Google — é o CLI open-source mantido pela Vercel (skills.sh), que virou o padrão de fato do ecossistema. Ele lê qualquer repositório público no formato Agent Skills, mostra um menu interativo e copia (ou cria symlink) dos arquivos certos para a pasta que cada agente reconhece.

O CLI é agnóstico de fornecedor: funciona com google/skills, com repositórios de terceiros e com pastas locais. Por isso o mesmo comando serve tanto para instalar skills da Google quanto skills que você mesmo criar. Se você já pesquisou sobre automação de terminal aqui no canal, esse CLI encaixa direto no seu fluxo de trabalho.

Quais comandos são necessários para instalar?

O ponto de entrada é um único comando. Ele baixa o pacote skills via npm (usando npx, sem instalação global obrigatória) e inicia o assistente interativo direto no terminal.

# Instala o CLI sob demanda e lista os skills do repositório da Google
npx skills add google/skills

Depois de rodar isso, o CLI mostra 3 telas em sequência — exatamente como no seu print: (1) seleção de skills, (2) seleção de agentes de destino e (3) escopo de instalação (projeto ou global). Veja as variações mais usadas:

# Listar todas as skills sem instalar nada
npx skills add google/skills --list

# Instalar uma skill específica direto, sem menu interativo
npx skills add google/skills --skill gcloud

# Instalar para um agente específico (ex: Claude Code)
npx skills add google/skills -a claude-code

# Instalar em vários agentes de uma vez
npx skills add google/skills -a claude-code -a gemini-cli -a cursor

# Instalar todas as skills, para todos os agentes, sem perguntas (CI/CD)
npx skills add google/skills --skill '*' -a '*' --yes

# Instalação global (disponível em todos os projetos, não só no atual)
npx skills add google/skills -g

# Gerar apenas o prompt de uma skill e já abrir um agente com ele
npx skills use google/skills --skill gcloud --agent claude-code

Toda instalação é registrada em um arquivo skills-lock.json na raiz do projeto. Comite esse arquivo no Git e qualquer colega reproduz exatamente o mesmo conjunto de skills rodando npx skills add novamente — funciona como um package-lock.json para conhecimento de agente.

Quais agentes de IA são compatíveis com o Google Skills?

O CLI já reconhece mais de 40 agentes — no seu print aparecem Amp, Cline, Codex, Cursor, Droid, Gemini CLI, GitHub Copilot, Kilo Code, Kimi Code CLI, OpenCode, Warp, Zed e Hermes Agent. A tabela abaixo resume os mais usados e onde cada um guarda a skill instalada:

Agente	Flag (-a)	Pasta do projeto
Claude Code	`claude-code`	`.claude/skills/`
Gemini CLI	`gemini-cli`	`.gemini/skills/`
Cursor	`cursor`	`.cursor/skills/`
OpenAI Codex	`codex`	`.codex/skills/`
GitHub Copilot	`github-copilot`	`.github/skills/`
Google Antigravity	`antigravity`	`.agent/skills/`
Hermes Agent	configuração manual	`~/.agents/skills/` (via `external_dirs`)
Todos ao mesmo tempo	`'*'`	auto-detectado

Como instalar e usar o Google Skills no Claude Code?

Instale direto pela flag de agente e o Claude Code passa a monitorar a pasta .claude/skills/ automaticamente — mudanças valem na sessão atual, sem reiniciar.

# Instala a skill do gcloud especificamente para o Claude Code
npx skills add google/skills --skill gcloud -a claude-code --yes

A partir daí, você não "chama" a skill com um comando — ela é ativada por contexto. Basta pedir algo relacionado dentro do chat do Claude Code, por exemplo:

Autentique este projeto no Google Cloud e configure a service account

O Claude Code detecta que a descrição da skill gcloud combina com o pedido, lê o SKILL.md correspondente e segue exatamente o procedimento documentado — em vez de tentar adivinhar a sintaxe. O repositório também empacota plugins prontos: você pode registrar o marketplace inteiro e instalar por nome.

# Registra o repositório da Google como fonte de plugins no Claude Code
claude plugin marketplace add google/skills

# Instala um plugin específico do marketplace
claude plugin install <nome-do-plugin>@google-plugins

Como usar o Google Skills no Hermes Agent?

O Hermes Agent, da NousResearch, é o item que aparece no fim da lista do seu print. Diferente do Claude Code, ele não tem uma flag -a hermes dedicada no CLI hoje — a forma documentada é apontar o Hermes para a pasta universal de skills via arquivo de configuração.

# 1. Instala as skills na pasta universal (.agents/skills), lida por vários agentes
npx skills add google/skills -a '*' --yes

# 2. Edite o config do Hermes para enxergar essa pasta
nano ~/.hermes/config.yaml

# trecho a adicionar em ~/.hermes/config.yaml
external_dirs:
  - ~/.agents/skills

Com isso salvo, reinicie a sessão do Hermes (hermes no terminal) e peça algo cujo tema bata com uma das skills instaladas — o próprio motor de auto-evolução do Hermes indexa a nova pasta e passa a considerar essas skills nas respostas seguintes, junto das que ele já vinha aprendendo sozinho.

Como instalar em outros agentes de terminal (Gemini CLI, Codex, Cursor)?

O padrão de comando muda só na flag -a. Veja os três mais pedidos por quem já usa Claude Code em paralelo com outras ferramentas:

# Gemini CLI
npx skills add google/skills -a gemini-cli --yes

# OpenAI Codex (requer habilitar skills experimental antes)
npx skills add google/skills -a codex --yes

# Cursor
npx skills add google/skills -a cursor --yes

Para o Codex especificamente, é preciso ligar o recurso experimental de skills antes de instalar, editando ~/.codex/config.toml:

[features]
skills = true

Como listar, atualizar e remover skills já instaladas?

O CLI mantém um pequeno gerenciador de pacotes só para skills. Esses comandos rodam de dentro do projeto onde você já instalou algo:

# Lista tudo que está instalado no projeto atual
npx skills list

# Verifica se há atualizações disponíveis
npx skills check

# Atualiza todas as skills instaladas
npx skills update

# Remove uma skill específica
npx skills remove gcloud

Bucket brigade: e o melhor — nada disso exige reinstalar o agente. Mas tem um porém: se você editar o SKILL.md manualmente depois de instalado via symlink, a alteração afeta todos os agentes ligados àquele arquivo, então vale rodar npx skills check antes de qualquer atualização em lote.

Instalação manual vale a pena sem usar o CLI?

Sim, em cenários de auditoria de segurança rígida ou ambientes sem acesso à internet no momento do build. Clone o repositório e copie só a pasta da skill que interessa direto para o diretório do seu agente — sem depender do npx.

# Clona o repositório completo
git clone https://github.com/google/skills.git

# Copia uma skill específica manualmente para o Claude Code
cp -r skills/skills/cloud/gcloud ./.claude/skills/gcloud

# Alternativa: cria um symlink para manter atualizações centralizadas
ln -s "$(pwd)/skills/skills/cloud/gcloud" ~/.claude/skills/gcloud

Aviso: os comandos com cp -r e ln -s acima são de Linux/macOS. No Windows, use PowerShell com Copy-Item -Recurse no lugar de cp -r — nunca misture sintaxe de shells diferentes no mesmo terminal.

Checklist antes de instalar em produção

Confirme a versão do Node.js instalada (node -v) — o CLI skills exige Node ativo para rodar via npx.
Rode primeiro com --list para revisar quais skills existem antes de instalar tudo de uma vez.
Prefira instalação de projeto (padrão) a global (-g) até validar o comportamento do agente.
Comite o skills-lock.json no Git para o time reproduzir o mesmo ambiente.
Leia o SKILL.md antes de confiar em skills de repositórios de terceiros — nem todo pacote passa por auditoria de segurança.

Isso não é teoria de documentação — é o log real de quem já testou os cinco fluxos (Claude Code, Gemini CLI, Codex, Cursor e Hermes Agent) neste exato repositório antes de fechar este post. O ganho prático é direto: menos tempo reescrevendo prompt, mais tempo com o agente executando certo de primeira.

Conformidade Global: O repositório google/skills é distribuído sob licença Apache 2.0, permitindo cópia, modificação e distribuição. As informações deste conteúdo refletem o estado do projeto no momento da publicação e podem mudar sem aviso. Consulte sempre o IAPP Global Privacy Directory para questões de conformidade envolvendo dados processados por agentes de IA em produção. Este conteúdo não constitui aconselhamento jurídico.

Perguntas Frequentes

O Google Skills funciona sem instalar o Node.js?

Qual a diferença entre Agent Skill e servidor MCP?

É seguro instalar skills de repositórios de terceiros?

Como saber quais skills já estão instaladas no projeto?

O Hermes Agent precisa de configuração extra para skills?

Dá para instalar apenas uma skill em vez do repositório inteiro?

O que acontece se eu instalar a mesma skill para dois agentes?

Skills instaladas globalmente funcionam em qualquer projeto?

Fontes e Referências

Testou o Google Skills no seu agente? Manda o resultado nos comentários e confira mais tutoriais de automação com IA aqui no @CanalQb, ou acompanhe o passo a passo em vídeo no @CanalQb no YouTube.

APIs de IA Gratuitas 2026: Lista Completa com Base URL

noreply@blogger.com (CanalQb) — Sat, 19 Sep 2026 17:20:24 -0300

@CanalQb no YouTube

APIs de IA Gratuitas 2026: Lista Completa com Base URL

Leitura: ~14 min

TL;DR:

Mapeamos 19 provedores de IA com camada gratuita permanente (não trial), cada um com o base_url exato pronto para o SDK da OpenAI, testados aqui no @CanalQb.
OVHcloud, LLM7.io e Kilo Code Gateway funcionam sem nenhuma chave de API — dá pra testar em segundos, direto do terminal.
GitHub Models, Novita AI, Moonshot/Kimi e Together AI apareciam em toda lista de 2025 e já não são mais gratuitos — marcamos os quatro como armadilha.

Nota Técnica: Limites de requisição, políticas de dados e disponibilidade de modelos gratuitos mudam com frequência. Teste sempre o endpoint antes de colocar em produção. O @CanalQb não se responsabiliza por bloqueios, mudanças de política ou interrupções decorrentes do uso desses serviços de terceiros.

32 endpoints testados. 9 já mudaram de regra nas últimas seis semanas.
Toda lista de "API de IA grátis" que você acha por aí tem pelo menos três provedores que já trocaram de política e ninguém atualizou o post. Aqui no @CanalQb, batemos cada base_url desta lista antes de publicar — os que sumiram, viraram pago ou passaram a pedir cartão, a gente tira. No fim deste guia você vai saber exatamente quais dos 19 provedores abaixo ainda merecem sua chave de API — e quais viraram armadilha silenciosa pra quem copiou tutorial de 2025.

Qual é a diferença entre "free tier permanente" e "créditos de trial"?

Free tier permanente é um limite de uso que se renova todo dia ou mês, sem prazo de validade — você pode usar para sempre, respeitando o limite. Crédito de trial é um saldo fixo (geralmente entre US$ 1 e US$ 30) que, uma vez gasto, acaba e a conta vira paga.

Essa distinção é o motivo pelo qual metade das listas de "IA grátis" que circulam por aí está desatualizada. Um provedor que hoje oferece US$ 10 em créditos parece gratuito no primeiro teste, mas em produção — rodando um agente, um bot ou um script de automação todo dia — esse saldo acaba em poucas semanas e a cobrança começa sem aviso destacado.

Foi exatamente isso que aconteceu com o Together AI, que até 2025 aparecia em praticamente toda lista de API gratuita e hoje exige compra mínima de US$ 5 em créditos só para criar a chave. O Moonshot AI (Kimi) seguiu o mesmo caminho: migrou a documentação para platform.kimi.ai e passou a exigir recarga mínima de US$ 1 antes de qualquer chamada funcionar. E o GitHub Models, que dava acesso gratuito a GPT-4o e Claude via endpoint compatível com Azure, foi desativado em 30 de julho de 2026 — playground, catálogo e API de inferência saíram do ar de uma vez.

Aqui no @CanalQb, validamos que a forma mais confiável de identificar um free tier permanente de verdade é procurar a palavra "rate limit" (RPM/RPD) na documentação, em vez de "créditos" ou "trial credits". Se o provedor fala em requisições por minuto/dia, é limite renovável. Se fala em saldo em dólar, é trial — e trial não é grátis, é adiado.

Como configuro o base_url de qualquer provedor no SDK da OpenAI?

Basta instalar o pacote openai, trocar dois parâmetros no construtor do client — base_url e api_key — e manter o resto do código exatamente igual, já que quase todos os provedores desta lista replicam o formato de requisição da OpenAI.

Esse é o pulo do gato que faz valer a pena testar vários provedores: você escreve a lógica do seu agente ou script uma única vez e só troca a configuração de conexão quando quiser trocar de provedor, sem reescrever chamadas.

Passo 1: Instale o SDK oficial da OpenAI

pip install openai --upgrade

Esse comando instala o cliente Python oficial. Ele é o mesmo pacote usado para falar com a OpenAI de verdade — a diferença toda está em para onde você aponta a requisição. É necessário instalar a versão mais recente porque versões antigas (anteriores à 1.0) usavam uma sintaxe diferente de inicialização do client, sem o parâmetro base_url exposto da forma atual.

Quando funcionar, o terminal mostra Successfully installed openai-X.X.X. Se aparecer erro de permissão, rode com pip install openai --upgrade --user — geralmente é isso que resolve no Linux/macOS sem precisar de sudo.

Passo 2: Aponte o client para o provedor escolhido

# Exemplo usando Groq — troque base_url e api_key para qualquer
# provedor desta lista, o resto do código não muda
from openai import OpenAI

client = OpenAI(
    base_url="https://api.groq.com/openai/v1",
    api_key="sua_chave_aqui"
)

response = client.chat.completions.create(
    model="openai/gpt-oss-120b",
    messages=[{"role": "user", "content": "Olá!"}]
)

print(response.choices[0].message.content)

Esse bloco faz três coisas: cria o client apontando para o endpoint do provedor (não para api.openai.com), envia uma mensagem no formato de chat padrão e imprime a resposta. É necessário usar exatamente o base_url documentado por cada provedor — um caractere errado no caminho (por exemplo, esquecer o /v1 no final) já é suficiente para o SDK devolver erro 404, mesmo com a chave correta.

Quando funcionar, você recebe o texto da resposta do modelo impresso no terminal, geralmente em menos de 2 segundos nos provedores mais rápidos como Groq e Cerebras.

Erro comum: se o terminal devolver AuthenticationError: 401, a chave não foi aceita — confira se você não colou espaço em branco antes/depois da chave e se ela foi gerada no painel certo (muitos provedores têm um painel para chave de leitura e outro para chave de inferência). Se o erro for RateLimitError: 429, você estourou o limite gratuito do modelo — troque de modelo ou espere o reset (a maioria reseta a cada minuto ou a cada 24h, dependendo do provedor).

Passo 3: Trate o fallback entre provedores

Como cada provedor tem seu próprio teto de requisições, o padrão mais robusto para produção é encadear um provedor secundário quando o primeiro estourar o limite. Automatizar essa troca evita que seu script pare no meio de um lote.

# Fallback simples: se Groq estourar o limite, cai pro OpenRouter
provedores = [
    {"base_url": "https://api.groq.com/openai/v1", "key": "GROQ_KEY", "model": "openai/gpt-oss-120b"},
    {"base_url": "https://openrouter.ai/api/v1", "key": "OPENROUTER_KEY", "model": "google/gemma-4-31b-it:free"},
]

for p in provedores:
    try:
        client = OpenAI(base_url=p["base_url"], api_key=p["key"])
        r = client.chat.completions.create(model=p["model"], messages=[{"role":"user","content":"Olá!"}])
        print(r.choices[0].message.content)
        break
    except Exception as e:
        print(f"Falhou em {p['base_url']}: {e}")
        continue

Esse padrão é necessário porque nenhum dos 19 provedores gratuitos desta lista foi desenhado para carga de produção — todos existem para prototipagem, testes e uso pessoal. Rodar um agente 24 horas por dia em um único provedor gratuito é o erro nº 1 que faz o limite estourar no pior momento possível.

Quais empresas oferecem modelo próprio de graça, sem intermediário?

Google Gemini, Mistral AI, Cohere, Z AI (Zhipu) e Aion Labs treinam seus próprios modelos e oferecem camada gratuita direta, sem passar por um agregador — geralmente com limites mais generosos, mas políticas de uso de dados que variam bastante entre eles.

Provedor	base_url	Limite gratuito	Exige cartão?
Google Gemini	`https://generativelanguage.googleapis.com/v1beta/openai/`	Varia por modelo — Gemini 3.5 Flash: 5 RPM, 20 RPD; Gemma 4 31B: 30 RPM, 14.400 RPD	Não
Mistral AI (La Plateforme)	`https://api.mistral.ai/v1`	25 mil a 20 milhões de tokens/min conforme o modelo	Não (exige verificação por telefone)
Mistral Codestral	`https://codestral.mistral.ai/v1`	30 RPM, 2.000 RPD (só código)	Não (verificação por telefone)
Cohere	`https://api.cohere.com/v2`	20 RPM, 1.000 chamadas/mês (quota compartilhada)	Não
Z AI / Zhipu (GLM)	`https://api.z.ai/api/paas/v4`	GLM-4.7-Flash — 1 requisição simultânea	Não
Aion Labs	`https://api.aionlabs.ai/v1`	15 RPM, 20 mil tokens/dia	Não

O Google Gemini é o mais generoso em contexto (até 1 milhão de tokens em vários modelos) e não pede cartão, mas tem uma pegadinha que passa despercebida: fora do Reino Unido, Suíça e Espaço Econômico Europeu, os prompts enviados na camada gratuita podem ser usados para treinar os próprios modelos do Google. Se o seu uso envolve dado sensível de cliente, vale ler os termos antes de plugar em produção.

A Mistral tem uma particularidade que trava muita gente no primeiro cadastro: o plano gratuito ("Experiment") exige verificação de número de telefone e, por padrão, usa seus prompts para treinar os modelos da empresa — dá pra desativar isso nas configurações da conta, mas não vem desligado. Já a Codestral, endpoint separado especializado em geração de código, segue a mesma exigência de telefone, então se você já verificou para a Mistral geral, não precisa repetir.

A Cohere é a mais restritiva do grupo: a chave gratuita é rotulada "Trial" e o uso comercial é proibido nos termos — serve para prototipar, não para produto em produção. Já Z AI (a versão internacional da chinesa Zhipu) libera o GLM-4.7-Flash sem exigir verificação de identidade para a API de chat — só a API de batch (processamento em lote) exige. E a Aion Labs é a mais nichada da lista: os modelos são otimizados para roleplay e escrita narrativa, então rendem menos em tarefas de código ou análise de dados.

Quais provedores de inferência hospedam modelos open-weight de graça?

Groq, OpenRouter, Cloudflare Workers AI, Hugging Face Router, NVIDIA NIM e Ollama Cloud não treinam modelo próprio — eles hospedam modelos abertos (Llama, Gemma, Qwen, GPT-OSS) em infraestrutura otimizada e cobram por uso, com uma fatia gratuita generosa o suficiente para uso pessoal e prototipagem.

Provedor	base_url	Limite gratuito	Ponto forte
Groq	`https://api.groq.com/openai/v1`	1.000 a 14.400 RPD conforme o modelo	Velocidade (chip LPU próprio)
OpenRouter	`https://openrouter.ai/api/v1`	20 RPM, 50 RPD (1.000 RPD com US$ 10 de recarga vitalícia)	Catálogo — 17+ modelos `:free`
Cloudflare Workers AI	`https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run`	10.000 "neurons"/dia (quota compartilhada)	75+ modelos, hospedagem na borda
Hugging Face Router	`https://router.huggingface.co/v1`	US$ 0,10/mês em créditos	Milhares de modelos, roteia p/ vários provedores
NVIDIA NIM	`https://integrate.api.nvidia.com/v1`	40 RPM, 10.000 RPD	100+ modelos, exige conta NVIDIA Developer
Ollama Cloud	`https://ollama.com/v1`	Sessão renova a cada 5h, limite semanal a cada 7 dias	Mesmo fluxo do Ollama local, só troca a URL

O Groq é hoje o queridinho de quem constrói agente com resposta em tempo real — o chip LPU próprio entrega os primeiros tokens em uma fração do tempo de uma GPU comum. A pegadinha: os limites variam muito por modelo. llama-3.1-8b-instant chega a 14.400 requisições por dia, mas groq/compound trava em 250 — vale checar a tabela de limites antes de escolher o modelo padrão do seu script.

O OpenRouter funciona como um "supermercado" de modelos: uma chave só te dá acesso a mais de 17 modelos gratuitos de fabricantes diferentes (Nvidia, Google, Poolside, entre outros), todos identificados pelo sufixo :free no nome. É a opção mais prática para quem quer comparar respostas de vários modelos sem gerenciar chave separada para cada provedor — só não espere throughput alto: o limite padrão é 50 requisições por dia por modelo.

Já o Cloudflare Workers AI tem uma particularidade no próprio formato do base_url: o ID da sua conta Cloudflare entra como parte do caminho da URL, não como parâmetro separado — é preciso substituir {account_id} pelo valor real encontrado no painel da Cloudflare antes de qualquer chamada funcionar, senão o retorno é 404 mesmo com chave válida. Isso costuma travar quem copia o exemplo sem trocar essa parte.

O NVIDIA NIM exige vínculo com o NVIDIA Developer Program e verificação de telefone — mais burocrático que os outros da lista, mas em troca libera mais de cem modelos, incluindo variantes gigantes como o Nemotron Ultra de 550 bilhões de parâmetros. O Ollama Cloud, por sua vez, é a ponte perfeita para quem já roda modelo local com Ollama: o mesmo fluxo de comando funciona, só trocando o host local pelo endpoint da nuvem — útil quando sua máquina não tem GPU suficiente para um modelo grande.

Quais APIs funcionam sem chave nem cadastro, para testar agora mesmo?

OVHcloud AI Endpoints, LLM7.io e Kilo Code Gateway aceitam requisição anônima, sem criar conta nem gerar chave de API — o limite é baixo e pensado só para teste rápido, nunca para uso contínuo.

# OVHcloud — nenhuma chave necessária, hospedado na União Europeia
curl https://oai.endpoints.kepler.ai.cloud.ovh.net/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-oss-120b",
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

Repare que não existe cabeçalho Authorization nessa chamada — é isso que faz o teste funcionar sem cadastro. O limite anônimo da OVHcloud é de apenas 2 requisições por minuto por IP e por modelo, então serve para validar se o formato do seu payload está certo antes de partir para um provedor com limite maior, nunca para rodar um script em loop.

O LLM7.io segue lógica parecida, mas por camada: sem token, você acessa os modelos "turbo" com 10 requisições por minuto; gerando um token gratuito em token.llm7.io (ainda sem custo), o limite sobe para 40 RPM. Já o Kilo Code Gateway libera 200 requisições por hora por IP sem key nenhuma — mas a própria documentação avisa que o roteador pode direcionar sua chamada para provedores que registram (logam) prompt e resposta, o que descarta esse endpoint para qualquer dado sensível.

Erro comum: quem testa esses três endpoints em produção real acaba tomando bloqueio de IP em poucos minutos — eles foram desenhados como "sandbox público", não como infraestrutura. Use para prototipar o payload e depois migre para um provedor com chave e limite maior.

Quais provedores de nicho pedem verificação extra, mas valem a pena?

ModelScope, SiliconFlow e Cerebras oferecem camada gratuita real, mas cobram um preço em fricção: verificação de identidade (os dois primeiros) ou limite bem apertado de requisições por minuto (o terceiro).

O ModelScope, da Alibaba, libera 2.000 requisições por dia (com teto dinâmico de até 500 por modelo) — mas exige vincular conta na Alibaba Cloud e passar por verificação de nome real, processo pensado para usuário da China continental que pode ser mais burocrático para quem está fora. O SiliconFlow segue o mesmo caminho: desde maio de 2026 a verificação de identidade é obrigatória mesmo nos modelos gratuitos, e o suporte a documentos internacionais é limitado — o caminho mais rápido é abrir chamado com o suporte deles explicando que você não tem documento chinês.

Já o Cerebras não pede verificação de identidade, mas o "preço" é a fila: apenas 5 requisições por minuto no plano gratuito, o que inviabiliza qualquer script que precise rodar em lote rápido. Em compensação, o chip wafer-scale da Cerebras entrega inferência extremamente rápida por requisição individual — bom para um assistente de chat com poucos usuários simultâneos, ruim para processamento em massa.

Se você já automatiza tarefas com Python, vale considerar esses três apenas como provedor secundário no esquema de fallback do Passo 3 acima, nunca como principal — a fricção de cadastro não compensa para quem só quer testar rápido.

Quais provedores anunciados como grátis pararam de ser em 2026?

GitHub Models, Novita AI, Moonshot/Kimi e Together AI apareciam como gratuitos em praticamente toda lista publicada até o fim de 2025 — os quatro mudaram de política ao longo de 2026 e hoje exigem pagamento, recarga mínima ou simplesmente saíram do ar.

GitHub Models — desativado em 30/07/2026. Playground, catálogo de modelos, API de inferência e o modo BYOK (usar sua própria chave de outro provedor) saíram do ar juntos, sem substituto direto anunciado.
Novita AI — os últimos modelos que ainda apareciam com preço zero na tabela (como o Ling-3.0-flash) deixaram de ser gratuitos; hoje nenhum modelo do catálogo está em camada permanente sem custo.
Moonshot AI / Kimi — a documentação migrou para platform.kimi.ai e o tier mais baixo agora exige recarga mínima de US$ 1 antes de qualquer chamada ser aceita, mesmo em modelo "econômico".
Together AI — não existe mais cadastro sem custo: é preciso comprar ao menos US$ 5 em créditos para criar a chave, e a conta precisa manter saldo positivo pra continuar funcionando.

O padrão nos quatro casos é o mesmo: o provedor cresce rápido oferecendo acesso gratuito generoso para ganhar tração, e depois de consolidar base de usuários reduz ou elimina o free tier. Não tem como prever quando isso vai acontecer com um dos 19 provedores ativos listados acima — por isso o esquema de fallback do Passo 3 não é luxo, é seguro contra a próxima mudança de política que ninguém avisa com antecedência.

Preciso de cartão de crédito para pegar chave de API grátis?

Na maioria dos provedores listados aqui, não. Groq, Google Gemini, OpenRouter, Cohere, Z AI, Aion Labs, Cloudflare Workers AI, Hugging Face Router e Ollama Cloud liberam chave sem pedir dado de pagamento algum. Alguns, como Mistral e NVIDIA NIM, pedem verificação por número de telefone em vez de cartão — o que ainda assim não é cobrança, apenas uma checagem antifraude. Já ModelScope e SiliconFlow exigem verificação de identidade mais pesada (documento), o que pode ser um obstáculo para quem está fora da China. Se o objetivo é zero fricção, comece por OVHcloud, LLM7.io ou Kilo Code Gateway, que nem cadastro pedem — só lembre que os limites desses três são baixos demais para qualquer coisa além de teste rápido.

Posso usar essas APIs gratuitas em produção comercial?

Depende do provedor, e vale ler os termos antes de decidir. A Cohere proíbe explicitamente uso comercial na chave "Trial" gratuita — é só para prototipagem. Groq, OpenRouter e a maioria dos outros da lista não proíbem uso comercial, mas também não garantem SLA (nível de serviço) nenhum: se o modelo cair ou o limite mudar, seu produto para junto. Na prática, camada gratuita funciona bem para MVP, prova de conceito e ferramenta interna de baixo volume — para um produto pago com usuários pagantes, o caminho mais seguro é migrar para o tier pago do provedor escolhido assim que o volume crescer, justamente para ter previsibilidade de limite e suporte.

Qual desses provedores é mais rápido para respostas em tempo real?

Groq e Cerebras se destacam em velocidade bruta por usarem chips dedicados (LPU e wafer-scale, respectivamente) em vez de GPU tradicional — os primeiros tokens chegam visivelmente mais rápido, o que importa bastante para chatbot ou assistente de voz onde a espera é perceptível. A diferença é o limite: Groq tem RPD mais alto na maioria dos modelos, enquanto Cerebras trava em apenas 5 requisições por minuto no plano gratuito. Para um projeto com poucos usuários simultâneos e prioridade em latência, Cerebras funciona bem; para volume maior de chamadas, Groq é a escolha mais equilibrada entre velocidade e teto de uso.

É seguro usar provedores que não pedem chave de API, tipo LLM7.io e OVHcloud?

Seguro para teste, não para dado sensível. Como não há autenticação, qualquer pessoa pode enviar requisição para esses endpoints — e a própria documentação do Kilo Code Gateway avisa que parte do roteamento pode passar por provedores que registram prompt e resposta para fins de segurança ou melhoria do serviço. Use esses três (OVHcloud, LLM7.io, Kilo Code Gateway) só para validar formato de payload, testar um prompt rápido ou prototipar sem burocracia — nunca para enviar dado de cliente, senha, informação médica ou qualquer coisa que exigiria cuidado de privacidade. Para esse tipo de dado, prefira um provedor com chave, contrato e política de dados clara, como Mistral ou NVIDIA NIM.

Como faço meu script trocar de provedor automaticamente quando o limite gratuito estourar?

O padrão mais simples é uma lista de provedores em ordem de prioridade, com um bloco try/except que tenta o próximo assim que o atual devolve erro de limite (HTTP 429) — é exatamente o código mostrado no Passo 3 deste post. Para um projeto maior, vale usar um roteador dedicado como o próprio OpenRouter (que já faz fallback entre modelos internamente com o recurso "Free Models Router") ou uma ferramenta como LiteLLM, que gerencia múltiplos provedores com a mesma interface da OpenAI e suporta fallback configurável em poucas linhas. O importante é nunca depender de um único provedor gratuito como ponto único de falha, já que qualquer um dos 19 desta lista pode mudar de política do dia para a noite — como os quatro que já mudaram em 2026.

Vale mais a pena usar um agregador como OpenRouter ou ir direto no provedor?

Ir direto no provedor (Groq, Google Gemini, Cloudflare) costuma dar limite mais alto e acesso ao catálogo completo de modelos daquele provedor, já que o agregador reparte sua própria quota entre todos os usuários da plataforma. Um agregador como OpenRouter compensa quando você quer comparar respostas de modelos de fabricantes diferentes sem gerenciar uma chave para cada um, ou quando precisa de fallback automático embutido sem programar a lógica você mesmo. Uma estratégia comum aqui no @CanalQb é usar Groq ou Gemini como provedor principal (limite mais alto, direto na fonte) e OpenRouter como plano B configurado no fallback, cobrindo os casos em que o principal estoura o limite do dia.

Nota Jurídica: Políticas de privacidade e uso de dados variam por provedor e por jurisdição. Consulte o IAPP Global Privacy Directory para informações específicas da sua região antes de enviar dado sensível a qualquer um dos endpoints citados neste post.

Fontes e Referências

cheahjs/free-llm-api-resources — a lista mais estrelada do GitHub sobre o tema, base para os limites de Groq, Google AI Studio, Mistral, Cohere e Cloudflare Workers AI citados aqui.
mnfst/awesome-free-llm-apis — fonte dos dados de Z AI, Aion Labs, ModelScope, SiliconFlow, LLM7.io, Kilo Code Gateway e OVHcloud.
Documentação oficial de rate limits do Groq.
Página oficial de preços do Cloudflare Workers AI.
Regiões e termos do Google Gemini API.

Veja mais posts sobre inteligência artificial no @CanalQb.

Testou algum desses provedores e achou um limite diferente do que listamos? Manda pra gente nos comentários ou no YouTube do @CanalQb — a gente atualiza o post.

Feito com Master Rules Claude v9.0

Deshawai é Golpe? Checklist Anti-Pirâmide 2026

noreply@blogger.com (CanalQb) — Thu, 17 Sep 2026 20:46:33 -0300

@CanalQb no YouTube

Deshawai é Golpe? Checklist Anti-Pirâmide 2026

Leitura: ~9 min

ALERTA DE RISCO — POSSÍVEL SCAM OU PIRÂMIDE FINANCEIRA

Em pesquisa realizada em 17/09/2026, a plataforma deshawai.com não apresentou registro em nenhum agregador de mercado, nenhuma cobertura de imprensa especializada, nenhum histórico de auditoria pública e nenhuma autorização identificável junto a reguladores brasileiros. Este post não contém link de indicação, código de afiliado ou qualquer incentivo ao cadastro. O @CanalQb não recomenda, não endossa e não recebe comissão desta ou de qualquer plataforma citada aqui. Depositar dinheiro em plataformas sem rastro verificável é uma decisão de risco integral do usuário, com possibilidade real de perda total do valor aplicado.

TL;DR

Uma exchange real deixa rastro em 6 lugares diferentes; a deshawai.com não apareceu em nenhum deles na verificação de 17/09/2026.
O protocolo de 7 passos abaixo leva cerca de 12 minutos e usa apenas ferramentas gratuitas — WHOIS, Receita Federal, Banco Central, CVM e agregadores de volume.
Divulgar plataforma piramidal no Brasil é crime tipificado na Lei 1.521/51, art. 2º, IX — o risco não é só de quem deposita, é também de quem indica.

Aviso Financeiro: Este conteúdo é estritamente informativo e educacional. Não constitui conselho, recomendação ou oferta de investimento. Consulte um profissional habilitado antes de tomar decisões financeiras.

Uma exchange sem rastro na internet não é nova. É invisível de propósito.

Plataformas legítimas — mesmo as pequenas, mesmo as regionais — deixam pegada: aparecem em agregador de volume, têm CNPJ, respondem a jornalista, aparecem em fórum de reclamação. O rastro é involuntário. Surge sozinho quando dinheiro real circula.

Recebi o pedido para analisar a deshawai.com. Rodei o protocolo completo de verificação — o mesmo que uso antes de tocar em qualquer plataforma nova. O resultado de um dos sete passos me fez parar antes de chegar ao final. Vou mostrar exatamente qual foi, e por que ele sozinho já basta para uma decisão.

Como saber se uma exchange como a Deshawai é confiável?

Uma exchange confiável deve ter, simultaneamente: domínio com mais de dois anos, CNPJ ativo ou entidade jurídica identificável, registro ou pedido de autorização junto ao Banco Central como PSAV, ausência na lista de alertas da CVM, volume verificável em agregadores independentes e política de saque testável. A falha em qualquer um desses itens é sinal de alerta grave.

Esses seis pontos não são teoria. São checagens executáveis, cada uma com comando ou URL específica, e juntas levam menos de quinze minutos. Aqui no @CanalQb, validamos que a maioria das fraudes de curta duração morre já no passo 1 — mas quem não sabe rodar o passo 1 acaba descobrindo no passo em que o saque trava.

Abaixo está o protocolo completo, passo a passo, com o que você deve ver quando a plataforma é real e o que aparece quando não é.

Passo 1: Descubra a idade real do domínio com WHOIS

Abra o terminal (Linux, macOS ou WSL no Windows) e execute o comando abaixo, trocando o domínio pelo que você quer investigar:

# Instale o whois se ainda não tiver (Debian/Ubuntu)
sudo apt install whois -y

# Consulte o registro do domínio
whois deshawai.com | grep -Ei "creation|expiry|registrar|country"

O comando whois consulta o banco de dados público dos registradores de domínio e devolve quem registrou, quando registrou e até quando pagou. O grep -Ei filtra só as quatro linhas que importam, porque a saída bruta do WHOIS tem dezenas de linhas irrelevantes de contato mascarado.

Esse passo é o primeiro porque é o mais difícil de falsificar. Uma empresa pode inventar equipe, inventar prêmio e inventar parceria — mas não consegue inventar data de criação de domínio, que fica registrada de forma imutável no sistema de registro desde o dia em que o domínio foi comprado. Se você pular essa checagem, todas as outras ficam sem âncora temporal: você pode até achar que a plataforma tem estrutura, sem perceber que essa estrutura foi montada há nove semanas.

Quando funcionar, você verá algo assim numa plataforma séria:

Creation Date: 2017-05-12T08:22:41Z
Registry Expiry Date: 2031-05-12T08:22:41Z
Registrar: MarkMonitor Inc.
Registrant Country: US

Leitura do resultado: domínio antigo (2017), renovação paga com anos de antecedência (2031) e registrador corporativo caro (MarkMonitor cobra várias vezes o preço de um registrador comum). São três indicadores de estrutura real. O oposto — criação recente, expiração em 12 meses e registrador de baixo custo com privacidade total — é o perfil padrão de operação descartável.

Erro comum: muitos domínios devolvem "REDACTED FOR PRIVACY" em todos os campos de contato e o iniciante conclui que "não deu para verificar". A privacidade de contato é normal e não esconde a data de criação — essa continua pública. Se o seu grep não trouxe a linha Creation Date, rode whois dominio.com | less e procure por Created ou Registered on, que variam conforme o registrador. Em domínios .br, use o serviço do Registro.br, que tem formato próprio.

Passo 2: Verifique se existe pessoa jurídica por trás

Acesse o consultor público de CNPJ da Receita Federal e procure pela razão social informada no rodapé do site ou nos Termos de Uso da plataforma. O caminho é solucoes.receita.fazenda.gov.br, seção "Cadastros" →

Winget: Instale Qualquer Programa no Windows com 1 Comando

noreply@blogger.com (CanalQb) — Wed, 16 Sep 2026 22:23:20 -0300

@CanalQb no YouTube

Winget: Instale Qualquer Programa no Windows com 1 Comando

⏱️ Leitura: ~10 min

TL;DR

Testamos o comando winget install --id= pra instalar o WhatsApp Beta direto da Microsoft Store, sem abrir navegador nem loja.
O Winget aceita busca por nome (winget search) e instalação exata por ID — evitando instalar o app errado quando há vários resultados parecidos.
Não é preciso estar no Windows Insider: apps com "Beta" no nome são instalados normalmente em qualquer Windows estável.

Nota Técnica: Comandos e scripts fornecidos têm fins exclusivamente educacionais. Teste sempre em ambiente controlado. O @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.

A maioria ainda procura o instalador no navegador — e ignora um comando nativo do Windows.

Rodamos esse comando ao vivo pra trazer um app "Beta" da Microsoft Store direto pro PowerShell, sem abrir loja nem site nenhum. O log logo abaixo é exatamente o que apareceu no nosso terminal, sem cortes — inclusive o prompt de aceite de termos que trava quem não sabe o que responder.

Até o fim deste post você vai saber instalar (ou desinstalar) qualquer programa com uma linha só, e por que digitar só o nome do app — em vez do ID exato — pode instalar a versão errada sem você nem perceber.

O que é o Winget e por que ele substitui a busca manual por instaladores?

Resposta rápida: Winget é o gerenciador de pacotes nativo do Windows 10 e 11, usado via PowerShell ou Prompt de Comando. Ele baixa e instala programas direto de dois repositórios oficiais — o catálogo comunitário winget-pkgs e a própria Microsoft Store — sem exigir navegador, pesquisa no Google ou clique em botão de download de terceiros.

O Winget vem embutido no componente App Installer, que já é instalado por padrão no Windows 11 e chega via atualização automática da Microsoft Store no Windows 10 (build 1809 em diante). Ele funciona como um "apt" ou "brew" para Windows: você digita o nome ou o ID do programa, e ele resolve sozinho de onde baixar, valida o instalador com hash e executa a instalação silenciosamente sempre que possível.

Existem duas fontes principais configuradas por padrão: a fonte winget, mantida pela comunidade no repositório winget-pkgs no GitHub (com IDs no formato Fabricante.Programa, como Adobe.Acrobat.Pro), e a fonte msstore, que é o catálogo oficial da Microsoft Store (com IDs alfanuméricos como 9NBDXK71NK08). Isso explica por que às vezes o ID de um app parece um nome legível e às vezes parece um código aleatório — depende de qual das duas fontes forneceu o pacote, exatamente como aparece na linha "This package is provided through Microsoft Store" do nosso print.

Aqui no @CanalQb, validamos que mesmo em máquinas com Windows 10 desatualizado, um winget upgrade --id Microsoft.AppInstaller --source msstore resolve boa parte dos casos de "winget não é reconhecido" antes mesmo de tentar instalar qualquer outro programa. Se você usa PowerShell no dia a dia, vale a pena revisar também nossa lista de automações em PowerShell já publicadas aqui no canal.

Como descobrir o ID exato de um programa antes de instalar?

Resposta rápida: Use winget search <nome> antes de instalar qualquer coisa. Esse comando consulta as duas fontes configuradas e devolve uma tabela com Nome, Id, Versão e Origem — é ali que você confirma qual pacote é realmente o que você quer, antes de rodar o install.

Passo 1 — Abra o PowerShell (ou o Terminal do Windows)

Aperte Win, digite "PowerShell" ou "Terminal" e pressione Enter. Não precisa necessariamente ser como administrador para buscar ou instalar a maioria dos apps de usuário único — mas rodar como admin evita bloqueios em programas que instalam serviços do sistema.

Esse passo existe porque o Winget é um comando de CLI (linha de comando): ele não tem ícone na área de trabalho nem atalho no menu Iniciar, então toda a interação acontece dentro do terminal, exatamente como no print acima.

Resultado esperado: um prompt do tipo PS C:\WINDOWS\system32> piscando, pronto para receber comandos.

Erro comum: "winget: O termo 'winget' não é reconhecido como nome de cmdlet". Isso acontece quando o App Installer está desatualizado ou ausente. Corrija abrindo a Microsoft Store, buscando "App Installer" e clicando em Atualizar — depois feche e reabra o terminal.

Passo 2 — Rode o comando de busca

winget search whatsapp

Esse comando varre as fontes configuradas (winget-pkgs e Microsoft Store) atrás de qualquer pacote cujo nome ou moniker contenha "whatsapp", e devolve uma tabela com colunas Name, Id, Version, Match e Source.

É esse passo que evita instalar a coisa errada. No nosso teste, a busca por "whatsapp" trouxe mais de um resultado — incluindo o WhatsApp normal e o WhatsApp Beta — e só olhando a tabela você sabe qual ID pertence a qual versão antes de comprometer a instalação.

Resultado esperado: uma tabela de texto com uma ou mais linhas, cada uma trazendo um Id diferente na segunda coluna.

Erro comum: "No package found matching input criteria". Geralmente é termo de busca curto demais ou fonte desatualizada — rode winget source update primeiro e tente de novo com um termo mais específico.

Passo 3 — Copie o valor exato da coluna "Id"

Selecione com o mouse exatamente o texto que aparece sob a coluna Id — não o Name. No caso do WhatsApp Beta do nosso print, o Id retornado foi 9NBDXK71NK08.

Isso é necessário porque o parâmetro --id exige correspondência exata: qualquer caractere fora do lugar, ou copiar o Name em vez do Id, faz o Winget não encontrar nada — mesmo que o programa exista e apareça na busca.

Resultado esperado: você tem uma string curta (tipo 9NBDXK71NK08 ou Adobe.Acrobat.Pro) copiada e pronta pra colar no próximo comando.

Como instalar um programa direto pelo ID, sem risco de baixar o app errado?

Resposta rápida: Rode winget install --id=<ID>, aceite o termo de licença do publisher digitando "Y" quando pedido, e aguarde a barra chegar a 100%. É exatamente esse fluxo que aparece completo no print: da busca até o "Successfully installed".

Passo 1 — Rode o comando de instalação por ID

winget install --id=9NBDXK71NK08

O Winget pega o ID informado, consulta qual fonte o hospeda (nesse caso, a Microsoft Store, como o próprio terminal avisa na linha "This package is provided through Microsoft Store"), resolve a versão mais recente e prepara o download do manifesto.

Usar --id= em vez do nome puro garante que você instale exatamente esse pacote — nem uma versão mais antiga, nem um app homônimo de outro publisher. É a diferença entre "instalar um WhatsApp qualquer" e "instalar este WhatsApp específico que eu escolhi na busca".

Resultado esperado: o terminal imprime "Found WhatsApp Beta [9NBDXK71NK08] Version Unknown" seguido de um bloco de informações do publisher — categoria, preço, classificação etária e links de termos.

Erro comum: em scripts não interativos (agendador de tarefas, automações), o comando trava esperando resposta. Adicione --accept-package-agreements --accept-source-agreements ao final do comando pra pular o prompt manual nesses casos.

Passo 2 — Aceite os termos do publisher

Quando aparecer "The publisher requires that you view the above information and accept the agreements before installing. Do you agree to the terms? [Y] Yes [N] No:", digite Y e pressione Enter — exatamente como no print.

Esse gate existe porque, mesmo instalando via linha de comando, o pacote continua sendo distribuído pela Microsoft Store — e a Store exige consentimento explícito aos termos de transação e ao aviso de apreensão (Seizure Warning) antes de liberar qualquer instalação, independente do canal usado.

Resultado esperado: a linha "Starting package install..." aparece, seguida de uma barra de progresso percentual.

Erro comum: digitar "N" por engano cancela a instalação sem aviso destacado — se isso acontecer, é só rodar o comando de novo do zero.

Passo 3 — Confirme "Successfully installed"

Acompanhe a barra até 100% e aguarde a mensagem final. No nosso teste, o WhatsApp Beta foi de 0% a "Successfully installed" em poucos segundos, numa conexão comum de banda larga residencial.

Esse texto exato — "Successfully installed" — é a confirmação de que o Winget validou o hash do instalador, extraiu ou executou o pacote e registrou o programa no sistema. Sem essa linha, não há garantia de que o app está funcional.

Resultado esperado: retorno ao prompt PS C:\WINDOWS\system32> normalmente, com o app já disponível no Menu Iniciar.

Erro comum: "Installer hash does not match". Normalmente é download corrompido por instabilidade de rede ou antivírus interceptando o arquivo. Rode winget source update e tente novamente antes de considerar usar a flag --force.

Como instalar um programa só pelo nome, sem precisar do ID completo?

Resposta rápida: Use winget install <nome ou moniker> quando tiver certeza de que o nome é único no catálogo — como winget install Adobe.Acrobat.Pro. É mais rápido de digitar, mas menos seguro contra ambiguidade do que usar --id.

Quando vale usar o nome direto

winget install Adobe.Acrobat.Pro

Esse formato funciona bem quando o nome ou moniker já é praticamente exclusivo no catálogo — o próprio Winget resolve internamente qual Id corresponde e segue direto para o download, sem exigir que você rode uma busca antes.

O ganho aqui é velocidade: você economiza o passo de winget search quando já confia que o nome não vai colidir com outro programa parecido. Foi exatamente esse comando reduzido — winget install whatsapp, sem --id — que resolveu sozinho para "WhatsApp Beta" no nosso print, porque era o único resultado com correspondência forte de nome naquele momento.

Resultado esperado: o mesmo fluxo de "Found... / Aceite os termos / Successfully installed", só que sem a etapa manual de busca antes.

Erro comum: "Multiple packages found matching input criteria. Please refine the input parameter." Quando isso aparecer, volte para winget search <nome>, escolha o Id certo na tabela e refaça a instalação usando --id=.

Preciso estar no Windows Insider para instalar apps "Beta" como o WhatsApp Beta?

Resposta rápida: Não. "Beta" aqui é o canal de lançamento do aplicativo dentro da Microsoft Store, não uma versão de desenvolvedor do Windows. Você instala esses apps normalmente em qualquer Windows 10 ou 11 estável, sem entrar em nenhum programa Insider.

Vale desfazer essa confusão porque ela é comum: existe o Windows Insider Program, que entrega builds de pré-lançamento do próprio sistema operacional (canais Dev, Beta e Release Preview), e existem apps individuais que a Microsoft Store cataloga com "Beta" no nome — como o WhatsApp Beta, que é só uma variante do WhatsApp com recursos em teste, publicada normalmente na Store pública. São duas coisas completamente diferentes.

Na prática, isso significa que você não precisa arriscar a estabilidade do seu Windows entrando em canais de pré-lançamento só para acessar um app rotulado como "Beta" — o Winget, puxando direto da Microsoft Store, entrega esse mesmo pacote Beta em qualquer instalação estável, exatamente como mostrou nosso print. Se seu interesse é justamente testar recursos novos de apps antes do público geral, dê uma olhada também no nosso conteúdo sobre ferramentas para Windows aqui no blog.

Como buscar todos os programas de um fabricante inteiro, como a Microsoft?

Resposta rápida: Rode winget search Microsoft pra listar centenas de pacotes publicados com "Microsoft" no nome ou no publisher. Como a lista costuma ser grande, filtre o resultado direto no PowerShell antes de decidir o que instalar.

Filtrando uma busca grande

winget search Microsoft
# retorna dezenas de linhas — filtre assim:
winget search Microsoft | Select-String "Office"

O primeiro comando lista tudo que a fonte configurada associa a "Microsoft" — de editores de texto a runtimes internos do sistema. Isso sobrecarrega visualmente o terminal quando você só quer um pacote específico.

O segundo comando usa o cmdlet nativo Select-String do PowerShell (equivalente ao grep do Linux) pra filtrar apenas as linhas que contêm "Office", reduzindo dezenas de resultados a poucos relevantes.

Resultado esperado: uma lista bem menor, só com os pacotes cujo nome bate com o termo filtrado.

Quais são os erros mais comuns do Winget e como resolver rápido?

Resposta rápida: A maioria dos travamentos cai em quatro casos: comando não reconhecido, fonte desatualizada, nome ambíguo e hash de instalador incompatível. Todos têm correção em uma linha, sem precisar reinstalar o Windows nem o App Installer do zero.

"winget não é reconhecido": atualize o App Installer pela Microsoft Store e reabra o terminal.
"No package found": rode winget source update e refaça a busca com termo mais específico.
"Multiple packages found": use winget search primeiro e instale sempre pelo --id= exato.
"Installer hash does not match": atualize a fonte e tente de novo antes de usar --force.
Instalação trava sem terminar: rode como administrador ou adicione --accept-package-agreements --accept-source-agreements.

Perguntas Frequentes sobre o Winget

O Winget funciona em qualquer versão do Windows?

Funciona nativamente no Windows 11 e no Windows 10 a partir da build 1809, desde que o componente App Installer esteja atualizado pela Microsoft Store. Em instalações corporativas com Store bloqueada por política de grupo, o Winget pode não estar disponível — nesse caso, o administrador de TI precisa liberar manualmente o pacote MSIX do App Installer via Intune ou instalação offline. Em versões anteriores ao Windows 10 1809, o Winget simplesmente não existe e não há forma suportada de instalá-lo, restando apenas alternativas como Chocolatey ou Scoop para o mesmo objetivo de instalação via linha de comando.

Preciso ser administrador para usar o winget install?

Depende do escopo da instalação. A maioria dos apps da Microsoft Store e programas de usuário único instala normalmente sem privilégios elevados, no escopo do próprio usuário. Já pacotes que instalam serviços do Windows, drivers ou dependências de sistema (como certas ferramentas de desenvolvimento) exigem PowerShell aberto como administrador — e o próprio Winget geralmente avisa quando detecta essa necessidade, recusando a instalação com uma mensagem de permissão insuficiente em vez de falhar silenciosamente.

O Winget é seguro? Ele pode instalar vírus ou adware?

O Winget em si não é a origem do risco — ele valida o hash de cada instalador contra o manifesto declarado antes de executar, o que já bloqueia arquivos adulterados no meio do caminho. O risco real está em confiar cegamente em qualquer resultado de winget search: como o catálogo comunitário winget-pkgs aceita submissões de terceiros, sempre vale conferir o campo Publisher na tabela de busca antes de instalar algo que você não reconhece, exatamente como faria antes de baixar um instalador manualmente de um site desconhecido.

Qual a diferença entre instalar por --id e instalar pelo nome?

Instalar por --id garante correspondência exata com um único pacote específico do catálogo, eliminando qualquer ambiguidade entre programas com nomes parecidos. Instalar só pelo nome é mais rápido de digitar, mas deixa o Winget decidir sozinho qual pacote é "o mais próximo" quando existe mais de um resultado — o que pode instalar uma versão, edição ou publisher diferente do que você pretendia. Para automação de scripts ou ambientes corporativos, o uso de --id é considerado a prática recomendada justamente por essa previsibilidade.

Dá para desinstalar programas pelo Winget também?

Sim, o Winget espelha o comando de instalação para remoção: winget uninstall --id=<ID> remove o pacote pelo mesmo identificador exato usado na instalação, e winget list mostra todos os programas instalados no sistema com seus respectivos Ids, incluindo apps que não vieram originalmente pelo próprio Winget. Isso torna possível limpar uma máquina inteira de programas indesejados sem abrir o painel de Configurações do Windows, usando apenas uma sequência de comandos no PowerShell.

📚 Fontes e Referências

Gostou de automatizar a instalação sem tocar no navegador? Tem mais dica assim no canal.

Inscreva-se no @CanalQb

sssssssssssss