================================================================================
                TIKTOK SHOP INFINITY LIVE  —  MANUAL DO USUÁRIO
                                    Versão 1.1.0
================================================================================

   Este conteúdo é protegido por DIREITOS AUTORAIS. A extensão Tiktok Shop
   Infinity Live é um software licenciado por COMPUTADOR (HWID). É proibido
   copiar, revender, redistribuir, modificar ou compartilhar esta extensão,
   seus códigos, manuais ou arquivos sem autorização expressa do autor.
   Cada licença é válida para UM computador e o uso da extensão é pessoal
   e intransferível. A violação destas condições poderá acarretar o bloqueio
   permanente da licença e medidas legais.

================================================================================
1. O QUE É A EXTENSÃO
================================================================================

O Tiktok Shop Infinity Live transforma o seu computador em uma estação de
transmissão para o painel de LIVE do TikTok Shop, sem precisar de webcam ou
microfone físicos. Ela entrega, na transmissão:

  • Câmera virtual  — o vídeo (MP4) da sua biblioteca aparece como se fosse
    a sua webcam;
  • Áudio da LIVE   — narrações (voz) e música de fundo, controlados por você;
  • Automação       — modo infinito, fixação automática de produtos e proteção
    contra violações;
  • Moderação       — bloqueio automático de usuários por palavra-chave;


================================================================================
2. REQUISITOS
================================================================================

  • Google Chrome (versão 116 ou superior);
  • Conta no TikTok Shop com acesso ao painel de transmissão ao vivo
    (dashboard real ou modo prática);
  • Uma licença válida (você a recebe pelo WhatsApp 55 51 98400-6889);
  • Conexão com a internet (para validar a licença);
  • Arquivos de mídia: vídeo MP4 (câmera virtual) e áudios opcionais
    (narrações e/ou músicas).

================================================================================
3. INSTALAÇÃO
================================================================================

Você já baixou e descompactou a extensão. Agora:

  1. Abra o Chrome e digite na barra de endereços:  chrome://extensions
     (ou: Menu ☰ → Extensões → Gerenciar extensões).
  2. No canto superior direito, ative o botão  "Modo do desenvolvedor".
  3. Clique no botão  "Carregar sem compactação"  ("Load unpacked").
  4. Selecione a PASTA da extensão que você descompactou (a pasta que contém
     os arquivos manifest.json, background.js, sidepanel.html, etc.).
  5. A extensão "Tiktok Shop Infinity Live" aparecerá na lista de extensões.

DICA: para facilitar, clique no ícone de "quebra-cabeça" na barra do Chrome e
fixe o ícone da extensão na barra de ferramentas.

Para ATUALIZAR a extensão (quando houver nova versão):
  • feche a extensão antiga e carregue a nova pasta seguindo os passos acima.
  • Se a versão carregada não for a versão obrigatória, a extensão não vai
    funcionar: aparecerá um aviso de atualização com o botão do WhatsApp.

================================================================================
4. ATIVAÇÃO DA LICENÇA (PRIMEIRO USO)
================================================================================

  1. Abra o painel lateral da extensão (clique no ícone da extensão na barra
     do Chrome e selecione o painel).
  2. Na tela "Licença", digite o código que você recebeu
     (formato: TIL-XXXX-XXXX-XXXX-XXXX) e clique em "Ativar licença".
  3. Pronto: a extensão guarda a validade e começa a contar o tempo restante.

REGRAS IMPORTANTES DA LICENÇA:

  • Uma licença é vinculada ao HWID (identificador do computador) no momento
    da ativação. Ela passa a valer APENAS naquele PC;
  • Não é possível ativar a mesma licença em outro computador (o servidor
    recusa: "Licença já ativada em outro computador");
  • Se você formatar o computador ou trocar o navegador, pode ser necessário
    entrar em contato pelo WhatsApp para desvincular e reagrupar a licença;


================================================================================
5. RENOVAÇÃO E VALIDADE
================================================================================

