أكواد الخروج في Bash، مخرجات السكريبت والفروقات في الملفات ضمن بطاقة دردشة

ما يمكن للوكيل القيام به

• الملفاتتعمل read_file وwrite_file وedit_file وgrep وglob وlist_dir في مجلد العمل الخاص بالدردشة، ويعرض edit_file فرق كل تغيير. يعرض عداد عدد الملفات التي تم إنشاها وتعديلها وقراءتها.
• Shellيشغل أمراً في البيئة المختارة، مثل Windows أو WSL أو خادم تملكه عبر SSH، ويعرض رمز الخروج الفعلي. يتم حظر الأوامر الخطرة.
• الويبتبحث web_search عن المعلومات، ويجلب http_get صفحة توثيق واحدة، مما يتيح لك قراءة ما يفعله الأمر قبل استخدامه.
• لقطات الشاشة والصوريقرأ ocr النص من لقطة شاشة محفوظة، مثل رسالة خطأ، ويحفظ gen_image ملفات الصور.
• الأتمتةتبدأ task وكلاء فرعيين بالتوازي، ترسل run_on_model خطوة صعبة إلى نموذج أكبر، والمهارات هي أدلة قابلة لإعادة الاستخدام.
• أوضاع الموافقةيعمل Auto-run فوراً، ويتوقف Ask first قبل الإجراءات التي تغير شيئاً، ويكتب Plan only خطة ولا يشغل شيئاً.
• Cronيشغل موجهاً في جدول زمني، مثلاً اختبار يومي لبرامجك الخاصة على جهاز تملكه.
• النماذجمزود ذكاء اصطناعي سحابي عبر نقطة نهاية API، أو نموذج على جهازك، أو النموذج المدمج الذي يكون جاهزاً دون الحاجة إلى نقطة نهاية خاصة بك.

أربع مهام مع أكواد الخروج والحجج

فحص رمز الخروج عند غياب حجة

تطلب من الوكيل معرفة ما يحدث عندما لا يتلقى check.sh أي حجة. يفتح read_file السكريبت، ويشغل Shell bash check.sh بدون أي شيء بعد الاسم. تظهر البطاقة المخرجات الفعلية ورمز الخروج، وهو 2 إذا كان السكريبت يطبع سطر الاستخدام في الخطأ القياسي وينتهي بـ exit 2. يقع رمز الخروج في $؟، ويرى المتصل فقط هذا الرقم، لذا يكون السكريبت الذي ينتهي برمز واضح أسهل في الاختبار من الذي يعيد دائماً 1. يشغل Shell السكريبت مرة أخرى بقيمتين، ويجب أن تظهر البطاقة 0. إذا فاجأك الأكواد، اقرأ البطاقة، ثم اسمح لـ edit_file باقتراح إصلاح تحت Ask first وراجع الفرق.

تحليل الخيارات باستخدام getopts

تكتب "اشرح لي getopt" فيجيب الوكيل بكلمات بسيطة: getopts هي أداة مدمجة في Bash للخيارات القصيرة مثل -v أو -f file، بينما getopt هو أمر منفصل يتعامل أيضاً مع الخيارات الطويلة مثل --file ويتصرف بشكل مختلف بين الأنظمة. ثم يفتح read_file السكريبت الخاص بك، ويضيف edit_file حلقة getopts وترى الفرق. يشغل Shell السكريبت مع -v، ومع -f ومع خيار خاطئ، ولكل بطاقة رمز خروج خاص بها. يجب أن ينتهي الخيار الخاطئ بـ 2، وهو الرمز المعتاد للاستخدام الخاطئ. بالنسبة لعدد قليل من الخيارات، تكفي حلقة while مع case وshift، لذا اطلب هذا الإصدار إذا كنت تفضله. اقبل الفرق فقط بعد قراءته.

الحفاظ على القيم التي تحتوي على مسافات كوحدة واحدة

فشل تمرير الحجج التي تحتوي على مسافات إلى السكريبت عندما لا تكون القيم محاطة بعلامات اقتباس، لأن المحلل يفصلها إلى كلمات منفصلة. يقرأ الوكيل الملف باستخدام read_file، يجد $1 و$@ غير المحاطين بعلامات اقتباس، ويقترح edit_file علامات اقتباس مزدوجة حولها. يشغل Shell السكريبت بقيمة مثل "كلمتين"، وتظهر المخرجات ما إذا كانت تصل كسطر واحد أو كسطرين. إحدى الحيل لإدارة حجج سطر الأوامر هي shift، التي تحذف القيمة الأولى حتى تتمكن الحلقة من المرور عبر الباقي، ويمكن للوكيل إضافتها في نفس الفرق. تحت Ask first، ينتظر التعديل منك. راجع الفرق، شغل الاختبار مرة أخرى وقارن المخرجات الاثنين بنفسك.

التوقف عند الأخطاء باستخدام set -eu

الذين يبحثون عن "bash exit script" يبحثون عادةً عن الأمر builtin للخروج: يوقف N السكريبت بالحالة N، بينما يترك return N الدالة فقط. يمكن للوكيل إضافة set -eu وset -o pipefail في الأعلى، بحيث يتوقف السكريبت عند الأخطاء والمتغيرات غير المحددة، ثم يشغل الملف بـ bash -n للتحقق من التركيب وbash -x لطباعة كل أمر. إذا لم يكن return يعطي حالة الأمر الأخير، فقد يكون هناك أمر آخر قد عمل في بينهما، لأن $؟ يحتوي فقط على رمز الخروج للأحدث. تظهر بطاقة Shell التتبع. اقرأها من الأعلى، قارنها مع السكريبت وقرر ما إذا كان التعديل سيظل قائماً.