إنتقل إلى المحتوى الرئيسي

البداية السريعة

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

لمن هذه الصفحة​

استخدم هذه الصفحة إذا كنت:

  • تثبّت EstaCoda لأول مرة
  • تضبط مزوّدًا ونموذجًا واحدًا
  • تتحقق من CLI قبل تفعيل Telegram أو WhatsApp أو الصوت أو المتصفح أو توليد الصور
  • تصلح تثبيتًا اكتمل لكنه لا ينتج جلسة تعمل
  • تجهّز نسخة مصدرية للتطوير

أسرع مسار​

اختر الصف الذي يطابق هدفك:

الهدفابدأ من هناثم
أريد تشغيل EstaCoda محليًاثبّت، ثم شغّل estacoda setupاقبل خيار التشغيل النهائي أو شغّل estacoda
ثبّتّه سابقًاestacoda verifyافحص estacoda model status
شغّلت estacoda وظهر الإعدادأكمل مسار الإعداداستخدم estacoda setup إذا خرجت مبكرًا
أريد Telegram أو WhatsAppاحصل أولًا على جلسة CLI محلية تعملاضبط القنوات بعد التحقق
أريد الصوت أو بحث الويب أو المتصفح أو توليد الصورأنهِ الإعداد الأساسي أولًاأضف القدرات الاختيارية واحدة تلو الأخرى
أريد تعديل المصدراستنسخ المستودعشغّل ./scripts/setup-estacoda.sh
هناك شيء معطّلestacoda doctorأصلح أول مانع قبل إضافة ميزات أخرى

إذا لم تعمل جلسة CLI محلية عادية، لا تفعّل القنوات أو الصوت أو المتصفح أو توليد الصور أو أسطح التطور بعد. احصل أولًا على تفاعل محلي نظيف واحد.

1. ثبّت EstaCoda​

مسار التثبيت الافتراضي يستخدم المثبّت العام:

curl -fsSL https://www.estacoda.com/install.sh | bash

ينشئ هذا تثبيتًا مُدار المصدر تحت ~/.estacoda/estacoda، ثم يبني المشروع، ويكتب ملف تشغيل إلى ~/.local/bin/estacoda، ويشغّل estacoda init.

إذا لم يكن ~/.local/bin ضمن PATH، أضفه:

export PATH="$HOME/.local/bin:$PATH"

2. شغّل الإعداد الأول​

ابدأ مسار الإعداد المُراجع:

estacoda setup

إذا شغّلت estacoda قبل اكتمال الإعداد، يكتشف EstaCoda الحالة غير المكتملة ويوجهك إلى الإعداد.

يمر معالج الإعداد الأول بهذه المراحل:

الخطوةماذا تفعلالنتيجة
اللغة ونمط الواجهةيختار لغة الإعداد ونمط الطرفيةيستخدم الإعداد نمط الواجهة المختار
مساحة العمليختار مسار مساحة العمليعرف EstaCoda أين يمكنه العمل
الثقة بمساحة العمليحدد الثقة للمجلد المختاريتبع سلوك الأدوات قرار الثقة
نقطة نهاية المزود والنموذجيختار إعداد المزوّد والنموذج الأساسي، بما في ذلك عنوان النقطة المحلية/الخاصة عند الحاجةيصبح لديك إعداد نموذج قابل للاستخدام
معالجة الاعتماديخزّن الاعتماد أو يعيد استخدامه أو يتجاوزه حسب طريقة اعتماد المزودلا تظهر الأسرار الخام في شاشة المراجعة
وضع الأمانيختار سلوك الموافقاتتتطلب الأفعال الحساسة مستوى الموافقة المحدد
Agent Evolutionيختار سلوك التعلم والمراجعةيتبع سلوك التطور إعدادات المراجعة
القدرات الاختياريةيضبط القنوات والصوت وبحث الويب والمتصفحتُضاف الأسطح الإضافية فقط عند اختيارها
المراجعة والتطبيقيعرض ملخصًا نهائيًا قبل الكتابةتُطبّق التغييرات بعد التأكيد
التحقق والتشغيليفحص الجاهزية ويعرض تشغيل الجلسةتصل إلى جلسة محلية

الإعداد مُراجع قبل التطبيق. يعرض المعالج ملخصًا قبل حفظ تغييرات الإعداد، ولا يعرض الأسرار الخام في مخرجات المراجعة.

يعرض المعالج خيار رجوع في مطالبات الاختيار عندما يساعد على تصحيح اختيار سابق. تحتفظ مطالبات النص والأسرار بسلوكها المعتاد.

يمكن لمسار الإعداد الأول ضبط القنوات والصوت وبحث الويب والمتصفح. توليد الصور، وإعدادات النماذج الاحتياطية، والإعدادات الأعمق للمزوّدين متاحة بعد الإعداد الأساسي من خلال محرّر الإعدادات وأوامر CLI المخصصة.

3. اضبط نموذجًا واحدًا يعمل​

اختر مزوّدًا ونموذجًا واحدًا يعملان أولًا. للخوادم المحلية أو الخاصة المتوافقة مع OpenAI مثل Ollama أو LM Studio أو llama.cpp أو vLLM، اختر مسار نقطة النهاية المحلية / الخاصة وأدخل عنوان نقطة النهاية عندما يُطلب منك ذلك. مفاتيح API اختيارية لهذا المسار. لا تضبط النماذج الاحتياطية أو القنوات أو القدرات الاختيارية قبل أن يتحقق الإعداد الأساسي.

