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

مرجع الإعدادات

محتوى المقال

المزامنة
#

يزامن PocketHook محادثاتك وإعدادات التطبيق بين أجهزتك باستخدام حساب iCloud الخاص بك — دون حساب PocketHook، ودون أي خادم طرف ثالث.

يتطلبتسجيل الدخول إلى iCloud، وتفعيل iCloud Drive
ما الذي يُزامَنالمحادثات، وتكوين الخادم، ومعظم الإعدادات
ما الذي لا يُزامَنبعض الإعدادات مخصصة عمداً لكل جهاز على حدة — راجع فتح عناوين URL تلقائيًا أدناه

سجّل الدخول بنفس حساب iCloud على iPhone وiPad وMac وسيظهر كل شيء تلقائياً — دون الحاجة لأي إعداد. تبقى بياناتك في قاعدة بيانات iCloud الخاصة بك؛ خوادم PocketHook لا تراها أبداً.

تكوين الخادم
#

إعدادات الاتصال الأساسية بخادم PocketHook الخاص بك.

عنوان URL للخادم
#

النوعحقل نصي (URL)
الافتراضيفارغ
يُخزَّن فيiOS Keychain

نقطة النهاية HTTPS التي يرسل إليها PocketHook رسائل الدردشة الخاصة بك. تُقبل عناوين HTTPS فقط — ويُرفض HTTP لأسباب أمنية. هذه هي نقطة النهاية الرئيسية التي يستمع عليها خادمك.

رمز المصادقة
#

النوعحقل نصي آمن
الافتراضيفارغ
الطول10–1,000 حرف
يُخزَّن فيiOS Keychain

رمز Bearer يُرسل في ترويسة Authorization مع كل طلب. يمكن لخادمك استخدامه للتحقق من أن الطلبات قادمة من جهازك. يُخزَّن بأمان في iOS Keychain — وليس كنص عادي أبدًا.

متوافق مع OpenClaw
#

النوعمفتاح تبديل
الافتراضيOFF

فعّله إذا كان خادمك يستخدم منصة OpenClaw أو أي واجهة API متوافقة مع OpenAI Chat Completions. عند تفعيله، يرسل PocketHook الرسائل بتنسيق دردشة OpenAI ويحلل علامات الاختصارات المضمّنة ([SHORTCUT:name]، [DATA:{...}]، [URL:...]) من الاستجابة. وتُضمَّن ترويسة x-openclaw-agent-id مع الطلبات.

اختبار الاتصال
#

زر يرسل طلب اختبار إلى خادمك المكوَّن. يعرض:

  • زمن الاستجابة بالمللي ثانية
  • نتيجة فحص Health Check (إذا كان مفعّلاً)
  • تفاصيل الخطأ إذا فشل الاتصال

استخدمه بعد تغيير عنوان URL للخادم أو رمز المصادقة للتحقق من أن كل شيء يعمل.


الشبكة
#

اضبط سلوك المهلات لأنواع العمليات المختلفة.

مهلة الطلب
#

النوعStepper ‏(±5 ثوانٍ)
الافتراضي5 ثوانٍ
النطاق1–600 ثانية

المدة التي ينتظرها PocketHook حتى يبدأ الخادم في الرد على الطلب. إذا كان خادمك يقوم بمعالجة ثقيلة (مثل استدعاء نموذج ذكاء اصطناعي)، فارفع هذه القيمة. لخوادم webhook البسيطة، القيمة الافتراضية البالغة 5 ثوانٍ كافية عادةً.

مهلة المورد
#

النوعStepper ‏(±10 ثوانٍ)
الافتراضي60 ثانية
النطاق30–600 ثانية

الحد الأقصى للوقت حتى تكتمل الاستجابة بأكملها، بما في ذلك نقل البيانات. يجب أن تكون هذه القيمة أعلى من مهلة الطلب. ارفعها إذا كان خادمك يعيد حمولات كبيرة أو كانت سرعات الرفع لديه بطيئة.

Health Check
#

النوعمفتاح تبديل
الافتراضيOFF

فعّل مراقبة سلامة الخادم. عند التفعيل، يرسل PocketHook طلب GET إلى عنوان URL الخاص بـ Health Check أثناء اختبارات الاتصال ويعرض ما إذا كان خادمك يبلّغ بأنه سليم.

عنوان URL للـ Health Check
#

النوعحقل نصي (URL)
الافتراضيفارغ
يظهر عندمايكون Health Check مفعّلاً (ON)

