منح وكلاء الذكاء الاصطناعي سياق مستودع كبير بدون فهرس محلي

المستودعات الكبيرة لا تناسب نافذة السياق، وإذا سبق لك أن وجّهت فهرسًا مبنيًا على الحاسوب المحمول نحو مستودع موحّد حقيقي، فأنت تعرف أنه لا يناسبه بشكل مريح هناك أيضًا — تقفز ذاكرة الوصول العشوائي، ويستغرق الفهرسة الأولى ساعة، ويبدأ وكيلك مع ذلك الجلسة التالية بتخمين الملفات المهمة.

الإجابة المعتادة هي تشغيل فهرس بجانب المحرر، وبالنسبة لمستودع يناسب جهازًا واحدًا بشكل مريح، هذه إجابة جيدة. إذا كان مستودعك الموحّد يُفهرَس بسرعة بالفعل في Cursor وكان ذلك هو المكان الوحيد الذي تحتاج فيه إلى الخريطة، فلا شيء يضيفه هذا المقال — تخطَّه.

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

متى يصبح الفهرس المحلي الأداة الخاطئة

يفترض الفهرس المحلي أن الكود يعيش على نفس الجهاز الذي يستعلمه، وعلى نطاق مستودع موحّد حقيقي، يتوتر ذلك الافتراض حتى داخل محرر واحد. المستودع ببساطة أكبر مما تريد إبقاءه ‘ساخنًا’ على الحاسوب المحمول: تعمل في حزمة واحدة بينما يقع نطاق التأثير على بُعد ثلاثة أدلة، والفهرسة الباردة الأولى لشجرة مكوّنة من مليوني سطر ليست شيئًا تريد المرور به مرتين — سواء على جهازك الخاص، أو على عامل CI الذي لم يستنسخ تلك الشجرة من قبل. أو ينبغي أن يتمكن زميل الفريق من استعلام نفس الخريطة التي تستعلمها، دون انتظار جهازه الخاص ليكافح مع نفس الفهرس.

لا شيء من هذا سبب للتخلص من فهرس محرر جيد. إنه سبب لامتلاك خريطة مستضافة أيضًا يمكن لأي من وكلائك استعلامها عبر MCP.

ومشكلة النطاق تلك أعمق من ‘الكثير من الملفات للصق’. على شجرة كبيرة، السؤال المثير للاهتمام نادرًا ما يكون ‘أرني هذا الملف’ — إنه أي ملف، أي رمز، من يستدعي، أي اختبار. الوكيل الذي يبدأ بسرد src/ وقراءة أول ثلاث نتائج سيفوّت بسعادة المعالج في apps/api والعميل المُولَّد في packages/sdk. ما تحتاجه هو استرجاع مبني من الشجرة بأكملها، ثم مُصنَّف، ثم مقتبس.

ماذا يعني ‘سياق مستودع كبير’ فعليًا

إلقاء الملفات في الطلب ليس سياقًا — إنه نسخ أصغر وأسوأ للشجرة. ما يحتاجه وكيلك فعليًا هو طرح سؤال والحصول على إجابة مقتبسة تعود إليه: أين يُعرَّف هذا الرمز ومن يستدعيه، وما الذي يعتمد على الوحدة التي سأغيّرها، وأي ملفات اختبار تغطي هذا السلوك، وكيف تبدو تلك الشجرة الآن، وليس الربع الماضي.

يجب أن تأتي تلك الإجابات من فهرس مبني من مستودعك، وليس من ذاكرة النموذج عن مستودع شخص آخر، ويجب أن يعيش ذلك الفهرس في مكان ما خارج نافذة سياق الوكيل. لهذه المشكلة، ينبغي أن يعيش أيضًا في مكان ما خارج حاسوبك المحمول.

شيء آخر لا تستطيع ملفات التعليمات فعله لك: CLAUDE.md وAGENTS.md هما المكانان الصحيحان للأعراف والسلوك، لكنهما ليسا خريطة حية ومُصنَّفة وقابلة للاستعلام لشجرة مكوّنة من مليوني سطر. استخدم القواعد للسلوك؛ استخدم ذكاء المستودع للحقائق.

نبني الخريطة في السحابة، وأنت تستعلمها من أي عميل

Maguyva هي طبقة سياق قاعدة كود MCP عن بُعد. تربط GitHub، وتختار مستودعك، ويمكنك أن تبتعد بينما يحلّل خط الأنابيب السحابي الشجرة، ويبني الرموز وحواف الرسم البياني، ويحافظ على خريطة مُصنَّفة — دون الحاجة أبدًا إلى فهرس محلي.

عندما تدفع كودًا، تُحلَّل الملفات المتغيرة تدريجيًا، وتُعاد بناء طبقات الرسم البياني والتصنيف وفق جدول: يوميًا في الخطة المجانية، وكل ساعة في الخطط المدفوعة. كل لقطة مختومة بالوقت، حتى يتمكن وكيلك من معرفة أي نسخة من الشجرة يقرأ. القيد الصادق هنا هو العمل المحلي غير المتزامن — التغييرات الموجودة فقط في شجرة عملك، والتي لم تُدفَع أبدًا، ليست بعد في الخريطة المستضافة.

