اربط مشروع Atoms الخاص بك بـ GitHub للاحتفاظ برمزه في مستودع خاص ونقل التغييرات بين Atoms وGitHub دون استخدام أوامر Git.

يشرح هذا الدليل عملية الإعداد الكاملة: ربط حساب GitHub الخاص بك بـ Atoms، وإنشاء المستودع، والتأكد من أن الاتصال يعمل، والحفاظ على تزامن إصدارات مشروعك بين Atoms وGitHub.

كيف يعمل الاتصال

هناك مرحلتان لربط GitHub:

1. اربط حساب GitHub الخاص بك. يمنح هذا Atoms إذنًا للعمل مع GitHub نيابةً عنك.
2. أنشئ مستودعًا لمشروعك. المستودع هو المساحة الخاصة في GitHub حيث يتم تخزين رمز مشروعك وسجل التغييرات.

يقوم Atoms حاليًا بإنشاء مستودع خاص جديد في حساب GitHub الشخصي للمستخدم المتصل. لا يمكنك الاتصال بمستودع موجود، أو إنشاء المستودع ضمن مؤسسة، أو جعله عامًا عبر أداة الربط.

قبل أن تبدأ

قبل ربط مشروعك بـ GitHub، تأكد من أن:

• تتضمن باقة Atoms الخاصة بك اتصال GitHub. إذا كنت تستخدم الباقة Free، فسيؤدي تحديد GitHub إلى نقلك إلى صفحة Plans.
• يمكن فقط لمالك مساحة العمل ربط GitHub أو فصله. إذا كنت محررًا، فاطلب من مالك مساحة العمل تنفيذ هذه الخطوة.
• لديك حساب GitHub أو أنك مستعد لإنشاء واحد أثناء الإعداد.
• يسمح المتصفح لديك بالنوافذ المنبثقة من Atoms.
• لا يعمل أي Agents حاليًا على مشروعك.

لا تحتاج إلى رمز وصول شخصي من GitHub لربط حسابك. لا تلصق أبدًا Tokens أو كلمات المرور أو أي بيانات اعتماد أخرى الخاصة بـ GitHub في Chat.

اربط حساب GitHub الخاص بك

افتح أداة ربط GitHub

1. افتح المشروع الذي تريد ربطه.
2. انقر على اسم المشروع في أعلى يمين لوحة الدردشة.
3. حدد Connectors من القائمة المنسدلة التي تظهر.
4. اعثر على Github في قائمة أدوات الربط المتاحة، ثم انقر على connect.

يمكنك أيضًا فتح Settings → Connectors → GitHub وتحديد Connect.

افتح Settings → Connectors وحدد Connect لـ GitHub.

فوّض Atoms في GitHub

إذا كان Connected Account يعرض بالفعل حساب GitHub الذي تريد استخدامه، فهذا يعني أنه تمت الموافقة عليه بالفعل. يمكنك المتابعة إلى Create a private repository.

1. يفتح Atoms نافذة تفويض GitHub. سجّل الدخول إلى حساب GitHub الذي تريد ربطه، أو أنشئ حسابًا جديدًا إذا لزم الأمر.
2. تحقق من أنك سجلت الدخول إلى حساب GitHub الصحيح.
3. راجع الأذونات التي يطلبها Atoms. إذا كنت موافقًا، فحدد Authorize Atoms-Agents.
4. ارجع إلى Atoms وانتظر ظهور رسالة Connect success.
5. في Atoms، افتح Connectors وتأكد من أن حساب GitHub الخاص بك يظهر على أنه متصل.

يطلب Atoms أذونات OAuth التالية: repo وread:user وworkflow. تتيح هذه الأذونات لـ Atoms قراءة وكتابة المستودعات العامة والخاصة التي يمكن للحساب المتصل الوصول إليها، وقراءة معلومات الملف الشخصي الأساسية، وإضافة ملفات سير عمل GitHub Actions أو تحديثها.

ينطبق هذا التفويض على حساب GitHub المتصل وليس مقتصرًا على المستودع الذي تم إنشاؤه لمشروع Atoms الحالي. لا يمكن لـ Atoms الوصول إلى المستودعات التي لا يستطيع الحساب المتصل نفسه الوصول إليها، وقد تفرض سياسات المؤسسة قيودًا إضافية.

راجع أذونات GitHub وحدد Authorize Atoms-Agents.

أنشئ مستودعًا خاصًا

بعد تفويض حساب GitHub الخاص بك، أنشئ المستودع الخاص الذي سيخزن رمز مشروعك.

1. ضمن Connected Account، تحقق من أن اسم المستخدم المعروض يطابق حساب GitHub الذي تريد استخدامه.
2. ضمن Create New Repository، أدخل اسمًا للمستودع. يجب أن يكون الاسم:
   • يتكون من 1–100 حرفًا؛
   • ويستخدم فقط الأحرف أو الأرقام أو الشرطات (-) أو الشرطات السفلية (_) أو النقاط (.).
3. حدد Create.
4. انتظر ظهور رسالة GitHub repository connected successfully!.

ينشئ Atoms مستودعًا خاصًا جديدًا في حساب GitHub الشخصي للمستخدم المتصل، ويربطه بمشروع Atoms الحالي، ثم يحاول تحميل الملفات الحالية للمشروع إلى GitHub.

أدخل اسمًا وأنشئ مستودعًا خاصًا جديدًا.

تحقق من أن الاتصال نجح