نقطة نهاية HTTPS منفصلة تعيد نصًا عاديًا true أو false. يُستعلم عن هذا العنوان أثناء اختبارات الاتصال للتحقق من أن خادمك يعمل. مفيد عندما تكون نقطة نهاية API الرئيسية لديك خلف مصادقة لكنك تريد فحص حالة بسيطًا.


الأتمتة
#

تحكّم في كيفية تنفيذ PocketHook لاختصارات iOS المُشغّلة من استجابات الخادم.

اختصارات iOS
#

النوعمفتاح تبديل
الافتراضيON

مفتاح التبديل الرئيسي لتنفيذ الاختصارات. عندما يكون OFF، يستمر PocketHook في عرض رسائل الخادم لكنه يتجاهل أي حقول shortcut في الاستجابات. مفيد لتصحيح الأخطاء أو لتعطيل الأتمتة مؤقتًا.

التأخير بين الاختصارات
#

النوعشريط تمرير
الافتراضي2.0 ثانية
النطاق0.5–10.0 ثوانٍ

وقت الانتظار بين تنفيذ الاختصارات المتتالية عندما يعيد الخادم عدة أتمتات في استجابة واحدة. ارفع هذه القيمة إذا كانت اختصاراتك تعتمد على بعضها البعض (مثلاً، الاختصار الأول ينشئ ملفًا يقرأه الثاني).

مهلة الاختصار
#

النوعمنتقٍ مقسّم
الافتراضي5 دقائق (300s)
الخيارات30s، 1 min، 2 min، 5 min

الحد الأقصى لانتظار انتهاء كل اختصار على حدة قبل أن يعتبره PocketHook متجاوزًا للمهلة. الاختصارات طويلة التشغيل (مثل تلك التي تعالج وسائط أو تجري عدة استدعاءات API) قد تحتاج الدقائق الخمس كاملة.


الواجهة الشخصية
#

ضمّن واجهة ويب مخصصة مباشرة داخل PocketHook.

الواجهة الشخصية
#

النوعمفتاح تبديل
الافتراضيOFF

اعرض تبويبًا مخصصًا مع عرض ويب مضمّن. عند التفعيل، يظهر تبويب جديد في التنقل الرئيسي تُعرض فيه صفحة الويب المخصصة الخاصة بك. تُحمَّل الصفحة مسبقًا لعرضها فورًا وتدعم السحب للتحديث.

عنوان URL للواجهة الشخصية
#

النوعحقل نصي (URL)
الافتراضيفارغ
يظهر عندماتكون الواجهة الشخصية مفعّلة (ON)

عنوان URL الذي يُعرض في تبويب الواجهة الشخصية. يُقبل كل من HTTP وHTTPS (يوصى بـ HTTPS). يمكن أن يكون لوحة معلومات أو لوحة إدارة أو أي صفحة ويب تريد الوصول السريع إليها إلى جانب دردشتك.


الروابط
#

كوّن كيفية تعامل PocketHook مع عناوين URL الواردة في استجابات الخادم.

تبويب الروابط
#

النوعمفتاح تبديل
الافتراضيON

أظهر أو أخفِ تبويب الروابط في التنقل الرئيسي. عند التفعيل، تُحفظ جميع عناوين URL المستلمة من استجابات الخادم وتُعرض في تبويب مخصص مع معاينات غنية للروابط وبحث وإمكانية حذف.

فتح عناوين URL تلقائيًا
#

النوعمفتاح تبديل
الافتراضيON
مُزامَن؟لا — يُضبط بشكل مستقل على كل جهاز

عند التفعيل، يفتح PocketHook تلقائيًا عناوين URL الواردة في استجابات الخادم في متصفحك الافتراضي. عند التعطيل، تظل عناوين URL تُحفظ في تبويب الروابط (إذا كان مفعّلاً) لكنها لن تُفتح تلقائيًا.

هذا الإعداد مخصص لكل جهاز عمداً: فقد ترغب في أن تُفتح الروابط تلقائياً على iPhone لكن ليس على Mac. النقر على شارة الرابط أسفل الرسالة يفتحها دائماً، بغض النظر عن هذا الإعداد.


اللغة
#

خصّص لغة التطبيق ولغة الإملاء.

لغة التطبيق
#

النوعمنتقٍ
الافتراضيافتراضي النظام
الخياراتافتراضي النظام، English، Español

تجاوز لغة عرض التطبيق بشكل مستقل عن لغة جهازك. عند الضبط على “افتراضي النظام”، يتبع PocketHook إعداد لغة iOS لديك.

لغة الإملاء
#

النوعمنتقٍ
الافتراضيلغة النظام
الخيارات21 لغة

