Što je PocketHook Safari proširenje?#
Safari proširenje za macOS koje omogućuje vašem samostalno hostiranom Agent Serveru da radi unutar vašeg pravog preglednika: otvara i zatvara kartice, čita stranice, pronalazi i klika kontrole, ispunjava obrasce i snima zaslone — u vašoj sesiji, s vašim prijavama, na vašem računalu.
Sve radi lokalno. Proširenje komunicira samo s Agent Serverom na vašem vlastitom Macu (loopback), i ništa se ne šalje nikamo drugamo.
Instalacija#
Proširenje dolazi uz Agent Server kao notarizirana macOS aplikacija — bez App Storea, bez Xcodea:
bun run safari:install
Ovo instalira Pockethook Safari.app u /Applications i pokreće je. Zatim, u Safariju:
- Postavke → Proširenja — uključite PocketHook Safari i odobrite pristup web stranicama.
- Generirajte jednokratni kod za uparivanje na poslužitelju:
bun run safari:code
- Otvorite popup proširenja u alatnoj traci Safarija, unesite kod i pritisnite Pair. Zelena točka znači da ste povezani.
Provjerite vezu bilo kada s bun run safari:status.
Razine dozvola#
Vi odlučujete koliko autonomije agent dobiva, po poslužitelju, s bun run safari:config:
| Razina | Što znači |
|---|---|
confirm (zadano) | Svaki klik s vanjskim učincima (glasanje, slanje, objava, kupnja…) prvo traži vašu potvrdu |
autonomous | Glasovi, praćenja i slanja izvršavaju se bez pitanja; plaćanja, trajna brisanja te promjene računa ili sigurnosti i dalje traže potvrdu |
readonly | Samo navigacija, pregled i snimanje — klikanje i tipkanje su onemogućeni |
Što agent može raditi#
- Otvarati kartice, navigirati njima i zatvarati ih
- Pregledati stranicu: vidljive kontrole sa stabilnim selektorima, stanjem i semantičkim atributima
- Pronaći kontrole prema njihovom vidljivom tekstu ili identificirajućim atributima
- Klikati i ispunjavati obrasce (svjesno frameworka, s provjerom prije/poslije)
- Skrolati i snimati zaslone, koji se vraćaju u vaš chat
Svaka akcija izvještava o tome što se stvarno dogodilo — uključujući je li klik zaista nešto promijenio — pa agent provjerava umjesto da nagađa.
Sigurnosni model#
- Samo loopback — proširenje se povezuje isključivo na lokalne adrese koje vi konfigurirate.
- Jednokratni kodovi za uparivanje — kodovi istječu nakon 5 minuta i vrijede samo jednom; dobivena vjerodajnica nikada ne napušta vaš Mac.
- Istek naredbi — naredbe koje proširenje ne preuzme unutar 20 sekundi se odbacuju, pa se ništa ne izvršava sa zakašnjenjem.
- Ključevi su kod vas — plaćanja i destruktivne radnje uvijek zahtijevaju vašu izričitu potvrdu, na svakoj razini dozvola koja dopušta klikanje.
- Provjerljivo — JavaScript proširenja isporučuje se čitljiv unutar paketa aplikacije.
Preuzimanje#
Proširenje dolazi u paketu s Agent Serverom (assets/safari/PocketHook-Safari.zip), ili ga preuzmite izravno: PocketHook-Safari.zip — potpisano i notarizirano za macOS.