تحقق من الاتصال في كل من Atoms وGitHub قبل الاعتماد على المستودع.

1. في Atoms، تأكد من أن Repository Status يعرض Connected.
2. ضمن Branches، تحقق من أن أحد الفروع يحتوي على علامة صح. هذا هو الفرع المتصل حاليًا بمشروع Atoms الخاص بك. إذا كنت جديدًا على GitHub، فأبقِ هذا الفرع محددًا.
3. حدد View on GitHub.
4. في GitHub، تأكد من أن المستودع:
   • ينتمي إلى حساب GitHub الصحيح؛
   • موسوم بأنه Private؛
   • يحتوي على ملفات المشروع المتوقعة؛ و
   • يحتوي على commit واحد على الأقل.

إذا كان المستودع فارغًا وكان Push Changes متاحًا في Atoms، فحدده وانتظر حتى تنتهي العملية. ثم حدّث صفحة المستودع في GitHub وتحقق من أن ملفات المشروع تظهر الآن.

تحقق من المستودع المتصل والفرع المحدد في Atoms.

تحقق من المستودع الخاص وملفات المشروع في GitHub.

حافظ على تزامن Atoms وGitHub

لا يبقى Atoms وGitHub متزامنين تلقائيًا. عند إجراء تغييرات على أحد الجانبين، استخدم عناصر التحكم في المزامنة لنقل تلك التغييرات إلى الجانب الآخر.

الإجراء	استخدمه عندما	ما الذي يحدث
Push Changes	لقد أجريت تغييرات في Atoms وتريد إرسالها إلى GitHub.	يرسل Atoms ملفات المشروع الحالية إلى فرع GitHub المحدد.
Pull Updates	تم إجراء تغييرات على الفرع المحدد في GitHub وتريد جلبها إلى Atoms.	يحدّث Atoms المشروع بأحدث التغييرات من GitHub.

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

إذا لم تكن على أحدث إصدار، فسيعرض Atoms الرسالة You must be on the latest version to pull updates or push changes.

قبل المزامنة، تحقق أيضًا من أن الفرع المحدد هو الفرع الذي تريد تحديثه.

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

إذا كان Repository Status يعرض Upstream Changes Available، فهذا يعني أن GitHub يحتوي على تغييرات لا يملكها Atoms بعد. راجع المستودع قبل اختيار إجراء.

استخدم Pull Updates وPush Changes للفرع المحدد.

ادفع التغييرات من Atoms إلى GitHub

1. أنهِ إجراء تغييراتك في Atoms وانتظر حتى يتوقف Agent عن العمل.
2. تأكد من أنك تعرض أحدث إصدار من المشروع.
3. افتح Settings → Connectors → GitHub وتحقق من تحديد الفرع الصحيح.
4. حدد Push Changes.
5. أبقِ الصفحة مفتوحة أثناء دفع التغييرات.
6. عندما تظهر Changes pushed successfully، حدد View on GitHub وتحقق من وجود أحدث ملفات المشروع هناك.

Push Changes متاح فقط عندما يحتوي Atoms على تغييرات لم يتم إرسالها بعد إلى GitHub. ولا يكون متاحًا أثناء عمل Agent أو عندما تعرض إصدارًا أقدم من المشروع.

بمجرد تحديد Push Changes، يتم إرسال التغييرات إلى GitHub فورًا دون طلب تأكيد. إذا تم تغيير الملف نفسه في كل من Atoms وGitHub، فستكون الأولوية للإصدار الموجود في Atoms وسيستبدل الإصدار المخزن حاليًا في GitHub.

اسحب التحديثات من GitHub إلى Atoms

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

1. افتح Settings → Connectors → GitHub.
2. تحقق من أن Repository Status يعرض تغييرات جديدة من GitHub وأن الفرع الصحيح محدد.
3. حدد Pull Updates.
4. اقرأ تحذير Pull May Affect Project. إذا كنت تريد جلب تغييرات GitHub إلى مشروع Atoms الحالي، فحدد Confirm.
5. أبقِ الصفحة مفتوحة أثناء سحب التغييرات.
6. عندما تظهر Changes pulled successfully، افتح عارض التطبيقات واختبر الأجزاء المتأثرة من مشروعك للتأكد من أن كل شيء لا يزال يعمل كما هو متوقع.

Pull Updates متاح فقط عندما يحتوي فرع GitHub المحدد على تغييرات لم يتم جلبها بعد إلى Atoms.

افصل GitHub

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

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

1. افتح Settings → Connectors → GitHub.
2. حدد Disconnect.
3. في تأكيد Disconnect GitHub، حدد Disconnect مرة أخرى.
4. يجب أن يفتح GitHub صفحة التفويض ذات الصلة تلقائيًا. إذا لم يحدث ذلك، ففي GitHub انتقل إلى Settings → Applications → Authorized OAuth Apps.
5. اعثر على Atoms، وحدد ... على يمين صفه، ثم حدد Revoke. لا تحدد Revoke all؛ فهذا الإجراء يزيل الوصول لكل تطبيقات OAuth المصرح بها المدرجة في الصفحة.
6. اتبع أي خطوات تأكيد مطلوبة من Github.
7. ارجع إلى Atoms وأعد فتح أداة ربط GitHub للتأكد من أن الحساب لم يعد متصلًا.

حدد Disconnect في أداة ربط GitHub.

ألغِ فقط تطبيق OAuth الخاص بـ Atoms في GitHub.