Skip to main content
  1. Τεκμηρίωση/

Επέκταση Safari

Τι είναι η επέκταση Safari του PocketHook;
#

Μια επέκταση Safari για macOS που επιτρέπει στον αυτοφιλοξενούμενο Agent Server σας να δουλεύει μέσα στον πραγματικό σας browser: να ανοίγει και να κλείνει καρτέλες, να διαβάζει σελίδες, να βρίσκει και να πατά στοιχεία ελέγχου, να συμπληρώνει φόρμες και να τραβά στιγμιότυπα οθόνης — στη συνεδρία σας, με τις συνδέσεις σας, στο μηχάνημά σας.

Όλα τρέχουν τοπικά. Η επέκταση επικοινωνεί μόνο με τον Agent Server στον δικό σας Mac (loopback), και τίποτα δεν αποστέλλεται πουθενά αλλού.

Εγκατάσταση
#

Η επέκταση συνοδεύει τον Agent Server ως επικυρωμένη (notarized) εφαρμογή macOS — χωρίς App Store, χωρίς Xcode:

bun run safari:install

Αυτό εγκαθιστά το Pockethook Safari.app στο /Applications και το εκκινεί. Στη συνέχεια, στο Safari:

  1. Ρυθμίσεις → Επεκτάσεις — ενεργοποιήστε το PocketHook Safari και παραχωρήστε πρόσβαση σε ιστότοπους.
  2. Δημιουργήστε έναν κωδικό σύζευξης μίας χρήσης στον server:
bun run safari:code
  1. Ανοίξτε το popup της επέκτασης στη γραμμή εργαλείων του Safari, εισαγάγετε τον κωδικό και πατήστε Pair. Η πράσινη κουκκίδα σημαίνει ότι είστε συνδεδεμένοι.

Ελέγξτε τη σύνδεση οποιαδήποτε στιγμή με bun run safari:status.

Επίπεδα δικαιωμάτων
#

Εσείς αποφασίζετε πόση αυτονομία έχει ο agent, ανά server, με bun run safari:config:

ΕπίπεδοΤι σημαίνει
confirm (προεπιλογή)Κάθε κλικ με εξωτερικές συνέπειες (ψήφος, υποβολή, δημοσίευση, αγορά…) σας ρωτά πρώτα
autonomousΨήφοι, follows και υποβολές εκτελούνται χωρίς ερώτηση· οι πληρωμές, οι οριστικές διαγραφές και οι αλλαγές λογαριασμού ή ασφάλειας εξακολουθούν να ρωτούν
readonlyΜόνο πλοήγηση, επιθεώρηση και λήψη στιγμιοτύπων — το κλικ και η πληκτρολόγηση είναι απενεργοποιημένα

Τι μπορεί να κάνει ο agent
#

  • Να ανοίγει, να πλοηγείται και να κλείνει καρτέλες
  • Να επιθεωρεί μια σελίδα: ορατά στοιχεία ελέγχου με σταθερούς selectors, κατάσταση και σημασιολογικά χαρακτηριστικά
  • Να βρίσκει στοιχεία ελέγχου από το ορατό κείμενό τους ή τα αναγνωριστικά τους χαρακτηριστικά
  • Να κάνει κλικ και να συμπληρώνει φόρμες (με επίγνωση των frameworks, με επαλήθευση πριν/μετά)
  • Να κάνει scroll και να τραβά στιγμιότυπα οθόνης, που επιστρέφουν στη συνομιλία σας

Κάθε ενέργεια αναφέρει τι συνέβη πραγματικά — συμπεριλαμβανομένου του αν ένα κλικ άλλαξε όντως κάτι — ώστε ο agent να επαληθεύει αντί να μαντεύει.

Μοντέλο ασφαλείας
#

  • Μόνο loopback — η επέκταση συνδέεται αποκλειστικά σε τοπικές διευθύνσεις που ρυθμίζετε εσείς.
  • Κωδικοί σύζευξης μίας χρήσης — οι κωδικοί λήγουν μετά από 5 λεπτά και ισχύουν μόνο μία φορά· το διαπιστευτήριο που προκύπτει δεν φεύγει ποτέ από τον Mac σας.
  • Λήξη εντολών — οι εντολές που η επέκταση δεν παρέλαβε εντός 20 δευτερολέπτων απορρίπτονται, ώστε τίποτα να μην εκτελείται καθυστερημένα.
  • Τα κλειδιά τα κρατάτε εσείς — οι πληρωμές και οι καταστροφικές ενέργειες απαιτούν πάντα τη ρητή επιβεβαίωσή σας, σε κάθε επίπεδο δικαιωμάτων που επιτρέπει κλικ.
  • Ελέγξιμη — η JavaScript της επέκτασης παραδίδεται αναγνώσιμη μέσα στο πακέτο της εφαρμογής.

Λήψη
#

Η επέκταση συνοδεύει τον Agent Server (assets/safari/PocketHook-Safari.zip), ή κατεβάστε την απευθείας: PocketHook-Safari.zip — υπογεγραμμένη και επικυρωμένη για macOS.