للتحقق مما إذا كان اختصار Mac يُشفّر نص البحث المحدد، افحص القيمة التي تصل إلى عنوان URL النهائي الخاص به: أضف إجراء معاينة سريعة (Quick Look) بعد أن يقوم الاختصار بإنشاء عنوان URL، وشغّله باستخدام عبارة اختبار تحتوي على مسافات وأحرف محجوزة، وتحقق مما إذا كانت تلك الأحرف تظهر كرموز هروب بالنسبة المئوية. نجاح التشغيل بمفرده لا يثبت أن نص البحث قد تم تشفيره بشكل صحيح؛ إذ يمنحك عنوان URL المرئي وسيلة لفحص ما قام الاختصار بتجميعه فعلياً. توثق شركة Apple ميزة "معاينة سريعة" لمعاينة المحتوى الذي يتم تمريره بين إجراءات الاختصار، كما يصف دليل Mac الخاص بها مهام سير العمل المعتمدة على عناوين URL والتي تتطلب تشفير النص بنظام URL. (اختبار إجراءاتك في تطبيق "الاختصارات" على Mac؛ استخدام مخطط URL لتطبيق آخر في "الاختصارات" على Mac)

حدد النص وعنوان URL اللذين تحتاج إلى فحصهما

عادةً ما يأخذ اختصار البحث عبارة محددة، ويضعها في عنوان URL للبحث، ثم يفتح ذلك العنوان. الجزء الذي يجب التحقق منه هو قيمة الاستعلام (query value) التي تحتوي على العبارة — وليس مجرد ما إذا كان عنوان URL النهائي يبدأ بعنوان ويب. على سبيل المثال، إذا كان عنوان URL للبحث بالشكل https://example.com/search?q=...، فافحص القيمة التي تلي q=. النطاق النموذجي هنا للتوضيح فقط؛ استخدم خدمة البحث والمعامل الفعليين اللذين صُمم الاختصار من أجلهما.

تفحص إجراءات الاختصار من أعلى إلى أسفل. ابحث عن مكان إدخال النص المحدد في سير العمل، والمكان الذي يتم فيه تجميع عنوان URL أو استعلام البحث، والإجراء الذي يفتح عنوان URL. يوضح دليل "الاختصارات" من Apple أن الإجراءات المتصلة تمرر مخرجاتها إلى الأمام، وأن إجراء "معاينة سريعة" يمكنه معاينة المحتوى المتنقل بين الإجراءات. (اتصالات الإجراءات في تطبيق "الاختصارات" على Mac؛ اختبار إجراءاتك في تطبيق "الاختصارات" على Mac)

إتاحة النص المحدد لاختصار Mac

إذا كنت تفحص اختصاراً موجوداً بالفعل، فتأكد من أنه مهيأ لاستلام النص المحدد. في تطبيق "الاختصارات"، افتح الاختصار، وافتح تفاصيله، ومكّن خيار استخدام كإجراء سريع (Use as Quick Action) أو إظهار في ورقة المشاركة (Show in Share Sheet). تذكر Apple أن هذا يضيف إجراء إدخال في بداية سير العمل. بعد ذلك، حدد عبارة في أحد التطبيقات وقم بتشغيل الاختصار من خيارات المشاركة في التطبيق أو الإجراءات السريعة المتاحة. تعتمد القائمة الدقيقة على التطبيق وكيفية تمكين الاختصار. (تشغيل اختصار أثناء العمل على Mac)

وفقاً لـ Apple، فإن الاختصار الذي يتم تشغيله من Dock لا يستلم محتوى من التطبيق الحالي. إذا قمت بتشغيله بهذه الطريقة، فقد يعمل دون النص المحدد الذي تنوي اختباره. تحقق من إجراء الإدخال الخاص بالاختصار وشغّله من تطبيق مصدر مدعوم مع تحديد نص بداخله. (تشغيل اختصار أثناء العمل على Mac؛ تقييد الإدخال لاختصار عند تشغيله من تطبيق آخر على Mac)

معاينة عنوان URL المكتمل قبل فتحه

