Written with AI assistance from the source video. The video is the authority.
Log in to leave a comment
No posts yet
عند تشغيل أدوات التطوير القائمة على الطرفية (Terminal) في بيئة جدار الحماية (Firewall) والبروكسي الداخلي، تحدث أخطاء حظر الشبكة. والسبب هو فشل التحقق من شهادة الجذر الخاصة بالشركة نظراً لأن طبيعة وقت التشغيل تتجاوز التخزين الافتراضي لنظام التشغيل.
يجب إدخال الإعدادات مباشرة في ملف تعريف الطرفية. أدخل عنوان البروكسي الداخلي في المتغيرين HTTP_PROXY و HTTPS_PROXY. وحدد مسار ملف شهادة الجذر الداخلية في المتغير NODE_EXTRA_CA_CERTS. ومن خلال تعيين ANTHROPIC_BASE_URL إلى نقطة نهاية Ollama المحلية ووضع قيمة CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC على 1، يتم حظر الاتصال الخارجي. يتيح لك ذلك الالتزام بلوائح جدار الحماية، القضاء على أخطاء الفحص، وتقليل وقت الإعداد.
عند تشغيل الفحص الكامل في مستودع متجانس (Monolithic) يتجاوز 500 ألف سطر، يستغرق الأمر 30 دقيقة أو يتوقف بسبب خطأ في ذاكرة التخزين المؤقت (Heap Memory). في بيئة ذاكرة وصول عشوائي (RAM) بحجم 16 جيجابايت، يجب استخدام نموذج محلي بحجم 14B أو 20B حتى يتمكن الماسح الضوئي من الصمود. قم بإنشاء ملف .understandignore في جذر المشروع.
طريقة تطبيق أنماط الاستثناء بسيطة. أنشئ ملفاً في الدليل الرئيسي واكتب مسارات **/node_modules/, **/target/, **/build/, **/src/test/. قم بزيادة حد ذاكرة التخزين المؤقت لـ Node.js عن طريق كتابة الأمر NODE_OPTIONS="--max-old-space-size=8192" في الطرفية. مع تقليل ملفات الهدف للتحليل، ينخفض وقت اكتمال الفحص الأولي إلى أقل من 3 دقائق.
عند طرح الأسئلة استهدافاً للمستودع الضخم بأكمله، يتم تحميل عشرات الآلاف من العقد الموجودة في رسم بياني المعرفة دفعة واحدة، مما يؤدي إلى حدوث ظاهرة الهلوسة. حيث يتم الخلط بين فئة الدفع القديمة والجديدة ويتم جلب طرق لا تعمل. يجب تضييق نطاق منطق الأعمال.
إجراءات قصر نطاق الاستعلام على دليل معين هي كالتالي. عند عرض ملف واحد، قم بإلحاق المسار النسبي للملف المستهدف بعد الأمر. وعند فهم تدفق النطاق، قم بتنفيذ الأمر الذي استخراج العقد داخل حدود نطاق معين فقط. حتى عند استخدام أوامر الدردشة، حدد مسار الدليل المراد مراجعته واستبعد مجلد الاختبار. مع تقليل عدد العقد، تزداد دقة استكشاف الكود.
من الخطير تعديل الكود مباشرة بالاعتماد فقط على النتائج التي تقدمها الذكاء الاصطناعي. يجب مقارنة مخرجات رسم بياني المعرفة مع الكود المصدري الفعلي مباشرة. افتح ميزة استكشاف الملفات في بيئة التطوير المتكاملة (IDE) لمعرفة ما إذا كانت الطريقة التي ذكرتها الذكاء الاصطناعي موجودة بالفعل. تحقق من علاقات الاستدعاء وتأكد من نطاق المعاملات وملفات التعيين. قبل تعديل الكود، قم بتنفيذ الأمر الذي يحلل تأثير التداعيات.
في الأنظمة القديمة حيث غادر الشخص المسؤول وليس هناك وثائق، حتى لو كنت تحاول فهم واجهة برمجة تطبيقات (API) واحدة، فيجب عليك البحث في عشرات الملفات. باستخدام أدوات Understand-Anything، يتم إنشاء جولة ترشدك عبر النظام بترتيب تبعيات الطبقات بدءاً من نقطة الدخول (Entry Point). لست بحاجة إلى السؤال مراراً وتكراراً لمطور ذو خبرة.
طريقة استخراج رسم بياني لتدفق الطلبات والاستجابات هي كالتالي. بعد الانتهاء من تحليل رسم بياني المعرفة، قم بتشغيل واجهة لوحة المعلومات (Dashboard UI). حدد ميزة الجولة من القائمة أو أدخل الأمر مباشرة. قم بتصور تدفق التنفيذ من خلال متابعة العقد المؤدية من نقطة دخول واجهة برمجة التطبيقات إلى خدمة الواجهة الخلفية (Backend) وقاعدة البيانات بالتتابع.
عند التعامل مع الكود القديم، يجب حساب الآثار الجانبية مقدماً. بعد تعديل الكود وقبل الالتزام (Commit)، قم بتشغيل الأمر الذي يسهل تحويل الملفات المعدلة إلى عقد رسوم بيانية. يتم حساب العقد المتصلة بشكل شامل. فهم التأثيرات التي ستحدثها التغييرات على واجهات برمجة التطبيقات الحالية أو مهام الدفعات (Batch jobs) مقدماً.
يتم استخراج الأصول التي تم تحليلها بصيغة مركدوان (Markdown) وتسجيلها في ويكي الشركة. تخلص من ديون التوثيق عن طريق التزام ملف رسم بياني المعرفة الذي تم إنشاؤه بعد اكتمال الفحص. إذا كان الملف كبيراً، قم بإدارته باستخدام Git LFS. قم بتكوين تتبع الملفات الكبيرة، وحفظ ملف التكوين في المستودع واستخدامه كدليل إرشاد للموظفين الجدد (Onboarding). من خلال إعداد خط管道 تزايدي ليعمل مع كل عملية التزام (Commit)، يمكنك الحفاظ على أحدث حالة للهندسة المعمارية دون الحاجة إلى إجراء فحص كامل في كل مرة.
