تخطَّ إلى المحتوى
Documentation

Eve AI لـ VS Code

Eve AI هو وكيل البرمجة الرسمي من CHAMPREP، المدمج مباشرةً في الشريط الجانبي لـ Visual Studio Code. قم بالبرمجة المشتركة مع قاعدة الكود الخاصة بك، واطرح الأسئلة، وخطط لتغييرات معقدة في البنية، واسمح لـ Eve بتحرير الملفات في مساحة العمل الخاصة بك بموافقتك الصريحة.

كان يُعرف Eve AI سابقًا باسم CHAMPREP AI؛ يشير كلا الاسمين إلى نفس الوكيل ويستخدمان بالتبادل عبر المنصة.

التثبيت من متاجر الإضافات

Section titled “التثبيت من متاجر الإضافات”

يتوفر Eve AI في كلا سجلي الإضافات الرئيسيين:

Marketplaceالأفضل لـرابط
سوق Visual Studio CodeMicrosoft VS Code الرسميEve AI في سوق VS Code
افتح سجل VSXVSCodium، Gitpod، Cursor، Eclipse Theia، WindsurfEve AI على Open VSX

الخيار أ: التثبيت من واجهة مستخدم VS Code

Section titled “الخيار أ: التثبيت من واجهة مستخدم VS Code”
  1. افتح Visual Studio Code.
  2. افتح عرض «الإضافات» (Ctrl+Shift+X أو Cmd+Shift+X).
  3. ابحث عن Eve AI (أو champrep-ai).
  4. حدد التثبيت.

الخيار ب: التثبيت من سطر الأوامر

Section titled “الخيار ب: التثبيت من سطر الأوامر”

قم بتشغيل الأمر التالي في محطة العمل الخاصة بك:

Terminal window
code --install-extension champrep.champrep-ai

إذا كنت تستخدم VSCodium أو محررًا بديلًا تم تكوينه باستخدام Open VSX:

Terminal window
codium --install-extension champrep.champrep-ai

المتطلبات الأساسية: CHAMPREPCLI

Section titled “المتطلبات الأساسية: CHAMPREPCLI”

تستخدم Eve AI المحلي (CHAMPREPCLIالإصدار 0.3.6 أو أحدث) للمصادقة بشكل آمن، وتخزين بيانات الاعتماد في سلسلة المفاتيح الخاصة بنظام التشغيل الخاص بك، وتشغيل الخلفية الخاصة بالوكيل:

  1. قم بتثبيت باستخدامCLI المُثبِّتCLI:

    Terminal window
    # macOS or Linux (Homebrew):
    brew tap champrep/cli
    brew install champrep
    # Or direct curl installer:
    curl -fsSL https://cli.champrep.com/install.sh | sh
  2. افتح مجلد مشروعك في VS Code و ثق بمساحة العمل عند المطالبة بذلك. تعمل Eve فقط داخل مساحات عمل موثوقة حفاظًا على أمانك.

:::tip[أوامر المحطة الطرفية القابلة للتبديل] يتضمنCLI كلاً من champrep الأداة والمخصصة eve ملف ثنائي للوكيل. قيد التشغيل eve, eve ai, champrep ai، أو champrep eve في محطة العمل الخاصة بك تُطلق جلسة وكيل البرمجة الثنائية نفسها تمامًا. :::

متصل بالنظام البيئي بأكمله

Section titled “متصل بالنظام البيئي بأكمله”

تكمن القوة الرئيسية لـ Eve AI في أنها تربطك مباشرةً بمساحة العملCHAMPREP الكاملة بدلاً من العمل كأداة دردشة منفصلة:

  • Drive & المستندات: اسحب المواصفات المعمارية ومتطلبات العملاء وملاحظات التصميم وجداول البيانات المخزنة في مباشرةًCHAMPREPDrive إلى سياق التطوير الخاص بك.
  • Mail & Calendar: تحقق من اجتماعات البرمجة الثنائية القادمة، واطلع على دعوات الجدولة، وراجع المراسلات دون الحاجة إلى التبديل إلى متصفح الويب.
  • Work & التذاكر: افحص لوحات العمل، واطلع على تقارير الأخطاء أو الميزات المخصصة، وقم بتغيير حالات التذاكر مباشرةً أثناء إجراء عمليات التثبيت للكود.
  • Notes: قم على الفور بتصدير ملخصات التنفيذ، وقوائم المراجعة التي تم إنشاؤها، أو تفسيرات الكود إلى .CHAMPREPNotes
  • بروتوكول سياق النموذج (MCP): تفاعل بسلاسة مع خوادم MCP المستضافة والمحلية على حد سواء.
  • جسر متصفح Chrome: تواصل مع CHAMPREP لملحق Chrome للتقاط حالة DOM للمتصفح في الوقت الفعلي، وإرفاق علامات التبويب النشطة، وتحليل لقطات شاشة واجهة المستخدم على الويب.

