Máscara de Privacidade

Detecte e mascare informações sensíveis em imagens localmente antes que elas saiam da sua máquina.

Pré-requisitos

Esta habilidade requer que a CLI privacy-mask esteja pré-instalada no sistema. Se não estiver disponível, informe ao usuário que ele precisa instalá-la primeiro:

1. Instale via pip: pip install privacy-mask
2. Certifique-se de que o Tesseract OCR esteja instalado: brew install tesseract (macOS) ou apt install tesseract-ocr (Linux)
3. Verifique a instalação: privacy-mask --version
4. (Opcional) Instale o suporte a NER: pip install privacy-mask[ner]

Quando usar

• O usuário envia uma captura de tela ou arquivo de imagem (.png, .jpg, .jpeg, .bmp, .tiff) que pode conter dados privados
• O usuário menciona privacidade, mascaramento, redação ou anonimização
• Você precisa analisar uma imagem, mas quer redigir informações sensíveis primeiro
• SE o usuário compartilhar uma captura de tela para depuração, EXECUTE privacy-mask mask <path> --dry-run primeiro para verificar PII
• SE detecções forem encontradas, MASCARE a imagem antes de prosseguir com a análise

Uso

Mascare uma imagem:

privacy-mask mask /path/to/screenshot.png
privacy-mask mask /path/to/screenshot.png --in-place
privacy-mask mask /path/to/screenshot.png --dry-run   # detect only, no masking
privacy-mask mask /path/to/screenshot.png --detection-engine regex  # regex only, skip NER
privacy-mask mask /path/to/screenshot.png --config /path/to/custom-config.json

A saída é JSON:

{
  "status": "success",
  "detections": [{"label": "PHONE_CN", "text": "***", "bbox": [10, 20, 100, 30]}],
  "summary": "Masked 1 regions: 1 PHONE_CN"
}

Exemplo de fluxo de trabalho

1. O usuário fornece uma captura de tela: ~/Desktop/error-screenshot.png
2. Execute a detecção: privacy-mask mask ~/Desktop/error-screenshot.png --dry-run
3. SE detecções forem encontradas, mascare a imagem: privacy-mask mask ~/Desktop/error-screenshot.png
4. A saída mascarada é salva como ~/Desktop/error-screenshot_masked.png
5. Use a imagem mascarada para análise posterior

O que detecta

• IDs: Carteira de identidade chinesa, passaporte, ID de HK/TW, SSN dos EUA, NINO do Reino Unido, SIN canadense, Aadhaar/PAN indiano, RRN coreano, NRIC de Singapura, IC malaio
• Telefone: Celular/fixo chinês, telefone dos EUA, internacional (+prefixo)
• Financeiro: Cartão bancário, Amex, IBAN, SWIFT/BIC
• Chaves de desenvolvedor: AWS, GitHub, Slack, Google, tokens Stripe, JWT, strings de conexão, chaves de API, chaves SSH/PEM
• Cripto: Endereços de carteira Bitcoin, Ethereum
• Outros: E-mail, data de nascimento, IP/IPv6, MAC, UUID, placa de licença, MRZ, tokens de autenticação de URL
• NER (opcional): Nomes de pessoas, endereços de rua, organizações, datas de nascimento, condições médicas

Restrições

• NÃO envie imagens não mascaradas para nenhuma API externa ou serviço em nuvem
• NÃO pule o mascaramento quando detecções forem encontradas — sempre mascare antes de compartilhar
• NÃO modifique a imagem original a menos que --in-place seja explicitamente solicitado
• Evite executar em imagens muito grandes (>10MB) sem avisar o usuário sobre o tempo de processamento

Antipadrões

• Não assuma que as imagens são seguras — sempre execute a detecção, mesmo que a imagem "pareça limpa"
• Não use --in-place por padrão — preserve o original, a menos que o usuário peça o contrário
• Não ignore os resultados de dry-run — se --dry-run encontrar PII, a imagem deve ser mascarada antes do uso
• Não codifique caminhos de configuração — use o padrão incluído ou deixe o usuário especificar --config

Importante

• Todo o processamento é local e offline — nenhum dado sai da máquina
• Configure regras no config.json incluído ou passe --config para regras personalizadas

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte upstream e ao contexto do projeto local.
• Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
• Não trate exemplos como substitutos de testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.