Gå til hovedindhold
  1. Dokumentation/

Safari-udvidelse

Hvad er PocketHook Safari-udvidelsen?
#

En Safari-udvidelse til macOS, der lader din selvhostede Agent Server arbejde inde i din rigtige browser: åbne og lukke faner, læse sider, finde og klikke på kontroller, udfylde formularer og tage skærmbilleder — i din session, med dine logins, på din maskine.

Alt kører lokalt. Udvidelsen taler kun med Agent Server på din egen Mac (loopback), og intet sendes andre steder hen.

Installation
#

Udvidelsen leveres sammen med Agent Server som en notariseret macOS-app — ingen App Store, ingen Xcode:

bun run safari:install

Dette installerer Pockethook Safari.app i /Applications og starter den. Derefter, i Safari:

  1. Indstillinger → Udvidelser — aktivér PocketHook Safari og giv adgang til websteder.
  2. Generér en engangsparringskode på serveren:
bun run safari:code
  1. Åbn udvidelsens popup i Safaris værktøjslinje, indtast koden og tryk på Pair. En grøn prik betyder, at du er forbundet.

Tjek forbindelsen når som helst med bun run safari:status.

Tilladelsesniveauer
#

Du bestemmer, hvor meget autonomi agenten får, per server, med bun run safari:config:

NiveauHvad det betyder
confirm (standard)Hvert klik med eksterne effekter (stem, indsend, udgiv, køb…) spørger dig først
autonomousStemmer, follows og indsendelser kører uden at spørge; betalinger, permanente sletninger og ændringer af konto eller sikkerhed spørger stadig
readonlyKun navigation, inspektion og skærmbilleder — klik og indtastning er deaktiveret

Hvad agenten kan
#

  • Åbne, navigere i og lukke faner
  • Inspicere en side: synlige kontroller med stabile selektorer, tilstand og semantiske attributter
  • Finde kontroller ud fra deres synlige tekst eller identificerende attributter
  • Klikke og udfylde formularer (framework-bevidst, med verifikation før/efter)
  • Scrolle og tage skærmbilleder, der sendes tilbage til din chat

Hver handling rapporterer, hvad der faktisk skete — inklusive om et klik virkelig ændrede noget — så agenten verificerer i stedet for at gætte.

Sikkerhedsmodel
#

  • Kun loopback — udvidelsen forbinder udelukkende til lokale adresser, som du konfigurerer.
  • Engangsparringskoder — koder udløber efter 5 minutter og kan kun bruges én gang; den resulterende legitimation forlader aldrig din Mac.
  • Kommandoudløb — kommandoer, som udvidelsen ikke har hentet inden for 20 sekunder, kasseres, så intet udføres for sent.
  • Du har nøglerne — betalinger og destruktive handlinger kræver altid din eksplicitte bekræftelse, på alle tilladelsesniveauer der tillader klik.
  • Auditerbar — udvidelsens JavaScript leveres læsbart inde i app-bundtet.

Download
#

Udvidelsen følger med Agent Server (assets/safari/PocketHook-Safari.zip), eller hent den direkte: PocketHook-Safari.zip — signeret og notariseret til macOS.