No TOPO da extensão (painel e aba da câmera) existe um CRONÔMETRO REGRESSIVO
 mostrando os DIAS e HORAS restantes de licença.

  • Quando faltar pouco tempo, o cronômetro fica visível para você se planejar;
  • Quando a licença VENCER: uma POPUP cobre a tela inteira da extensão e a
    extensão é bloqueada. O botão "Renovar no WhatsApp" abre a conversa com o
    suporte (55 51 98400-6889) para você renovar;
  • Renovou? Digite a mesma licença (ou a nova) e a extensão volta a funcionar
    imediatamente.

ATUALIZAÇÃO OBRIGATÓRIA:
  • Se a extensão estiver numa versão diferente da obrigatória, aparecerá a
    tela "Atualização obrigatória" com o botão do WhatsApp para você baixar a
    nova versão. A extensão NÃO funciona em versão desatualizada.

================================================================================
6. COMO USAR — PASSO A PASSO
================================================================================

6.1 Preparando o material
  • Aba VÍDEO: clique em "Carregar Vídeo (MP4)" para enviar o vídeo da câmera
    virtual. Você pode enviar vários vídeos (playlist).
  • Aba ÁUDIO: envie NARRAÇÕES (voz — áudio principal da live) e MÚSICAS DE
    FUNDO (tocam por baixo, em volume menor). Ajuste os volumes e o modo
    (Loop na ordem ou Aleatório).

6.2 Iniciando a câmera virtual
  1. Clique em "Iniciar câmera virtual" (aba INÍCIO). Uma nova aba da
     extensão será aberta com o player da câmera;
  2. No player, clique em "1. Iniciar vídeo com som". Esse clique libera o
     áudio (a extensão reproduz o vídeo MUDO e usa narração/música como som);
  3. Agora clique no ÍCONE da extensão na barra do Chrome. Esse segundo clique
     conecta a captura da aba com a página do TikTok;
  4. Na página do TikTok (site, painel web), ao pedir câmera/microfone, a
     extensão já entrega a "Infinite Live Camera" e o "Infinite Live Audio"
     (dispositivos virtuais que existem SÓ dentro do navegador — programas
     externos como Live Studio ou OBS NÃO os enxergam; a automação completa
     funciona transmitindo pelo site).
  Para parar: clique em "Parar" na aba INÍCIO.

6.3 Modo infinito
  Ative em Central → Automação → "Modo infinito". A extensão reinicia a live
  automaticamente quando ela cai/termina (e confirma os diálogos).

6.4 Auto-Pin de produtos
  Fixa automaticamente o primeiro produto listado e pode estender a fixação
  (+60s) quando o botão aparecer.

6.5 Proteção contra violações
  Monitora a página em busca de alertas (violação, infração, conteúdo não
  original, live suspensa, etc.). Ao detectar, ENCERRA a live automaticamente
  para evitar penalidades e desliga o modo infinito.

6.6 Bloqueio automático (moderação)
  Digite palavras-chave (uma por linha). Usuários cujo nome contenha alguma
  palavra são bloqueados automaticamente.

6.7 Comentários automáticos
  Escreva frases (uma por linha) e defina o intervalo mínimo/máximo entre
  comentários. A extensão publica aleatoriamente essas frases no chat.

6.9 Monitor (aba INÍCIO)
  Mostra o tempo de live, número de scans, pins, bloqueios e alertas em tempo
  real, além do espaço usado em disco pela extensão.

6.10 Encerrar a live
  Na aba INÍCIO, logo abaixo do botão "Parar", existe o botão "Encerrar a
  live". Ele clica automaticamente em "Encerrar" no painel do TikTok e confirma
  o diálogo, encerrando a transmissão de forma segura.

