دليل تشغيل Engine

ContextMint Engine هو تطبيق شريط النظام على سطح المكتب الذي يدير خادم API الخاص بـ Python، وOllama، ومهام الفهرسة، وتشخيصات المشغّل. يستخدم المطوّرون VS Code للمحادثة اليومية؛ ويستخدم المشغّلون والقادة Engine للصحة والسعة.

شريط النظام ودورة التشغيل

  • Start all — خادم API + Ollama (محلي أولاً)
  • Stop all — إيقاف تدريجي؛ تُظهر الإضافة حالة غير متصل
  • خيارات التشغيل التلقائي في الإعدادات (خدمة نظام التشغيل / تسجيل الدخول — حسب المنصة)

تبويب النظرة العامة

بطاقات سريعة:

  • الجاهزية — الخادم، وOllama، وRedis (إن استُخدم)، وملاحظات طبقة البيانات
  • مساحات العمل — المستودعات المسجّلة، حالة الفهرسة، تفاصيل تؤدي إلى الفهرسة / الجودة
  • مسارات المحادثة (الجلسة) — أعداد تدفقات Repo / Work / Hybrid ومقاييس اقتراح مسار Work

تبويب الخادم

  • المنفذ وعنوان الربط (الافتراضي loopback)
  • إعادة تشغيل الخادم دون إغلاق Engine
  • رابط إلى /api/health لعرض بيانات الصحة الخام بصيغة JSON

تبويب Ollama

  • حالة التشغيل والرابط
  • إعادة تشغيل عملية Ollama
  • التشغيل الأول: رابط تثبيت إذا لم يُعثر على الملف التنفيذي

تبويب النماذج

  • النماذج المثبتة مقابل المتاحة للسحب
  • نموذج التضمين المستخدم للفهرسة (تغييره قد يتطلب إعادة فهرسة)
  • نموذج المحادثة الافتراضي للتوجيه المحلي
  • نماذج الرؤية — اسحب moondream أو llava أو qwen2-vl لأسئلة وأجوبة لقطات الشاشة وتدقيقات ARGUS

تبويب الفهرسة

  • تقدّم كل مساحة عمل، وعدد الملفات، والأخطاء
  • إعادة فهرسة يدوية / إجراءات تفعيل مساحة العمل
  • تفاصيل حالة الملفات على مستوى المستودعات الكبيرة

تبويب الجودة

  • تشغيل فحوصات الجودة (التكرارات، الإشارات البنيوية)
  • تغذّي النتائج درج الحوكمة في VS Code
  • تقدّم الفحص للمستودعات طويلة التشغيل

تبويب المعرفة

تصفّح سجلّات طبقة المعرفة وقت الفهرسة وتتبّع أحداث تدقيق النشاط المنقّحة — المكمّل التشغيلي لحوكمة VS Code. راجع المعرفة والحوكمة للاطلاع على أمثلة عملية، والاستمرارية (Structure غير محدودة زمنياً؛ تفترض واجهة Activity نافذة من 1 إلى 24 ساعة افتراضياً)، وقائمة تحقق لقطات الشاشة.

  • Structure — المسارات، والخدمات، والمستندات، والأقسام، والسياسات؛ جدول قابل للبحث + معاينة رسم بياني
  • Activity — تتبّع سجل التدقيق JSONL (governance_fast_path، تدفقات المحادثة، الإجراءات)؛ تصدير JSON

تبويب السجلات

  • تتبّع سجلات الخادم مع مرشّح النافذة الزمنية
  • استخدمه عند فشل المحادثة أو الفهرسة بشكل متقطع

تبويب الإعدادات

  • مسار Python، ومسار حزمة الخلفية
  • تجاوز رابط الخادم، ورابط Ollama
  • إعدادات المشغّل المعكوسة من الإعدادات الافتراضية للخادم عند إتاحتها

ميزانية السياق

افتح Context budget في تنقل Engine لضبط max_context_tokens (سقف شحن RAG) وتطبيق max_gen_tokens (طول الإجابة / num_predict في Ollama) معاً حسب فئة عتادك. تُحفظ القيم في ~/.contextmint/server.defaults.yaml؛ أعد تشغيل الخادم بعد التطبيق. حساب التحجيم التفاعلي: حاسبة ميزانية السياق.

حول وحزمة الدعم

صدّر حزمة دعم (الإصدارات، إعدادات منقّحة، السجلات الأخيرة) عند فتح مشكلات GitHub أو المراسلة عبر anis@contextmint.ai.

مشكلات: استكشاف الأخطاء ← المحرك والخادم.