GitHub

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

الربط

1. افتح الإعدادات > الموصلات، وانقر على GitHub، ثم ربط.
2. يُفتح GitHub. وافق على منح WebTwizz صلاحية الوصول.
3. ضمن إكمال الربط، اختر المستودع الذي سيُرفع إليه كود هذا المشروع، أو انقر على إنشاء بجوار مستودع جديد لبدء مستودع فارغ.

لا حاجة إلى لصق رموز وصول أو إجراء إعدادات في GitHub.

الربط من بطاقة في المحادثة يعمل بالطريقة نفسها: بعد موافقتك، تُفتح الإعدادات > الموصلات عند إكمال الربط.

ما يظهر لك

• المزامنة: الحالة الحالية، مع زر ارفع الآن. اسم المستودع بجوار العنوان يفتحه على GitHub.

  • متزامن مع فرعك، ووقت آخر رفع أو سحب، وعدد الملفات.
  • لم يُرفع بعد، قبل أول رفع.
  • GitHub متقدم بمقدار عدد من الإيداعات: رفع شخص ما تغييرات إلى GitHub. يجلب اسحب الآن تغييراته إلى المشروع. وعند تفعيل الرفع والسحب، تصل التغييرات تلقائيًا أيضًا عندما لا يكون أحد بصدد التحرير.
  • تغيّر كل من GitHub وWebTwizz: رُفعت تغييراتك إلى فرع باسم webtwizz-sync بدلًا من ذلك. استخدم فتح طلب سحب لدمجها، أو اطلب من الذكاء الاصطناعي سحب تغييرات GitHub أولًا.
  • لم يتم الرفع الأخير أو لم يتم السحب الأخير، مع السبب الذي يقدمه GitHub.

  تعرض الحالات الثلاث الأخيرة يحتاج إلى مراجعة.

• التغييرات الواردة: عندما يكون GitHub متقدمًا، تظهر الإيداعات التي سيجلبها اسحب الآن، من الأحدث إلى الأقدم، والملفات التي تغيّرها. يفتح كل إيداع على GitHub.

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

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

  • يدمجه دمج أو دمج الإيداعات في إيداع واحد أو إعادة التأسيس والدمج، حسب ما يسمح به المستودع. يطلب كل خيار التأكيد أولًا، موضحًا ما سيُدمج وأين، وأن طلب السحب سيُغلق، ثم تؤكد بالزر نفسه. إذا كنت على الفرع الذي يُدمج فيه الطلب، فسيجلب اسحب الآن التغييرات بعد ذلك.
  • عندما لا يمكن دمجه بعد، يوضح دمج السبب بدلًا من ذلك، مثل كونه مسودة، أو فشل الفحوصات، أو وجود تعارضات.
  • يفتح جميع طلبات السحب القائمة على GitHub.

• يعيد إعادة تشغيل المهام الفاشلة، في إيداع أو طلب سحب فشلت فحوصات GitHub Actions الخاصة به، تشغيل المهام الفاشلة بعد تأكيدك.

• عند العمل على فرع غير الفرع الرئيسي للمستودع، ولم يُفتح منه طلب سحب بعد، تعرض قائمة طلبات السحب الفرع مع فتح طلب سحب.

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

• الإعدادات:
  • المستودع: المكان الذي يُرفع إليه كود هذا المشروع. إذا لم تظهر مستودعات إحدى المؤسسات، يفتح السماح بالوصول على GitHub الصفحة التي تمنح فيها WebTwizz صلاحية الوصول إليها.
  • مستودع جديد: يطلب إنشاء إدخال اسم المستودع وتحديد ما إذا كان خاص، وهو خيار مفعّل ما لم توقفه. يمكن أن تتضمن الأسماء أحرفًا وأرقامًا وشرطات وشرطات سفلية ونقاطًا.
  • الفرع: ينقل التبديل المشروع إلى كود ذلك الفرع.
  • فرع جديد: يطلب إنشاء إدخال اسم الفرع وينشئه من الفرع الحالي بحالة المشروع الحالية. يصل الفرع إلى GitHub عند الرفع التالي.
  • المزامنة: لا يرفع عندما أدفع الكود إلا عندما ترفع أنت أو الذكاء الاصطناعي. ينشئ رفع كل حفظ إيداعًا ويرفع كل عملية حفظ، مع تجميعها على مدى 30 ثانية. ويجلب الرفع والسحب أيضًا الإيداعات الجديدة على فرعك إلى المشروع عندما لا يكون أحد بصدد تحريره.
  • رسائل الإيداع: يستخدم صِف التغيير ملخص الذكاء الاصطناعي لما غيّره، عند توفره. ويستخدم التحديث من WebTwizz الرسالة نفسها في كل مرة.
