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

جهّز ملفات يمكن للتطبيق الذي اخترته فتحها

المهمة المحددة هي تحديد عدة ملفات محلية موجودة في Finder وإرسال كل منها إلى التطبيق نفسه. ابدأ بمستندين نصيين عاديين تجريبيين: Blue note.txt، ويحتوي على Blue sample، وGreen note.txt، ويحتوي على Green sample. احفظهما في مجلد جديد على سطح المكتب باسم Finder Opening Test. إذا كان هذا المجلد موجودًا بالفعل، فاختر اسمًا آخر وعدّل المثال اللاحق بما يناسبه.

قبل إنشاء الاختصار، افتح كل عينة يدويًا: انقر عليها في Finder مع الضغط على Control، واختر Open With، ثم حدد TextEdit. يثبت ذلك أن التطبيق المقصود يستطيع التعامل مع المدخلات. توثّق Apple هذه الطريقة لفتح ملف باستخدام تطبيق معين، إلى جانب سحب الملف إلى أيقونة تطبيق. اختيار تطبيق لفتح ملف على Mac.

في سير عمل آخر، استبدل بذلك تطبيقًا مثبتًا وملفات مؤقتة بتنسيق يدعمه. اختيار تطبيق لا يثبت أنه يستطيع قراءة كل تنسيق محدد. اجعل الاختبار الأول مقتصرًا على المستندات المحلية العادية؛ فالمجلدات وحزم المستندات تتطلب أساليب معالجة مختلفة.

أنشئ الإجراء السريع في Finder

اضبط إدخال الملفات والاستجابة عند غياب التحديد

أنشئ اختصارًا في Shortcuts وسمّه Open Selected Text in TextEdit. يشرح دليل الإنشاء من Apple كيفية إضافة الإجراءات من مكتبة الإجراءات وضبط معلماتها. إنشاء اختصار مخصص على Mac.

افتح Details للاختصار، وفعّل Use as Quick Action، وحدد Finder ضمن المواقع المتاحة. توثّق Apple التكامل مع Finder وتشير إلى أن تحديد Finder قد يتطلب إضافة ملفات أو مجلدات إلى أنواع الإدخال المسموح بها للاختصار. تشغيل اختصار أثناء العمل على Mac.

في أعلى سير العمل، انقر أنواع الإدخال المقبولة. ألغِ التحديد العام وفعّل Files. تعرّف Apple هذا النوع بأنه يشمل المستندات والصور وملفات PDF وغيرها من الملفات؛ أما المجلدات فلها نوع إدخال منفصل. يقبل سير العمل هذا الملفات عمدًا. فهم أنواع الإدخال في Shortcuts على Mac.

اضبط السلوك عند غياب الإدخال على Stop and Respond، واكتب الرسالة Select sample files in Finder, then run this Quick Action.. يجعل ذلك سبب عدم حدوث شيء في التشغيل الفارغ واضحًا. توثّق Apple أن بعض مواقع التشغيل، ومنها Dock، لا توفر إدخالًا أوليًا، وتشرح خيار الاستجابة هذا. تقييد إدخال اختصار عند تشغيله من تطبيق آخر على Mac.

صِل كل ملف محدد بإجراء الفتح

أضف Repeat with Each واضبط قائمته على Shortcut Input. داخل الحلقة، أضف Open File. اضبط معلمة الملف على Repeat Item، ثم اختر TextEdit في معلمة التطبيق بدلًا من ترك Default App محددًا. ما يلي مخطط لسير العمل، وليس شفرة قابلة للتنفيذ:

استقبال الملفات من Finder
إذا لم يوجد إدخال: إيقاف التنفيذ وإظهار استجابة

التكرار مع كل عنصر في Shortcut Input
    فتح Repeat Item في TextEdit
إنهاء التكرار

التوصيل الأساسي هو Repeat Item. توثّق Apple أن Repeat with Each يقبل قائمة ويشغّل الإجراءات المحصورة داخله مرة لكل عنصر؛ ويحتوي Repeat Item على العنصر الحالي أثناء كل تكرار. إن تمرير قائمة Shortcut Input بأكملها إلى إجراء الفتح داخل الحلقة سيهدم تصميم معالجة ملف واحد في كل تكرار. استخدام إجراءات التكرار في Shortcuts على Mac.

تحقق من معلومات إجراء الفتح على Mac قبل تشغيله: انقر أيقونته مع الضغط على Control واختر Show Info. توثّق Apple هذه الطريقة لفحص وصف الإجراء والمدخلات التي يقبلها والمخرجات الناتجة. تأكد من تحديد إجراء فتح الملفات ومن أن إعداداته تتيح التطبيق الذي اخترته. التنقل في قائمة الإجراءات في Shortcuts على Mac.

حافظ على هذه الحدود عند تعديل سير العمل:

المرحلة القيمة المستخدمة هنا ما ينبغي الحفاظ عليه
إدخال Finder عناصر الملفات المحددة أبقِ الملفات على هيئة عناصر ملفات.
إدخال Repeat with Each قائمة Shortcut Input عالج القائمة المقدمة.
Repeat Item ملف محدد واحد صِل هذا المتغير بـ Open File.
بعد الفتح لا يوجد إجراء لاحق في سير العمل هذا لا تفترض أن النتيجة تتضمن محتوى المستندات بعد تحريره.

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

