Mi az a PocketHook Safari-bővítmény?#
Egy macOS-es Safari-bővítmény, amely lehetővé teszi, hogy a saját üzemeltetésű Agent Server a valódi böngésződben dolgozzon: lapokat nyit és zár be, oldalakat olvas, vezérlőket keres meg és kattint rájuk, űrlapokat tölt ki és képernyőképeket készít — a te munkameneteidben, a te bejelentkezéseiddel, a te gépeden.
Minden helyben fut. A bővítmény kizárólag a saját Maceden futó Agent Serverrel kommunikál (loopback), és semmi nem kerül elküldésre máshová.
Telepítés#
A bővítmény az Agent Serverrel együtt érkezik, közjegyzőileg hitelesített (notarized) macOS appként — se App Store, se Xcode:
bun run safari:install
Ez telepíti a Pockethook Safari.app-ot az /Applications mappába, és elindítja. Ezután a Safariban:
- Beállítások → Bővítmények — engedélyezd a PocketHook Safari bővítményt, és adj hozzáférést a webhelyekhez.
- Generálj egyszer használatos párosítókódot a szerveren:
bun run safari:code
- Nyisd meg a bővítmény felugró ablakát a Safari eszköztárán, írd be a kódot, és nyomd meg a Pair gombot. A zöld pont azt jelenti, hogy csatlakozva vagy.
A kapcsolatot bármikor ellenőrizheted a bun run safari:status paranccsal.
Jogosultsági szintek#
Te döntöd el, mennyi autonómiát kap az agent, szerverenként, a bun run safari:config paranccsal:
| Szint | Mit jelent |
|---|---|
confirm (alapértelmezett) | Minden külső hatással járó kattintás (szavazás, beküldés, közzététel, vásárlás…) először tőled kérdez |
autonomous | A szavazások, követések és beküldések kérdezés nélkül futnak; a fizetések, végleges törlések, valamint a fiók- vagy biztonsági változtatások továbbra is rákérdeznek |
readonly | Csak navigálás, vizsgálat és rögzítés — a kattintás és a gépelés le van tiltva |
Mire képes az agent#
- Lapok megnyitása, navigálás és bezárás
- Oldal vizsgálata: látható vezérlők stabil szelektorokkal, állapottal és szemantikus attribútumokkal
- Vezérlők megtalálása a látható szövegük vagy azonosító attribútumaik alapján
- Kattintás és űrlapkitöltés (framework-tudatosan, előtte/utána ellenőrzéssel)
- Görgetés és képernyőképek készítése, amelyek visszakerülnek a chatedbe
Minden művelet jelenti, hogy valójában mi történt — beleértve azt is, hogy egy kattintás tényleg megváltoztatott-e valamit — így az agent ellenőriz, nem pedig találgat.
Biztonsági modell#
- Csak loopback — a bővítmény kizárólag az általad konfigurált helyi címekhez csatlakozik.
- Egyszer használatos párosítókódok — a kódok 5 perc után lejárnak és csak egyszer használhatók; a létrejövő hitelesítő adat soha nem hagyja el a Macedet.
- Parancsok lejárata — azok a parancsok, amelyeket a bővítmény 20 másodpercen belül nem vesz fel, eldobásra kerülnek, így semmi nem fut le megkésve.
- A kulcsok nálad vannak — a fizetések és a romboló műveletek mindig a te kifejezett megerősítésedet igénylik, minden olyan jogosultsági szinten, amely engedélyezi a kattintást.
- Auditálható — a bővítmény JavaScript-je olvasható formában érkezik az app csomagjában.
Letöltés#
A bővítmény az Agent Serverrel együtt érkezik (assets/safari/PocketHook-Safari.zip), vagy töltsd le közvetlenül: PocketHook-Safari.zip — aláírva és közjegyzőileg hitelesítve macOS-re.