Ce este extensia Safari PocketHook?#
O extensie Safari pentru macOS care permite Agent Server-ului tău auto-găzduit să lucreze în browserul tău real: să deschidă și să închidă taburi, să citească pagini, să găsească și să apese controale, să completeze formulare și să facă capturi de ecran — în sesiunea ta, cu autentificările tale, pe mașina ta.
Totul rulează local. Extensia comunică doar cu Agent Server-ul de pe propriul tău Mac (loopback), și nimic nu este trimis în altă parte.
Instalare#
Extensia vine împreună cu Agent Server ca aplicație macOS notarizată — fără App Store, fără Xcode:
bun run safari:install
Aceasta instalează Pockethook Safari.app în /Applications și o lansează. Apoi, în Safari:
- Configurări → Extensii — activează PocketHook Safari și acordă acces la site-uri web.
- Generează un cod de împerechere de unică folosință pe server:
bun run safari:code
- Deschide popup-ul extensiei în bara de instrumente Safari, introdu codul și apasă Pair. Un punct verde înseamnă că ești conectat.
Verifică conexiunea oricând cu bun run safari:status.
Niveluri de permisiune#
Tu decizi câtă autonomie primește agentul, per server, cu bun run safari:config:
| Nivel | Ce înseamnă |
|---|---|
confirm (implicit) | Fiecare clic cu efecte externe (vot, trimitere, publicare, cumpărare…) îți cere mai întâi confirmarea |
autonomous | Voturile, follow-urile și trimiterile rulează fără să întrebe; plățile, ștergerile permanente și modificările de cont sau de securitate cer în continuare confirmare |
readonly | Doar navigare, inspectare și capturare — clicurile și tastarea sunt dezactivate |
Ce poate face agentul#
- Deschide, navighează și închide taburi
- Inspectează o pagină: controale vizibile cu selectori stabili, stare și atribute semantice
- Găsește controale după textul lor vizibil sau după atributele care le identifică
- Dă clic și completează formulare (compatibil cu framework-uri, cu verificare înainte/după)
- Derulează și face capturi de ecran, livrate înapoi în chatul tău
Fiecare acțiune raportează ce s-a întâmplat cu adevărat — inclusiv dacă un clic a schimbat într-adevăr ceva — astfel încât agentul verifică în loc să ghicească.
Model de securitate#
- Doar loopback — extensia se conectează exclusiv la adresele locale pe care le configurezi tu.
- Coduri de împerechere de unică folosință — codurile expiră după 5 minute și pot fi folosite o singură dată; credențialul rezultat nu părăsește niciodată Mac-ul tău.
- Expirarea comenzilor — comenzile pe care extensia nu le-a preluat în 20 de secunde sunt eliminate, așa că nimic nu se execută cu întârziere.
- Cheile sunt la tine — plățile și acțiunile distructive necesită întotdeauna confirmarea ta explicită, la fiecare nivel de permisiune care permite clicuri.
- Auditabilă — JavaScript-ul extensiei este livrat lizibil în pachetul aplicației.
Descărcare#
Extensia vine împreună cu Agent Server (assets/safari/PocketHook-Safari.zip), sau descarc-o direct: PocketHook-Safari.zip — semnată și notarizată pentru macOS.