Instalacja i dokumentacja

Spis treści

Instalacja

1. Pierwsze kroki
2. Privacy Owl (Twój asystent na stronach AI)
3. Skanowanie przesyłanych plików
4. Bąbelek zaznaczenia
5. Menu kontekstowe
6. Strona czatu
7. Strona ustawień
8. Strona audytu
9. Strona anonimizacji plików
10. Skróty klawiszowe
11. Języki
12. FAQ i rozwiązywanie problemów

1. Pierwsze kroki

Po zainstalowaniu rozszerzenia w prawym górnym rogu paska narzędzi Chrome pojawi się mała ikona SOWA. Kliknij ją, aby otworzyć menu podręczne z trzema przyciskami:

Przycisk	Działanie
Chat	Otwiera pełną stronę czatu, na której możesz wpisywać tekst, wykrywać dane osobowe i wysyłać wiadomości do AI.
Settings	Otwiera stronę ustawień, na której konfigurujesz sposób działania SOWA.
Audit	Otwiera stronę audytu, na której możesz przeglądać dziennik wszystkich działań SOWA.

Te trzy przyciski to Twój punkt wejścia do wszystkiego.

2. Privacy Owl

Gdy odwiedzasz obsługiwaną stronę czatu AI (ChatGPT, Claude, Gemini, Copilot, Grok), w rogu ekranu pojawia się mała sowa. To Twój strażnik prywatności.

Jak działa sowa

• Zwykłe oczy – wszystko wygląda bezpiecznie, nie wykryto danych osobowych.
• Czerwone oczy – sowa znalazła dane osobowe w tym, co wpisujesz.
• Sowa nieprzerwanie monitoruje Twoje pisanie (co pół sekundy) i sprawdza, czy nie pojawiają się dane osobowe.
• Sowę można przeciągnąć do dowolnego rogu ekranu.

Menu nawigacyjne sowy

Kliknij sowę, aby otworzyć jej menu. Menu zawiera przełącznik blokady (przełączanie między prawdziwym tekstem a placeholderami), selektor deanonimizacji pliku (upuść plik DOCX, a SOWA przywróci oryginalne wartości) oraz szybkie linki do Czatu, Audytu i Ustawień.

Co się dzieje podczas pisania

1. Zaczynasz pisać w polu czatu AI.
2. Sowa skanuje Twój tekst w poszukiwaniu danych osobowych.
3. Jeśli wykryto dane osobowe, oczy sowy stają się czerwone, a wykryte elementy zostają podświetlone w polu tekstowym.
4. Zanim wiadomość zostanie wysłana, SOWA zastępuje dane osobowe bezpiecznymi placeholderami (np. Anna Nowak staje się [NAME_1]).
5. Po otrzymaniu odpowiedzi AI, SOWA automatycznie przywraca prawdziwe dane w odpowiedzi.

Ochrona przed automatycznym wysłaniem

Gdy naciśniesz Enter i zostaną wykryte dane osobowe, pojawi się mała nakładka z trzema opcjami:

Przycisk	Działanie
Anonimizuj, a następnie wyślij	Zastępuje wszystkie dane osobowe placeholderami, a następnie wysyła automatycznie. Najbezpieczniejsza opcja.
Wyślij mimo to	Wysyła bez zmian, bez anonimizacji.
Anuluj	Anuluje wysłanie, dzięki czemu możesz wprowadzić zmiany.

3. Skanowanie przesyłanych plików

Gdy przesyłasz plik do czatu AI (np. przeciągając PDF do ChatGPT), SOWA może przeskanować plik w poszukiwaniu danych osobowych przed jego wysłaniem.

Jak to działa

1. Przeciągasz plik do czatu lub klikasz przycisk załącznika.
2. SOWA przechwytuje przesyłanie i skanuje plik w poszukiwaniu danych osobowych.
3. Jeśli dane osobowe zostaną znalezione, pojawia się okno modalne pokazujące nazwę pliku, rozmiar i format, liczbę znalezionych danych osobowych (pogrupowanych według typu) oraz podgląd porównawczy tekstu oryginalnego i zanonimizowanego.

Przyciski decyzji

Button	What it does
Anonimizuj najpierw	Zastępuje wszystkie dane osobowe w pliku, a następnie przesyła wersję zanonimizową. W przypadku plików PDF redaguje bezpośrednio w PDF (białe pole + tekst zastępczy).
Wyślij mimo to	Przesyła oryginalny plik bez zmian.
Anuluj	Anuluje przesyłanie.

Obsługiwane typy plików

• Pliki tekstowe: .txt, .md, .csv, .json, .log, .xml, .html, .py, .js, .ts, .yaml, .sql, .sh i wiele innych.
• Dokumenty: PDF (tekst wyodrębniany i redagowany w miejscu), DOCX (tekst wyodrębniany), XLSX (tekst wyodrębniany).
• Maksymalny rozmiar pliku: 5 MB.

4. Bąbelek zaznaczenia

