Skip to content

README-USER.md

Latest commit

 

History

History
318 lines (239 loc) · 7.99 KB

README-USER.md

File metadata and controls

318 lines (239 loc) · 7.99 KB
Raw

✅ CO ZOSTAŁO ZROBIONE

🎯 Twoje Wymagania:

  1. ✅ Przycisk włącz/wyłącz w popup rozszerzenia
  2. ✅ Logi w dashboardzie - co było, co zostało zanonimizowane
  3. ✅ Działanie na ChatGPT, Perplexity, Claude i innych stronach AI

🔧 Zmiany w Kodzie:

1. Toggle ON/OFF w Popup ✅

Pliki zmodyfikowane:

  • chrome-extension/popup.html - dodano CSS i HTML toggleprzycisk
  • chrome-extension/popup.js - logika włącz/wyłącz z zapisem w chrome.storage
  • chrome-extension/content-script.js - sprawdzanie stanu przed każdą operacją

Jak działa:

  • Kliknij ikonę rozszerzenia
  • Toggle button "Auto-anonimizacja"
  • ZIELONY = włączone, SZARY = wyłączone
  • Stan zapisuje się automatycznie
  • Działa na wszystkich kartach jednocześnie

2. Logi w Dashboardzie ✅

Pliki zmodyfikowane:

  • backend/api/anonymize.py - dodano deque(maxlen=100) dla logów
  • backend/api/anonymize.py - dodano endpoint GET /api/logs
  • backend/api/anonymize.py - dodano endpoint POST /api/logs/clear
  • web-ui/app.html - dodano sekcję "Logi" z UI i JavaScript

Jak działa:

  • Backend zapisuje ostatnie 100 operacji anonimizacji
  • Dashboard wyświetla logi z:
    • Timestamp
    • Tekst oryginalny (czerwony)
    • Tekst zanonimizowany (zielony)
    • Liczba znalezionych encji
    • Czas przetwarzania (ms)
  • Przycisk "Wyczyść Logi"

Jak zobaczyć:

  1. Otwórz http://localhost:6677/dashboard
  2. Kliknij "Logi" w menu (ikona dokumentu)
  3. Zobacz historię anonimizacji

3. Optymalizacja dla Stron AI ✅

Pliki zmodyfikowane:

  • chrome-extension/content-script.js - wyłączono niewiarygodny Enter key handler
  • Dokumentacja: AI-SITES-GUIDE.md - kompleksowy przewodnik

Co działa na ChatGPT/Claude/Perplexity:

  • ✅ PASTE (Ctrl+V) - 100% niezawodne! ⭐ NAJLEPSZE
  • ✅ Skrót klawiszowy (Ctrl+Shift+A) - backup method
  • ✅ Menu kontekstowe (prawy przycisk)

Co NIE działa (wyłączone):

  • ❌ Enter key handler - nowoczesne frameworki (React) nie obsługują re-triggerowania
  • ❌ Auto-anonimizacja przed wysłaniem - wymaga lepszej implementacji

📋 CO MUSISZ ZROBIĆ TERAZ:

Krok 1: Przeładuj Rozszerzenie ⚠️ WAŻNE!

1. Otwórz: chrome://extensions/
2. Znajdź "Presidio Browser Anonymizer"
3. Kliknij ikonę odświeżenia ⟳ (lub przełącz OFF → ON)
4. ZAMKNIJ wszystkie karty ChatGPT/Claude/Perplexity
5. Otwórz je PONOWNIE (F5 nie wystarczy!)

Krok 2: Sprawdź Toggle

1. Kliknij ikonę rozszerzenia w toolbar
2. Sprawdź czy przycisk "Auto-anonimizacja" jest ZIELONY
3. Jeśli szary - kliknij aby włączyć

Krok 3: Test Lokalny

# Otwórz stronę testową
open /Users/gaca/presidio-local-anonymizer/test-extension.html

# Lub w terminalu:
cd /Users/gaca/presidio-local-anonymizer
open test-extension.html

W teście:

  1. Otwórz DevTools (F12)
  2. Skopiuj tekst testowy
  3. Wklej w pole (Ctrl+V)
  4. Sprawdź czy zostaje zanonimizowany
  5. Sprawdź logi w konsoli

Krok 4: Test na ChatGPT

1. Otwórz https://chatgpt.com
2. Skopiuj: "Jan Kowalski, email: jan@example.com, PESEL: 92010212345"
3. Kliknij w pole tekstowe ChatGPT
4. Wklej (Ctrl+V)
5. ✅ Powinno wkleić: "[OSOBA], email: [EMAIL], PESEL: [PESEL]"

Krok 5: Test na Claude

1. Otwórz https://claude.ai
2. Powtórz test jak dla ChatGPT
3. Ctrl+V → sprawdź czy anonimizuje

Krok 6: Test na Perplexity

1. Otwórz https://www.perplexity.ai
2. Powtórz test jak dla ChatGPT
3. Ctrl+V → sprawdź czy anonimizuje

Krok 7: Sprawdź Logi w Dashboardzie

1. Otwórz http://localhost:6677/dashboard
2. Kliknij "Logi" w menu (4. pozycja, ikona dokumentu)
3. Sprawdź czy widzisz historię anonimizacji
4. Zobacz tekst oryginalny → zanonimizowany

🚀 Najlepsza Metoda Użycia (ZALECANA):

⭐ PASTE (Ctrl+V) - 100% Niezawodne!

