E156 Ecosystem Starter — البدء السريع (العربية)

الأسهل — التثبيت الكامل في المتصفح، بدون استخدام الطرفية

إذا لم تستخدم سطر الأوامر من قبل، انقر على هذا الزر. ستفتح لك مساحة عمل GitHub مجانية مع تثبيت النظام بالكامل مسبقاً: القواعد، الذاكرة، خطاف Sentinel، أداة التحقق Overmind مع مفتاح TruthCert HMAC، تهيئة ProjectIndex، وواجهة Gemini CLI. لن يُثبَّت أي شيء على حاسوبك.

افتح في GitHub Codespaces ←

البناء ~2-3 دقائق. الأفضل على حاسوب مكتبي أو محمول — Codespaces في متصفح الهاتف يعمل تقنياً لكن الطرفية غير مستقرة.

ليس لديك حساب GitHub بعد؟ اقرأ هذا أولاً.

إذا كان لديك بريد جامعي ينتهي بـ .edu.eg، .edu.sa، .edu.jo، إلخ — قدّم على GitHub Education أولاً. تحصل على 90 ساعة Codespaces مجانية شهرياً (بدلاً من 60)، بدون خطوة التحقق بالهاتف، ووصول لأدوات مدفوعة أخرى.
إذا كان لديك بريد شخصي فقط (Gmail/Yahoo) — سجِّل على github.com/signup. سيطلب GitHub التحقق بـ SMS؛ قد يفشل بصمت على بعض شبكات الجوال (STC، Etisalat، Zain). إذا لم يصلك الكود، جرّب من شبكة أخرى أو استخدم GitHub Education أعلاه.
إذا كان هاتفك جهازك الوحيد — استعِر حاسوباً محمولاً للتسعين دقيقة الأولى من الإعداد؛ بعدها يمكنك الكتابة من هاتفك عبر محرر GitHub على الويب.

ما هو GitHub Codespace؟ (نسخة الفقرة الواحدة)

الـ Codespace هو حاسوب Linux يعمل على سحابة GitHub، مع VS Code (محرّر برمجي) مفتوح في متصفح الويب الخاص بك. لا يُثبَّت شيء على حاسوبك — كل شيء يحدث على الجهاز السحابي. تكتب الكود في المتصفح، تحفظه على GitHub، ويبقى موجوداً عند إغلاق التبويب. مجاني لـ 60 ساعة/شهر للحسابات الشخصية (90 لحسابات Education)، ثم يتوقف حتى الشهر التالي. مثل Google Docs، لكن لبيئة برمجية.

سبق وثبّتت نسخة قديمة؟ (التحديث)

إذا شغّلت المثبِّت سابقاً (مثلاً v0.7.0 في مارس)، أعِد تشغيل نفس السطر الواحد أعلى هذه الصفحة. الـ bootstrap الجديد سيسحب آخر إصدار موسوم ويستبدل قواعدك وقوالب الذاكرة. ملفاتك المحرَّرة (*.md.user) محفوظة. للتحقق من النسخة المثبَّتة، في أي طرفية Codespace شغّل e156 version.

نصيحة i18n: للحصول على كل شيء بالعربية داخل الـ Codespace، أضف E156_LANG=ar إلى أسرار المستخدم في github.com/settings/codespaces. ينطبق على كل codespace تفتحه.

نصيحة — أوقف الـ codespace عند الانتهاء. أي codespace خامل يستمر في استهلاك ساعاتك الشهرية حتى يتم تعليقه تلقائياً (الافتراضي: 30 دقيقة). للإيقاف فوراً: اذهب إلى github.com/codespaces واضغط ⋯ ← Stop codespace، أو شغّل gh codespace stop في الطرفية. مع 60 ساعة مجانية شهرياً، ترك تبويب مفتوح طوال اليوم سيستنفد حصتك في أقل من أسبوع.

ملاحظة: هذه نسخة مختصرة بالعربية. النسخة الإنجليزية الكاملة تحتوي على جميع التعليمات التفصيلية (المتطلبات الأساسية، استكشاف الأخطاء، نموذج الأمان، أمثلة المشاريع). أوامر التثبيت أدناه متطابقة في جميع اللغات.

التثبيت — Windows

افتح PowerShell (وليس Command Prompt). اضغط Win+R، اكتب powershell، ثم Enter. الصق:

irm https://mahmood726-cyber.github.io/e156-ecosystem-starter/bootstrap.ps1 | iex

التثبيت — macOS / Linux / WSL

curl -fsSL https://mahmood726-cyber.github.io/e156-ecosystem-starter/e156-setup.sh | bash

التحقق من التثبيت

# Windows PowerShell
ls $env:USERPROFILE\.claude\rules

# macOS / Linux / WSL
ls ~/.claude/rules

يجب أن ترى أربعة ملفات .md: e156، lessons، advanced-stats، rules.

الخطوة التالية — إنتاج عمل بنفس مستوى الجودة

تثبيت القواعد هو نصف العمل. النصف الآخر هو استخدامها بنفس الطريقة: brainstorm ← spec-lock ← plan-lock ← TDD ← audit.

اقرأ STUDENT-WORKFLOW.md (بالإنجليزية) للحصول على الدليل الكامل: الطريقة خطوة بخطوة، مستودعات الأمثلة للنسخ، وكيف يعمل Sentinel + Overmind كبوابات للجودة.

المتطلبات الأساسية

Python 3.11+ من python.org/downloads (مع تحديد "Add python.exe to PATH").
R 4.5+ من cran.r-project.org.
Node.js 20+ من nodejs.org.
واجهة سطر أوامر لوكيل ذكاء اصطناعي: Gemini CLI (مجاني)، Claude Code (مدفوع)، أو OpenAI Codex.

في حالة المشاكل

راجع قسم "What if something goes wrong" في الصفحة الإنجليزية.
يكتب المثبِّت سجلاً في %LOCALAPPDATA%\e156\logs\install-<ts>.log (Windows) أو ~/.local/state/e156/logs/install-<ts>.log (Linux/WSL). يتم إخفاء مفاتيح API والأسرار تلقائياً قبل أي مشاركة.