في محرر الاختصارات، أدرج إجراء معاينة سريعة (Quick Look) بين الإجراء الذي يُنشئ عنوان URL النهائي والإجراء الذي يفتحه. شغّل الاختصار باستخدام عبارة اختبار عادية مثل red & blue sky. ينبغي أن تُظهر "معاينة سريعة" مخرجات الإجراء السابق. يتيح لك هذا فحص عنوان URL المُنشأ قبل أن يتلقاه إجراء الفتح؛ وهذا الإجراء بحد ذاته لا يتحقق من قبول موفر البحث لعنوان URL أو تفسيره للاستعلام على النحو المنشود. توصي Apple باستخدام "معاينة سريعة" كوسيلة لتحديد المحتوى المتدفق بين إجراءات الاختصار. (اختبار إجراءاتك في تطبيق "الاختصارات" على Mac)

اقرأ قيمة الاستعلام في المعاينة. في مكون الاستعلام النموذجي المشفر بنظام النسبة المئوية، قد تظهر المسافة بالشكل %20، وقد تظهر علامة العطف (&) التابعة لعبارة البحث بالشكل %26. إذا ظلت علامة العطف حرفية & داخل القيمة، فقد يتعامل معها محلل URL كبداية لمعامل آخر. هذا مجرد مثال تشخيصي، وليس ضماناً لصيغة الاستعلام لدى كل خدمات البحث. تستخدم أمثلة مخطط URL الخاصة بتطبيق "الاختصارات" من Apple الرمز %20 للمسافات، وتصف صراحةً النص الموفر بأنه مشفر بنظام URL. (تشغيل اختصار باستخدام مخطط URL على Mac)

التحقق من الإجراء الذي يقوم بالتشفير

ابحث في إجراءات المحرر عن تشفير URL (URL Encode) وتحقق مما إذا كان يتلقى متغير النص المحدد قبل إدراج تلك القيمة في الاستعلام. الغرض الموثق للإجراء هو تشفير النص أو فك تشفيره لاستخدامه في عنوان URL عن طريق إضافة رموز الهروب بالنسبة المئوية أو إزالتها. (URL Encode) توثق Apple أيضاً إنشاء عناوين URL باستخدام إجراء URL وفتحها باستخدام فتح عناوين URL (Open URLs) أو فتح عنوان URL الخاص بـ X-Callback (Open X-Callback URL)، لكن دليلها يحذر من أن مخططات URL قد تتطلب نصوصاً مشفرة وقد يصعب تصحيح أخطائها. (استخدام مخطط URL لتطبيق آخر في "الاختصارات" على Mac)

الفحص المفيد يكمن في موضع الإجراء والمعاينة، وليس مجرد وجود إجراء يحتوي اسمه على "URL". تأكد من أن النص المحدد يتدفق إلى خطوة التشفير، وأن النتيجة المشفرة — وليست التحديد الأصلي — هي ما يتم إدراجه كقيمة للاستعلام. بعد ذلك، تأكد من أن معاينة Quick Look تُظهر رموز الهروب المتوقعة. تجنب تشفير قيمة مشفرة بالفعل مرة ثانية: فقد يتم تشفير علامات النسبة المئوية نفسها، مما يحول %20 إلى %2520. ظهور هذا النمط في المعاينة يعد دليلاً يستوجب فحص سير العمل بحثاً عن تشفير متكرر.

تفسير النتيجة وحدودها

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

يمكن للمعاينة أن تعرض سلسلة عنوان URL التي جمعها الاختصار؛ لكنها لا تستطيع تحديد كيفية معالجة خدمة بحث معينة للاستعلام، أو ما إذا كان عنوان URL سيُفتح بنجاح، أو ما إذا كانت الخدمة تطبق قواعدها الخاصة. لإجراء فحص وظيفي نهائي، قم بإزالة إجراء "معاينة سريعة" التشخيصي أو نقله، واستخدم الاختصار مع عبارة تجريبية غير حساسة. توثق Apple عناصر تحكم Mac لتلقي المحتوى وفتح عناوين URL، لكنها لا تضمن سلوكاً متطابقاً للاستعلام عبر مختلف خدمات البحث. (تشغيل اختصار أثناء العمل على Mac؛ استخدام مخطط URL لتطبيق آخر في "الاختصارات" على Mac)

المصادر