بعد الإعداد، افحص إعداد النموذج النشط:

estacoda model status

تُكتب حالة الملف الشخصي تحت:

~/.estacoda/profiles/default/

4. ابدأ أول جلسة​

إذا عرض معالج الإعداد تشغيل EstaCoda، اقبل ذلك. وإلا شغّل:

estacoda

استخدم prompt يسهل التحقق منه:

Check this directory and tell me what kind of project this is.
Then list the first three files you would inspect next.

الجلسة الأولى التي تعمل تعني:

الفحصشكل النجاح
بدء التشغيليبدأ EstaCoda بلا أخطاء مزوّد أو نموذج
إعداد النموذجيعرض estacoda model status الإعداد المختار
أول إجابةيرد الوكيل بشكل طبيعي
الدور الثانييعمل سؤال متابعة داخل الجلسة نفسها
الأدواتيعرض /tools الأدوات المتاحة أو يشرح سبب عدم توفرها
الأمانتشرح الموافقات أو الرفض ما حدث

5. تحقق من الإعداد​

شغّل هذه الأوامر بعد الجلسة الأولى:

estacoda verify
estacoda model status
estacoda doctor

استخدم estacoda doctor --live فقط عندما يبدو الإعداد المحلي صحيحًا لكن اتصال المزوّد ما زال يفشل.

6. جرّب عناصر التحكم الأساسية​

داخل الجلسة:

الأمرالاستخدام
/helpعرض أوامر الجلسة المتاحة
/toolsعرض الأدوات المتاحة
/modelفحص أو تغيير إعداد النموذج للجلسة
/statusعرض حالة الجلسة والتشغيل
/interruptإلغاء دور نشط
/exitالخروج من الجلسة

اكتب / لفتح قائمة الأوامر. استخدم /help داخل الجلسة لمعرفة عناصر التحكم المتاحة في النسخة المثبتة لديك.

7. أضف الطبقة التالية​

أضف الأسطح الاختيارية فقط بعد أن يعمل CLI المحلي.

الطبقة التاليةاستخدمها عندماابدأ من
Telegramتريد وصولًا عن بُعد من Telegramالقنوات
WhatsAppتريد وصول WhatsApp مرتبطًا عبر QRالقنوات
الصوتتريد STT/TTSالصوت
بحث الويبتريد بحث ويب حيًا عبر Brave أو DDGSمرجع المزودين
المتصفحتريد عملًا مدعومًا بالمتصفحالمتصفح
توليد الصورتريد أدوات صور مدعومة بمزوّدتوليد الصور
المهاراتتريد إجراءات مهام قابلة لإعادة الاستخدامالمهارات
MCPتريد خوادم أدوات خارجيةالأدوات

8. أعطال شائعة​

العرضالسبب المرجحأول إصلاح
يفتح estacoda الإعداد بدل الجلسةالإعداد غير مكتملشغّل estacoda setup
يكتمل الإعداد لكن التشغيل محجوبتم تأجيل الثقة بمساحة العملأعد تشغيل الإعداد أو وثّق مساحة العمل
إعداد النموذج موجود لكنه لا يجيباعتماد مفقود أو غير صالحشغّل estacoda model status ثم estacoda setup
الأوامر غير موجودة بعد التثبيت~/.local/bin ليس ضمن PATHأضفه إلى ملف shell وأعد التحميل
الأدوات غير متاحةسياسة الأدوات أو إعداد الملف الشخصي لا يعرّضهاشغّل /tools و estacoda verify
رسائل القنوات لا تصلإعداد المصادقة أو قائمة السماح أو المنصة غير مكتملراجع وثائق القنوات والتشخيص
تغيّر السلوك بعد تعديلاتتغيّر إعداد الملف الشخصي أو حالة الثقةشغّل estacoda doctor قبل تغيير إعدادات أخرى

9. ترتيب التعافي​

استخدم هذا الترتيب قبل التصحيح اليدوي:

estacoda verify
estacoda model status
estacoda doctor
estacoda setup

استخدم estacoda doctor --live بعد ذلك فقط إذا بقي اتصال المزوّد هو سبب الفشل المرجح.

10. مسارات التثبيت المتقدمة​

ثبّت في مجلد مخصص وتجاوز تهيئة الحالة الأولى:

curl -fsSL https://www.estacoda.com/install.sh | bash -s -- --dir <path> --skip-init

إذا كنت تنوي تعديل المصدر، استنسخ المستودع وشغّل سكربت الإعداد:

git clone https://github.com/sifr01-labs/EstaCoda.git
cd EstaCoda
./scripts/setup-estacoda.sh

ينشئ هذا تثبيتًا يدوي المصدر. تبقى نسخة المصدر محفوظة عند إلغاء التثبيت، ويعمل التحديث في وضع الفحص والإرشاد.

لكل مسارات التثبيت، راجع التثبيت.

11. مرجع سريع​

الأمرالاستخدام
estacodaبدء جلسة تفاعلية، أو التوجيه إلى الإعداد إذا كان غير مكتمل
estacoda setupتشغيل الإعداد أو الإصلاح المُراجع
estacoda verifyفحص جاهزية الإعداد
estacoda model statusفحص إعدادات المزوّد/النموذج النشطة
estacoda doctorتقرير الصحة والإصلاحات المطلوبة
estacoda doctor --liveإضافة فحوصات اتصال حية للمزوّد
estacoda --helpعرض مساعدة CLI

ماذا بعد​