تشخيصات LSP — فحص الكود أثناء الكتابة

تخيّل مُصحّحًا إملائيًا لما تكتبه، لكن للكود البرمجي — هذا هو LSP Diagnostics.

ما هو LSP أصلًا؟

LSP تعني Language Server Protocol (بروتوكول خادم اللغة). إنه مساعد يعمل في الخلفية يتحدث مع محرر الأكواد لديك. عندما تكتب، يرسل المحرر الكود إلى خادم اللغة، الذي يفحصه بحثًا عن الأخطاء ويعيد الاقتراحات. ترى النتيجة كخطوط حمراء متموجة تحت الكلمات، أو تحذيرات صفراء، أو أيقونات مصباح صغيرة.

في Hermes Agent، نستخدم LSP لنمنحك تغذية راجعة فورية أثناء الكتابة — دون الحاجة لتشغيل أمر “فحص” منفصل. الأمر أشبه بوجود مطوّر كبير صبور يطّلع على ما تكتبه من فوق كتفك، وينبّهك إلى الأخطاء الإملائية والزلات المنطقية قبل أن تحفظ الملف حتى.

لماذا يجب أن يهتم المبتدئون؟

لست بحاجة لمعرفة كيفية عمل LSP داخليًا. لكن عليك أن تعرف أن:

يكتشف الأخطاء البسيطة (أقواس ناقصة، أسماء متغيرات خاطئة) فورًا.
يعلّمك أثناء العمل — مرّر مؤشر الفأرة فوق الخط المتموج لترى المشكلة والحل.
يوفّر الوقت — تصلح المشاكل وهي جديدة، وليس بعد جلسة تنقيح طويلة ومضنية.

كيفية استخدام LSP Diagnostics في Hermes Agent

يأتي Hermes Agent مع دعم LSP مدمجًا. إليك كيفية البدء:

1. افتح مشروعك

تأكد من أنك داخل المجلد الذي يحتوي على الكود. في الطرفية:

cd my-project

2. شغّل تكامل محرر Hermes Agent

نفّذ هذا الأمر (أو استخدم الاختصار في محررك):

hermes lsp start

الآن، افتح أي ملف .py أو .js أو .ts أو .go. سترى التشخيصات تظهر تلقائيًا.

3. اقرأ لوحة التشخيص

في معظم المحررات، اضغط:

Ctrl+Shift+M   (ويندوز/لينكس)
Cmd+Shift+M    (ماك)

سيؤدي هذا إلى فتح لوحة “المشاكل”. تعرض كل مشكلة، مع اسم الملف ورقم السطر ووصفًا مختصرًا.

4. طبّق الإصلاحات السريعة

انقر على سطر متموج. ستظهر نافذة صغيرة. اختر “إصلاح سريع” أو اضغط:

Ctrl+.   (ويندوز/لينكس)
Cmd+.    (ماك)

سيقترح Hermes Agent إصلاحًا — غالبًا ما يكون ضغطة زر واحدة لقبوله.

ماذا تعني الرموز؟

خط أحمر = خطأ. هناك شيء خاطئ بالتأكيد (مثل دالة غير معرّفة).
خط أصفر = تحذير. ليس خطأ فادحًا، لكنه غالبًا مؤشر على خلل (مثل متغير غير مستخدم).
أزرق/مصباح = اقتراح. تحسين اختياري (مثل تبسيط هذا الكود).

مثال واقعي

لنقل إنك كتبت هذا في بايثون:

def greet(name):
    print("Hello, " + nam)

لاحظ nam — خطأ إملائي. سيقوم LSP بوضع خط أحمر تحته. مرّر مؤشر الفأرة فوقه، وسترى:

الاسم "nam" غير معرّف. هل تقصد "name"؟

انقر على الإصلاح السريع، وسيتغيّر إلى name تلقائيًا. لقد تجنّبت للتو انهيارًا برمجيًا.

أخطاء شائعة (وكيف تتجنبها)

لا تتجاهل التحذيرات — غالبًا ما تشير إلى أخطاء مستقبلية.
افحص اللوحة بانتظام — وليس فقط السطر الحالي.
إذا رأيت “No LSP server found” — تأكد من أنك نفّذت hermes lsp start وأن نوع ملفك مدعوم.

خلاصة ونصيحة عملية

تمنحك LSP Diagnostics تغذية راجعة في الوقت الفعلي، مما يجعل البرمجة أشبه بمحادثة وليس لعبة تخمين. تكتب، والأداة تنبّهك، وتصلح — الأمر بهذه البساطة.

نصيحة عملية: قبل تشغيل الكود، ألقِ دائمًا نظرة على لوحة “المشاكل”. نظرة واحدة سريعة يمكن أن توفّر عليك عشر دقائق من البحث عن “لماذا هذا معطّل؟”. اجعلها عادة — سيشكرك مستقبلك.

الآن انطلق واكتب بعض الأكواد، ودع الخطوط المتموجة ترشدك.