#Face Blocker

Extensão Chrome que detecta e oculta automaticamente tweets contendo rostos específicos cadastrados pelo usuário.

🔒 100% local - Processamento com face-api.js (TensorFlow.js), sem envio de dados externos.

---

🚀 Recursos

• ✅ Detecção facial em tempo real
• ✅ Bloqueio automático de tweets
• ✅ Múltiplas fotos por pessoa (até 50)
• ✅ Interface moderna e intuitiva
• ✅ Menu de contexto (clique direito em imagens)
• ✅ Privacidade total (processamento local)
• ✅ Configurações de sensibilidade personalizáveis

---

📦 Instalação

1. Abra chrome://extensions/ no Chrome
2. Ative Modo do desenvolvedor (canto superior direito)
3. Clique em Carregar sem compactação
4. Selecione a pasta do projeto
5. Pronto! ✅

Nota: Todas as dependências já estão incluídas no pacote.

---

🎯 Como Usar

Adicionar Rosto (Método 1: Popup)

1. Clique no ícone da extensão
2. Digite o nome da pessoa
3. Selecione uma ou mais fotos (até 50)
4. Clique em Adicionar à Lista
5. Recarregue o Twitter

Adicionar Rosto (Método 2: Menu de Contexto)

1. No Twitter, clique direito em uma imagem
2. Selecione "Adicionar à lista de bloqueio"
3. Escolha uma pessoa existente ou crie nova
4. Pronto!

Remover Rosto

1. Abra o popup
2. Clique em Remover ao lado do nome

Ajustar Sensibilidade

1. Abra as Configurações de Sensibilidade
2. Ajuste os sliders conforme necessário
3. Restaurar Padrões se necessário

---

📁 Estrutura

Face Blocker/
├── manifest.json           # Configuração da extensão
├── background.js           # Service worker (context menu)
├── content.js              # Detecção e bloqueio no Twitter
├── popup.html/js           # Interface do usuário
├── face-api.min.js         # Biblioteca face-api.js
└── models/                 # Modelos de IA pré-treinados
    ├── tiny_face_detector_model-*
    ├── face_landmark_68_model-*
    └── face_recognition_model-*

---

🔧 Tecnologia

• Manifest V3 - Chrome Extensions
• face-api.js - Reconhecimento facial
• TensorFlow.js - Machine Learning
• Chrome Storage API - Armazenamento local
• MutationObserver - Detecção de novos tweets

---

🛡️ Privacidade

✅ Zero envio de dados externos
✅ Imagens não são armazenadas
✅ Apenas descritores matemáticos (vetores 128D)
✅ Processamento 100% no navegador
✅ Sem login ou rastreamento

---

⚙️ Como Funciona

Adição:

1. Usuário faz upload de foto(s)
2. face-api.js detecta o rosto
3. Extrai descriptor (vetor 128D)
4. Salva no chrome.storage.local

Bloqueio:

1. MutationObserver detecta nova imagem
2. face-api.js analisa a imagem
3. Compara com rostos bloqueados (distância euclidiana)
4. Se match (< 0.5), remove o tweet

Otimizações:

• Redimensiona imagens para 256px
• Marca imagens processadas
• Processamento assíncrono
• Cache de resultados

---

🐛 Solução de Problemas

"Erro ao carregar modelos"

• Verifique se a pasta models/ contém todos os arquivos
• Recarregue a extensão em chrome://extensions/

"Nenhum rosto detectado"

• Use fotos frontais bem iluminadas
• Evite fotos muito pequenas
• Tente múltiplas fotos da pessoa

"Não está bloqueando"

• Recarregue o Twitter (F5)
• Abra DevTools (F12) e veja console
• Verifique mensagens [Face Blocker]

---

📝 Parâmetros

• Threshold: 0.5 (distância euclidiana)
• Detector: TinyFaceDetector (rápido)
• Recognition: FaceRecognitionNet (128D)
• Tamanho: 256px max (otimização)

---

⚠️ Uso educacional. Respeite a privacidade.