Sourcegraph Cody

مقدمة

Sourcegraph Cody يقدم قدرة عملية للمهندسين على تحويل مستودعات الشيفرة إلى مصدر معرفة قابل للاستفسار والتعديل الفوري، مما يجعل الاستكشاف والتحرير والتوثيق عبر قواعد الشيفرة الكبيرة أمراً أسرع وأدق من الاعتماد على البحث اليدوي أو الذاكرة الفردية.

ما هي الأداة؟

Sourcegraph Cody هي مساعد برمجي مدفوع بالذكاء الاصطناعي مخصَّص للعمل على الشيفرة المصدرية والمستودعات. يجمع Cody بين تقنيات بحث الشيفرة المتقدمة لـ Sourcegraph (مثل البحث الوراثي والسياق القائم على الفهارس) وآليات الاسترجاع المعزّز بالتوليد (RAG — Retrieval-Augmented Generation) التي تعتمد على تضمينات (embeddings) للسياق، مع محركات نماذج لغوية كبيرة (LLMs) للتوليد والشرح والتكميل. يتكامل Cody مع:

• واجهة الويب لـ Sourcegraph (Cody Chat داخل المتصفح).
• ملحقات IDE شائعة مثل VS Code وJetBrains.
• نُهج الاستضافة المتعددة: Sourcegraph Cloud أو Self-hosted (Cody Server) لمتطلبات الخصوصية والأمن.

وظيفياً، يوفر Cody: دردشة سياقية عن الشيفرة (Cody Chat)، اقتراحات وتكملة شفرة قائمة على سياق المستودع، ميزات خاصة بالمراجعات وإنشاء طلبات السحب (PR)، توليد تغييرات مقترحة (diffs)، تفسير وظائف وتعليقات، وسائل لكتابة اختبارات وأدلة تشغيل (runbooks) استناداً إلى شجرة المشروع المفهرسة.

الميزات الرئيسية

• استرجاع السياق عبر الفهرس (Repository-aware RAG):

  قبل إنشاء الإجابة، يبحث Cody داخل فهرس Sourcegraph عن أجزاء الشيفرة والمستندات الأكثر صلة باستخدام تضمينات ونقاط تطابق دقيقة، ثم يُقدّم هذه المقتطفات للنموذج للرد. هذا يقلل من الاعتماد على نافذة السياق المحدودة للنموذج ويزيد من قابلية التتبّع للمصادر.

• دردشة سياقية مدمجة (Cody Chat):

  واجهة دردشة تسمح بطرح أسئلة عن الدوال، الاعتماديات، أو أخطاء اختبارية. تعرض الردود المقتطفات المرجعية مع وصلات إلى المواضع في المستودع، وتدعم أوامر مثل “اعطني diff لتعديل X” أو “أنشئ PR مع هذا التعديل”.

• اقتراحات وتكميل شفرة داخل IDE:

  تعمل الملحقات على تقديم اقتراحات تعتمد على ملفّات متعددة في المشروع، وليس فقط على الملف المفتوح حالياً؛ ما يجعل التكميل واعياً بالواجهات العامة (APIs) والبُنى المعمارية للمشروع.

• دعم دقيق للذكاء الشيفري (Precise code intelligence):

  عند إعداد LSIF أو فهرسة Sourcegraph، يمكن لـ Cody ربط الرموز (symbols) عبر الملفات وتقديم إجابات دقيقة مثل مواقع التعريف والاستخدام، مما يفيد عند شرح الاعتمادية أو تتبع مصدر خطأ.

• أنشطة تلقائية لإنشاء أو تعديل PRs:

  يمكن للمستخدم طلب “إنشاء PR يصلح X” وسيقترح Cody مجموعة تغييرات (diff) يمكن استعراضها محلياً أو عبر الواجهة لرفعها كفرع وطلب سحب.

• مرونة في المزودين والنماذج:

  يدعم تشغيل Cody مع مزوِّدي LLMs خارجيين (مثل OpenAI أو نماذج مُدارة داخلياً) أو بنية Self-hosted عبر Cody Server، لتلبية متطلبات السرية والامتثال.

• سياسة أمنية للمحتوى الخاص (Private code handling):

  خيارات لتشغيل الفهرسة داخل الشبكة الداخلية أو على Cloud مع تحكم بالوصول، مع إمكانية الاحتفاظ بسجل الاستعلامات والسياسات للتحكم بما يُرسَل إلى مزودي LLM خارجيين.

كيفية الاستخدام

متطلبات مبدئية

• حساب Sourcegraph Cloud أو مثيل Sourcegraph Self-hosted مُهيأ.
• إمكانية الوصول إلى المستودعات (GitHub/GitLab/Bitbucket) وربطها بـ Sourcegraph.
• اختياري: مفتاح API لمزوِّد نموذج لغوي (OpenAI/Anthropic/etc.) إذا أردت استخدام مزوِّد خارجي.

خطوات عملية للتثبيت والتهيئة

1. التسجيل وتثبيت Sourcegraph:

   إن كنت تستخدم Cloud: سجِّل عبر sourcegraph.com وأنشئ مؤسسة (organization). إن أردت Self-hosted: اتبع دليل التثبيت الرسمي لتشغيل Sourcegraph داخل شبكة الشركة (يتطلب Kubernetes أو Docker حسب الدليل).

2. ربط المستودعات:

   من لوحة الإدارة (Site Admin) أضِف ربط GitHub/GitLab. امنح Sourcegraph صلاحيات قراءة المستودعات المطلوبة. بعد الربط، ستُعرض المستودعات في واجهة البحث.