# على ماذا يعمل Maguyva

Canonical source: https://maguyva.ai/ar/stack

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

مبني من أجل السرعة، وقابلية تتبع الأخطاء، والتحسين المستمر: بنية تحتية مُثبَتة في الأساس، ومكوّنات مصمَّمة خصيصًا حيث يتطلبها ذكاء الكود.

- PostgreSQL + Lance
- بحث متجهي مكمَّم
- محرك لغة الشيفرة
- MCP في كل مكان
- 285+ لغة

## ما الذي يعمل في الإنتاج

هذه هي الطبقات الأساسية التي بقيت بعد تكرارات متعددة. كل واحدة منها استحقت مكانها إما بتسهيل تتبع الأخطاء أو بإزالة الاحتكاك من تنفيذ الوكيل.

### PostgreSQL + Lance

*قاعدة البيانات*

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

### Voyage AI: voyage-4-large

*التضمينات*

تضمينات كود بمعدل استرجاع مرتفع لبحث الوكلاء واسترجاعهم للمعلومات وربط إجاباتهم بالكود الفعلي.

### Binary Quantized HNSW

*البحث المتجهي*

تضمينات مضغوطة إلى توقيعات 2048 بت ومفهرَسة باستخدام HNSW. تخفيض للتخزين بمقدار 32 ضعفًا، وبحث منخفض زمن الاستجابة، ودون أي بنية تحتية إضافية.

### محرك لغة الشيفرة

*محرك اللغة*

مكدس Tree-sitter مُعدَّل بشكل كبير، بقواعد نحوية مخصَّصة، وأساليب استدلالية للمعالجات، وتغطية استخلاص تمتد عبر 285 لغة

### بروتوكول MCP

*البروتوكول*

خادم MCP بعيد لـ Claude Code وClaude Desktop وCursor وVS Code وDevin Desktop وعملاء آخرون متوافقون مع MCP. يقدّم 11 أداة على TypeScript Cloudflare Worker مع نقل HTTP تدفقي أصلي.

### Lance العمودي + R2

*التخزين المؤقت*

تضمينات مخزَّنة مؤقتًا بشكل عمودي، ومُزامَنة سحابيًا

## المكدس بعد الطرق المسدودة

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

بدأت تجارب التنسيق قبل ذلك. يبدأ هذا الخط الزمني في سبتمبر 2025، حين تبلور منتج Maguyva نفسه بوضوح.

- **2025-Q3** (التأسيس): بدء بناء Maguyva المركَّز ← Voyage voyage-code-3. يتبلور اتجاه المنتج، وتبدأ حلقة التكرار السريع
- **2025-Q3** (التخزين): طبقة استرجاع متجهي ثنائي. بحث مكمَّم بفهارس مدمجة، دون مكدس متجهات منفصل
- **2025-Q4** (محرك AST): تشغيل محرك لغة الشيفرة. استعلامات مخصَّصة، وحلول احتياطية للمحلّل النحوي، واستدلالات قائمة على المعالجات عبر 285 لغة
- **2025-Q4** (البحث): بحث دمجي متعدد الأنماط. استرجاع مرتَّب عبر الفهارس الدلالية والنصية وAST والرسم البياني، ضمن استعلام واحد
- **2026-Q1** (التخزين المؤقت): مزامنة Lance العمودي + R2. تخزين مؤقت عمودي من جهة الخادم، وبدء تشغيل بارد أسرع
- **2026-Q1** (الجودة): إطار تحقق لـ285 لغة. اختبار استخلاص آلي عبر كل لغة مدعومة
- **2026-Q1** (الإطلاق): الإطلاق العام على maguyva.ai. 7 أشهر من البناء المركَّز إلى التوفر العام
- **2026-Q2** (البروتوكول): MCP على TypeScript Cloudflare Worker. نقل HTTP تدفقي أصلي، وزمن وصول أقل، واستبدال أثناء حركة البيانات الحية
- **NOW** (التضمينات): تضمينات الإنتاج → voyage-4-large. بحث دلالي بمعدل استرجاع أعلى بعد الانتقال من voyage-code-3

## نستخدم ما نُصدره

يُبنى Maguyva بواسطة وكلاء يعملون على Maguyva.