Gdy zaznaczasz tekst na obsługiwanej stronie AI, w pobliżu zaznaczenia pojawia się mały pływający pasek.

Button	What it does
SOWA	Anonimizuje zaznaczony tekst w miejscu.
WL	Dodaje zaznaczony tekst do białej listy (SOWA będzie go ignorować).
BL	Dodaje zaznaczony tekst do czarnej listy (SOWA zawsze będzie traktować go jako dane osobowe).

5. Menu kontekstowe

Kliknij prawym przyciskiem myszy na dowolnej stronie, aby zobaczyć opcje SOWA w menu kontekstowym:

• SOWA: Send Selection – skopiuj zaznaczony tekst do okna podręcznego SOWA.
• SOWA: Anonymise (inline) – anonimizuj zaznaczony tekst bezpośrednio na stronie.
• SOWA: Whitelist Selection – dodaj do białej listy.
• SOWA: Blacklist Selection – dodaj do czarnej listy.

6. Strona czatu

Otwórz stronę czatu, klikając Chat w menu podręcznym lub menu sowy. Tutaj możesz pisać, wykrywać dane osobowe i wysyłać wiadomości do AI w kontrolowanym środowisku pracy.

Główny obszar roboczy

• Pole tekstowe – wpisz lub wklej wiadomość.
• Lista rozwijana profilu modelu – wybierz model AI lub interfejs API do użycia.
• Przycisk podglądu – sprawdź, jak wiadomość wygląda po anonimizacji.
• Karta wykrytych danych osobowych – kolorowe etykiety pokazują każdy wykryty typ danych. Rozwiń Szczegóły, aby zobaczyć pozycje i poziomy pewności.
• Karta lokalnego LLM – jeśli Tryb mocy jest włączony, uruchom lokalny model AI w celu dokładniejszego wykrywania.
• Wyślij (zewnętrzny LLM) – wysyła zanonimizową wiadomość do wybranego interfejsu API i wyświetla odpowiedź z przywróconymi oryginalnymi wartościami.

Panel szybkich akcji

Na szerokich ekranach prawy panel boczny oferuje skróty do Anonimizacji plików, szerokiego widoku historii, Diagnostyki i przełącznika debugowania.

7. Ustawienia

Trzy sekcje przełączane z lewego paska bocznego.

Wykrywanie

Kontroluje sposób, w jaki SOWA wykrywa dane osobowe.

• Przełącznik Trybu mocy – włącza dodatkowy lokalny model AI (WebLLM) dla lepszego wykrywania danych osobowych. Używa 2–4 GB RAM, ale wykrywa więcej przypadków granicznych.
• Lista rozwijana potoku – wybierz kolejność wykrywania: tylko regex (najszybszy), regex-ner (zalecany) lub tylko ner.
• Przełączniki Regex / Biała lista / Czarna lista – włącz lub wyłącz każdą warstwę wykrywania.
• Sekcja NER – włącz rozpoznawanie nazwanych jednostek (lokalny model 65 MB, wymagana zgoda). Wybierz model, ustaw próg pewności i priorytet.
• Sekcja lokalnego LLM – włącz przetwarzanie LLM w przeglądarce (wymaga WebGPU, pobiera ~200 MB).
• Szablony danych osobowych – gotowe zestawy reguł: domyślny, lekki, bankowy, medyczny, ubezpieczeniowy.
• Niestandardowe reguły i listy – dodaj własne reguły regex. Format: KIND|REGEX|FLAGS|PRIORITY. Pola Biała lista i Czarna lista przyjmują jedną frazę na wiersz.

Modele AI

Z jakimi usługami AI komunikuje się SOWA.

• Bazowy URL, Model, Klucz API, Temperatura, Prompt systemowy – standardowe ustawienia interfejsu API kompatybilnego z OpenAI. Klucze API są przechowywane lokalnie i nigdy nie są przesyłane do SOWA.
• Profile modeli – tablica JSON konfiguracji do szybkiego przełączania.

Witryny i prywatność

Gdzie i jak SOWA działa na stronach internetowych.

• Przełącznik integracji z witrynami – główny przełącznik anonimizacji na zewnętrznych stronach AI.
• Tryb wyświetlania Privacy Owl – pokaż tylko przycisk wbudowany, tylko sowę lub oba.
• Kolory podświetlania – podświetlenie danych osobowych (domyślnie czerwony) i podświetlenie placeholderów wysłanych wiadomości (domyślnie fioletowy).
• Motyw akcentu sowy – morski, fioletowy, niebieski, bursztynowy lub niestandardowy.
• Zakres słownika – dla domeny (oddzielny słownik dla każdej witryny) lub globalny (wspólny dla wszystkich witryn).
• Reguły witryn – wzorce URL, dla których SOWA jest aktywna (obsługiwane symbole wieloznaczne, np. *chatgpt.com*).
• Przełącznik skanowania przesyłanych plików, Przełącznik automatycznego zapisu.

8. Strona audytu

