مزامنة GitHub
اربط GitHub برمز جهاز أو برمز وصول، وانشر مشروعًا مستودعًا جديدًا أو قائمًا، وادفع واسحب بين الحواسيب، وكيف يُحمى رمز وصولك.
مزامنة GitHub نسخٌ احتياطي اختياري خارج الحاسوب وتسليمٌ بين حواسيب متعددة، وهي مبنية على مستودع Git الحقيقي الذي هو عليه كل مشروع بالفعل. تعمل عمليات commit المحلية من دون GitHub. وعند الاتصال، لا يظل أي حساب Oleafly في الصورة: فقط GitHub الخاص بك.
ربط حسابك
قسم بعنوان “ربط حسابك”Settings، ثم Integrations، ثم GitHub، ثم أحد المسارين:
- Connect GitHub (موصى به): تدفق رمز الجهاز. يعرض Oleafly رمزًا قصيرًا، ويفتح متصفحك
github.com/login/device(مع زر Copy للرمز)، توافق، فيكتشفه التطبيق خلال ثوانٍ. ويطلب الاتصال نطاقَي الوصولrepoوread:userفقط. - Personal access token: وسّع «Advanced: use a personal access token» والصق PAT إذا كنت تفضّل إنشاء بيانات اعتمادك بنفسك.
بعد الاتصال، تظهر صورتك الرمزية واسم المستخدم في Settings وفي قائمة GitHub في شريط الأدوات العلوي. وينسى Disconnect الرمز.
كيف يُحمى رمز وصولك
قسم بعنوان “كيف يُحمى رمز وصولك”يُخزَّن الرمز في ملف محلي مشفَّر بـAES-256-GCM مقصور على مالكه، ولا يُسلَّم أبدًا إلى طبقة واجهة المستخدم في التطبيق؛ فلا تعرف الواجهة سوى «connected as @you». وعندما يحتاج Git إلى المصادقة، يُحقن الرمز عبر مساعد بيانات اعتماد في الذاكرة، فلا يظهر أبدًا في سطر أوامر ولا في .git/config ولا في سجل الأوامر لديك. وتُنظَّف تلقائيًا عند الإقلاع البناءاتُ الأقدم التي ضمّنت الرموز في عناوين URL للمستودعات البعيدة.
نشر مشروع
قسم بعنوان “نشر مشروع”في لوحة Source Control، انقر Publish to GitHub:
- Create new repository: اختر اسمًا (معبأً مسبقًا من المشروع)، وأبقِ تحديد Private (الموصى به) أو ألغه، ثم اختر Create and push. ينشئ Oleafly المستودع، وينفّذ commit لملفات المشروع، ويوصّل
origin، ويدفع. - Link existing: اختر من قائمة قابلة للبحث في مستودعاتك (الخاصة منها تظهر بقفل)، ثم اختر Link and push.
وبعد النشر، تقدم قائمة GitHub في شريط الأدوات Open in GitHub وCopy repository link.
الملفات التي تشبه الأسرار تبقى محلية
قسم بعنوان “الملفات التي تشبه الأسرار تبقى محلية”لا ينفّذ النشر أبدًا commit لملفات تحمل عادةً مفاتيح أو كلمات مرور، مثل .env أو *.pem أو مفاتيح SSH الخاصة أو credentials.json. وتبقى هذه الملفات في مجلد المشروع غير محضَّرة، ويسمّيها الحوار. ولنشر أحدها رغم ذلك، حضّره ونفّذ له commit بنفسك في Source Control. أما القوالب مثل .env.example والمفاتيح العامة وملفات Keynote ذات الامتداد .key فتُنشر كالمعتاد.
ترفع الدفعةُ السجلَّ كاملًا. فإذا كان قد نُفّذ commit في أي وقت لملف يحمل أحد هذه الأسماء، فإن Oleafly يسرده وينتظر Cancel أو Publish anyway قبل أن ينشئ أي شيء على GitHub.
المزامنة اليومية
قسم بعنوان “المزامنة اليومية”زرّا Push وPull في لوحة Source Control يفعلان ما يقولان، مقابل origin على فرعك الحالي. ويقع Fetch وSync في قائمة More Source Control actions، ويقع Commit & Push وCommit & Sync في القائمة بجانب Commit. ويخبرك مؤشر ahead/behind (↑ ↓) بجانب كبسولة الفرع متى كان هناك ما يُدفع أو يُسحب.
حاسوبان
قسم بعنوان “حاسوبان”- على الحاسوب A: انشر المشروع، واعمل، ثم Push.
- على الحاسوب B: اربط حساب GitHub نفسه، ثم اختر Import a project → GitHub واختر المستودع. وراجع دليل الاستيراد. ومن ذلك الحين فصاعدًا: Pull، اعمل، Push.
- وعلى A مجددًا: Pull قبل أن تبدأ. يذكّرك المؤشر.
لون الغلاف، واختيار المستند الرئيسي، والتاريخ، كلها تنتقل معك، لأنها تعيش في مجلد المشروع نفسه.
تغيير رأيك
قسم بعنوان “تغيير رأيك”بعد ضبط مستودع بعيد، تحتوي قائمة More Source Control actions على عنصرين إضافيين:
- Change repo يعيد فتح حوار النشر لتوجيه
originإلى مكان آخر. - Unlink يزيل المستودع البعيد؛ ويبقى المشروع المحلي وتاريخه دون مساس.
التعارضات والفروع
قسم بعنوان “التعارضات والفروع”إذا صادف السحب تعارضَ دمج، سردَ Source Control الملفاتِ المتعارضة. اختر Use current أو Use incoming لكل ملف، أو حرّر الملف واختر Mark resolved، ثم اختر Complete merge. ويعيد Abort merge الملفات إلى ما كانت عليه. ويعمل Push وPull على الفرع المفعَّل لديك، وقائمة الفروع أعلى اللوحة تبدّل الفروع أو تنشئها. وراجع Git وإدارة المصدر.
الحدود، مذكورة بوضوح
قسم بعنوان “الحدود، مذكورة بوضوح”يصادق Oleafly المستودعات البعيدة العاملة بـHTTPS. وينشئ النشر لك واحدًا منها مضبوطًا على النحو الصحيح.
إذا فشل شيء
قسم بعنوان “إذا فشل شيء”- «No remote ‘origin’»: انشر أولًا؛ فزرّا Push وPull يحتاجان إلى مستودع بعيد.
- رفض الدفع لأن المستودع البعيد يحوي عمليات commit: اسحب أولًا ثم ادفع.
- «No GitHub token set»: اربط الحساب في Settings ثم Integrations ثم GitHub.
المزيد في الأسئلة الشائعة.