6.11 Sino de venda (automatico)
  Igual às lives de sucesso do TikTok Shop: quando o painel detecta uma nova
  venda (pelos cards de metrica), a extensão toca um SININHO no áudio da
  transmissão — automaticamente, sem precisar ativar nada (ja vem ligado).
  Configuração: aba ÁUDIO → card "Sino de venda". La voce pode desligar
  ("Tocar sino a cada venda"), ajustar o volume (0–100) e usar o botão
  "Testar sino" para conferir o som na live (se a aba da live estiver
  fechada, o teste toca local no painel). O som usado é o arquivo
  "sino.mp3" (copia sem espacos do "SOM DE SINO TIKTOK SHOP.mp3") embarcado na extensão.
  Opcional: "Aplausos junto na venda" (desligado por padrao) toca o
  "applause.mp3" em segundo plano ~0,35s depois do sino, fazendo som duplo
  na compra. Usa o mesmo volume do sino.
   "Ouvir o sino neste computador" (monitor local, desligado por padrao)
   toca nas caixas do PC para o operador ouvir. Não vai para a live por esse
   caminho: o som que o espectador ouve sai sempre pelo microfone virtual.
   "Sino aleatório" (desligado por padrao, logo abaixo do "Testar sino"):
   toca o sino sozinho de tempos em tempos, mesmo sem venda, para simular
   movimento na live. Voce define o intervalo mínimo e máximo em segundos
   (de 10 a 120). Só funciona com a live no ar e com o sino ativado; não
   gera aviso no celular nem entra no log de vendas (é só o som).
  Quem transmite pelo Live Studio ou outro programa externo não recebe câmera,
  microfone, sino, overlay nem automação da extensão — esses recursos existem
  só dentro do navegador, transmitindo pelo site do TikTok.

6.12 Encerrar a live automaticamente (contagem regressiva)
  No card "Câmera Virtual" (aba INÍCIO), abaixo do botão "Encerrar a live",
  você pode programar em HORAS e MINUTOS quanto tempo a live deve ficar no ar.
  Ao clicar em "Iniciar contagem", aparece a contagem regressiva; quando chega
  a zero, o botão "Encerrar a live" é acionado automaticamente e a transmissão
  termina. Use "Cancelar" para parar a contagem antes da hora.

  Observações:
    • Rotação de vídeos: a playlist gira sozinha (na ordem ou aleatório,
      conforme "Loop infinito"/"Shuffle" na aba Vídeo). O botão "Pular para o
      próximo" troca o vídeo manualmente.
    • Áudio original do vídeo: se NÃO houver narrações selecionadas em
      "Narrações (voz)", o vídeo roda com o som original dele. Com narração
      ativa, o vídeo fica mudo e a narração/música viram o áudio da live.

