Mikä on PocketHookin Safari-laajennus?#
macOS:n Safari-laajennus, jonka avulla itse isännöimäsi Agent Server voi työskennellä oikeassa selaimessasi: avata ja sulkea välilehtiä, lukea sivuja, etsiä ja klikata kontrolleja, täyttää lomakkeita ja ottaa kuvakaappauksia — sinun istunnossasi, sinun kirjautumisillasi, sinun koneellasi.
Kaikki toimii paikallisesti. Laajennus keskustelee vain oman Macisi Agent Serverin kanssa (loopback), eikä mitään lähetetä minnekään muualle.
Asennus#
Laajennus toimitetaan Agent Serverin mukana notarisoituna macOS-sovelluksena — ei App Storea, ei Xcodea:
bun run safari:install
Tämä asentaa Pockethook Safari.app -sovelluksen kansioon /Applications ja käynnistää sen. Sen jälkeen Safarissa:
- Asetukset → Laajennukset — ota PocketHook Safari käyttöön ja myönnä pääsy verkkosivustoille.
- Luo kertakäyttöinen parituskoodi palvelimella:
bun run safari:code
- Avaa laajennuksen ponnahdusikkuna Safarin työkalupalkista, syötä koodi ja paina Pair. Vihreä piste tarkoittaa, että yhteys on muodostettu.
Tarkista yhteys milloin tahansa komennolla bun run safari:status.
Oikeustasot#
Sinä päätät, kuinka paljon autonomiaa agentti saa, palvelinkohtaisesti, komennolla bun run safari:config:
| Taso | Mitä se tarkoittaa |
|---|---|
confirm (oletus) | Jokainen klikkaus, jolla on ulkoisia vaikutuksia (äänestys, lähetys, julkaisu, ostos…), kysyy sinulta ensin |
autonomous | Äänestykset, seuraamiset ja lähetykset suoritetaan kysymättä; maksut, pysyvät poistot sekä tili- tai turvallisuusmuutokset kysyvät edelleen |
readonly | Vain navigointi, tutkiminen ja kuvakaappaukset — klikkaaminen ja kirjoittaminen on estetty |
Mitä agentti voi tehdä#
- Avata, selata ja sulkea välilehtiä
- Tutkia sivun: näkyvät kontrollit vakailla selektoreilla, tilalla ja semanttisilla attribuuteilla
- Löytää kontrollit niiden näkyvän tekstin tai tunnistavien attribuuttien perusteella
- Klikata ja täyttää lomakkeita (framework-tietoisesti, ennen/jälkeen-varmennuksella)
- Vierittää sivua ja ottaa kuvakaappauksia, jotka palautetaan chattiisi
Jokainen toiminto raportoi, mitä oikeasti tapahtui — myös sen, muuttiko klikkaus todella jotain — joten agentti varmentaa arvaamisen sijaan.
Turvallisuusmalli#
- Vain loopback — laajennus yhdistää yksinomaan määrittämiisi paikallisiin osoitteisiin.
- Kertakäyttöiset parituskoodit — koodit vanhenevat 5 minuutissa ja kelpaavat vain kerran; syntyvä tunniste ei koskaan poistu Macistasi.
- Komentojen vanheneminen — komennot, joita laajennus ei nouda 20 sekunnin kuluessa, hylätään, joten mitään ei suoriteta myöhässä.
- Avaimet ovat sinulla — maksut ja tuhoavat toiminnot vaativat aina nimenomaisen vahvistuksesi, jokaisella klikkaamisen sallivalla oikeustasolla.
- Auditoitavissa — laajennuksen JavaScript toimitetaan luettavassa muodossa sovelluspaketin sisällä.
Lataus#
Laajennus tulee Agent Serverin mukana (assets/safari/PocketHook-Safari.zip), tai lataa se suoraan: PocketHook-Safari.zip — allekirjoitettu ja notarisoitu macOS:lle.