CONTENT_GUARDIAN by SuraKlaus

CONTENT GUARDIAN - Descrição Completa para AMO

📋 Informações Básicas

Nome da Extensão: CONTENT GUARDIAN
Versão: 0.1.0
Idiomas: Português (Brasil), Português (Portugal), Inglês
Compatibilidade: Firefox 60+



🎯 Resumo Breve (Descrição Curta)

Bloqueador inteligente de conteúdo web que intercepta buscas com palavras-chave específicas e bloqueia URLs. Com sistema de whitelist, proteção por senha e ferramentas de diagnóstico, oferece controle granular sobre o acesso a conteúdo na web.



📝 Descrição Completa

O que é o Content Guardian?

Content Guardian é uma extensão de controle de conteúdo poderosa, flexível e fácil de usar que permite gerenciar o acesso a informações na web. Funciona bloqueando automaticamente buscas contendo termos específicos e impedindo o acesso a URLs selecionadas, com suporte a exceções e proteção por senha.

Principais Recursos

1. Bloqueio Inteligente de Termos de Busca

• Detecta e bloqueia automaticamente buscas em mais de 70 mecanismos diferentes
• Suporta parâmetros de busca de: Google, Bing, DuckDuckGo, Baidu, Yahoo, Ask.com, e muitos outros
• Compatível com variações internacionais (português, inglês, espanhol, francês, italiano, alemão, etc.)
• Normalização inteligente: remove acentos e variações de escrita para detectar tentativas de contorno
• Correspondência flexível: palavras longas (>5 caracteres) usam detecção por padrão regex; palavras curtas usam correspondência literal para maior precisão

2. Bloqueio de URLs Específicas

• Crie uma lista de domínios e URLs que deseja restringir
• Bloqueio baseado em prefixo para máxima flexibilidade
• Proteja URLs inteiras ou blocos de URLs com uma única entrada

3. Sistema de Whitelist (Exceções)

• Adicione palavras permitidas mesmo que estejam na lista de bloqueio
• Permite exceções contextualizadas para pesquisas legítimas
• Previne conflitos automáticos entre listas

4. Proteção Avançada com Senha

• Proteja itens bloqueados com senhas opcionais
• Limite de 3 tentativas antes de ativar bloqueio temporário (24 horas)
• Sistema de lockout automático para aumentar a segurança
• Contador de tentativas visível na interface

5. Interface de Gerenciamento Intuitiva

• Design limpo e responsivo
• Tema claro e escuro para conforto visual
• Abas organizadas para Whitelist, Blacklist e URLs Bloqueadas
• Busca em tempo real para encontrar rapidamente itens
• Ícones visuais indicando proteção por senha (🔒/🔓)

6. Terminal de Diagnóstico Integrado

• Monitore todas as ações da extensão em tempo real
• Visualize bloqueios, permissões e erros conforme ocorrem
• Pause/retome coleta de logs sem fechar a extensão
• Estatísticas: total de logs, bloqueios, permissões
• Atalhos de teclado: Ctrl+L (limpar), Ctrl+S (exportar), Ctrl+Espaço (pausar)
• Exporte logs em arquivo .txt para análise

7. Página de Aviso Elegante

• Design visual moderno com animação
• Contagem regressiva configurável (padrão: 5 segundos)
• Explica claramente por que a aba foi bloqueada
• Mostra o termo ou URL que acionou o bloqueio
• Fecha automaticamente a aba após o contador

Como Usar

Primeira Execução:
1. Clique no ícone da extensão na barra de ferramentas
2. O popup "URL Guardian" abrirá automaticamente na aba Whitelist

Adicionando Palavras à Whitelist (Permitidas):
1. Acesse a aba "📝 Whitelist"
2. Digite uma palavra que deseja permitir (mesmo se estiver bloqueada)
3. Clique em "➕ Adicionar" ou pressione Enter
4. A palavra será adicionada imediatamente

Bloqueando Palavras (Blacklist):
1. Acesse a aba "🚫 Blacklist"
2. Digite a palavra que deseja bloquear
3. (Opcional) Adicione uma senha para proteger este bloqueio
4. Clique em "🚫 Adicionar à Blacklist"
5. A palavra agora será bloqueada em todas as buscas

Bloqueando URLs:
1. Acesse a aba "🔗 URLs Bloqueadas"
2. Digite a URL que deseja bloquear (ex: youtube.com, reddit.com/r/procrastination)
3. (Opcional) Proteja com senha
4. Clique em "🚫 Adicionar à Blacklist de URLs"

Removendo Itens:
- Whitelist: Clique em "Remover" ao lado da palavra
- Blacklist/URLs: Marque as caixas de seleção e clique "🗑️ Remover Selecionadas"
- Se protegidas por senha, será solicitada a senha

Usando o Terminal de Logs:
1. Clique em "🖥️ Abrir Terminal de Logs"
2. Uma nova aba abrirá com logs em tempo real
3. Veja todos os eventos: bloqueios, permissões, erros
4. Use os controles para pausar, limpar ou exportar logs

Pesquisando:
- Use a barra "🔍 Pesquisar palavras..." para filtrar itens em qualquer aba
- A busca funciona em tempo real

