Instalação & documentação

Índice

Instalação

1. Primeiros passos
2. O Privacy Owl (o seu assistente nos sites de IA)
3. Digitalização de ficheiros carregados
4. A Bolha de Seleção
5. Menu de contexto (clique direito)
6. Página de Chat
7. Página de Definições
8. Página de Auditoria
9. Página de Anonimização de Ficheiros
10. Atalhos de teclado
11. Idiomas
12. FAQ & resolução de problemas

1. Primeiros passos

Depois de instalar a extensão, verá um pequeno ícone do SOWA na barra de ferramentas do Chrome (canto superior direito). Clique nele para ver o menu de pop-up com três botões:

Botão	O que faz
Chat	Abre a página de Chat completa onde pode escrever texto, detetar PII e enviar mensagens para a IA.
Definições	Abre a página de Definições onde configura o funcionamento do SOWA.
Auditoria	Abre a página de Auditoria onde pode ver um registo de tudo o que o SOWA fez.

Esses três botões são a sua porta de entrada para tudo.

2. O Privacy Owl

Quando visita um site de chat de IA suportado (ChatGPT, Claude, Gemini, Copilot, Grok), aparece uma pequena coruja no canto do ecrã. Este é o seu guardião de privacidade.

Como funciona a Coruja

• Olhos normais – tudo parece seguro, sem dados pessoais detetados.
• Olhos vermelhos – a coruja encontrou informações pessoais no que está a escrever.
• A coruja monitoriza continuamente a sua escrita (a cada meio segundo) e verifica se há dados pessoais.
• Pode arrastar a coruja para qualquer canto do ecrã.

Menu de navegação da Coruja

Clique na coruja para abrir o seu menu. O menu inclui um botão de bloqueio (alternar entre texto real e texto com marcadores), um seletor para des-anonimizar ficheiro (largue um DOCX e o SOWA restaura os marcadores para os originais) e atalhos rápidos para Chat, Auditoria e Definições.

O que acontece quando escreve

1. Começa a escrever na caixa de chat de IA.
2. A coruja analisa o seu texto em busca de dados pessoais.
3. Se for detetado PII, os olhos da coruja ficam vermelhos e os itens detetados são realçados no seu campo de texto.
4. Antes da sua mensagem ser enviada, o SOWA substitui os dados pessoais por marcadores seguros (por ex., Anna Nowak torna-se [NAME_1]).
5. Depois de a IA responder, o SOWA recoloca os dados reais na resposta automaticamente.

Proteção de envio automático

Quando prime Enter e é detetado PII, aparece uma pequena sobreposição com três opções:

Botão	O que faz
Anonimizar primeiro e depois enviar	Substitui todo o PII por marcadores e envia automaticamente. Opção mais segura.
Enviar mesmo assim	Envia tal como está, sem anonimizar.
Cancelar	Cancela o envio para que possa editar.

3. Digitalização de ficheiros carregados

Quando carrega um ficheiro para um chat de IA (por exemplo, arrastando um PDF para o ChatGPT), o SOWA pode digitalizar o ficheiro em busca de dados pessoais antes de ser enviado.

How it works

1. Arrasta um ficheiro para o chat ou clica no botão de anexo.
2. O SOWA interceta o carregamento e digitaliza o ficheiro em busca de PII.
3. Se for detetado PII, aparece um modal com o nome + tamanho + formato do ficheiro, quantos itens de PII foram encontrados (agrupados por tipo) e uma pré-visualização lado a lado do texto original vs. anonimizado.

Botões de decisão

Botão	O que faz
Anonimizar primeiro	Substitui todo o PII no ficheiro e carrega a versão anonimizada. Para PDFs, redige diretamente no PDF (caixa branca + texto de marcador).
Enviar mesmo assim	Carrega o ficheiro original sem alterações.
Cancelar	Cancela o carregamento.

Tipos de ficheiro suportados

• Ficheiros de texto: .txt, .md, .csv, .json, .log, .xml, .html, .py, .js, .ts, .yaml, .sql, .sh e muitos mais.
• Documentos: PDF (texto extraído e redigido no local), DOCX (texto extraído), XLSX (texto extraído).
• Tamanho máximo do ficheiro: 5 MB.

4. A Bolha de Seleção

