IBM Bob
استكشاف الأخطاء

استكشاف أخطاء Bob Shell

ابحث عن حلول للمشاكل التي قد تواجهها عند استخدام Bob Shell.

المصادقة

أخطاء الشهادات

الخطأ: Unable to verify certificate

السبب: أنت على شبكة شركة تحتوي على جدار حماية يعترض ويفحص حركة مرور SSL/TLS. يتطلب هذا الثقة بشهادة CA مخصصة من قِبل Node.js.

الحل: عيّن متغير البيئة NODE_EXTRA_CA_CERTS على المسار المطلق لملف شهادة CA الجذرية للشركة:

 
export NODE_EXTRA_CA_CERTS=/path/to/your/corporate-ca.crt

تكامل IDE

فشل الاتصال

الخطأ: لا يستطيع Bob Shell الاتصال بـ IDE.

السبب: قد لا تكون إضافة Bob Shell Companion مثبّتة أو تعمل، أو قد يكون Bob Shell يعمل خارج مجلد مساحة العمل.

الحل:
  1. ثبّت إضافة Bob Shell Companion في IDE الخاص بك.
    2.
  2. انتقل إلى مجلد مساحة عملك في الطرفية.
    3.
  3. ابدأ Bob Shell من مجلد مساحة العمل.
    4.
  4. شغّل /ide enable في Bob Shell.
    5.

فشل الاتصال في حاوية dev container

الخطأ: لا يستطيع Bob Shell الاتصال بـ IDE عند التشغيل داخل حاوية dev container.

السبب: منفذ Bob Shell غير محوَّل من حاوية dev container إلى الجهاز المضيف.

الحل:
  1. احصل على منفذ Bob Shell من الطرفية داخل حاوية dev container: 
    echo $BOB_SHELL_CLI_IDE_SERVER_PORT
    مثال على الإخراج: 42991
    2.
  2. افتح لوحة الأوامر في IDE وحدد Forward a Port.
    3.
  3. أضف المنفذ الظاهر في الخطوة 1 (مثل 42991).
    4.
  4. ابدأ Bob Shell: 
    bob
    5.
  5. فعّل تكامل IDE: 
    /ide enable
    أو تحقق من حالة الاتصال: 
    /ide status
    6.

فشل الاتصال بإضافة IDE المرافقة

الخطأ: 🔴 Disconnected: Failed to connect to IDE companion extension

السبب: إضافة Bob Shell Companion غير مثبّتة أو غير مفعّلة أو لا تعمل في IDE الخاص بك.

الحل:
  1. تحقق من تثبيت وتفعيل إضافة Bob Shell Companion في IDE الخاص بك.
    2.
  2. افتح طرفية جديدة في IDE الخاص بك.
    3.
  3. شغّل /ide enable في Bob Shell.
    4.

انقطاع الاتصال بشكل غير متوقع

الخطأ: 🔴 Disconnected: IDE connection error. The connection was lost unexpectedly

السبب: انقطع اتصال IDE بسبب مشكلة في الشبكة أو إعادة تشغيل IDE.

الحل:
  1. شغّل /ide enable لإعادة الاتصال.
    2.
  2. إذا استمرت المشكلة، أعد تشغيل IDE الخاص بك.
    3.

عدم تطابق المجلدات

الخطأ: 🔴 Disconnected: Directory mismatch

السبب: يعمل Bob Shell في مجلد مختلف عن مساحة العمل المفتوحة في IDE الخاص بك.

الحل:
  1. انتقل إلى نفس المجلد المفتوح في IDE الخاص بك.
    2.
  2. أعد تشغيل Bob Shell من ذلك المجلد.
    3.

لا يوجد مجلد مساحة عمل مفتوح

الخطأ: 🔴 Disconnected: To use this feature, please open a workspace folder

السبب: لا يوجد مجلد أو مساحة عمل مفتوحة في IDE الخاص بك.

الحل:
  1. افتح مجلدًا أو مساحة عمل في IDE الخاص بك.
    2.
  2. أعد تشغيل Bob Shell.
    3.

تكامل IDE غير مدعوم

الخطأ: IDE integration is not supported in your current environment

السبب: Bob Shell لا يعمل من داخل الطرفية المدمجة في IDE مدعوم.

