Czym jest rozszerzenie Safari PocketHook?#
Rozszerzenie Safari dla macOS, które pozwala Twojemu samodzielnie hostowanemu Agent Server pracować wewnątrz Twojej prawdziwej przeglądarki: otwierać i zamykać karty, czytać strony, znajdować i klikać kontrolki, wypełniać formularze i przechwytywać zrzuty ekranu — w Twojej sesji, z Twoimi loginami, na Twoim komputerze.
Wszystko działa lokalnie. Rozszerzenie komunikuje się wyłącznie z Agent Server na Twoim własnym Macu (loopback), a nic nie jest wysyłane nigdzie indziej.
Instalacja#
Rozszerzenie jest dostarczane wraz z Agent Server jako notaryzowana aplikacja macOS — bez App Store, bez Xcode:
bun run safari:install
To polecenie instaluje Pockethook Safari.app w /Applications i ją uruchamia. Następnie, w Safari:
- Ustawienia → Rozszerzenia — włącz PocketHook Safari i przyznaj dostęp do witryn.
- Wygeneruj jednorazowy kod parowania na serwerze:
bun run safari:code
- Otwórz popup rozszerzenia na pasku narzędzi Safari, wpisz kod i naciśnij Pair. Zielona kropka oznacza, że jesteś połączony.
Połączenie możesz sprawdzić w dowolnym momencie za pomocą bun run safari:status.
Poziomy uprawnień#
To Ty decydujesz, ile autonomii dostaje agent, dla każdego serwera osobno, za pomocą bun run safari:config:
| Poziom | Co oznacza |
|---|---|
confirm (domyślny) | Każde kliknięcie z zewnętrznymi skutkami (głosowanie, wysłanie, publikacja, zakup…) najpierw prosi Cię o potwierdzenie |
autonomous | Głosy, obserwowania i wysyłki wykonują się bez pytania; płatności, trwałe usunięcia oraz zmiany konta lub zabezpieczeń nadal wymagają zgody |
readonly | Tylko nawigacja, inspekcja i przechwytywanie — klikanie i pisanie są wyłączone |
Co potrafi agent#
- Otwierać karty, nawigować i je zamykać
- Sprawdzać stronę: widoczne kontrolki ze stabilnymi selektorami, stanem i atrybutami semantycznymi
- Znajdować kontrolki po ich widocznym tekście lub atrybutach identyfikujących
- Klikać i wypełniać formularze (ze świadomością frameworków, z weryfikacją przed/po)
- Przewijać i przechwytywać zrzuty ekranu, dostarczane z powrotem do Twojego czatu
Każda akcja raportuje, co faktycznie się wydarzyło — łącznie z tym, czy kliknięcie naprawdę coś zmieniło — dzięki czemu agent weryfikuje zamiast zgadywać.
Model bezpieczeństwa#
- Tylko loopback — rozszerzenie łączy się wyłącznie z lokalnymi adresami, które skonfigurujesz.
- Jednorazowe kody parowania — kody wygasają po 5 minutach i są jednokrotnego użytku; wynikowe poświadczenie nigdy nie opuszcza Twojego Maca.
- Wygasanie poleceń — polecenia, których rozszerzenie nie odebrało w ciągu 20 sekund, są odrzucane, więc nic nie wykonuje się z opóźnieniem.
- Klucze trzymasz Ty — płatności i akcje destrukcyjne zawsze wymagają Twojego wyraźnego potwierdzenia, na każdym poziomie uprawnień pozwalającym na klikanie.
- Możliwość audytu — JavaScript rozszerzenia jest dostarczany w czytelnej postaci wewnątrz pakietu aplikacji.
Pobieranie#
Rozszerzenie jest dołączone do Agent Server (assets/safari/PocketHook-Safari.zip), albo pobierz je bezpośrednio: PocketHook-Safari.zip — podpisane i notaryzowane dla macOS.