Quando seleciona texto num site de IA suportado, aparece uma pequena barra flutuante perto da sua seleção.

Button	What it does
SOWA	Anonimiza o texto selecionado de forma integrada.
WL	Adiciona o texto selecionado à Lista Branca (o SOWA irá ignorá-lo).
BL	Adiciona o texto selecionado à Lista Negra (o SOWA tratá-lo-á sempre como PII).

5. Menu de contexto (clique direito)

Clique com o botão direito em qualquer página e verá as opções do SOWA no menu de contexto:

• SOWA: Enviar Seleção – copiar o texto selecionado para o pop-up do SOWA.
• SOWA: Anonimizar (integrado) – anonimizar o texto selecionado diretamente na página.
• SOWA: Adicionar à Lista Branca – adicionar à Lista Branca.
• SOWA: Adicionar à Lista Negra – adicionar à Lista Negra.

6. Página de Chat

Abra a página de Chat clicando em Chat no menu pop-up ou no menu da coruja. Aqui pode escrever, detetar PII e enviar mensagens para a IA num espaço de trabalho controlado.

Área de trabalho principal

• Área de texto – escreva ou cole a sua mensagem.
• Menu de perfil de modelo – escolha qual modelo/API de IA utilizar.
• Botão de pré-visualização – veja como ficará a sua mensagem após a anonimização.
• Cartão de PII detetado – etiquetas codificadas por cores mostram cada tipo de PII encontrado. Expanda Detalhes para ver posições e pontuações de confiança.
• Cartão de LLM local – se o Modo Avançado estiver ativo, execute o modelo de IA local para uma deteção mais robusta.
• Enviar (LLM externo) – envia a sua mensagem anonimizada para a API escolhida e exibe a resposta com os marcadores restaurados.

Barra lateral de ações rápidas

Em ecrãs largos, uma barra lateral direita oferece atalhos para Anonimização de Ficheiros, vista de histórico alargado, Diagnóstico e um botão de depuração.

7. Definições

Três secções, alternadas a partir da barra lateral esquerda.

Deteção

Controla como o SOWA encontra dados pessoais.

• Botão Modo Avançado – ativa uma IA local extra (WebLLM) para melhor deteção de PII. Usa 2–4 GB de RAM mas deteta mais casos extremos.
• Menu de pipeline – escolha a ordem de deteção: apenas regex (mais rápido), regex-ner (recomendado) ou apenas ner.
• Botões Regex / Lista Branca / Lista Negra – ativar ou desativar cada camada de deteção.
• Secção NER – ativar o reconhecimento de entidades nomeadas (modelo local de 65 MB, adesão voluntária). Escolha um modelo, defina o limiar de confiança e a prioridade.
• Secção de LLM local – ativar o processamento de LLM no browser (requer WebGPU, descarrega ~200 MB).
• Predefinições de PII – conjuntos de regras pré-construídos: padrão, light, banco, med (médico), seguro.
• Regras e listas personalizadas – adicione as suas próprias regras regex. Formato: KIND|REGEX|FLAGS|PRIORITY. As áreas de texto de Lista Branca e Lista Negra aceitam uma frase por linha.

Modelos de IA

Quais os serviços de IA com que o SOWA comunica.

• URL base, Modelo, Chave de API, Temperatura, Prompt de sistema – definições de API compatíveis com OpenAI. As chaves de API são armazenadas localmente, nunca transmitidas ao SOWA.
• Perfis de modelo – array JSON de configurações para troca rápida.

Sites & Privacidade

Onde e como o SOWA funciona em websites.

• Botão de Integração de Sites – interruptor principal para anonimização em sites de IA externos.
• Modo de exibição do Privacy Owl – mostrar apenas o botão integrado, apenas a coruja, ou ambos.
• Cores de realce – realce de PII (vermelho por padrão) e realce de marcador de mensagem enviada (roxo por padrão).
• Tema de destaque da Coruja – Verde-azulado, Roxo, Azul, Âmbar ou Personalizado.
• Âmbito do dicionário – por domínio (dicionário separado por site) ou global (partilhado entre todos os sites).
• Regras de site – padrões de URL onde o SOWA está ativo (carateres universais suportados, por ex. *chatgpt.com*).
• Botão de digitalização de ficheiros carregados, Botão de guardado automático.

8. Página de Auditoria