Kompletny rejestr wszystkich działań SOWA – każde wykrycie danych osobowych, każda anonimizacja, każda decyzja o wysłaniu, każda zmiana konfiguracji. Przechowywany lokalnie na Twoim urządzeniu.

Karty statystyk

Całkowita liczba zdarzeń, anonimizacji, wysłanych wiadomości, decyzji użytkownika, przeskanowanych plików, zajętego miejsca.

Weryfikacja integralności

SOWA używa łańcucha skrótów SHA-256, aby upewnić się, że nikt nie zmodyfikował dziennika audytu. Skrót każdego zdarzenia zawiera skrót poprzedniego zdarzenia. Kliknij Weryfikuj integralność, aby zwalidować łańcuch od początku do końca.

Opcje eksportu

• Eksportuj JSON – pełny dziennik audytu jako plik JSON.
• Eksportuj CSV – dziennik audytu jako arkusz kalkulacyjny.
• Wyczyść dziennik audytu – usuń wszystkie zdarzenia (nieodwracalne).

Filtry

Filtruj według typu zdarzenia, zakresu dat lub adresu URL. Typy zdarzeń obejmują: Wykryto dane osobowe, Zanonimizowano, Wysłano, Odpowiedź, Deanonimizowano, Decyzja użytkownika, Zmieniono konfigurację, Błąd.

Karta Słownik

Pokazuje wszystkie mapowania danych osobowych ↔ placeholder utworzone przez SOWA. Możesz przeszukiwać, usuwać poszczególne wpisy, eksportować lub wyczyścić cały słownik.

9. Strona anonimizacji plików

Dedykowana strona do wsadowej anonimizacji plików tekstowych. Upuść jeden lub wiele plików .txt, sprawdź liczbę danych osobowych w każdym pliku, a następnie wybierz anonimizację, wysłanie oryginału lub pobranie.

10. Skróty klawiszowe

Skrót	Gdzie	Działanie
Alt + Shift + A	Dowolna obsługiwana strona AI	Anonimizuje zaznaczony tekst lub bieżące pole tekstowe.
Enter	Okno przesyłania	Potwierdź „Anonimizuj najpierw”.
Escape	Okno przesyłania	Anuluj przesyłanie.

11. Języki

Interfejs użytkownika SOWA obsługuje cztery języki:

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

Zmieniaj język za pomocą przycisków DE / EN / FR / PL w nagłówku każdej strony rozszerzenia. Cały interfejs aktualizuje się natychmiast.

Samo wykrywanie działa na tekście w dowolnym języku. Dostarczany model NER jest wielojęzyczny (DistilBERT, PL / EN / DE / FR).

12. FAQ i rozwiązywanie problemów

Sowa nie pojawia się na mojej stronie czatu AI

Otwórz Ustawienia → Witryny i prywatność i upewnij się, że opcja „Włącz anonimizację na zewnętrznych witrynach” jest aktywna. Następnie sprawdź, czy Twoja witryna znajduje się na liście reguł witryn – możesz tam dodać własne wzorce URL.

SOWA nie wykrywa pewnych nazw ani organizacji

Włącz wykrywanie NER w Ustawienia → Wykrywanie → Lokalny model AI. NER używa lokalnego modelu AI znacznie lepiej radzącego sobie z wykrywaniem nazw, organizacji i miejsc niż wyrażenia regularne.

Słownik zawiera stare wpisy

Kliknij Wyczyść słownik na karcie Słownik strony audytu. Spowoduje to wyczyszczenie wpisów zarówno z lokalnego magazynu przeglądarki, jak i magazynu rozszerzenia.

Chcę jeszcze dokładniejszego wykrywania

Włącz Tryb mocy w ustawieniach. Dodaje to lokalny LLM (Phi-3 lub podobny) do potoku. Wolniejszy, ale wykrywa przypadki graniczne. Wymaga WebGPU i 2–4 GB RAM.

Skąd wiem, że mój dziennik audytu nie został zmodyfikowany?

Przejdź do strony audytu i kliknij Weryfikuj integralność. SOWA sprawdza łańcuch skrótów SHA-256. Zielony baner oznacza, że skróty wszystkich zdarzeń są zgodne.

Czy mogę używać SOWA bez połączenia z internetem?

Tak. Po pobraniu modelu NER (~65 MB) i/lub modelu WebLLM (~200 MB) całe wykrywanie danych osobowych odbywa się lokalnie. Jedynym momentem, gdy dane opuszczają Twoje urządzenie, jest wyraźne kliknięcie „Wyślij" do zewnętrznego interfejsu API AI.

Jakie typy danych osobowych wykrywa SOWA?

Imiona i nazwiska, adresy e-mail, numery telefonów (w tym polskie komórkowe), adresy fizyczne, PESEL, NIP, IBAN, BIC/SWIFT, numery kart kredytowych, numery praw jazdy, numery paszportów, daty urodzenia, adresy IP, adresy URL z danymi osobowymi, klucze API, hasła, tokeny, nazwy organizacji i inne.