الحل: شغّل Bob Shell من داخل الطرفية المدمجة في IDE مدعوم.

مشاكل الإعداد

.bobignore لا يعمل

الخطأ: يتجاهل Bob Shell ملفات تريد منه الوصول إليها، أو يصل إلى ملفات تريد تجاهلها.

السبب: قد يحتوي ملف .bobignore على أنماط متعارضة أو ترتيب غير صحيح للأنماط أو يكون في موقع خاطئ. ربما لم تصبح التغييرات سارية المفعول بعد.

الحل:
  1. تحقق من ملف .bobignore للأنماط المتعارضة.
    2.
  2. تأكد من أن الأنماط الأكثر تحديدًا (مثل النفي بـ !) تأتي بعد الأنماط العامة.
    3.
  3. أعد تشغيل جلسة Bob Shell بعد إجراء التغييرات على .bobignore.
    4.
  4. استخدم المسارات المطلقة إذا لم تعمل المسارات النسبية كما هو متوقع.
    5.
  5. تحقق من أن ملف .bobignore موجود في مجلد جذر مشروعك.
    6.

الإعدادات لا تُطبَّق

الخطأ: لا تُسري تغييرات إعدادات Bob Shell.

السبب: قد يكون ملف الإعدادات في موقع خاطئ أو يحتوي على صيغة JSON غير صالحة أو يُتجاوز بواسطة مصادر إعداد ذات أولوية أعلى. ربما لم تصبح التغييرات سارية المفعول بعد.

الحل:
  1. تحقق من موقع ملف الإعدادات:
    • إعدادات المشروع: .bob/settings.json في مجلد مشروعك
    • إعدادات المستخدم: ~/.bob/settings.json في مجلدك الرئيسي
    2.
  2. تحقق من صحة صيغة JSON (استخدم مدققًا لـ JSON).
    3.
  3. تذكر ترتيب أولوية الإعداد:
    • وسيطات سطر الأوامر (أعلى أولوية)
    • متغيرات البيئة
    • إعدادات المشروع
    • إعدادات المستخدم
    • إعدادات النظام الافتراضية (أدنى أولوية)
    4.
  4. أعد تشغيل Bob Shell بعد تغيير ملفات الإعدادات.
    5.

التعليمات المخصصة لا تُحمَّل

الخطأ: لا تُطبَّق التعليمات المخصصة على جلسات Bob Shell.

السبب: قد تكون ملفات التعليمات المخصصة في موقع خاطئ أو تحتوي على امتدادات ملفات غير صحيحة أو لم تُحمَّل في السياق الحالي.

الحل:
  1. تحقق من أن الملفات في الموقع الصحيح:
    • على مستوى مساحة العمل: .bob/rules/ في جذر مشروعك
    • خاصة بالوضع: .bob/rules-{modeSlug}/ في جذر مشروعك
    2.
  2. تأكد من أن الملفات تحتوي على الامتدادات الصحيحة (.md أو .txt أو .xml).
    3.
  3. استخدم /memory refresh لإعادة تحميل جميع ملفات السياق.
    4.
  4. استخدم /memory show للتحقق من السياق الحالي.
    5.

مشاكل تشغيل الأوامر

الأمر غير موجود

الخطأ: command not found: bob

السبب: Bob Shell غير مثبّت بشكل صحيح أو غير موجود في PATH الخاص بنظامك.

الحل:
  1. تحقق من تثبيت Bob Shell: 
    which bob
    2.
  2. إذا لم يُعثر عليه، أعد تثبيت Bob Shell باتباع تعليمات التثبيت.
    3.
  3. تأكد من أن PATH الخاص بشيل النظام يتضمن مجلد تثبيت Bob Shell.
    4.

وضع الشل لا يعمل

الخطأ: وضع الشل (أمر !) لا يشغّل الأوامر.

السبب: قد لا تكون تكتب ! في موجّه فارغ، أو تفتقر إلى الأذونات اللازمة، أو قد يكون الأمر نفسه غير صالح.

الحل:
  1. تحقق من أنك تكتب ! في موجّه فارغ.
    2.
  2. تأكد من أن لديك الأذونات اللازمة لتشغيل أوامر الشل.
    3.
  3. جرّب تشغيل الأمر مباشرةً في طرفيتك أولاً للتحقق من أنه يعمل.
    4.