أجرِ اختبارًا صغيرًا قبل استخدام تحديد أكبر

في Finder، افتح Finder Opening Test وحدد مستندي العينة، ثم انقر أحد العنصرين المحددين مع الضغط على Control. اختر Quick Actions، ثم Open Selected Text in TextEdit. توثّق Apple تشغيل الاختصارات من هذه القائمة السياقية ومن جزء معاينة Finder. إذا لم يظهر الاختصار، فتحقق من إتاحته في Finder ومن تفعيل امتداد Finder. تشغيل اختصار من قائمة Quick Actions.

تحقق من المحتوى، وليس من مجرد ظهور TextEdit. ينبغي أن تتمكن من العثور على كل من Blue sample وGreen sample. يطلب سير العمل عملية فتح واحدة لكل ملف محدد؛ ولا يضبط موضع النوافذ أو تجميع علامات التبويب أو ترتيب المستندات.

استخدم مصفوفة الاختبار الصغيرة هذه للتمييز بين مشكلات التحديد ومشكلات التطبيق. هذه فحوص مقترحة وليست نتائج اختبار مسجلة:

الاختبار ما ينبغي التحقق منه
تحديد Blue note.txt وحده تُفتح العينة الزرقاء.
تحديد مستندي العينة معًا يتاح المحتويان المختلفان.
التشغيل من دون إدخال مُقدّم تظهر رسالة التحديد المضبوطة.
تحديد ملفين بالاسم نفسه من مجلدين مختلفين يظل من الممكن تمييز المحتويين المختلفين.

لإجراء الفحص الأخير، أنشئ مجلدين فرعيين داخل مجلد الاختبار المؤقت. احفظ في كل منهما مستندًا نصيًا عاديًا باسم Sample.txt، يحتوي الأول على First folder sample والثاني على Second folder sample. حدد الملفين معًا في بحث Finder محصور في مجلد الاختبار، ثم شغّل الإجراء السريع.

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

افهم حدود وجود الملفات وتعارض الأسماء

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

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

فتح مستند لا يثبت أيضًا نجاح عملية تحرير أو تصدير لاحقة. اجعل الإصدار الأول مقتصرًا على فتح العينات المؤقتة، ثم قيّم أي عملية إضافية وفق مدخلاتها ومخرجاتها وسلوكها عند وجود ملف مسبقًا.

استخدم Terminal لعزل مشكلات الإدخال

إذا كان استدعاء الاختصار من Finder غير واضح، فاختبر الاختصار نفسه بمدخلات ملفات صريحة. توثّق Apple الأمر shortcuts run والخيار -i لتوفير مسارات الملفات. وتوضح تحديدًا الفرق بين ذلك وبين تمرير نص المسار عبر الأنابيب، إذ يوفّر هذا نصًا بدلًا من إدخال مسار ملف. تشغيل الاختصارات من سطر الأوامر.

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

/bin/bash <<'SCRIPT'
set -eu

sample_dir="$HOME/Desktop/Finder Opening Test"
first="$sample_dir/Blue note.txt"
second="$sample_dir/Green note.txt"

for file in "$first" "$second"; do
  if [ ! -f "$file" ]; then
    printf 'Missing sample file: %s\n' "$file" >&2
    exit 1
  fi
done

/usr/bin/shortcuts run "Open Selected Text in TextEdit" \
  -i "$first" "$second"
SCRIPT

يستخدم هذا المثال مساري العينتين الصريحين فقط. ولا يكتشف التحديد الحالي في Finder. توثّق Apple رمز خروج 0 للتشغيل الناجح للاختصار و1 عند حدوث خطأ؛ ومع ذلك، افحص مستندي العينة للتأكد من ظهور النتيجة المقصودة. سلوك أمر Shortcuts.

شخّص أول نقطة تختلف عندها النتيجة

إذا ظهر الاختصار لكنه لم يتلقَّ شيئًا، فتحقق من نوع Files المقبول وأعد تشغيله بعد تحديد ملفات العينة في Finder. إذا لم يُفتح سوى مستند واحد، فتحقق من توصيل قائمة الحلقة ومن توصيل Repeat Item بإجراء الفتح.

لفحص ما يدخل إلى سير العمل، ضع Quick Look مؤقتًا قبل حلقة التكرار وصِله صراحةً بـ Shortcut Input. أبقِ حلقة التكرار موصولة صراحةً بـ Shortcut Input أيضًا. توصي Apple بإدراج Quick Look بين الإجراءات لفحص المحتوى الذي يجري تمريره. أزل الإجراء التشخيصي بعد التحقق من العينات. اختبار الإجراءات في Shortcuts على Mac.

إذا فُتح تطبيق آخر، فأعد التحقق من معلمة التطبيق في Open File. إذا لم يتمكن TextEdit من فتح عينة يدويًا، فحل مشكلة المستند أولًا. تشير Apple إلى أن التطبيق قد يعجز عن فتح ملف لأنه لا يتعرف على تنسيقه. اختيار تطبيق لفتح ملف على Mac.

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

المصادر