Apa itu Sambungan Safari PocketHook?#
Sambungan Safari untuk macOS yang membolehkan Agent Server hos sendiri anda bekerja di dalam pelayar sebenar anda: membuka dan menutup tab, membaca halaman, mencari dan mengklik kawalan, mengisi borang, dan mengambil tangkapan skrin — dalam sesi anda, dengan log masuk anda, pada mesin anda.
Semuanya berjalan secara tempatan. Sambungan ini hanya berkomunikasi dengan Agent Server pada Mac anda sendiri (loopback), dan tiada apa-apa dihantar ke mana-mana tempat lain.
Pemasangan#
Sambungan ini disertakan bersama Agent Server sebagai aplikasi macOS yang dinotarisasi — tanpa App Store, tanpa Xcode:
bun run safari:install
Ini memasang Pockethook Safari.app ke dalam /Applications dan melancarkannya. Kemudian, dalam Safari:
- Tetapan → Sambungan — dayakan PocketHook Safari dan berikan akses laman web.
- Jana kod penggandingan sekali guna pada pelayan:
bun run safari:code
- Buka popup sambungan pada bar alat Safari, masukkan kod, dan tekan Pair. Titik hijau bermaksud anda sudah bersambung.
Semak sambungan pada bila-bila masa dengan bun run safari:status.
Tahap kebenaran#
Anda yang menentukan berapa banyak autonomi yang diberikan kepada agent, bagi setiap pelayan, dengan bun run safari:config:
| Tahap | Maksudnya |
|---|---|
confirm (lalai) | Setiap klik dengan kesan luaran (undi, hantar, terbit, beli…) meminta pengesahan anda terlebih dahulu |
autonomous | Undian, follow, dan penghantaran berjalan tanpa bertanya; pembayaran, pemadaman kekal, dan perubahan akaun atau keselamatan masih meminta kebenaran |
readonly | Hanya navigasi, pemeriksaan, dan tangkapan — klik dan menaip dinyahdayakan |
Apa yang boleh dilakukan oleh agent#
- Membuka, menavigasi, dan menutup tab
- Memeriksa halaman: kawalan yang kelihatan dengan pemilih stabil, keadaan, dan atribut semantik
- Mencari kawalan melalui teks yang kelihatan atau atribut pengenalan
- Klik dan mengisi borang (memahami framework, dengan pengesahan sebelum/selepas)
- Menatal dan mengambil tangkapan skrin, yang dihantar kembali ke sembang anda
Setiap tindakan melaporkan apa yang sebenarnya berlaku — termasuk sama ada klik benar-benar mengubah sesuatu — supaya agent mengesahkan dan bukannya meneka.
Model keselamatan#
- Loopback sahaja — sambungan ini hanya bersambung ke alamat tempatan yang anda konfigurasikan.
- Kod penggandingan sekali guna — kod tamat tempoh selepas 5 minit dan hanya sah sekali; kelayakan yang terhasil tidak pernah meninggalkan Mac anda.
- Tamat tempoh perintah — perintah yang tidak diambil oleh sambungan dalam masa 20 saat akan dibuang, jadi tiada apa-apa yang dilaksanakan lewat.
- Kunci di tangan anda — pembayaran dan tindakan yang memusnahkan sentiasa memerlukan pengesahan eksplisit anda, pada setiap tahap kebenaran yang membenarkan klik.
- Boleh diaudit — JavaScript sambungan ini dihantar dalam bentuk boleh dibaca di dalam bundle aplikasi.
Muat turun#
Sambungan ini disertakan bersama Agent Server (assets/safari/PocketHook-Safari.zip), atau dapatkannya terus: PocketHook-Safari.zip — ditandatangani dan dinotarisasi untuk macOS.