Alternar Tema:
- Clique no botão "🌙/☀️" no canto superior direito
- A preferência é salva automaticamente

Parâmetros de Busca Suportados (70+)

A extensão detecta automaticamente buscas através de parâmetros como:
- Globais: q, search_query, query, term, search, keywords
- Google/Bing: q, p, s
- Variações: texto, palavras, busca, term, find, kw, kwd
- Internacionais: szukaj (polonês), recherche (francês), suche (alemão), ricerca (italiano), búsqueda (espanhol)
- Especiais: oq, aq, as_q, as_qor, as_rq, as_nlo, as_nhi, field-keywords
- E muitos mais...

Recursos de Segurança e Privacidade

🔒 Segurança de Dados

• Todos os dados são armazenados localmente no navegador
• Nenhuma informação é enviada para servidores externos
• Sem rastreamento, sem análise remota
• Sem coleta de dados pessoais

🛡️ Proteção Contra Bypass

• Normalização inteligente de entrada (remove acentos, minúsculas)
• Detecção por padrão regex para evitar variações
• Sistema de whitelist/blacklist hierárquico
• Validação de entrada antes do armazenamento

🔐 Sistema de Tentativas

• Máximo de 3 tentativas antes de lockout
• Bloqueio temporário de 24 horas após exceder tentativas
• Contador visível de tentativas falhas
• Reabilitação automática após 24 horas

📝 Auditoria

• Terminal de logs detalhado para monitoramento
• Registro de todas as ações (adicionar, remover, bloquear, permitir)
• Exportação de logs para análise posterior
• Sem armazenamento automático de histórico

Casos de Uso Ideais

• Controle Parental: Bloqueie conteúdo inadequado para crianças enquanto permite exceções seguras
• Produtividade: Restrinja acesso a sites de distração e redes sociais
• Ambientes Educacionais: Configure restrições para laboratórios e salas de aula
• Segurança Corporativa: Bloqueie conteúdo não autorizado em redes
• Recuperação e Bem-Estar: Auxilie na jornada de recuperação com bloqueios sensatos

Permissões Necessárias

• tabs: Permite monitorar mudanças de URL quando você navega
• storage: Permite armazenar suas listas de bloqueio localmente
• <all_urls>: Necessário para analisar parâmetros de todas as URLs

Por que estas permissões?
- Sem acesso a tabs, a extensão não conseguiria detectar quando você faz uma busca
- Sem storage, suas listas seriam perdidas ao fechar o navegador
- Sem acesso a URLs, não poderia verificar bloqueios

Requisitos Técnicos

• Firefox: Versão 60 ou superior
• Compatibilidade: Chrome 90+ (também funciona em Chromium)
• Espaço: Menos de 1 MB
• RAM: Impacto mínimo (< 5 MB)
• Conexão Internet: Não necessária (funciona totalmente offline)

Suporte e Troubleshooting

A extensão não está bloqueando nada:
- Verifique se a palavra está realmente adicionada à Blacklist
- Abra o Terminal para ver logs de erro
- Certifique-se que a palavra não está na Whitelist

Não consigo acessar um site que quero:
- Adicione a URL à Whitelist
- Se está bloqueado por senha, use a senha correta
- Aguarde 24 horas se estiver em lockout

Preciso de ajuda:
- Verifique o Terminal de Logs para detalhes técnicos
- Limpe o navegador cache (Ctrl+Shift+Delete)
- Desative e reative a extensão

Melhorias Futuras

• Sincronização entre dispositivos
• Importação/exportação de configurações
• Agendamento de bloqueios por horário ou dias
• Relatórios estatísticos detalhados
• Integração com provedores de filtro externo
• Suporte a expressões regulares customizadas
• Modo "Foco" automático durante horários específicos

🌍 Informações Adicionais

Compatibilidade Navegador

• Firefox: Versão 60 ou superior ✅
• Chrome/Edge: Também funciona (compatibilidade estendida)

Idiomas Suportados

• 🇧🇷 Português (Brasil)
• 🇵🇹 Português (Portugal)
• 🇬🇧 English (International)

Licença

Open Source - Todos podem contribuir e modificar

Privacidade

Esta extensão respeita completamente sua privacidade. Nenhum dado sai do seu navegador.



⚠️ Notas Importantes

1. Responsabilidade de Uso: Este software é uma ferramenta de controle. Seu uso é de responsabilidade total do usuário.
2. Sem Garantias: A extensão é fornecida "no estado em que se encontra". Não oferecemos garantias sobre disponibilidade ou funcionamento em todos os casos.
3. Atualizações: Recomendamos manter Firefox atualizado para melhor compatibilidade.
4. Reporte de Problemas: Encontrou um bug? Nos ajude a melhorar reportando na página de suporte.

🎓 Dicas Profissionais

• Para Máxima Segurança: Use senhas em todos os bloqueios críticos
• Para Flexibilidade: Mantenha uma whitelist bem documentada
• Para Monitoramento: Verifique o Terminal regularmente
• Para Backup: Exporte seus logs periodicamente
• Para Organização: Use a busca para encontrar rapidamente o que precisa

Última Atualização: 2025
Versão AMO: 0.1.0
Status: Ativo e em desenvolvimento