1. Skopiuj tekst z danymi (Ctrl+C)
2. Wejdź na ChatGPT/Claude/Perplexity
3. Kliknij w pole tekstowe
4. Wklej (Ctrl+V)
5. ✅ Tekst automatycznie zanonimizowany!
6. Wyślij do AI

Dlaczego PASTE jest najlepsze:

  • ✅ Działa na 100% stron AI
  • ✅ Automatyczne - nie wymaga dodatkowych kliknięć
  • ✅ Natychmiastowe - anonimizacja przed wklejeniem
  • ✅ Niezawodne - nie zależy od struktury strony
  • ✅ Uniwersalne - ten sam workflow dla wszystkich AI

🔄 Backup: Ctrl+Shift+A

Jeśli PASTE nie zadziałał:

1. Wklej tekst normalnie
2. Zaznacz cały tekst
3. Ctrl+Shift+A (Cmd+Shift+A na Mac)
4. ✅ Tekst zanonimizowany!
5. Wyślij

📚 Dokumentacja:

1. AI-SITES-GUIDE.md ⭐ PRZECZYTAJ TO!

Kompletny przewodnik po anonimizacji na stronach AI:

  • ChatGPT, Claude, Perplexity, Gemini
  • Najlepsze metody (PASTE!)
  • Co działa, co nie działa
  • Troubleshooting
cat /Users/gaca/presidio-local-anonymizer/AI-SITES-GUIDE.md

2. TESTING.md

Szczegółowe instrukcje testowania:

  • Jak przeładować rozszerzenie
  • Jak sprawdzić logi
  • Jak debugować problemy
cat /Users/gaca/presidio-local-anonymizer/TESTING.md

3. test-extension.html

Lokalna strona testowa:

open /Users/gaca/presidio-local-anonymizer/test-extension.html

🔍 Debugging:

Jeśli widzisz: "Błąd anonimizacji. Wklejam oryginalny tekst."

1. Sprawdź backend:

curl http://localhost:6677/api/health

Jeśli nie działa:

cd /Users/gaca/presidio-local-anonymizer/backend
source .venv/bin/activate
python app.py

2. Sprawdź logi:

Content Script (strona WWW):

  • F12 → Console
  • Szukaj logów: [Presidio]

Background Service Worker:

  • chrome://extensions/
  • "Presidio" → "Inspect views: service worker"
  • Szukaj logów: [Presidio Background]

Backend:

  • Terminal gdzie uruchomiony backend
  • Szukaj: POST /api/anonymize z status 200

✅ Podsumowanie Zmian:

Funkcja Status Pliki
Toggle ON/OFF ✅ Gotowe popup.html, popup.js, content-script.js
Logi w Dashboard ✅ Gotowe anonymize.py, app.html
ChatGPT support ✅ Działa content-script.js (PASTE)
Claude support ✅ Działa content-script.js (PASTE)
Perplexity support ✅ Działa content-script.js (PASTE)
Dokumentacja ✅ Gotowa AI-SITES-GUIDE.md, TESTING.md
Test page ✅ Gotowa test-extension.html

🎯 Następne Kroki:

  1. ✅ Przeładuj rozszerzenie (chrome://extensions/)
  2. ✅ Zamknij i otwórz ponownie karty AI
  3. ✅ Sprawdź toggle (ikona rozszerzenia)
  4. ✅ Test lokalny (test-extension.html)
  5. ✅ Test na ChatGPT (Ctrl+V)
  6. ✅ Test na Claude (Ctrl+V)
  7. ✅ Test na Perplexity (Ctrl+V)
  8. ✅ Sprawdź logi (http://localhost:6677/dashboard → Logi)

📊 Statystyki Backendu:

Z logów backendu widzę że rozszerzenie JUŻ DZIAŁAŁO wcześniej:

2025-11-15 15:01:56 - api.anonymize - INFO - Anonymized text: 9 entities found, 445ms
2025-11-15 15:13:47 - api.anonymize - INFO - Anonymized text: 9 entities found, 487ms
2025-11-15 15:13:53 - api.anonymize - INFO - Anonymized text: 9 entities found, 128ms
2025-11-15 15:14:21 - api.anonymize - INFO - Anonymized text: 9 entities found, 80ms
2025-11-15 15:18:02 - api.anonymize - INFO - Anonymized text: 9 entities found, 116ms

Backend działa poprawnie! ✅

💡 Najważniejsze:

⭐ Używaj PASTE (Ctrl+V) - to najlepszy sposób!

Skopiuj → Ctrl+V na stronie AI → ✅ Automatycznie zanonimizowane!

Nie próbuj:

  • Pisać i wysyłać Enterem (nie działa)
  • Klikać "Send" i czekać na auto-anonimizację (wyłączone)

Zamiast tego:

  • ✅ PASTE (Ctrl+V) - zawsze działa!
  • ✅ Ctrl+Shift+A - backup

📞 Pytania?

Przeczytaj:

  1. AI-SITES-GUIDE.md - jak używać na różnych stronach AI
  2. TESTING.md - jak testować i debugować
  3. Sprawdź logi w DevTools (F12)
  4. Sprawdź backend health: curl http://localhost:6677/api/health

Powodzenia! 🚀

Rozszerzenie jest gotowe do użycia na:

  • ✅ ChatGPT
  • ✅ Claude
  • ✅ Perplexity
  • ✅ Gemini
  • ✅ I WSZYSTKICH innych stronach!

Pamiętaj: PASTE (Ctrl+V) = Najlepsza metoda! ⭐