Co je rozšíření PocketHook pro Safari?#
Rozšíření Safari pro macOS, které umožňuje vašemu vlastnímu Agent Serveru pracovat přímo ve vašem skutečném prohlížeči: otevírat a zavírat panely, číst stránky, hledat ovládací prvky a klikat na ně, vyplňovat formuláře a pořizovat snímky obrazovky — ve vaší relaci, s vašimi přihlášeními, na vašem počítači.
Vše běží lokálně. Rozšíření komunikuje pouze s Agent Serverem na vašem vlastním Macu (loopback) a nic se nikam jinam neodesílá.
Instalace#
Rozšíření se dodává s Agent Serverem jako notarizovaná aplikace pro macOS — bez App Store, bez Xcode:
bun run safari:install
Tím se nainstaluje Pockethook Safari.app do /Applications a aplikace se spustí. Poté v Safari:
- Nastavení → Rozšíření — povolte PocketHook Safari a udělte přístup k webovým stránkám.
- Vygenerujte na serveru jednorázový párovací kód:
bun run safari:code
- Otevřete popup rozšíření v panelu nástrojů Safari, zadejte kód a stiskněte Pair. Zelená tečka znamená, že jste připojeni.
Připojení můžete kdykoli ověřit pomocí bun run safari:status.
Úrovně oprávnění#
Sami rozhodujete, kolik autonomie agent dostane, pro každý server zvlášť, pomocí bun run safari:config:
| Úroveň | Co znamená |
|---|---|
confirm (výchozí) | Každé kliknutí s vnějšími účinky (hlasování, odeslání, publikování, nákup…) se vás nejprve zeptá |
autonomous | Hlasování, sledování a odeslání proběhnou bez ptaní; platby, trvalá mazání a změny účtu nebo zabezpečení se stále ptají |
readonly | Pouze navigace, prohlížení a snímání — klikání a psaní jsou zakázány |
Co agent umí#
- Otevírat panely, procházet je a zavírat
- Prohlédnout stránku: viditelné ovládací prvky se stabilními selektory, stavem a sémantickými atributy
- Najít ovládací prvky podle viditelného textu nebo identifikačních atributů
- Klikat a vyplňovat formuláře (s ohledem na frameworky, s ověřením před/po)
- Posouvat stránku a pořizovat snímky obrazovky, které se vracejí do vašeho chatu
Každá akce hlásí, co se skutečně stalo — včetně toho, zda kliknutí opravdu něco změnilo — takže agent ověřuje, místo aby hádal.
Model zabezpečení#
- Pouze loopback — rozšíření se připojuje výhradně k lokálním adresám, které nakonfigurujete.
- Jednorázové párovací kódy — kódy vyprší po 5 minutách a lze je použít jen jednou; výsledné přihlašovací údaje nikdy neopustí váš Mac.
- Expirace příkazů — příkazy, které si rozšíření nevyzvedne do 20 sekund, se zahodí, takže se nic nespustí opožděně.
- Klíče držíte vy — platby a destruktivní akce vždy vyžadují vaše výslovné potvrzení, na každé úrovni oprávnění, která umožňuje klikání.
- Auditovatelné — JavaScript rozšíření je v balíčku aplikace dodáván v čitelné podobě.
Stažení#
Rozšíření je přibaleno k Agent Serveru (assets/safari/PocketHook-Safari.zip), nebo si ho stáhněte přímo: PocketHook-Safari.zip — podepsané a notarizované pro macOS.