Čo je rozšírenie Safari od PocketHook?#
Rozšírenie Safari pre macOS, ktoré umožňuje vášmu vlastnému Agent Serveru pracovať priamo vo vašom skutočnom prehliadači: otvárať a zatvárať karty, čítať stránky, hľadať a klikať na ovládacie prvky, vypĺňať formuláre a snímať obrazovku — vo vašej relácii, s vašimi prihláseniami, na vašom počítači.
Všetko beží lokálne. Rozšírenie komunikuje iba s Agent Serverom na vašom vlastnom Macu (loopback) a nič sa neposiela nikam inam.
Inštalácia#
Rozšírenie sa dodáva spolu s Agent Serverom ako notarizovaná macOS aplikácia — bez App Store, bez Xcode:
bun run safari:install
Tým sa nainštaluje Pockethook Safari.app do /Applications a spustí sa. Potom v Safari:
- Nastavenia → Rozšírenia — zapnite PocketHook Safari a udeľte prístup k webovým stránkam.
- Vygenerujte na serveri jednorazový párovací kód:
bun run safari:code
- Otvorte popup rozšírenia v paneli nástrojov Safari, zadajte kód a stlačte Pair. Zelená bodka znamená, že ste pripojení.
Pripojenie môžete kedykoľvek skontrolovať pomocou bun run safari:status.
Úrovne oprávnení#
Sami rozhodujete, koľko autonómie agent dostane, pre každý server zvlášť, pomocou bun run safari:config:
| Úroveň | Čo znamená |
|---|---|
confirm (predvolené) | Každé kliknutie s externými účinkami (hlasovanie, odoslanie, publikovanie, nákup…) si najprv vyžiada vaše potvrdenie |
autonomous | Hlasovania, sledovania a odoslania bežia bez pýtania; platby, trvalé mazania a zmeny účtu alebo zabezpečenia si potvrdenie stále vyžadujú |
readonly | Iba navigácia, kontrola a snímanie — klikanie a písanie sú vypnuté |
Čo agent dokáže#
- Otvárať karty, navigovať a zatvárať ich
- Skontrolovať stránku: viditeľné ovládacie prvky so stabilnými selektormi, stavom a sémantickými atribútmi
- Nájsť ovládacie prvky podľa viditeľného textu alebo identifikačných atribútov
- Klikať a vypĺňať formuláre (s podporou frameworkov, s overením pred/po)
- Skrolovať a snímať obrazovku, snímky sa vracajú do vášho chatu
Každá akcia hlási, čo sa skutočne stalo — vrátane toho, či kliknutie naozaj niečo zmenilo — takže agent overuje namiesto hádania.
Bezpečnostný model#
- Iba loopback — rozšírenie sa pripája výhradne k lokálnym adresám, ktoré nakonfigurujete.
- Jednorazové párovacie kódy — kódy vypršia po 5 minútach a platia iba raz; výsledné prihlasovacie údaje nikdy neopustia váš Mac.
- Expirácia príkazov — príkazy, ktoré si rozšírenie nevyzdvihlo do 20 sekúnd, sa zahodia, takže nič sa nevykoná oneskorene.
- Kľúče držíte vy — platby a deštruktívne akcie vždy vyžadujú vaše výslovné potvrdenie, na každej úrovni oprávnení, ktorá povoľuje klikanie.
- Auditovateľné — JavaScript rozšírenia sa dodáva v čitateľnej podobe vo vnútri balíka aplikácie.
Stiahnutie#
Rozšírenie je súčasťou Agent Servera (assets/safari/PocketHook-Safari.zip), alebo si ho stiahnite priamo: PocketHook-Safari.zip — podpísané a notarizované pre macOS.