بشكل افتراضي، تقوم «إيف» بفحص مساحة العمل الخاصة بك بطريقة غير مدمرة. يمكنها قراءة الملفات، وتحليل أشجار الدلائل، وشرح الأنماط غير المألوفة، ووضع خطط تنفيذ متعددة الخطوات دون المساس بأي ملف على القرص.

2. تعديلات الملفات بموافقتك الصريحة

Section titled “2. تعديلات الملفات بموافقتك الصريحة”

عندما تكون مستعدًا لكي تكتب Eve الكود، حدد تطبيق تعديلات الملف خيار. تعرض Eve الفروق المقترحة وتطلب تأكيدك قبل كتابة أي تغييرات في مجلد مساحة العمل.

3. إضافة التحديد إلى الدردشة

Section titled “3. إضافة التحديد إلى الدردشة”

قم بتمييز أي جزء من الكود في محررك، وانقر بزر الماوس الأيمن، ثم حدد Eve AI: إضافة التحديد إلى Chat (أو استخدم لوحة الأوامر). يتم إرفاق الملف ونطاق الأسطر المحددين مباشرةً بموجه الدردشة الحالي.

4. الوكيل الكامل في المحطة الطرفية

Section titled “4. الوكيل الكامل في المحطة الطرفية”

هل تحتاج إلى تشغيل مجموعات الاختبارات، أو تشغيل المُجمِّعات، أو بدء خوادم التطوير، أو تشغيل سير عمل متعدد الوكلاء؟ انقر Eve AI: فتح الوكيل الكامل في Terminal لفتح محطة طرفية تفاعلية تعمل eve مع إدارة كاملة للصدفة (shell) والعمليات.

5. التبديل بين الحسابات المتعددة

Section titled “5. التبديل بين الحسابات المتعددة”

Work عبر المشاريع الشخصية ومؤسسات العملاء وفرق المؤسسات دون الحاجة إلى تسجيل الخروج. انقر على الحساب النشط في شريط الحالة أو قم بتشغيل Eve AI: Select Account للتبديل بين الحسابات على الفور.

افتح Eve AI الرمز الموجود في شريط الأنشطة واختر تسجيل الدخول:

  • تسجيل الدخول عبر المتصفح (موصى به): اختر تسجيل الدخول عبر المتصفح. سيفتح متصفحك صفحة المصادقةCHAMPREP. قم بتأكيد الموافقة وأدخل رمز التحقق المكون من 8 أرقام في المطالبة في VS Code.
  • API مفتاح: الصق CHAMPREPAPIمفتاحًا يحتوي على ai:agent النطاق. يتم حفظ بيانات الاعتماد بشكل آمن في سلسلة مفاتيح نظام التشغيل الخاص بك.

لتبديل الحسابات، قم بتشغيل Eve AI: Select Account من لوحة الأوامر (Ctrl+Shift+P / Cmd+Shift+P).

قم بتكوين Eve AI ضمن الإعدادات (Cmd+, أو Ctrl+,)، ابحث عن champrepAi:

الإعدادالافتراضيالوصف
champrepAi.cliPathchamprepمسار الملف القابل للتنفيذCLI (على سبيل المثال champrep أو /usr/local/bin/eve)
champrepAi.modelautoمعرف النموذج؛ auto يختار النموذج الأمثل لكل موجه

تحتفظ الإعدادات بـ champrepAi.* البادئة للحفاظ على التوافق مع الإصدارات السابقة.

جميع الأوامر متاحة في لوحة الأوامر في VS Code:

الأمرالمعرفالإجراء
Eve AI: تسجيل الدخولchamprepAi.signIn / eveAi.signInالمصادقة عبر المتصفح أو APIمفتاح
Eve AI: حدد الحسابchamprepAi.selectAccount / eveAi.selectAccountتبديل الملف الشخصي/الحساب النشط
Eve AI: تسجيل الخروجchamprepAi.signOut / eveAi.signOutتسجيل الخروج من الحساب المحدد
Eve AI: جديد ChatchamprepAi.newChat / eveAi.newChatابدأ محادثة جديدة
Eve AI: إضافة التحديد إلى ChatchamprepAi.addSelection / eveAi.addSelectionأرسل مقتطف الكود المحدد إلى الدردشة
Eve AI: فتح الوكيل الكامل في محطة العملchamprepAi.openCli / eveAi.openCliقم بتشغيل وكيل المحطة الطرفية التفاعلي (eve)
Eve AI: تحديثchamprepAi.refresh / eveAi.refreshإعادة تحميل حالة الوكيل والاتصالات
Eve AI: التحقق من حالة ملحق ChromechamprepAi.browserStatus / eveAi.browserStatusتحقق من الاتصال بـ لـCHAMPREP Chrome

كلا champrepAi.* و eveAi.* يتم دعم معرفات الأوامر في ارتباطات المفاتيح المخصصة.