================================================================================
6.13 VÍDEO GRAVADO + WEBCAM REAL NA MESMA LIVE (50/50)  [NOVO]
================================================================================

  Esta versão permite misturar, ao vivo, o VÍDEO GRAVADO com a SUA CÂMERA e o
  SEU MICROFONE reais, tudo na mesma transmissão. Fica muito mais realista.

  Onde configurar: aba VÍDEO do painel, no card
  "Webcam + Microfone (ao vivo)".

  Passo a passo:

    1. EM "Fonte da imagem", escolha uma das opções:
         • "Somente vídeo gravado"  → comportamento antigo (só o MP4);
         • "Somente webcam"         → só a câmera real;
         • "Vídeo + Webcam (ambos)" → metade da tela com o vídeo e a outra
           metade com a sua câmera. É o modo pedido pelo cliente.

    2. Ainda na primeira vez, deixe "Câmera física" em "(padrão do sistema)" e
       clique em "Detectar câmeras". O Chrome vai pedir permissão de câmera/
       microfone — clique em PERMITIR. Depois de autorizar, a lista de câmeras
       aparece e você pode escolher a correta.

    3. Ligue o botão "Usar microfone físico" para o áudio da live ser a sua voz
       (o som do vídeo gravado é silenciado enquanto o microfone estiver ligado).
       Ajuste o "Volume do microfone (%)" se quiser.

    4. EM "Como mostrar os dois", escolha:
         • "Metade e metade (50/50)"        → tela dividida;
         • "Vídeo cheio + câmera em janela" → vídeo ocupa tudo e a câmera fica
           numa janelinha (PiP) que você posiciona como quiser.

    5. No modo 50/50 escolha a "Divisão da tela" (lado a lado OU em cima/embaixo)
       e se a câmera fica na 1ª metade (senão ela vai para a 2ª metade).

     6. No modo janela (PiP) ajuste posição horizontal/vertical, tamanho, formato
        (círculo ou retângulo), quem aparece na janelinha e a OPACIDADE da
        janelinha (100% = sólida; abaixo disso ela fica translúcida sobre o
        vídeo — ver 6.18).

    7. Por fim, clique em "Iniciar câmera virtual" (aba INÍCIO) e, no TikTok,
       escolha "Infinity Live Camera" / "Infinity Live Audio" e inicie a LIVE.

  EDITOR VISUAL (arrastar e soltar):
    Logo abaixo das opções aparece a moldura (retângulo vertical) que representa
    a tela da live. É um pré-visualizador para você enquadrar do jeito que quer:
      • Arraste a CAIXA AZUL (câmera) para movê-la e use a ALÇA BRANCA no canto
        para aumentar/diminuir o tamanho.
      • No modo "Metade e metade (50/50)", arraste a LINHA BRANCA no meio para
        escolher a proporção (ex.: 60% vídeo / 40% câmera).
      • No modo janela (PiP), a caixa azul é a janelinha; arraste e redimensione
        livremente.
    As mudanças são aplicadas NA HORA, sem parar a live.
    Observação: como o vídeo real é montado na aba do TikTok, a moldura é um
    esquema — a posição/tamanho valem em porcentagem, então ficam iguais na live.

  DICAS IMPORTANTES:
    • No modo 50/50, o vídeo e a câmera são recortados para PREENCHER a metade
      (sem faixas pretas). Aproxime o rosto da câmera para ficar bem enquadrado.
    • Enquanto o microfone físico estiver ligado, o áudio é SÓ o microfone
      (com música de fundo/sinos da live, se estiverem ativos).
    • Se você trocar de câmera ou de microfone, pare e inicie a câmera virtual
      de novo para aplicar.
    • É preciso permitir o acesso à câmera/microfone no Chrome. Se negar, a
      webcam não aparece e a live fica só com o vídeo gravado.

