PocketHook Safari एक्सटेंशन क्या है?#
macOS के लिए एक Safari एक्सटेंशन जो आपके सेल्फ-होस्टेड Agent Server को आपके असली ब्राउज़र के अंदर काम करने देता है: टैब खोलना और बंद करना, पेज पढ़ना, कंट्रोल्स ढूंढना और क्लिक करना, फ़ॉर्म भरना और स्क्रीनशॉट लेना — आपके सेशन में, आपके लॉगिन के साथ, आपकी मशीन पर।
सब कुछ लोकल चलता है। एक्सटेंशन केवल आपके अपने Mac पर मौजूद Agent Server से बात करता है (loopback), और कुछ भी कहीं और नहीं भेजा जाता।
इंस्टॉल#
एक्सटेंशन Agent Server के साथ एक नोटराइज़्ड macOS ऐप के रूप में आता है — न App Store, न Xcode:
bun run safari:install
यह Pockethook Safari.app को /Applications में इंस्टॉल करके लॉन्च कर देता है। फिर, Safari में:
- Settings → Extensions — PocketHook Safari को सक्षम करें और वेबसाइट एक्सेस दें।
- सर्वर पर एक बार इस्तेमाल होने वाला पेयरिंग कोड जनरेट करें:
bun run safari:code
- Safari के टूलबार में एक्सटेंशन का पॉपअप खोलें, कोड दर्ज करें, और Pair दबाएं। हरा बिंदु दिखे तो आप कनेक्टेड हैं।
कनेक्शन कभी भी bun run safari:status से जांच सकते हैं।
अनुमति स्तर#
एजेंट को कितनी स्वायत्तता मिलेगी, यह आप प्रति-सर्वर तय करते हैं, bun run safari:config के साथ:
| स्तर | इसका मतलब |
|---|---|
confirm (डिफ़ॉल्ट) | बाहरी प्रभाव वाला हर क्लिक (वोट, सबमिट, पब्लिश, खरीदारी…) पहले आपसे पूछता है |
autonomous | वोट, फ़ॉलो और सबमिट बिना पूछे चलते हैं; भुगतान, स्थायी डिलीट, और अकाउंट या सुरक्षा से जुड़े बदलाव अब भी पूछते हैं |
readonly | केवल नेविगेट, इंस्पेक्ट और कैप्चर — क्लिक करना और टाइप करना अक्षम हैं |
एजेंट क्या-क्या कर सकता है#
- टैब खोलना, नेविगेट करना और बंद करना
- पेज इंस्पेक्ट करना: स्थिर सेलेक्टर्स, स्टेट और सिमेंटिक एट्रिब्यूट्स के साथ दिखाई देने वाले कंट्रोल्स
- कंट्रोल्स को उनके दिखाई देने वाले टेक्स्ट या पहचान वाले एट्रिब्यूट्स से ढूंढना
- क्लिक करना और फ़ॉर्म भरना (फ़्रेमवर्क-अवेयर, पहले/बाद के सत्यापन के साथ)
- स्क्रॉल करना और स्क्रीनशॉट लेना, जो वापस आपकी चैट में पहुंचते हैं
हर एक्शन रिपोर्ट करता है कि वास्तव में क्या हुआ — इसमें यह भी शामिल है कि किसी क्लिक ने सच में कुछ बदला या नहीं — ताकि एजेंट अनुमान लगाने के बजाय सत्यापित करे।
सुरक्षा मॉडल#
- केवल loopback — एक्सटेंशन विशेष रूप से आपके कॉन्फ़िगर किए गए लोकल एड्रेस से ही कनेक्ट होता है।
- एक बार वाले पेयरिंग कोड — कोड 5 मिनट में समाप्त हो जाते हैं और केवल एक बार काम करते हैं; परिणामी क्रेडेंशियल कभी आपके Mac से बाहर नहीं जाता।
- कमांड की समयसीमा — जो कमांड एक्सटेंशन 20 सेकंड के भीतर नहीं उठाता, वे रद्द कर दी जाती हैं, इसलिए कुछ भी देर से नहीं चलता।
- चाबियां आपके पास हैं — भुगतान और विनाशकारी कार्यों के लिए हमेशा आपकी स्पष्ट पुष्टि चाहिए, हर उस अनुमति स्तर पर जहां क्लिक करने की अनुमति है।
- ऑडिट योग्य — एक्सटेंशन का JavaScript ऐप बंडल के अंदर पढ़ने योग्य रूप में आता है।
डाउनलोड#
एक्सटेंशन Agent Server के साथ बंडल है (assets/safari/PocketHook-Safari.zip), या इसे सीधे डाउनलोड करें: PocketHook-Safari.zip — macOS के लिए साइन्ड और नोटराइज़्ड।