ينسّق نظام التنسيق لدينا وكلاء ذكاء اصطناعي متخصصين يستخدمون أدوات MCP ذاتها، وفهارس البحث ذاتها، والبنية التحتية الإنتاجية ذاتها التي تحصل عليها أنت. لا توجد نسخة داخلية. تُدرِج صفحة الفريق “1x Maguyva ($149) — ندفع لأنفسنا.” هذه ليست مزحة. إنها الفاتورة.

// نحن أول مستخدمي منتجنا، وننشر تحديثات في بيئة الإنتاج يوميًا

## القواعد التي نجت من الإنتاج

هذه هي القيود التي بقيت مفيدة في الإنتاج. لا علاقة لها بالإيديولوجيا بقدر ما تتعلق بإبقاء النظام مفهومًا بينما يُجري الوكلاء تعديلات بسرعة.

### بلا حلول احتياطية صامتة

فشل سريع، وإصلاح سريع. يظهر كل خطأ فورًا. لا تدهور سلس يُخفي العلل في الإنتاج.

*// الفشل الصريح > الفساد الصامت*

### أولوية RPC

منطق من جهة قاعدة البيانات لأجل الأداء. تُنفَّذ دوال PostgreSQL بالقرب من البيانات، ما يلغي جولات الذهاب والإياب.

*// دوال PostgreSQL، 0 ORM*

### CQRS

مسارات كتابة وقراءة منفصلة. يكتب خط الفهرسة، وتقرأ أدوات MCP. استراتيجيات تحسين مختلفة.

*// الكتابة: مجمَّعة | القراءة: مخزَّنة مؤقتًا*

### معرّفات UUID حتمية

اتساق التخزين المؤقت دون استعلامات قاعدة بيانات. المدخل ذاته = المعرّف ذاته. عمليات مصمَّمة بحيث لا يغيّر تكرارها النتيجة.

*// uuid5(namespace, content_hash)*

أفضل معمارية تقنية هي التي يمكنك تصحيح أخطائها في الثالثة فجرًا. (اختبرنا هذا فعلاً.)

// آخر تحديث: 2026-10

[جرّبه على مستودعك](https://app.maguyva.ai/auth/sign-up?plan=free)

## أين تعيش شيفرتك

لا غموض. إليك بالضبط ما يحدث لشيفرتك حين تربط مستودعًا.

- **خوادم فعلية، شرق الولايات المتحدة** (الحوسبة): أجهزة فعلية خام (bare-metal) في أشبورن، مضبوطة لأجل إنتاجية الفهرسة بدلًا من نُسخ عامة الغرض مزدحمة.
- **شبكة Cloudflare العالمية لتوصيل المحتوى (CDN)** (الحافة): استجابات الواجهة البرمجية (API) وMCP مخزَّنة مؤقتًا عند الحافة. الأصول الثابتة تُقدَّم من شبكة Cloudflare العالمية.
- **مقسَّم حسب المستأجر لكل مساحة عمل** (العزل): تحصل كل مساحة عمل على فهارس مستودع محصورة بالمستأجر عبر خط المعالجة وقاعدة البيانات. نستخدم شيفرة العملاء لتقديم ذكاء الكود، لا لتدريب نماذج أو بيع بيانات.
- **مؤسَّسة في سنغافورة** (الكيان): UT International PTE. LTD. ولاية قضائية حقيقية، وكيان حقيقي.
- **أزل مستودعًا، يُزَل الفهرس** (الحذف): افصل مستودعًا، وسيزيل Maguyva شيفرة المصدر المفهرَسة النشطة، والتضمينات، وبيانات الرسم البياني من الخدمة. النسخ الاحتياطية المتبقية تنتهي صلاحيتها وفق جدول الاحتفاظ.
- **تحتاج إلى الاتحاد الأوروبي أو أستراليا؟** (المناطق): مناطق النشر الإضافية موضوع نقاش مع العملاء الذين لديهم متطلبات إقامة بيانات.

## الخطوات التالية

- [ابدأ الآن](https://maguyva.ai/ar/docs): افهرس مستودعك الأول خلال دقائق.
- [اطّلع على الأسعار](https://maguyva.ai/ar/pricing): لكل مساحة عمل، وليس لكل مستخدم. ابدأ مجانًا.
- [تعرّف على الفريق](https://maguyva.ai/ar/team): إنسانان وسرب من وكلاء الذكاء الاصطناعي.
- [اقرأ المدونة](https://maguyva.ai/ar/blog): ملاحظات تقنية من عملية البناء.