Um registo completo de tudo o que o SOWA fez – cada deteção de PII, cada anonimização, cada decisão de envio, cada alteração de configuração. Armazenado localmente no seu dispositivo.

Cartões de estatísticas

Total de eventos, anonimizações, mensagens enviadas, decisões do utilizador, ficheiros digitalizados, armazenamento utilizado.

Verificação de integridade

O SOWA utiliza uma cadeia de hash SHA-256 para garantir que ninguém adulterou o registo de auditoria. O hash de cada evento inclui o hash do evento anterior. Clique em Verificar Integridade para validar a cadeia de ponta a ponta.

Opções de exportação

• Exportar JSON – registo de auditoria completo como ficheiro JSON.
• Exportar CSV – registo de auditoria como folha de cálculo.
• Limpar Registo de Auditoria – eliminar todos os eventos (irreversível).

Filtros

Filtre por tipo de evento, intervalo de datas ou URL. Os tipos de eventos incluem PII Detetado, Anonimizado, Enviado, Resposta, Des-anonimizado, Decisão do Utilizador, Config Alterada, Erro.

Separador Dicionário

Mostra todos os mapeamentos PII ↔ marcador que o SOWA criou. Pesquise, elimine entradas individuais, exporte ou limpe todo o dicionário.

9. Página de Anonimização de Ficheiros

Uma página dedicada à anonimização em lote de ficheiros de texto. Largue um ou vários ficheiros .txt, obtenha uma contagem de PII por ficheiro e escolha anonimizar, enviar o original ou descarregar.

10. Atalhos de teclado

Atalho	Onde	O que faz
Alt + Shift + A	Qualquer site de IA suportado	Anonimizar o texto selecionado ou o campo de texto atual.
Enter	Modal de carregamento	Confirmar "Anonimizar primeiro".
Escape	Modal de carregamento	Cancelar o carregamento.

11. Idiomas

A interface do utilizador do SOWA suporta quatro idiomas:

• Deutsch (DE)
• English (EN)
• Français (FR)
• Polski (PL)

Mude de idioma usando os botões DE / EN / FR / PL no cabeçalho de cada página da extensão. Toda a interface é atualizada instantaneamente.

A deteção em si funciona com texto em qualquer idioma. O modelo NER incluído é multilíngue (DistilBERT, PL / EN / DE / FR).

12. FAQ & resolução de problemas

A coruja não aparece no meu site de chat de IA

Abra Definições → Sites & Privacidade e certifique-se de que "Ativar anonimização em sites externos" está ligado. Depois verifique se o seu site está na lista de Regras de Site – pode adicionar padrões de URL personalizados aí.

O SOWA não deteta certos nomes ou organizações

Ative a deteção NER em Definições → Deteção → IA Local. O NER usa um modelo de IA local que é muito melhor do que regex para encontrar nomes, organizações e localizações.

O dicionário mantém entradas antigas

Clique em Limpar Dicionário no separador Dicionário da página de Auditoria. Isso limpa entradas tanto do armazenamento local do website como do armazenamento da extensão.

Quero uma deteção ainda mais precisa

Ative o Modo Avançado nas Definições. Isso adiciona um LLM local (Phi-3 ou semelhante) ao pipeline. Mais lento mas deteta casos extremos. Requer WebGPU e 2–4 GB de RAM.

Como sei que o meu registo de auditoria não foi adulterado?

Vá à página de Auditoria e clique em Verificar Integridade. O SOWA verifica a cadeia de hash SHA-256. Uma faixa verde significa que o hash de cada evento corresponde.

Posso usar o SOWA sem ligação à internet?

Sim. Depois de o modelo NER (~65 MB) e/ou o modelo WebLLM (~200 MB) serem descarregados, toda a deteção de PII acontece localmente. Os dados só saem do seu dispositivo quando clica explicitamente em “Enviar” para uma API de IA externa.

Que tipos de dados pessoais o SOWA deteta?

Nomes, endereços de e-mail, números de telefone (incluindo telemóvel alemão), moradas físicas, PESEL, NIP, IBAN, BIC/SWIFT, números de cartão de crédito, carta de condução, números de passaporte, datas de nascimento, endereços IP, URLs com informações pessoais, chaves de API, palavras-passe, tokens, nomes de organizações e mais.