PocketHook Safari Uzantısı Nedir?#
Kendi barındırdığınız Agent Server‘ın gerçek tarayıcınızın içinde çalışmasını sağlayan bir macOS Safari uzantısı: sekmeleri açıp kapatma, sayfaları okuma, kontrolleri bulup tıklama, formları doldurma ve ekran görüntüsü alma — sizin oturumunuzda, sizin girişlerinizle, sizin makinenizde.
Her şey yerel olarak çalışır. Uzantı yalnızca kendi Mac’inizdeki Agent Server ile konuşur (loopback) ve hiçbir şey başka bir yere gönderilmez.
Kurulum#
Uzantı, Agent Server ile birlikte noter onaylı (notarized) bir macOS uygulaması olarak gelir — App Store yok, Xcode yok:
bun run safari:install
Bu komut Pockethook Safari.app uygulamasını /Applications klasörüne kurar ve başlatır. Ardından Safari’de:
- Ayarlar → Uzantılar — PocketHook Safari‘yi etkinleştirin ve web sitesi erişimi verin.
- Sunucuda tek kullanımlık bir eşleştirme kodu oluşturun:
bun run safari:code
- Safari araç çubuğundaki uzantı açılır penceresini açın, kodu girin ve Pair düğmesine basın. Yeşil nokta bağlı olduğunuz anlamına gelir.
Bağlantıyı istediğiniz zaman bun run safari:status ile kontrol edin.
İzin düzeyleri#
Agent’ın ne kadar özerklik alacağına, sunucu bazında, bun run safari:config ile siz karar verirsiniz:
| Düzey | Anlamı |
|---|---|
confirm (varsayılan) | Dış etkileri olan her tıklama (oy verme, gönderme, yayınlama, satın alma…) önce size sorar |
autonomous | Oylar, takipler ve göndermeler sormadan çalışır; ödemeler, kalıcı silmeler ve hesap veya güvenlik değişiklikleri yine de sorar |
readonly | Yalnızca gezinme, inceleme ve yakalama — tıklama ve yazma devre dışıdır |
Agent neler yapabilir#
- Sekmeleri açma, gezinme ve kapatma
- Bir sayfayı inceleme: kararlı seçicilere, duruma ve semantik özniteliklere sahip görünür kontroller
- Kontrolleri görünür metinlerine veya tanımlayıcı özniteliklerine göre bulma
- Tıklama ve form doldurma (framework’lere duyarlı, öncesi/sonrası doğrulamalı)
- Kaydırma ve ekran görüntüsü alma, sohbetinize geri iletilir
Her eylem gerçekte ne olduğunu raporlar — bir tıklamanın gerçekten bir şeyi değiştirip değiştirmediği dahil — böylece agent tahmin etmek yerine doğrular.
Güvenlik modeli#
- Yalnızca loopback — uzantı, yalnızca sizin yapılandırdığınız yerel adreslere bağlanır.
- Tek kullanımlık eşleştirme kodları — kodlar 5 dakika sonra süresi dolar ve tek kullanımlıktır; oluşan kimlik bilgisi Mac’inizden asla ayrılmaz.
- Komut süresi dolması — uzantının 20 saniye içinde almadığı komutlar atılır, böylece hiçbir şey gecikmeli olarak çalışmaz.
- Anahtarlar sizde — ödemeler ve yıkıcı eylemler, tıklamaya izin veren her izin düzeyinde daima açık onayınızı gerektirir.
- Denetlenebilir — uzantının JavaScript’i uygulama paketi içinde okunabilir halde gelir.
İndirme#
Uzantı Agent Server ile birlikte gelir (assets/safari/PocketHook-Safari.zip) veya doğrudan indirin: PocketHook-Safari.zip — macOS için imzalı ve noter onaylı.