# 🤖 Robot Runner

**O Centro de Comando Profissional para Automação Android.**

O Robot Runner é um ecossistema desktop de alto desempenho projetado para preencher a lacuna entre a exploração manual e a automação profissional. Desenvolvido para **Analistas de Qualidade (QA)**, **SDETs** e **Arquitetos de Sistema**.

---
Leia este README em outros idiomas:
- [English](README.md)
- [Español](README.es.md)
---

## 🌟 A Vantagem de QA: Por que o Robot Runner?

Em um fluxo de trabalho tradicional, um engenheiro de QA alterna entre Appium Inspector, terminais para ADB/Logcat, e ferramentas de monitoramento. **O Robot Runner elimina essa troca de contexto.** Ele fornece um ambiente integrado onde diagnósticos e design de automação ocorrem paralelamente.

---

## 🚀 Capacidades Principais

### 🎛️ Centro de Comando de Dispositivos Unificado
*   **Descoberta Inteligente**: Detecção instantânea de dispositivos USB e Wi-Fi.
*   **Liberdade sem Fio**: Pareamento contínuo via TCP/IP e códigos Android 11+.
*   **Alcance Global**: Tunelamento **ngrok** integrado para testes em dispositivos remotos.
*   **Espelhamento de Alta Fidelidade**: Espelhamento de tela de baixíssima latência (Scrcpy).

### 🔍 Inspeção de UI de Precisão e Estratégia de Localizadores
*   **Geração Dinâmica de Localizadores**: Crie instantaneamente XPaths otimizados e `UiSelector`.
*   **Seleção Visual**: Selecione elementos diretamente do espelhamento de tela.
*   **Seletores Inteligentes de IA**: Avalie e extraia automaticamente o localizador mais resiliente usando IA.

### 📊 Diagnósticos em Tempo Real e Monitoramento de Performance
*   **Logcat Inteligente**: Logs do sistema e de aplicativos com filtragem avançada por pacote.
*   **Insights de Performance**: Acompanhe o uso de CPU, RAM e integridade da bateria em tempo real.

### 🧠 Mapeamento e Design Guiados por IA
*   **Mapeamento Autônomo**: Use o Mapper (DFS) para criar um gêmeo digital do seu aplicativo automaticamente.
*   **IA de Prompt para Código**: Traduza linguagem natural ou ações gravadas em scripts BDD (Robot Framework).
*   **Motor Multi-Modelo**: Conecte-se com Gemini, Claude e OpenAI para geração de código.

### ⚡ Execução Profissional
*   **Modos de Execução**: Suporte a arquivos `.robot`, diretórios inteiros e configurações `.args`.
*   **Console ao Vivo**: Assista à execução do stdout nativamente dentro do aplicativo.
*   **Perfis de Configuração**: Alterne instantaneamente entre setups de projetos e variáveis de ambiente.

---

## 📚 Documentação Abrangente

Explore nossos guias detalhados para obter o máximo do Robot Runner:

### 📖 Guias Principais
- [Instalação e Configuração](docs/pt-BR/SETUP.md)
- [Guia do Usuário](docs/pt-BR/USAGE.md)
- [Solução de Problemas](docs/pt-BR/TROUBLESHOOTING.md)

### 🏠 Módulos Principais
- [Início (Dashboard)](docs/pt-BR/HomeSubTab.md)
- [Conectar (Ngrok/Wi-Fi)](docs/pt-BR/ConnectSubTab.md)
- [Inspetor (UI & Gravação)](docs/pt-BR/InspectorSubTab.md)
- [Testes (Motor de Execução)](docs/pt-BR/TestsSubTab.md)
- [Histórico (Logs & Métricas)](docs/pt-BR/HistorySubTab.md)
- [Gerador de IA](docs/pt-BR/AIGeneratorSubTab.md)
- [Mapeador (Exploração Autônoma)](docs/pt-BR/MapperSubTab.md)

### 🧰 Módulos Toolbox
- [Apps (Gerenciador de Pacotes)](docs/pt-BR/AppsSubTab.md)
- [Checkup (Diagnósticos)](docs/pt-BR/CheckupSubTab.md)
- [Comandos (ADB Customizado)](docs/pt-BR/CommandsSubTab.md)
- [Dmesg (Logs de Kernel)](docs/pt-BR/DmesgSubTab.md)
- [Hardware (CPU/RAM Specs)](docs/pt-BR/HardwareSubTab.md)
- [Logcat (Logs em Tempo Real)](docs/pt-BR/LogcatSubTab.md)
- [Performance (Gráficos ao Vivo)](docs/pt-BR/PerformanceSubTab.md)
- [Cronômetro (Benchmarking)](docs/pt-BR/StopwatchSubTab.md)

### ⚙️ Sistema
- [Console de Execução](docs/pt-BR/RunConsole.md)
- [Página de Configurações](docs/pt-BR/SettingsPage.md)
- [Página Sobre](docs/pt-BR/AboutPage.md)

---
## 📄 Licença
Licenciado sob **Licença Não-Comercial / Sem-Revenda**.