التخطى الى المحتوى الأساسى
  1. التوثيق/

ملحق Safari

ما هو ملحق Safari من PocketHook؟
#

ملحق Safari لنظام macOS يتيح لخادم Agent Server المستضاف ذاتياً لديك العمل داخل متصفحك الحقيقي: فتح علامات التبويب وإغلاقها، قراءة الصفحات، العثور على عناصر التحكم والنقر عليها، ملء النماذج، والتقاط لقطات شاشة — في جلستك، بتسجيلات دخولك، على جهازك.

كل شيء يعمل محلياً. الملحق يتواصل فقط مع Agent Server على جهاز Mac الخاص بك (loopback)، ولا يُرسل أي شيء إلى أي مكان آخر.

التثبيت
#

يأتي الملحق مع Agent Server كتطبيق macOS موثّق (notarized) — بدون App Store وبدون Xcode:

bun run safari:install

هذا يثبّت Pockethook Safari.app في /Applications ويشغّله. بعد ذلك، في Safari:

  1. الإعدادات ← الملحقات — فعّل PocketHook Safari وامنحه صلاحية الوصول إلى مواقع الويب.
  2. أنشئ رمز اقتران لمرة واحدة على الخادم:
bun run safari:code
  1. افتح النافذة المنبثقة للملحق في شريط أدوات 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.