• يفتح فتح على GitHub، في أعلى الشاشة، المستودع.

إذا كان المستودع يحتوي بالفعل على كود في ذلك الفرع، يطلب ارفع الآن التأكيد قبل أول رفع: تُضاف ملفات هذا المشروع فوق الملفات الحالية في إيداع واحد، وتبقى الملفات الموجودة في المستودع فقط كما هي. أكّد باستخدام الرفع إلى واسم فرعك. ويظهر طلب التأكيد نفسه عند تفعيل رفع كل حفظ أو الرفع والسحب قبل أول رفع، وينفّذ الرفع والتفعيل ذلك الرفع الأول.

ما يمكن للذكاء الاصطناعي فعله

أخبر الذكاء الاصطناعي بما تريده في المحادثة. يشغّل git على كود مشروعك، وتظهر كل خطوة في المحادثة.

ما تقوله	ما يحدث
"ارفع الكود إلى GitHub"	ينشئ إيداعًا بتغييراتك ويرفعه إلى الفرع الحالي
"ارفع هذا إلى فرع جديد باسم redesign"	ينشئ الفرع وينتقل إليه ويرفع التغييرات
"اسحب أحدث التغييرات من GitHub"	يدمج نسخة الفرع الموجودة على GitHub في موقعك
"افتح طلب سحب لهذا الفرع"	يرفع الفرع ويفتح طلب سحب
"هل نجحت فحوصات طلب السحب؟"	يقرأ فحوصات طلب السحب
"ادمج طلب السحب 12"	يدمجه على GitHub
"اعرض آخر 10 إيداعات"	يعرض السجل

لا يرفع الذكاء الاصطناعي التغييرات أو يسحبها، ولا يبدّل الفروع أو يفتح طلبات السحب أو يدمجها إلا عندما تطلب ذلك. ولا ينفّذ رفعًا قسريًا أبدًا إلا إذا طلبت منه استبدال ما على GitHub.

إذا غيّرت الملف نفسه في الجانبين، يتوقف السحب ويسألك الذكاء الاصطناعي عن النسخة التي تريد الاحتفاظ بها: نسخة موقعك أم نسخة GitHub.

العمل على الكود خارج WebTwizz

1. ارفع موقعك إلى GitHub.
2. استنسخ المستودع وعدّله في محررك أو أداة البرمجة التي تستخدمها.
3. ارفع تغييراتك إلى GitHub.
4. عُد إلى WebTwizz واطلب من الذكاء الاصطناعي سحب أحدث التغييرات من GitHub.

ما يُرفع

الكود المصدري لموقعك. لا تُرفع مجلدات التبعيات وملفات القفل وملفات .env وملفات محرر WebTwizz. ما يصل إلى GitHub هو مشروع كامل يمكنك تشغيله في أي مكان.

الأسرار

لا يضيف GitHub أي أسرار.

معلومات مفيدة

• يحتاج الرفع والسحب إلى صلاحية مسؤول في المستودع، حتى يتمكن GitHub من إبلاغ WebTwizz بالإيداعات الجديدة. إن لم تكن لديك هذه الصلاحية، فاطلبها من مالك المستودع أو استخدم رفع كل حفظ.
• لا يعمل اسحب الآن أثناء عمل الذكاء الاصطناعي على المشروع. اسحب بعد انتهائه.
• إزالة GitHub من مشروع تُبقي المستودع وكل ما فيه كما هو.