الأدوات
مفسر الأكواد بالذكاء الاصطناعي
الصق أي كود، أو أمر طرفية، أو تتبع خطأ (stack trace)، ليوضح لك GPT-6 Luna وظيفته الفعلية بكلمات بسيطة وبالعمق الذي تحدده.
افهم الكود قبل تشغيله
سواء كنت تنسخ مقتطفاً برمجياً من منتدى، أو تستلم كوداً من زميل لك، أو تحدق في تتبع أخطاء (stack trace) في نهاية يوم عمل شاق: يبقى السؤال الأول دائماً "ما الذي يفعله هذا الكود بالضبط؟" الصق الكود أو الأمر أو التعبير النمطي (regex) أو رسالة الخطأ في المربع، وسيشرح لك أداة شرح الأكواد كل شيء بكلمات بسيطة وبالعمق الذي تختاره.
يتم تقديم الشرح عبر GPT-6 Luna. الهدف من هذه الأداة هو الفهم وليس إعادة الكتابة؛ فهي تصف ما يفعله الكود فعلياً، بما في ذلك أي سلوك غير متوقع، ولا تقترح تعديلات إلا إذا كان الحل قصيراً وضرورياً بوضوح. كما تم توجيهها لعدم اختلاق دوال برمجية، وتوضيح ما إذا كانت الإجابة تعتمد على إصدار معين أو كود لم تقم بلصقه، بالإضافة إلى التحذير بشدة من الأوامر التي تحذف البيانات أو تغير إعدادات النظام.
خمسة أنواع من الشرح
| نوع الشرح | ما ستحصل عليه |
|---|---|
| نظرة عامة سريعة | الهدف من الكود، مدخلاته ومخرجاته، وخطواته الأساسية |
| سطر بسطر | اقتباس كل جزء من الكود مع شرحه بالترتيب |
| للمبتدئين | تعريف كل مفهوم برمجي عند ظهوره لأول مرة |
| شرح واكتشاف المشاكل | الشرح مع توضيح الأخطاء المحتملة، الحالات النادرة (edge cases)، ومخاوف الأمان والأداء، بدءاً من الأخطر |
| معنى هذا الخطأ | توضيح رسالة الخطأ بكلمات بسيطة، أسبابها المحتملة في كودك، وما يجب فحصه |
تغطي قائمة اللغات كل من Python وJavaScript وTypeScript وJava وC# وC++ وC وGo وRust وPHP وKotlin وSwift وRuby وR وSQL، ونصوص Shell البرمجية، وPowerShell، وHTML وCSS، بالإضافة إلى التعبيرات النمطية (regex). خيار "التعرف التلقائي" يعمل مع معظم الحالات، لكن تحديد اللغة يفيد في المقتطفات القصيرة التي قد تتشابه بين عدة لغات. وبالنسبة للتعبيرات النمطية، ستحصل أيضاً على نصين متطابقين مع التعبير ونص ثالث لا يطابقه.
مثال: أمر تنظيف الملفات
يتكرر هذا السطر في العديد من شروحات إدارة السيرفرات. قمنا بلصقه مع اختيار "شرح واكتشاف المشاكل":
find . -name "*.log" -mtime +30 -exec rm {} \;
في غضون ثلاث ثوانٍ تقريباً، أوضحت الإجابة أن الأمر يبحث في المجلد الحالي وجميع المجلدات الفرعية داخله عن الملفات المنتهية بـ .log والتي تم تعديلها منذ أكثر من 30 يوماً، ثم يقوم بحذفها جميعاً. بعد ذلك، استعرضت الأداة الملاحظات والمخاطر بدءاً من الأكثر خطورة: الحذف نهائي وبدون تأكيد، لذا يُفضل تشغيل الأمر أولاً باستخدام -print بدلاً من الجزء الخاص بـ rm لمعاينة الملفات التي ستُحذف؛ كما أنه يصل إلى كل المجلدات الفرعية، لذا فإن مكان تشغيله مهم جداً؛ وحساب المدة يعتمد على فترات كاملة من 24 ساعة، وهو ما لا يتطابق تماماً مع الأيام التقويمية. هذا التحذير الأول هو تحديداً ما قد ينقذك من مأزق كبير.
كيف تحصل على شروحات أكثر وضوحاً
- الصق الدالة بالكامل، وليس سطراً واحداً من المنتصف، خصوصاً إذا كان السطر يعتمد على متغيرات تم تعريفها قبله.
- في حالات الأخطاء، أرفق الرسالة كاملة والكود المرتبط بها. السطور الأولى والأخيرة في تتبع الخطأ (stack trace) هي الأهم عادةً.
- حدد ما كنت تتوقعه في جملة تسبق الكود. سيركز الشرح حينها على الفارق بين ما توقعته والنتيجة الفعلية.
- احذف البيانات الحساسة. استبدل مفاتيح واجهات البرمجة (API keys)، وكلمات المرور، ونصوص الاتصال بقيم وهمية قبل اللصق. نحن لا نخزن ما تلصقه هنا (فهو يمر عبر بوابتنا وOpenRouter إلى OpenAI)، ولكن البيانات الحساسة لا يجب وضعها في أي مربع نصي عموماً.
تتمتع استعلامات قواعد البيانات بأداة مخصصة: يمكن لأداة مساعد SQL كتابة الاستعلامات وتصحيحها أيضاً. وإذا أردت شرحاً مبسطاً لمفهوم تقني عام بدلاً من كود محدد، فاستخدم أداة اشرحها ببساطة.
متى تنتقل إلى الدردشة؟
تم تصميم صفحة الأداة للتعامل مع مقتطف برمجي واحد في كل مرة. لجلسات تصحيح الأخطاء الأطول، أو لكتابة كود جديد بالكامل، يمكنك المتابعة في المحادثة، حيث يمكنك لصق المزيد من الملفات وطرح أسئلة متتالية. وللمشاكل المعقدة، فعّل خيار Think، والذي يحوّل الدردشة إلى نموذج GPT-6.1 Terra، وهو نموذج يفكر قليلاً وبعمق قبل الإجابة. تذكر أن أي شرح قد يحتوي على أخطاء، لذا اختبر النقاط المهمة دائماً بتشغيل الكود على مدخلات تجريبية.
الأسئلة الشائعة حول أداة شرح الأكواد
هل يمكنها شرح كود مكتوب بلغة غير مدرجة في القائمة؟
في كثير من الأحيان، نعم. اترك الإعداد على "التعرف التلقائي". تكون الشروحات أكثر دقة وموثوقية مع اللغات الشائعة.
هل ستقوم الأداة بإصلاح الكود الخاص بي؟
التركيز الأساسي هو الشرح. إذا كان الإصلاح قصيراً وواضحاً فستعرضه الأداة، أما لإعادة كتابة الكود بشكل شامل، فانتقل إلى الدردشة مع تفعيل Think.
بأي لغة سيظهر الشرح؟
بنفس اللغة التي تكتب بها أي كلمات توضيحية حول الكود. إذا قمت بلصق الكود بمفرده، فسيكون الشرح باللغة الإنجليزية.
هل الأداة مجانية؟
نعم. يستهلك كل شرح رسالة واحدة من رسائلك اليومية المجانية. للتوسع أكثر، جرّب الحصول على شرح خطوة بخطوة في الدردشة.
متابعة القراءة
إجابة فورية لسؤالك
بدون إنشاء حساب، وبدون بطاقة بنكية، وبدون تحميل أي شيء. اكتب ما تريد معرفته وستظهر لك بداية الإجابة في ثانية أو ثانيتين.