================================================================================
6.14 NOTIFICAÇÃO DE VENDAS NO CELULAR (web app)  [NOVO]
================================================================================

  A extensão pode avisar o seu celular sempre que houver uma VENDA na live. O
  aviso chega como uma notificação (mesmo com o app fechado), em Android e em
  iPhone (iOS 16.4 ou superior).

  O "app" do celular é um WEB APP (PWA): abre pelo navegador e é instalado na
  tela inicial ("Adicionar à tela inicial"), ficando com ícone e tela cheia,
  igual a um aplicativo.

  Como configurar no painel:
    1. Aba INÍCIO → card "Notificação de vendas no celular".
    2. Ligue o botão "Ativar notificação no celular".
    3. No campo "Endereço do servidor de avisos (push.php)", cole a URL do
       relay fornecido pelo suporte (ex.: https://sistemas.store/.../push.php).
    4. Clique em "Enviar notificação de teste" para conferir.

  Como instalar no celular:
    • Android (Chrome): abra o link do app → menu ⋮ → "Adicionar à tela
      inicial" → "Instalar". Abra pelo ícone e ative com a MESMA licença do PC.
    • iPhone (Safari): abra o link no Safari → Compartilhar → "Adicionar à Tela
      de Início". Abra PELO ÍCONE criado e ative com a mesma licença.

  Observações:
    • O aviso informa a QUANTIDADE, o VALOR da venda (R$) e a COMISSÃO
      ESTIMADA (percentual configurável no servidor). O valor vem da diferença
      do card "GMV" do painel do TikTok Shop a cada venda. Nome do comprador e
      produto continuam exigindo a API oficial do TikTok Shop.
      O app de avisos mostra o HISTÓRICO das vendas (com valor) e tem o botão
      "Limpar histórico".
    • Se a live vender vários itens de uma vez, o aviso pode vir agrupado
      (ex.: "3 itens vendidos agora!").
    • Trocar de celular exige ativar novamente o app no aparelho novo.
     • A instalação do app/servidor é feita pelo suporte (guia próprio).

================================================================================
6.15 SCREENSAVER ANTI-LOOP (FORMAS OU IMAGEM PNG)  [NOVO]
================================================================================

  Símbolos (ou a sua imagem PNG) quicando pela tela, sem parar. Serve para a
  imagem da live nunca ficar estática — o que ajuda a não ser marcada como
  "live gravada / em loop".

  Onde configurar: aba OVERLAY (📡 Overlay) do painel, na seção "Screensaver".

  Como usar:
     1. Ligue o botão "Ativar screensaver".
     2. Em "Modo", escolha:
          • "Formas geométricas" → símbolos coloridos quicando (forma
            aleatória, retângulo, círculo, triângulo, losango, estrela,
            coração ou cruz);
          • "Imagem PNG" → a SUA imagem quicando estilo DVD. Clique em
            "+ Adicionar imagem PNG", escolha o arquivo e aguarde o aviso
            "Imagem do screensaver adicionada". Para trocar, adicione outra;
            para tirar, clique em "Remover imagem".
     3. Ajuste tamanho (das formas ou da imagem), velocidade, quantidade
        (máximo 3, para não pesar) e opacidade.
     4. As mudanças valem NA HORA, sem parar a live.

  Dica: se o vídeo engasgar, reduza a quantidade e a opacidade primeiro.

================================================================================
6.16 LINHA PERCORRENDO A TELA  [NOVO]
================================================================================

  Uma faixa colorida que varre a tela em loop contínuo (horizontal, vertical
  ou diagonal), com brilho e faíscas opcionais. É outra camada de movimento
  constante contra a detecção de tela estática.

  Onde configurar: aba OVERLAY (📡 Overlay), na seção "Linha percorrendo".

  Como usar:
     1. Ligue o botão "Ativar linha".
     2. Escolha eixo, direção e se quer "Mesclar eixos" (alterna as direções
        sozinha a cada ciclo).
     3. Ajuste cor, espessura, velocidade, quantidade de linhas (máximo 5),
        brilho, faíscas e opacidade.

================================================================================
6.17 ZOOM DINÂMICO  [NOVO]
================================================================================

  Redesenha o próprio vídeo da live por cima da cena com zoom e deriva
  (deslocamento) suaves e contínuos, em transparência. O quadro inteiro
  "respira" o tempo todo, sem cortes.

  Onde configurar: aba OVERLAY (📡 Overlay), na seção "Zoom dinâmico".

  Como usar:
     1. Ligue o botão "Ativar zoom".
     2. Ajuste a intensidade do zoom (%), a deriva horizontal/vertical (%),
        a velocidade do ciclo (segundos), a opacidade (%) e a variação
        (quanto a transparência oscila).
     3. Sugestão inicial: zoom 8%, deriva 5%/4%, opacidade 35%.

================================================================================
6.18 OPACIDADE DA JANELINHA (PiP)  [NOVO]
================================================================================

  No modo "Vídeo cheio + câmera em janela" (ver 6.13), agora dá para deixar a
  janelinha translúcida sobre o vídeo.

  Onde configurar: aba VÍDEO, dentro das opções da janelinha (PiP), no campo
  "Opacidade da janela (%)" (de 10 a 100). 100% = janela sólida; valores
  menores deixam o vídeo de baixo aparecer através dela.

================================================================================
7. SOLUÇÃO DE PROBLEMAS
================================================================================

  "A tela de licença não passa" / "Licença inválida"
    → Confira se digitou o código completo (TIL-XXXX-XXXX-XXXX-XXXX);
    → Confirme que está usando a versão 1.1.0 (chrome://extensions → detalhes);
    → Verifique a internet; se a licença já foi usada em outro PC, contate o
      WhatsApp 55 51 98400-6889.

  "A câmera não aparece na página do TikTok"
    → Siga exatamente as 2 etapas: clique em "1. Iniciar vídeo com som" e
      depois no ícone da extensão na barra do Chrome;
    → Recarregue a página do TikTok após iniciar a câmera.

  "A extensão não funciona depois de recarregar o Chrome"
    → O ícone abre o painel; o player e o painel revalidam a licença sozinhos.

  "Não consigo arrastar a verificação 'não sou robô'"
    → Nesse momento a extensão PAUSA automaticamente toda a automação (nada é
      clicado), para você resolver a verificação sem interferência. Resolvido
      o desafio, a automação volta sozinha.

  "Alterei algo no painel e não valeu"
    → Confira o toggle (botão ON/OFF) na aba Central/Áudio/Vídeo e salve.

  "Cadê meu vídeo/áudio depois de reinstalar?"
    → Os arquivos ficam na própria extensão; ao remover a extensão, o acervo
      é apagado. Adicione os arquivos novamente.

================================================================================
8. AVISO LEGAL
================================================================================

  • Este software é licenciado por computador (HWID) e NÃO é de domínio
    público. Todo o conteúdo deste pacote (código, manual, logotipos) é
    protegido por direitos autorais;
  • É PROIBIDO: copiar, distribuir, revender, alugar, sublicenciar, fazer
    engenharia reversa ou usar em mais de um computador sem autorização;
  • O uso da extensão deve respeitar os Termos de Serviço do TikTok/TikTok
    Shop. O autor não se responsabiliza por bloqueios, penalidades ou
    suspensões aplicadas pelas plataformas;
  • Para renovação, suporte ou novas licenças, chame no WhatsApp:
    55 51 98400-6889  (https://wa.me/5551984006889)

                    © 2026 Tiktok Shop Infinity Live — Todos os direitos
                    reservados. Versão 1.1.0.
================================================================================
9. IA MULTI-PROVIDER (Groq → Gemini → Cerebras → OpenRouter)
================================================================================

  A aba "IA" do painel permite respostas automaticas inteligentes ao chat.

  9.1 COMO CONFIGURAR
    1) Groq: https://console.groq.com/keys → crie a chave → cole no campo Groq.
    2) Gemini: https://aistudio.google.com/app/apikey → crie a chave → cole.
    3) Cerebras: https://cloud.cerebras.ai/ → API keys → cole.
    4) OpenRouter (opcional): https://openrouter.ai/keys → cole.
    5) Clique "Testar conexão" em cada um (🟢 Conectado / 🔴 Key invalida /
       🟠 Limite atingido / 🔴 Erro de conexao).
    6) Ative "Ativar IA" e escolha o Modo: Fixa (sem IA), IA ou Ambos.
    7) Preencha o Contexto do produto (nome, preco, beneficios, regras).

  9.2 FALLBACK
    Ordem padrao: 1.Groq 2.Gemini 3.Cerebras 4.OpenRouter. Altere com ↑↓ ou
    o numero da prioridade. Em 429/quota o provider entra em cooldown de 60s
    (ou Retry-After do servidor) e o proximo assume. Cada pedido percorre a
    lista UMA vez — sem loop. 401 = marca "Key invalida" e pula. 5xx/timeout
    = 1 retry com backoff e depois proximo.

  9.3 RATE LIMIT / ANTI-SPAM / FILA
    Intervalo minimo padrao 8s entre respostas da IA; fila de 1 geracao por
    vez (max 4 enfileiradas, resto descartado sob flood); cache curto de
    mensagens identicas (45s); ignora vazio, emoji isolado, <3 letras,
    repetidas, proprias, links (opcional), mesmo usuario e consecutivas.

  9.4 ONDE FICAM AS CHAVES
    Somente em chrome.storage.local → chave "ai_keys", neste navegador.
    Nunca vao para sistemas.store, banco remoto, logs, console ou analytics.
    Na tela aparecem mascaradas (ex.: gsk_••••••••1234).

  9.5 ESTATISTICAS / TESTE
    Respostas hoje, por provider, fallbacks, erros, ultima resposta e
    provider — tudo local. "Zerar estatisticas" limpa. Sem provider ativo:
    a extensao mostra "IA indisponivel" no log e todo o resto continua.


================================================================================
