# EGC - السياق العالمي الممتد (Extended Global Context)
**وكلاؤك الآليون لن يبدأوا من الصفر مرة أخرى أبدًا.**
---
EGC هو وقت تشغيل محلي يمنح كل أداة برمجة تعتمد على الذكاء الاصطناعي تستخدمها ذاكرة مستمرة. في نهاية كل جلسة، يحفظ الذكاء الاصطناعي ما تعلمه عن مشروعك: القرارات التي اتخذتها، وما فشل، وتفضيلاتك، وما سيأتي بعد ذلك. في بداية الجلسة التالية، يقوم بتحميل تلك الحالة مرة أخرى. تثبيت واحد يغطي Claude Code و Cursor و Gemini CLI و Windsurf والمزيد.
---
## كيف يبدو EGC في الممارسة العملية
تفتح Claude Code في مشروع لم تلمسه منذ أسبوعين. دون كتابة أي شيء:
```
State loaded from egc-memory via ~/.egc/state/Projects--MyApp.md
Context and preferences acknowledged (terse responses).
Ready to pick up the next items:
• Test full install on a clean machine
• Add GEMINI.md with session memory protocol
• Publish v1.0.1 fix to npm after clean install test passes
• Add mcp_server_count to audit.js
```
يعرف الذكاء الاصطناعي بالفعل ما كنت تبنيه، والقرارات التي اتخذتها، وما فشل، وأين توقفت بالضبط. إنه يعرف لأن EGC حفظ تلك الحالة في نهاية جلستك الأخيرة وقام بتحميلها مرة أخرى عندما بدأت هذه الجلسة. لم تكتب أي شيء. لقد بدأت العمل فحسب.
---
## التثبيت
```bash
npm install -g @egchq/egc && egc install
```
أو التشغيل بدون تثبيت عالمي:
```bash
npx @egchq/egc install
```
[دليل التثبيت الكامل](../../docs/installation.md)
---
## ما يمنحه خادم MCP للذكاء الاصطناعي الخاص بك
يأتي EGC مع `egc-memory`، وهو خادم MCP يعرض 14 أداة يمكن للذكاء الاصطناعي استدعاؤها خلال الجلسة:
| الأداة | ماذا تفعل |
|---|---|
| `get_state` | يحمل ذاكرة المشروع عند بدء الجلسة |
| `update_state` | يحفظ القرارات والتفضيلات والخطوات التالية |
| `store_decision` | يحفظ قراراً واحداً في SQLite |
| `query_history` | يعيد القرارات السابقة حسب الطابع الزمني |
| `search_history` | بحث كامل في النص مع تصنيف BM25 |
| `working_memory_set` | يخزن سياقاً عابراً مع وقت انتهاء الصلاحية (TTL) |
| `working_memory_get` | يقرأ مفتاحاً عابراً |
| `working_memory_list` | يسرد جميع الإدخالات العابرة الحية للمشروع الحالي |
| `lesson_save` | يسجل المعرفة عبر الجلسات مع تضاؤل الثقة |
| `lesson_recall` | يسترجع الدروس النشطة فوق عتبة ثقة معينة |
| `lesson_reinforce` | يعزز الثقة في درس عندما يتكرر نفس النمط |
| `detect_patterns` | يبرز الأوامر المتكررة والأخطاء المتكررة من أحداث الخطاف (hook events) |
| `compress_observations` | يضغط ملاحظات الخطاف الخام إلى ملخصات مصنفة لتقليل استهلاك الرموز (tokens) |
| `get_project_state` | يعيد البيانات الوصفية لصحة الخادم وحالة محرك التخزين |
تعيش ملفات الحالة في `~/.egc/state/.md`. ملف واحد لكل مشروع، بصيغة Markdown بسيطة، وقابلة للقراءة من قبل البشر.
### السياق والأمان - 5 أدوات للحالات الصعبة
**`egc-guardian`**
هذه الأدوات تعمل تلقائياً في الخلفية. كل أمر shell وكل كتابة ملف يتم فحصهما قبل التنفيذ. لا تحتاج إلى استدعائها مباشرة.
| الأداة | ماذا تفعل |
|---|---|
| `validate_command` | يتحقق من أوامر shell مقابل قواعد أمان المشروع قبل التنفيذ |
| `validate_write` | يتحقق من مسارات كتابة الملفات لمنع الكتابة غير الآمنة |
| `reduce_context` | يضغط محتوى الملفات لتوفير ميزانية الرموز |
| `orchestrate_task` | يوجه الأوامر مع سياق الوكيل والمهارة ويعيد مقاييس الضغط |
| `auto_learn` | يستخرج إخفاقات الجلسة ويكتب دروساً قابلة للتنفيذ في جميع ملفات تكوين الأدوات |
### دائماً متزامن - عبر جميع الأدوات التي تستخدمها
**`egc watch`** - شغّله مرة واحدة وستبقى جميع الأدوات التي تستخدمها متزامنة. عندما تحرر السياق في أي ملف أداة، يتم مزامنته تلقائياً مع جميع الأدوات الأخرى.
```
egc watch # مراقبة المشروع الحالي
egc watch /path/proj # مراقبة مشروع محدد
egc watch --quiet # كتم المخرجات
```
### لوحة التحكم - مركز قيادة في الوقت الفعلي
شاهد كل استدعاء أداة وكل رمز وتكلفة يولدها وكلاؤك -- مباشرةً في المتصفح. تبدأ تلقائياً بعد `egc init`. [الدليل الكامل](docs/installation.md#dashboard)
---
## مكتبة الأوامر (Prompt library)
**479 مكوناً**: اختيارية. قم بتثبيتها للوصول إلى 63 وكيلاً و 229 مهارة و 76 أمراً مكتوبة من تجربة حقيقية. تخطاها وسيظل EGC يمنحك ذاكرة مستمرة.
| المكون | الإجمالي | Claude Code | Gemini CLI | Claude Code native |
|---|---|---|---|---|
| الوكلاء (Agents) | 63 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |
| الأوامر (Commands) | 76 | Shared | Instruction-based | 31 |
| المهارات (Skills) | 229 | Shared | 10 (native format) | 37 |
| القواعد (Rules) | 111 |: |: |: |
---
## دعم EGC
تم بناء EGC بواسطة مطور واحد، ويتم صيانته بشكل علني ومجاني.
- **[انضم إلى Discord](https://discord.gg/AtazrtxJ)**: اطرح الأسئلة وشارك التعليقات
- **[رعاية المشروع على GitHub](https://github.com/sponsors/Fmarzochi)**: أي مبلغ يساعد
- **[تبرع عبر PayPal](https://www.paypal.com/donate/?business=fmarzochi%40gmail.com¤cy_code=USD)**: لا يلزم وجود حساب GitHub
- **ضع نجمة على المستودع**: يساعد المطورين الآخرين في العثور عليه
- **[المساهمة](../../.github/CONTRIBUTING.md)**: وكلاء، مهارات، أوامر، إصلاح أخطاء، وثائق
- **المشاركة**: إذا غير EGC طريقة عملك، أخبر أحداً بذلك
### الرعاة
دعم المجتمع يبقي هذا المشروع حياً ومستقلاً.
#### شركاء الأدوات
أدوات البرمجة بالذكاء الاصطناعي التي تتكامل بشكل أصلي مع EGC. يحصل الشركاء على مساحة للشعار في جميع ملفات README وموقع EGCSite.
#### الرعاة السنويون · _كن أول راعٍ سنوي._
---
#### الداعمون
#### الرعاة الشهريون · _كن الأول_
---
#### الرعاة السنويون · _كن أول راعٍ سنوي._
---
#### الداعمون
#### الرعاة الشهريون · _كن الأول_
---
