البدء

ثبّت Engine والامتداد

يُشحن ContextMint كامتداد VS Code مع خلفية. المسار الافتراضي محلي أولاً: Engine على جهازك يدير الخادم وOllama؛ يتصل الامتداد عبر loopback. يمكن للفرق المؤسسية تشغيل API سيادي داخل البنية المحلية (متوافق مع OpenAI / vLLM + OIDC) بدلاً من ذلك — انظر الخادم السيادي · نماذج النشر. إذا فشل أي شيء أثناء التثبيت، افتح دعم التثبيت أولاً.

اختر نموذج النشر

محلي أولاً (ابدأ هنا)

Engine والامتداد على نفس الجهاز. مسار محلي أولاً سيادي، بدون خادم مشترك. اتبع الخطوات 1–3 أدناه.

API سيادي داخل البنية المحلية (تجربة مؤسسية)

فريق المنصات ينشر API + استدلال متوافق مع OpenAI (vLLM). يضبط الامتداد ContextMint.serverUrl + enterpriseMode. يتطلب مواءمة المسارات (Remote SSH أو مستودع mount). الدليل السيادي ←

محلي أولاً — ما تحتاجه

  • Windows 10+ أو macOS 12+ أو Linux x64
  • VS Code 1.85 أو أحدث
  • Ollama مثبّت (يمكن لـ Engine إرشاد إعداد التشغيل الأول)
  • مساحة عمل كود تريد فهرستها

الخطوة 1 — ContextMint Engine

يُثبَّت Engine مثل Ollama أو Docker Desktop: تطبيق شريط قائمة/سطح مكتب مع نافذة مشغّل عملية عند فتحه. اختر System أو Light أو Dark من الرأس أو الإعدادات. حمّل المثبّت من GitHub Releases.

Windows x64 contextmint-engine-win-x64.msi
macOS contextmint-engine-macos-universal.dmg
Linux x64 contextmint-engine-linux-x64.AppImage

التشغيل الأول يشغّل معالجاً قصيراً: اكتشاف Ollama، وتشغيل الخدمات، ورابط لتثبيت الامتداد. Start at login مفعّل افتراضياً — غيّره في Engine → Settings.

الخطوة 2 — ContextMint امتداد

ثبّت من VS Code Marketplace، أو حمّل .vsix من نفس GitHub Release الخاص بـ Engine.

افتح أي مجلد مساحة عمل. يتصل الامتداد بـ localhost:8000 ويسجّل مستودعك للفهرسة تلقائياً.

الخطوة 3 — أول محادثة

  1. تأكّد أن سطح Engine يظهر الخادم سليماً (أخضر).
  2. افتح VS Code على مجلد مشروعك.
  3. اضغط Ctrl+Shift+Alt+L أو افتح Chat من شريط النشاط.
  4. انتظر حتى تصبح الجاهزية Ready (قد تستغرق الفهرسة دقائقاً على المستودعات الكبيرة).
  5. اختياري: Engine → Models → اسحب نموذج رؤية (moondream) إذا كنت تخطط للصق لقطات واجهة.
  6. راجع Context Lens، ثم أرسل سؤالك الأول — أو الصق لقطة شاشة واسأل عنها.

في قائمة compose ⋯، اضبط Context على Repo لأسئلة الكود (افتراضي)، أو Work للتخطيط أو المراسلات، أو Hybrid عندما تريد أدلة المستودع مع التوصيات.

شريط الحالة يظهر ContextMint | Ready عندما يكون Engine والخلفية سليمين. قائمة قدرات الإصدار 1.0 الكاملة: الميزات ← · وثائق المستخدم ← · استكشاف الأخطاء ←

اختياري — توجيه سحابي (BYOK)

غير مطلوب لسير العمل الافتراضي. إذا وافق فريقك على استدلال هجين، فعّل cloud routing في إعدادات الامتداد وأضف مفاتيح API للمزود عبر ContextMint: Configure Cloud API Key. تُخزَّن المفاتيح في أسرار VS Code على جهازك — وليس في Engine أو إعدادات الخادم. يُنقَّى السياق المجمّع قبل أي إرسال سحابي. يبقى Ollama المحلي الافتراضي. التفاصيل: الأسئلة الشائعة · الثقة والأمان.

المؤسسات — API سيادي داخل البنية المحلية (تجربة)

للفرق المنظمة التي تشارك مضيف GPU واحد أو فهرس monorepo. ليس بديلاً عن Engine على كل حاسوب محمول — هذا خادم API تديره المنصة مع استدلال متوافق مع OpenAI (عادةً vLLM). لا تخلط بين «المؤسسات» و«Ollama tray على صندوق مشترك فقط».

  1. ينشر فريق المنصات مكدّس API (Docker Compose) مع Chroma وRedis وURL استدلال متوافق مع OpenAI (overlay vLLM شائع).
  2. اربط أو استنسخ المستودع على مضيف الخادم بحيث تتطابق مسارات الفهرسة مع ما يفتحه المطوّرون في VS Code (Remote SSH هو النمط الشائع).
  3. فعّل مصادقة الخادم (AUTH__ENABLED)، واضبط مُصدِر/جمهور OIDC، وقوائم السماح للنطاقات.
  4. كل مطوّر: يثبّت الامتداد فقط، ويضبط ContextMint.serverUrl على نقطة HTTPS للفريق، ويفعّل ContextMint.enterpriseMode، ويضبط ContextMint.oidcProviderId (مثل microsoft).
  5. اختياري: اضبط ContextMint.localFallbackUrl إذا كان Chat يجب أن يعود إلى engine محلي عندما يكون خادم الفريق غير متاح.

الدليل الكامل للمنصة: نشر الخادم السيادي. تواصل معنا لتجربة شريك تصميم — مراجعة بنية، واستراتيجية مسارات، ودعم استبيان أمان: مركز الثقة · شركاء التصميم.

التشغيل من السطح

Engine ليس لوحة تحكم يومية — بل تحكم في الاسترداد ودورة الحياة.

  • Tray — أخضر / كهرماني / أحمر بنظرة واحدة؛ Start all / Stop all
  • Overview — مشكلات الجاهزية عندما يحتاج شيء انتباهاً
  • Server · Ollama · Indexing — تعمّق فقط عند التصحيح
  • Logs / About — تشخيص وتصدير حزمة الدعم

عالق؟

إصلاحات شائعة قبل فتح issue على GitHub.

  • الخادم غير متصل → افتح Engine و Start all
  • Chat محظور → عادةً offline أو starting — وليس الفهرسة
  • Ollama غير متصل → وضع Limited ؛ قد يعمل البحث، والتوليد متدهور

استكشاف الأخطاء وثائق المستخدم الأسئلة الشائعة

تحتاج تجربة موجهة؟

قدّم طلباً كشريك تصميم لتجربة تقييم 30 يوماً (قابلة للتمديد إلى 90) مع دعم هندسي مباشر وملخص مكتوب لأصحاب المصلحة. يفتح التسجيل مع بداية سبتمبر 2026.

احجز عرضاً الثقة والأمان