ثم تربط أي عميل تستخدمه بالفعل بإضافة مفتاح API إلى تكوين MCP الخاص به. توجد أدلة إعداد لـ 24 عميل MCP موثّق، ويمكن لأي عميل آخر متوافق مع MCP يدعم التكوين القياسي أن يتصل أيضًا. إذا كان Cursor هو المكان الذي تعيش فيه، فإن صفحة Cursor ترسم ذلك المسار؛ نفس الخادم يستجيب لـ Claude Code وVS Code وWindsurf وCodex CLI والباقي.

أنت لا تغيّر المحرر. أنت تمنح وكيلك سطح أدوات — 11 أداة MCP عبر البحث والرموز وتحليل التبعيات واسترجاع الملفات وسياق المستودع — مع تغطية لأكثر من 279 لغة وتقنية قائمة على النص، مما يعني أكثر مما اعتقدت لمستودع موحّد توقف منذ زمن طويل عن كونه لغة واحدة.

تعود الإجابات مدعّمة بالأدلة، كمسارات ملفات مع أرقام أسطر. يجتمع البحث الدلالي والبنيوي والرسم البياني والنصي في نتيجة واحدة مُصنَّفة، حتى لا يعطيك سؤال مثل ‘ما الذي يعتمد على parseConfig’ كومة من grep أو اقتباسًا دلاليًا واحدًا فقط، بل الأماكن القليلة التي تهم فعلًا.

دليل ملموس

لا تبدأ بفهرسة الشركة بأكملها. هذا هو المسار الذي ينجح:

1. اختر مستودعًا واحدًا تعرفه جيدًا بالفعل — حزمة يمكنك تقييمها يدويًا أكثر قيمة من أكبر شجرة تملكها.
2. ابدأ مجانًا: 3 مستودعات، و50 ألف سطر مفهرس، وجميع الأدوات الـ11، ودون حصة استعلام شهرية. إذا كان مستودعك التمثيلي أكبر، فإن صفحة التسعير تسرد مستويات مساحة العمل ($0، $19، $49، $149) حسب التغطية المفهرسة — وليس عدد المقاعد.
3. اربط GitHub وانتظر اكتمال الفهرسة الأولى. أنت لا تُجمّع أي شيء محليًا.
4. اربط عميل MCP الخاص بك — بضعة أسطر تكوين. Maguyva خادم MCP عن بُعد، لذا لا يوجد إضافة ولا امتداد ولا محرر ثانٍ يجب تبنّيه.
5. اطرح سؤالًا واحدًا يمكنك التحقق منه. ‘ما الذي يعتمد على parseConfig؟’ أو ‘أين تُعالَج مهلة انتهاء جلسة تسجيل الدخول؟’ ثم افتح نتيجة file.ext:line المقتبسة وتحقق منها مقابل الشجرة أمامك.
6. فقط بعد أن تصمد الاقتباسات أمام التماس مع تلك الشجرة، تسمح للوكيل بالتحرير.

إذا ناسب المستودع الأول جيدًا وكانت شجرتك كبيرة، رقّي مساحة العمل لتناسب أسطرك المفهرسة ومعدل إعادة البناء. يشترك البشر والوكلاء في نفس عدد المستخدمين — تفرض Maguyva رسومًا لكل مساحة عمل، وليس لكل مقعد — لذا إضافة وكيل ثالث إلى الحلقة لا تكلفك شيئًا إضافيًا.

اختبار التفعيل هو نفسه الذي توصي به الوثائق لأي تشغيل أول: فهرس مستودع تعرفه بالفعل، اطرح سؤالًا واحدًا يمكنك التحقق منه. المستودع الكبير لا يغيّر ذلك الاختبار؛ يجعل فقط الملف الأول الخاطئ أكثر تكلفة.

ما تراقبه بعد الاتصال

راقب ثلاثة أشياء. الحداثة: تُعاد بناء الخطط المدفوعة كل ساعة، والخطة المجانية يوميًا، والعمل المحلي غير المدفوع لن يكون في الخريطة — هذه هي المقايضة التي تقبلها. النطاق: فهرس مجموعة تمثيلية من المستودعات، وليس كل نسخة متفرعة مؤرشفة؛ صُمّم المستوى المجاني عمدًا ليكون صغيرًا بما يكفي لمعرفة ما إذا كانت الإجابات تستحق الاحتفاظ بها. والتحقق: خريطة مستودع كبير لا تستطيع اقتباس المسارات وأرقام الأسطر ليست سوى محرك تخمين أبطأ، لذا اجعل وكيلك يُظهر المواقع قبل إرسال الرقعة.

ثم شغّل نفس الاختبار الذي كنت ستشغّله على مستودع صغير. فهرس مستودع تعرفه بالفعل. اطرح سؤالًا واحدًا يمكنك التحقق منه. إذا كانت الخريطة صحيحة، يتوقف وكيلك عن البدء من شجرة باردة.

// no laptop got hot building this map.