مشاكل الأداء

بطء في أوقات الاستجابة

الخطأ: يستجيب Bob Shell ببطء للطلبات.

السبب: مشاكل في اتصال الشبكة أو كثرة الملفات المحمّلة كسياق أو وجود ملفات ثنائية كبيرة في السياق.

الحل:
  1. تحقق من اتصال الشبكة.
    2.
  2. قلّص عدد الملفات في السياق باستخدام .bobignore.
    3.
  3. تجنب تضمين الملفات الثنائية الكبيرة أو المجلدات مثل node_modules/.
    4.
  4. فكّر في استخدام إشارات ملفات أكثر تحديدًا بـ @ بدلاً من تحميل جميع الملفات.
    5.

استخدام مرتفع للذاكرة

الخطأ: يستهلك Bob Shell ذاكرة مفرطة.

السبب: كثرة الملفات المحمّلة كسياق أو عدم استبعاد مجلدات كبيرة أو وجود استيرادات دائرية في ملفات الذاكرة.

الحل:
  1. قيّد عدد الملفات المحمّلة كسياق.
    2.
  2. استخدم .bobignore لاستبعاد المجلدات الكبيرة.
    3.
  3. أعد تشغيل Bob Shell بشكل دوري خلال الجلسات الطويلة.
    4.
  4. تحقق من وجود استيرادات دائرية في ملفات الذاكرة.
    5.

نصائح لتصحيح أخطاء Bob Shell

تفعيل سجلات التصحيح

لزيادة تفصيل السجلات لجلسة، استخدم علامة --log-level أو متغير البيئة BOB_LOG_LEVEL:

 
bob run --log-level debug "Explain @app.js"
BOB_LOG_LEVEL=debug bob chat

يمكنك أيضًا ضبط مستوى سجل دائم في ملف إعداداتك:

 
{
  "logging": {
    "logLevel": "debug"
  }
}

التحقق من إصدارك من Bob Shell

شغّل الأمر التالي لرؤية إصدارك من Bob Shell:

جلسة تفاعلية:

 
/about

جلسة غير تفاعلية:

 
bob --version

ملفات السجل

يكتب Bob Shell ملفات السجل إلى ~/.bob/logs/shell/. تُدار ملفات السجل تلقائيًا:
  • يُحتفظ بحد أقصى 10 ملفات سجل
    •
  • يُحدد حجم كل ملف بـ 5 ميجابايت
    •

للعثور على ملف السجل الحالي لجلسة:

 
ls -lt ~/.bob/logs/shell/ | head

شارك مقتطفات السجل ذات الصلة عند الإبلاغ عن المشاكل.

تحديد جذر مساحة العمل

يحدد Bob Shell جذر مساحة العمل بالصعود من مجلد العمل الحالي حتى يجد مجلد .git أو .bob. أول تطابق يصبح جذر مساحة العمل.

إذا لم يُعثر على مجلد .git أو .bob، يستخدم Bob Shell مجلد العمل الحالي كجذر لمساحة العمل.

ما رأيك في هذا الموضوع؟

المجلدات الموثوقة

تحكّم في المشاريع التي يمكنها استخدام القدرات الكاملة لـ Bob Shell مع أمان المجلدات الموثوقة.

ضبط إعدادات الوكيل

اضبط إعدادات الوكيل لـ Bob Shell في بيئات المؤسسات ذات قيود الشبكة

في هذه الصفحة

المصادقةأخطاء الشهاداتتكامل IDEفشل الاتصالفشل الاتصال في حاوية dev containerفشل الاتصال بإضافة IDE المرافقةانقطاع الاتصال بشكل غير متوقععدم تطابق المجلداتلا يوجد مجلد مساحة عمل مفتوحتكامل IDE غير مدعوممشاكل الإعداد.bobignore لا يعملالإعدادات لا تُطبَّقالتعليمات المخصصة لا تُحمَّلمشاكل تشغيل الأوامرالأمر غير موجودوضع الشل لا يعملمشاكل الأداءبطء في أوقات الاستجابةاستخدام مرتفع للذاكرةنصائح لتصحيح أخطاء Bob Shellتفعيل سجلات التصحيحالتحقق من إصدارك من Bob Shellملفات السجلتحديد جذر مساحة العمل