---
url: https://docs.ogmabox.com/ar/troubleshooting.md
description: >-
  تشخيص المشكلات الشائعة في إعداد Ogma والتقاط حركة الوكيل واعتراض HTTPS وبيئة
  تشغيل سطح المكتب والإضافات وMCP والماسح الأمني والتصدير.
---

# استكشاف الأخطاء وإصلاحها {#troubleshooting}

استخدم هذه الصفحة لتشخيص المشكلات الشائعة في إعداد Ogma وتشغيله.

## لا تظهر حركة مرور في سجل HTTP {#no-traffic-appears-in-http-history}

تحقق مما يلي:

1. مثيل Ogma قيد التشغيل.
2. يشير وكيل المتصفح أو التطبيق إلى منفذ الاستماع للمثيل، وهو عادة `127.0.0.1:8080`.
3. لا يتجاوز التطبيق المستهدف الوكيل.
4. لا تتجاوز إعدادات VPN أو وكيل النظام أو الحاوية أو المحاكي أو وكيل الهاتف إعدادات عميل الاختبار.
5. المشروع النشط مفتوح في مساحة العمل.

عند استخدام متصفح Ogma، افتح علامة تبويب جديدة وتأكد من ظهور شارة **عبر الوكيل**.

## تفشل طلبات HTTPS {#https-requests-fail}

تحقق مما يلي:

* شهادة هيئة التصديق CA الخاصة بـ Ogma مثبتة في مخزن الثقة الصحيح.
* استوردت شهادة CA إلى ملف تعريف المتصفح المستخدم فعليا.
* لا يستخدم الهدف تثبيت الشهادات.
* لا تستثني قواعد تمرير TLS المضيف.
* متطلبات شهادة العميل مضبوطة في **الإعدادات > شهادات العميل** إذا كان الهدف يتطلب mTLS.

بالنسبة إلى تطبيقات الهاتف أو سطح المكتب التي تستخدم تثبيت الشهادات، قد تحتاج إلى إعداد اختبار خاص بالتطبيق خارج Ogma.

## يوقف الاعتراض حركة مرور أكثر من اللازم {#intercept-pauses-too-much-traffic}

استخدم قواعد اعتراض أضيق.

الخطوات الموصى بها:

1. عطّل الاعتراض.
2. حدّد النطاق.
3. أضف شروط مطابقة للمضيف أو الطريقة أو المسار أو نوع المحتوى أو الترويسة.
4. أعد تفعيل الاعتراض.
5. راقب حجم قائمة الانتظار.

إذا بلغت قائمة الانتظار سعتها القصوى، يمرر Ogma حركة المرور الجديدة لتجنب وقوع العميل في حالة تعطل متبادل.

## يعرض الماسح الأمني نتائج غير مهمة كثيرة {#scanner-reports-too-much-noise}

لتقليل النتائج غير المهمة في الفحص السلبي:

* فعّل النطاق قبل الفحص.
* ركّز أولا على النتائج متوسطة وعالية وحرجة الخطورة.
* تعامل مع نتائج الترويسات المفقودة وفقا للسياق.
* استخدم قواعد سلبية مخصصة للأدلة الخاصة بالمشروع.

لتقليل النتائج غير المهمة في الفحص النشط:

* افحص طلبات محددة قبل فحص السجل بالكامل.
* راجع طلبات الإثبات وأجسام الاستجابات.
* تأكد من أن الأدلة الواردة في الاستجابة لم تكن موجودة في الاستجابة المرجعية.
* تحقق مما إذا كانت درجة الثقة في النتيجة مرجحة أم مؤكدة.

## لا تُحمّل الإضافات {#plugins-do-not-load}

تحقق مما يلي:

1. يحتوي المجلد الجذر للإضافة على `manifest.json`.
2. توجد مسارات نقاط الدخول المحددة في ملف البيان بعد البناء.
3. الإضافة مُجمّعة إلى JavaScript عادي.
4. أصول الواجهة الأمامية مضمنة في حزمة الإضافة.
5. الأذونات المطلوبة مُعلنة وممنوحة.
6. لا تحتوي علامة تبويب سجلات الإضافة على أخطاء `init()` أو الجسر.
7. حجم حزمة الإضافة أقل من الحد المضبوط.

## لا يستطيع مساعد MCP الوصول إلى Ogma {#mcp-assistant-cannot-see-ogma}

تحقق مما يلي:

* HTTP المضمن: يعمل MCP في **الإعدادات > MCP** ويستخدم العميل نقطة نهاية Streamable HTTP المنسوخة، وهي عادة `http://127.0.0.1:3000/mcp`.
* stdio المستقل: مسار الملف التنفيذي صحيح، ويتطابق `--api-url` / `OGMA_API_URL` مع الواجهة الخلفية قيد التشغيل. قد تستخدم مثيلات سطح المكتب منفذ API ديناميكيا.
* يتابع العميل جميع مؤشرات `tools/list`؛ فالصفحة الأولى وحدها لا تحتوي على جميع الأدوات.
* تتطلب أدوات الكتابة أو الإرسال أذونات صريحة في الإعدادات أو أعلام تشغيل مستقلة.
* أعد الاتصال بعد إعادة تشغيل MCP. لم تعد معرفات الجلسات ورموز التأكيد القديمة صالحة.

راجع [إعداد MCP](./mcp-setup.md).

## متصفح Ogma فارغ أو في موضع غير صحيح {#ogma-browser-is-blank-or-mispositioned}

تحقق مما يلي:

* تستخدم تطبيق سطح المكتب، وليس الواجهة الأمامية للويب فقط.
* تحتوي علامة التبويب النشطة على عنوان URL فعلي وليس `about:blank`.
* جرّب فتح المتصفح في نافذة منفصلة.
* غيّر حجم نافذة Ogma لفرض إعادة حساب حدود المتصفح.

## يتسبب JavaScript أو CSS المخصص في تعطل الواجهة {#custom-javascript-or-css-breaks-the-ui}

استخدم أحد مساري الاستعادة:

* انقر على **إعادة تعيين الواجهة المخصصة**.
* اضغط `Ctrl+Alt+Shift+R`.

يؤدي ذلك إلى مسح JavaScript وCSS المخصصين من التخزين المحلي وإعدادات سطح المكتب وتفضيلات الواجهة الخلفية، ثم إعادة تحميل Ogma.

## تبدو البيانات أو المشروع غير صحيحة {#data-or-project-looks-wrong}

تحقق مما يلي:

* المثيل الصحيح مفتوح.
* المشروع الصحيح نشط.
* لم تؤد تفضيلات بدء التشغيل إلى إعادة فتح مثيل آخر.
* لا تخفي عوامل التصفية أو النطاق الصفوف المتوقعة.
* لا يستثني إخفاء الأصول الثابتة نوع المحتوى الذي تبحث عنه.

أنشئ نسخة احتياطية قبل تعديل بيانات المشروع يدويا.