Skip to content

README_AR.md

Latest commit

 

History

History
226 lines (159 loc) · 8.76 KB

README_AR.md

File metadata and controls

226 lines (159 loc) · 8.76 KB

MemoryOS-Rust

⚠️ قد تكون هذه الترجمة متأخرة عن النسخة الإنجليزية. في حالة الشك، يرجى الرجوع إلى النسخة الإنجليزية.

نظام إدارة ذاكرة عالي الأداء لوكلاء الذكاء الاصطناعي - تطبيق Rust

License Rust Status Tests

اللغات: English | 简体中文 | 日本語 | Français | العربية | Deutsch | Español | 한국어

🎯 نظرة عامة

MemoryOS-Rust هو نظام إدارة ذاكرة عالي الأداء لوكلاء الذكاء الاصطناعي مبني باستخدام Rust + Tokio، يتميز ببنية ذاكرة من 3 مستويات (STM/MTM/LTM)، متوافق مع OpenAI API، ويدعم أكثر من 100,000 مستخدم متزامن.

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

  • 🚀 أداء عالي: Rust + Tokio، يدعم التزامن العالي مع أكثر من 10K QPS لكل نسخة.
  • 🧠 ذاكرة 3 مستويات: STM (Redis) → MTM (Qdrant) → LTM (Qdrant).
  • 🔌 بوابة عالمية: متوافق مع بروتوكول OpenAI، يدعم Gemini و Claude و Ollama و DeepSeek و Azure.
  • 🕸️ ذاكرة الرسم البياني: Qdrant-Native GraphRAG مع تصور Mermaid.
  • 📚 تصدير المعرفة: تصدير تلقائي للأسئلة الشائعة إلى Wiki (S3/Confluence)، يدعم Agent Playbook.
  • 🛡️ أمان المؤسسات: RBAC، تنظيف PII، دفاع ضد حقن الأوامر، حق النسيان GDPR.
  • 🤖 توجيه ذكي: توجيه تلقائي بين Llama المحلي (ساخن/خاص) و GPT-4 السحابي (معقد/بارد).

💻 متطلبات النظام

المواصفات الحد الأدنى (التطوير) الموصى به (الإنتاج)
CPU 2 vCPU 4+ vCPU
RAM 4GB 16GB+
القرص 10GB SSD 100GB NVMe
OS Linux / macOS Linux (K8s)

🚀 البدء السريع

1. تشغيل التبعيات

docker-compose up -d

2. التكوين

إنشاء ملف .env (اختياري) أو تعيين متغيرات البيئة:

export GEMINI_API_KEY="your_key_here"
export QDRANT_API_KEY="your_qdrant_key"

نسخ ملف التكوين:

cp config.example.toml config.toml
# تحرير config.toml لتمكين الوحدات المطلوبة (Router، Wiki، إلخ)

3. التشغيل

# الوضع الكامل الافتراضي
cargo run --release --bin memoryos-gateway

# (متقدم) تمكين ميزات محددة فقط (إذا كان Cargo.toml يدعم ذلك)
# cargo run --release --no-default-features --features "redis,qdrant"

4. الاختبار

curl http://localhost:8080/health/status

دليل مفصل: docs/QUICKSTART.md

🏗️ البنية المعمارية

graph TD
    Client[User Client] -->|OpenAI Protocol| Gateway
    subgraph MemoryOS-Rust
        Gateway -->|Auth & Shield| Router{Smart Router}
        Router -->|Tier 0: FAQ| DirectHit[Direct Response]
        Router -->|Tier 1: Hot| LocalLLM[Local Llama]
        Router -->|Tier 2: Cold| CloudLLM[OpenAI/Gemini]
        Gateway -->|Async Event| Queue[NATS/Redis]
        Queue --> Worker
        Worker -->|Summarize| VectorDB[(Qdrant)]
        Worker -->|Export| Wiki[S3/Confluence]
    end
Loading

البنية المعمارية التفصيلية: docs/ARCHITECTURE.md

📚 التوثيق

توثيق المستخدم

القراءة المتعمقة

توثيق المطور

⭐ موصى به: مبادئ التصميم والمقارنة لفهم رؤى تصميم النظام

📊 حالة المشروع

الإصدار: 0.2.0
الحالة: ✅ جاهز للإنتاج
الاكتمال: 100%

المرحلة الوحدة الحالة
Phase 1 Foundation (Config/Log) ✅
Phase 2 Gateway & Adapters ✅
Phase 3 Storage (Redis/Qdrant) ✅
Phase 4 Intelligence (Router/Shield) ✅
Phase 5 Worker & Async ✅
Phase 6 Wiki Export ✅
Phase 7 Graph Memory ✅

🛠️ المجموعة التقنية

  • اللغة: Rust 1.93+
  • وقت التشغيل غير المتزامن: Tokio
  • إطار الويب: Axum
  • التخزين قصير المدى: Redis
  • التخزين المتجه: Qdrant
  • LLM: OpenAI, Gemini, Claude, Ollama, DeepSeek, OpenRouter, Azure

🤝 المساهمة

المساهمات مرحب بها! يرجى اتباع سير العمل هذا:

قبل البدء

  1. 📖 اقرأ دليل التطوير
  2. 📝 سجل مهمتك في WORK_LOG.md
  3. 🔄 اسحب أحدث كود: git pull

أثناء العمل

  1. 📊 حدّث التقدم في WORK_LOG.md يوميًا
  2. 🐛 سجل المشاكل فورًا
  3. 🔴 حدّث الحالة إذا كنت محظورًا

بعد الانتهاء

  1. ✅ ضع علامة على المهمة كمكتملة في WORK_LOG.md
  2. 📝 حدّث CHANGELOG.md
  3. 🚀 أرسل الكود: git commit && git push

التعاون: نستخدم تسجيل مزدوج المسار WORK_LOG.md (بشري) + docs/state.json (AI) للتعاون الشفاف.

دليل مفصل: CONTRIBUTING.md

🔧 حالة الصيانة

الحالة الحالية: ✅ جاهز للإنتاج ويتم صيانته بنشاط

هذا المشروع مكتمل (100%) وفي وضع الصيانة. نركز على:

  • 🐛 إصلاحات الأخطاء وتحديثات الأمان
  • 📚 تحسينات التوثيق
  • 💡 التحسينات المدفوعة من المجتمع

انظر: MAINTENANCE.md لخطة الصيانة التفصيلية

📞 الاتصال

📄 الترخيص

ترخيص Apache 2.0 - انظر LICENSE

🌟 المشاريع ذات الصلة

الإصدار: 0.2.0 | التحديث: 2026-02-18