اللغة المستخدمة للإملاء الصوتي (تحويل الكلام إلى نص) في حقل إدخال الدردشة. اللغات المتاحة:

اللغةالرمز
الإنجليزية (الولايات المتحدة)en-US
الإنجليزية (المملكة المتحدة)en-GB
الإسبانية (إسبانيا)es-ES
الإسبانية (المكسيك)es-MX
الفرنسيةfr-FR
الألمانيةde-DE
الإيطاليةit-IT
البرتغالية (البرازيل)pt-BR
البرتغالية (البرتغال)pt-PT
الكتالانيةca-ES
الصينية (المبسطة)zh-CN
اليابانيةja-JP
الكوريةko-KR
العربيةar-SA
الروسيةru-RU
الهولنديةnl-NL
السويديةsv-SE
البولنديةpl-PL
التركيةtr-TR
التايلانديةth-TH
الفيتناميةvi-VN

المهام في الخلفية
#

تحقّق دوريًا من المهام المعلقة حتى عندما يكون التطبيق في الخلفية.

المهام في الخلفية
#

النوعمفتاح تبديل
الافتراضيOFF

فعّل الاستطلاع في الخلفية. عند التفعيل، يرسل PocketHook دوريًا طلب GET إلى عنوان URL للاستطلاع. إذا كانت الاستجابة true، يرسل رسالة الجلب إلى خادمك الرئيسي عند فتح التطبيق. يتطلب إذن الإشعارات لتنبيهك بالمهام المعلقة.

فترة التحقق
#

النوعمنتقٍ مقسّم
الافتراضي15 دقيقة
الخيارات5 min، 15 min، 30 min، 1 hr، 2 hr

عدد مرات تحقق PocketHook من عنوان URL للاستطلاع في الخلفية. الفترات الأقصر تعني اكتشافًا أسرع للمهام المعلقة لكنها تستهلك بطارية أكثر. قد يعدّل iOS التكرار الفعلي وفقًا لأنماط استخدام الجهاز.

عنوان URL للاستطلاع
#

النوعحقل نصي (URL)
الافتراضيفارغ
يظهر عندماتكون المهام في الخلفية مفعّلة (ON)

نقطة نهاية HTTPS يستطلعها PocketHook في الفترة المكوَّنة. يجب أن تعيد نصًا عاديًا true (مهام معلقة) أو false (لا مهام). هذا فحص خفيف — يجب أن يستجيب خادمك بسرعة دون معالجة ثقيلة.

Agent Server: استخدم https://your-host/jobs (عدّل المضيف والمنفذ بما يناسب إعدادك).

رسالة الجلب
#

النوعحقل نصي
الافتراضيfetchPendingTasks
الطول الأقصى10,000 حرف

الرسالة المرسلة إلى خادمك الرئيسي عندما يعثر فحص في الخلفية على مهام معلقة ويُفتح التطبيق. تظهر استجابة الخادم في الدردشة مثل أي رسالة أخرى. خصّص هذه الرسالة لتشغيل سلوك معين على جانب الخادم.


إدارة البيانات
#

راقب رسائلك المخزنة وأدرها.

الرسائل المخزنة
#

النوععرض للقراءة فقط
التنسيق“X من 500 رسالة”

يعرض عدد الرسائل المخزنة حاليًا. المؤشر مرمّز بالألوان:

  • أخضر — أقل من 70% من السعة
  • برتقالي — 70–90% من السعة
  • أحمر — أكثر من 90% من السعة

عند الوصول إلى حد 500 رسالة، تُحذف أقدم الرسائل تلقائيًا لإفساح المجال للرسائل الجديدة.

تصدير المحادثة
#

زر يصدّر جميع الرسائل المخزنة كملف JSON عبر قائمة المشاركة في iOS. يمكنك حفظ الملف أو إرساله عبر AirDrop أو مشاركته مع أي تطبيق. مفيد للنسخ الاحتياطي للمحادثات أو لتحليل سجل الرسائل.

حذف جميع الرسائل
#

زر إتلافي يزيل نهائيًا جميع الرسائل المخزنة. يتطلب تأكيدًا قبل التنفيذ. لا يمكن التراجع عن هذا الإجراء.


حول
#

معلومات للقراءة فقط حول تثبيت PocketHook لديك.

الحقلالوصف
إصدار التطبيقإصدار PocketHook الحالي (مثل 1.0.0)
البنية (Build)رقم البنية لهذا الإصدار
إصدار iOSإصدار iOS/iPadOS الذي يعمل على جهازك