دليل GitTree لسطح المكتب

استخدام GitTree في عملك اليومي

GitTree عميل Git لسطح المكتب على macOS وWindows وLinux. سجّل الدخول، فتكون كل مهام Git المحلية في الخطة المجانية: الفتح والاستنساخ والإيداع والتفريع والدمج وإعادة التأسيس والتخبئة والتراجع. ويضيف GitTree Pro تكاملات الاستضافة وتشغيلات CI/CD والصياغة بالذكاء الاصطناعي ونور، المساعدة الذكية.

تثبيت GitTree على macOS

GitTree لـ Mac تطبيق شامل واحد لأجهزة Apple silicon وIntel على macOS 13 أو أحدث، موقّع وموثّق من Apple. ثبّت Git أولًا، وافتح ملف ‎.dmg، واسحب GitTree إلى التطبيقات وشغّله.

تثبيت GitTree على Windows

GitTree لـ Windows مثبّت 64 بت لـ Windows 10 (22H2) وWindows 11. ثبّت Git for Windows أولًا، وشغّل المثبّت، وابدأ GitTree من قائمة ابدأ.

تثبيت GitTree على لينكس

يأتي GitTree لـ Linux (لينكس) حزمةَ ‎.deb لـ Ubuntu 22.04 أو أحدث وDebian 12 أو أحدث، وملف AppImage محمولًا، كلاهما لمعمارية x86_64 بنظام 64 بت. ثبّت Git 2.39 أو أحدث أولًا، ثم ثبّت ‎.deb عبر apt أو شغّل AppImage.

العثور على Git وضبط هوية الإيداع

يشغّل GitTree نسخة Git المثبّتة على حاسوبك ولا يضمّن واحدة أبدًا. ويحتاج إلى Git 2.39 أو أحدث، وإلى اسم وبريد لإيداعاتك (user.name وuser.email) يطلبهما أول مرة يحتاجهما إيداع.

التعرّف على أجزاء GitTree

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

إنشاء أول إيداع

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

استخدام Git المحلي مجانًا وفهم Pro

كل ميزة Git محلية في GitTree مجانية لكل من يسجّل الدخول بحساب GitTree. ويضيف GitTree Pro المساعد نور وتكاملات الاستضافة والصياغة بالذكاء الاصطناعي؛ ويمكنك تجربتها بفترة تجربة مجانية لا تبدأ إلا حين تطلبها.

فتح مستودع موجود

اختر مجلد مستودع Git موجود على حاسوبك، فيفتحه GitTree في تبويب خاص به مع مخطط الإيداعات والفروع والتغييرات. لا يُرفع شيء، ويبقى المستودع على حاسوبك.

استنساخ مستودع

ينسخ الاستنساخ (clone) مستودعًا من GitHub أو GitLab أو Bitbucket أو Azure DevOps أو أي خادم Git إلى حاسوبك مع سجله. في GitTree تلصق العنوان، وتختار مكانه، ثم تضغط استنساخ؛ ويُفتح في تبويب جديد عند الانتهاء.

إنشاء مستودع

تحوّل التهيئة مجلدًا إلى مستودع Git، كالأمر git init. في GitTree تختار المجلد والفرع الأولي، وتضيف .gitignore وترخيصًا إن أردت، ثم تضغط تهيئة.

استخدام المستودعات الأخيرة والمفضّلة

يسرد التبويب الجديد المستودعات التي فتحتها تحت الأخيرة والتي وضعت عليها نجمة تحت المفضّلة. اختر واحدًا لفتحه في تبويب. وتبقى القوائم على هذا الحاسوب.

العثور على المستودعات في القرص

يبحث البحث عن مستودعات… في مجلد تختاره ويسرد كل مستودع Git حتى عمق ثلاثة مجلدات. ولا يُفتح شيء حتى تختار؛ يمكنك فتح واحد أو إضافتها إلى مساحة عمل.

مراجعة الثقة بالمستودع

تحتوي بعض المستودعات إعدادات أو خطّافات لـ Git تشغّل برامج على حاسوبك حين يعمل Git فيها. وقبل أن يحدث ذلك يعرض GitTree الوثوق بهذا المستودع؟ مع ما عثر عليه بالضبط، ويتيح لك الوثوق به أو فتحه في الوضع المقيَّد.

فتح مستودع مجرّد

المستودع المجرّد فيه سجل بلا ملفات عمل، مثل التي تحتفظ بها الخوادم ليدفع إليها الآخرون (git init --bare وgit clone --bare). يفتحه GitTree لعرض المخطط والفروع والوسوم، ويعلّم تبويبه مجرّد، ويوقف الإجراءات التي تحتاج إلى ملفات عمل.

إدارة تبويبات المستودعات

يُفتح كل مستودع في تبويبه أعلى النافذة. وتُظهر التبويبات حالة المستودع، مثل وجود تغييرات غير مُودَعة أو إعادة تأسيس جارية، وتنتقل بينها من لوحة المفاتيح.

قراءة مخطط الإيداعات

يعرض مخطط الإيداعات سجل المستودع صفوفًا، الأحدث أولًا، بمسارات تتفرع حيث تبدأ الفروع وتلتقي حيث تندمج. وتُظهر الشارات على الصفوف الفروع والوسوم، وتُظهر علامة ✓ الفرع الذي تعمل عليه.

العثور على إيداع

اضغط Ctrl+F (أو ⌘F على Mac) في المخطط واكتب جزءًا من رسالة إيداع أو مؤلفًا أو SHA أو فرعًا أو وسمًا. يميّز GitTree النتائج وينتقل بينها؛ أما تصفية المخطط… فتضيّق السجل نفسه.

فحص إيداع

اختر إيداعًا في المخطط فتعرض لوحة التفاصيل على الجانب كل شيء عنه: الرسالة وقيمة SHA الكاملة وآباءه ومن كتبه وأودعه والملفات التي غيّرها. اختر ملفًا لترى فروقه.

التركيز على المخطط وتصفيته

في مستودع مزدحم يعرض التركيز على الفرع الحالي فرعك وفرعه المتتبَّع وفرعه الأساسي فقط، مع عدد إيداعاته منذ الأساس. وتُبقي تصفية المخطط… إيداعات مؤلف أو نطاق تاريخ أو مسار. ولا تحذف التصفية شيئًا من السجل؛ ويعيد مسح تصفية المخطط كل الصفوف.

تخصيص أعمدة المخطط

يعرض المخطط افتراضيًا شارات الفروع والمسارات والرسالة. وتضيف قائمة أعمدة المخطط أعمدة المؤلف والتاريخ وSHA وتبدّل إلى الصفوف المضغوطة؛ ويمكنك تغيير عرض كل عمود وإخفاء اللوحات الجانبية.

مقارنة الإيداعات والتصرّف في تحديد

حدّد إيداعين مع الضغط على Ctrl (أو ⌘ على Mac) واختر مقارنة هذين الإيداعين لترى كل ملف يختلف بينهما. ولتحديد عدة إيداعات إجراءاته الخاصة: نسخ قيم SHA أو الانتقاء أو العكس أو الضمّ أو إنشاء رقعة.

استخدام السحب والإفلات في المخطط

اسحب شارة فرع وأفلِتها على فرع آخر في المخطط فيعرض GitTree ما يمكن للفرعين فعله: تقديم سريع أو دمج أو إعادة تأسيس. ولا يحدث شيء حتى تختار، ويسري التأكيد المعتاد والتراجع.

مراجعة تغييرات العمل

لوحة تغييرات العمل هي git status في GitTree: تسرد كل ملف غيّرته منذ آخر إيداع، مقسّمة إلى الملفات غير المُجهَّزة والملفات المُجهَّزة، وتعرض فروق الملف الذي تختاره.

تجهيز الملفات والكتل والأسطر المحددة

لا يحتوي الإيداع (commit) إلا على ما جهّزته. في GitTree تجهّز ملفًا كاملًا، أو كتلة واحدة منه، أو الأسطر التي تحددها في عرض الفروق فقط، وتبقى بقية تعديلاتك في مجلد العمل لإيداع لاحق.

كتابة رسالة الإيداع والإيداع

يقع نموذج الإيداع تحت ملفاتك المُجهَّزة: سطر الملخّص، والوصف الاختياري، وخيارات الإيداع للمؤلفين المشاركين وSigned-off-by والخطّافات والدفع بعده. وينبّهك GitTree إلى أخطاء الرسائل الشائعة قبل الإيداع.

تعديل الإيداع الأخير

يستبدل التعديل الإيداع الأخير بإيداع جديد فيه رسالتك المصحَّحة وأي تغييرات تجهّزها الآن، كالأمر git commit --amend. وهو في GitTree مفتاح تعديل الإيداع الأخير في نموذج الإيداع.

التخلّص من التغييرات وتنظيف الملفات غير المتتبَّعة

يعيد التخلّص من التغييرات الملفات إلى آخر حالة مُودَعة أو مُجهَّزة لها، كالأمر git restore؛ ويزيل التنظيف الملفات التي لا يتتبّعها Git، كالأمر git clean. ويحفظ GitTree لقطة استعادة أولًا، فيستطيع تراجع إعادتها.

اختيار طريقة عرض الفروق واستخدامها

يمكن عرض أي فروق في GitTree كتلة أو عمود واحد أو جنبًا إلى جنب. ميّز الكلمات المتغيّرة، ولُفّ الأسطر الطويلة، وتجاهل تغييرات المسافات، وعاين Markdown، وانتقل من تغيير إلى التالي.

تجاهل الملفات من GitTree

مكان الملفات التي لا تريد إيداعها أبدًا، مثل مخرجات البناء أو الإعدادات المحلية، هو .gitignore. انقر ملفًا جديدًا في تغييرات العمل بزر الفأرة الأيمن واختر ما تتجاهله، أو حرّر .gitignore مباشرة بـ تحرير .gitignore….

إنشاء الرقع وتطبيقها

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

مراجعة الصور والتغييرات الثنائية

لا تستطيع فروق النص عرض صورة. فحين تتغيّر صورة PNG أو JPEG أو GIF أو WebP أو غيرها، يقارن GitTree الصورتين قبل وبعد: جنبًا إلى جنب أو شريط منزلق أو طبقتان شفافتان. وتعرض الملفات الثنائية الأخرى أحجامها.

إدارة علامات الفهرس للملفات المتتبَّعة

أحيانًا تغيّر ملفًا متتبَّعًا على حاسوبك فقط، مثل إعدادات محلية. وتخفي علامتان في Git مثل هذه التغييرات: يحتفظ تخطّي مجلد العمل (skip-worktree)… بنسختك ويوقف عرض تغييراتها؛ وافتراض عدم التغيير (assume-unchanged)… تسريع يوقف فحص Git للملف. وليست أيٌّ منهما طريقة لتجاهل ملف.

إنشاء الفروع والتبديل بينها

الفرع اسم متحرك لخط عمل. في GitTree ينشئ فرع في شريط الأدوات فرعًا عند الإيداع الذي أنت عليه، وينشئه النقر بزر الفأرة الأيمن على أي إيداع هناك. وانقر شارة فرع نقرًا مزدوجًا للتبديل إليه.

إعادة تسمية الفروع وحذفها

انقر شارة الفرع بزر الفأرة الأيمن لـ إعادة تسمية وحذف. يحفظ حذف فرع محلي آخر إيداع فيه تحت refs/ogt/trash أولًا، فيعيده تراجع؛ أما الحذف من المستودع البعيد فخيار منفصل باسم واضح.

إنشاء الوسوم وإدارتها

الوسم اسم ثابت لإيداع واحد، غالبًا لإصدار مثل v2.2.0. انقر إيداعًا بزر الفأرة الأيمن واختر وسم هنا، ثم وسمًا خفيفًا أو مشروحًا. ولا تُدفع الوسوم مع إيداعاتك: ادفع كلًّا منها بـ دفع الوسم.

تعيين التتبّع ونشر فرع

يبقى الفرع الجديد على حاسوبك فقط حتى تدفعه. ويسألك دفع الأول إلى أي مستودع بعيد ترسله، ومن ثم يتتبّع الفرع ذلك الفرع البعيد (فرعه المتتبَّع)، كالأمر git push -u. ويغيّر تعيين الفرع المتتبَّع… ما يتتبّعه.

مقارنة الفروع والوسوم

يقارن مقارنة مرجعين… أي فرعين أو وسمين أو فرعين بعيدين أو إيداعين بأسمائها. ويعرض كم إيداعًا يتقدّم أحدهما على الآخر ويتأخر عنه، والملفات المختلفة: إما كل الفروق (git diff A B) وإما ما غيّره الطرف الأحدث منذ افتراقهما فقط (A...B، ما يعرضه طلب السحب).

استخدام إجراءات Gitflow

Gitflow نموذج تفريع فيه فرع إنتاج وفرع تطوير وفروع للميزات والإصدارات والإصلاحات العاجلة. ويهيّئه قسم Gitflow في GitTree ويبدأ تلك الفروع وينهيها، فيدمجها ويسِمها ويحذفها نيابةً عنك.

التعرّف على HEAD المنفصل ومغادرته

يضعك التبديل إلى إيداع أو وسم بدلًا من فرع على HEAD منفصل: لست على أي فرع. يمكنك الاطلاع بل والإيداع، لكن الإيداعات الجديدة لا تنتمي إلى أي فرع. أنشئ فرعًا لتحفظها، أو بدّل إلى فرع لتعود.

الجلب والسحب والدفع

ينزّل الجلب الجديد في مستودعاتك البعيدة دون أن يغيّر عملك. ويُدخل السحب الفرع المتتبَّع في فرعك. ويرسل الدفع إيداعاتك إلى المستودع البعيد. والثلاثة في شريط الأدوات، وخياراتها في قوائم الأسهم بجوارها.

إضافة المستودعات البعيدة وتحريرها

المستودع البعيد نسخة مسمّاة من المستودع في مكان آخر، مثل origin على GitHub. يسردها قسم بعيد في اللوحة الجانبية؛ ويضيف إضافة مستودع بعيد… واحدًا، ويحرّره النقر عليه بزر الفأرة الأيمن أو يجلبه أو يقلّمه أو يزيله.

اختيار بيانات اعتماد المستودع البعيد

يشغّل GitTree نسخة Git لديك، لذا يسجّل الجلب والسحب والدفع الدخول كما يفعل Git على حاسوبك: عبر HTTPS بمساعد بيانات الاعتماد، وعبر SSH بمفتاحك أو وكيل SSH. وتبقى كلمات المرور والرموز في سلسلة مفاتيح نظامك، لا في ملفات GitTree أبدًا.

ضبط الجلب التلقائي

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

استخدام الدفع القسري الآمن (with-lease)

بعد تعديل إيداعات دفعتها أو إعادة تأسيسها أو إعادة تعيينها، يُرفض الدفع العادي. يستبدل دفع قسري آمن (with-lease)… الفرع البعيد بفرعك، لكن فقط إن كان ما زال حيث جلبته آخر مرة، كالأمر git push --force-with-lease. ولا يدفع GitTree دفعًا قسريًا بأي طريقة أخرى أبدًا.

العمل بسجل محدود للمستودع

ينزّل الاستنساخ السطحي آخر الإيداعات فقط؛ وينزّل الاستنساخ دون محتوى (blobless) محتوى الملفات عند الحاجة فقط. وكلاهما يسرّع استنساخ المستودعات الضخمة. ويُظهر المخطط في الاستنساخ السطحي أين يتوقف السجل، ويجلب جلب مزيد من السجل أو جلب السجل كاملًا البقية.

دمج الفروع

يضيف الدمج إيداعات فرع آخر إلى الفرع الذي أنت عليه، كالأمر git merge. انقر الفرع الآخر بزر الفأرة الأيمن واختر دمج … في …: يتحقق GitTree من التعارضات أولًا ويتيح لك اختيار طريقة تسجيل الدمج.

إعادة تأسيس فرع

تعيد إعادة التأسيس تطبيق إيداعات فرعك فوق فرع آخر، فيبقى السجل خطًا مستقيمًا، كالأمر git rebase. تحصل الإيداعات على معرّفات جديدة؛ ويحتفظ GitTree بالفرع القديم تحت refs/ogt/trash، ويعيده تراجع.

حل تعارضات الدمج

يقع التعارض حين يغيّر الفرعان الأسطر نفسها. تعرض أداة الحل في GitTree النسختين جنبًا إلى جنب، A وB: علّم الأسطر التي تبقيها في كل تعارض، وراجع النتيجة، ثم حفظ وتابع الدمج أو إعادة التأسيس أو الانتقاء.

انتقاء الإيداعات وعكسها

ينسخ انتقاء الإيداع تغييرات إيداع واحد إلى فرعك الحالي في إيداع جديد، كالأمر git cherry-pick. ويضيف عكس الإيداع إيداعًا جديدًا يلغي إيداعًا، كالأمر git revert: الطريقة الآمنة للتراجع عن شيء مدفوع بالفعل.

متابعة عملية أو تخطّيها أو إيقافها

قد يتوقف الدمج أو إعادة التأسيس أو الانتقاء أو العكس في منتصفه، غالبًا عند تعارض. ويذكر شريط فوق المخطط العملية وخطوتها، ويعرض حلّ ومتابعة وتخطّي (لإعادة التأسيس) وإيقاف…. ويحفظ الإيقاف ما يُسقطه أولًا، فيعيده تراجع.

إعادة استخدام حلول التعارضات المسجَّلة

مع تفعيل إعادة استخدام الحلول المسجَّلة (rerere) يتذكّر Git كيف حللت تعارضًا ويكتب الحل نفسه حين يتكرر ذلك التعارض، في إعادة تأسيس متكررة مثلًا. ويخبرك GitTree حين يحدث ذلك ويتيح لك مراجعته قبل تعليم الملف محلولًا.

تعديل السجل بإعادة التأسيس التفاعلية

تعيد إعادة التأسيس التفاعلية كتابة الإيداعات التي تعلو إيداعًا تختاره: أبقِ كلًّا منها أو أعد صياغته أو حرّره أو اضممه أو أسقطه، واسحبها إلى ترتيب جديد، كالأمر git rebase -i. ولتغيير واحد يفعل تعديل السجل في قائمة الإيداع ذلك بخطوة واحدة.

ضمّ الإيداعات

يجمع الضمّ (squash) عدة إيداعات في إيداع واحد، مثل fixup أو squash في git rebase -i. في GitTree يفتح كل ضمّ نافذة ضمّ أولًا: تعرض الإيداعات التي تُضمّ والنتيجة والرسالة ومن يُنسب إليه العمل، ولا يتغير شيء قبل أن تؤكد. لا تُمسّ تغييراتك غير المودعة أبدًا، وزر تراجع يعيد الإيداعات كما كانت.

تغيير إيداعات محلية محددة

لتغيير سريع واحد في السجل لا تحتاج إلى محرر إعادة التأسيس التفاعلية كله. تحرّر قائمة تعديل السجل لإيداع رسالته، أو تسقطه، أو تنقله لأعلى أو لأسفل؛ ويفتح تحديد عدة إيداعات نافذة ضمّ. ويعيد GitTree كتابة الإيداعات التي فوقه ويحتفظ بالفرع القديم، فيعيده تراجع.

إعادة تعيين فرع إلى إيداع

تنقل إعادة التعيين فرعك الحالي إلى إيداع آخر، كالأمر git reset. الناعمة تبقي كل تغيير مُجهَّزًا، والمختلطة تبقيها في مجلد العمل، والكاملة تتخلّص منها. ويحفظ GitTree كل شيء تحت refs/ogt/trash أولًا، فحتى الكاملة يمكن التراجع عنها.

التراجع والإعادة

يسجّل GitTree عملياتك في Git ليتراجع تراجع في شريط الأدوات عن آخرها: إيداع أو دمج أو إعادة تأسيس أو إعادة تعيين أو تخلّص من تغييرات أو تنظيف أو فرع أو وسم محذوف. ويعيد إعادة تنفيذها. وتحفظ الخطوات المدمّرة لقطة استعادة تحت refs/ogt/trash قبل تنفيذها.

العثور على رؤوس الفروع السابقة

يسجّل سجل المراجع (reflog) أين كان يشير فرع أو HEAD في كل مرة تحرّك: الإيداعات والتبديل وإعادة التعيين وإعادة التأسيس. ويسرد عرض سجل المراجع (reflog)… تلك القيود؛ اختر واحدًا لإظهار إيداعه في المخطط أو استعادة كفرع.

سجل الملف ونسب الأسطر

يسرد السجل كل إيداع غيّر ملفًا مع تتبّع إعادة التسمية، كالأمر git log --follow. ويعرض نسب الأسطر لكل سطر الإيداع والمؤلف اللذين غيّراه آخر مرة، كالأمر git blame. وكلاهما طريقة عرض في مساحة عمل الملف.

استخدام البحث الثنائي

يجد البحث الثنائي أول إيداع أدخل مشكلة بتقسيم السجل إلى نصفين بين إيداع فيه المشكلة وآخر بدونها، كالأمر git bisect. حدّد الإيداعين، واختبر الإيداع الذي يبدّل إليه GitTree، وحدّده سليم أو معيب، وكرّر حتى يذكر أول إيداع معيب.

تصدير أرشيف

يكتب تصدير أرشيف… ملفات إيداع أو فرع أو وسم كملف ‎.zip أو ‎.tar.gz، دون مجلد .git، كالأمر git archive. وهو أسرع طريقة لتسليم أحدهم شيفرة إصدار.

استخدام أدوات صيانة المستودع والمؤلفين

يعرض صيانة المستودع… حجم قاعدة الكائنات ويشغّل مهامًا تفحصها أو تسرّع السجل والحالة. ويكتب دمج هويات المؤلفين… أسطرًا في .mailmap ليظهر الشخص ذو الأسماء أو العناوين المتعددة مؤلفًا واحدًا.

تنظيم مساحات العمل

مساحة العمل مجموعة مسمّاة من المستودعات تُفتح معًا، مثل «العميل أ» أو «الجوال». وتعرض لوحتها فرع كل مستودع وحالة مزامنته وتغييراته، إضافة إلى طلبات السحب وتشغيلات CI/CD عبرها.

إدارة المستودعات المحفوظة

تحتفظ كل مساحة عمل بقائمة المستودعات المحفوظة: كل مستودع تفتحه أو تستنسخه أو تنشئه أو تضيفه من بحث وهي مساحة العمل الحالية يُحفظ هناك ويبقى بعد إغلاق تبويبه. افتحها من القائمة أو كلها معًا، أو أزل أحدها؛ ولا يُمسّ مجلده أبدًا.

تخبئة التغييرات

يضع المخبأ تغييراتك غير المُودَعة جانبًا ويمنحك مجلد عمل نظيفًا، كالأمر git stash، فتنتقل إلى مهمة أخرى وتعيد التغييرات لاحقًا. يخبّئ تخبئة في شريط الأدوات كل شيء، ويختار تبويب تخبئة في لوحة التغييرات ما تريده بالضبط.

العمل على عدة فروع بأشجار العمل

شجرة العمل مجلد عمل ثانٍ للمستودع نفسه، بفرع خاص بها، كالأمر git worktree add. راجع طلب سحب، أو شغّل بناءً طويلًا، أو دع وكيل برمجة يعمل في إحداها، دون تخبئة شيء في الأخرى.

إدارة الوحدات الفرعية

الوحدة الفرعية مستودع آخر مثبّت داخل مستودعك عند إيداع محدد. يسردها GitTree مع حالتها (غير مهيّأة، محدَّثة، إيداع مختلف، بها تعارض) ويضيفها ويهيّئها ويحدّثها ويفتحها ويحرّرها ويزيلها.

استخدام عناصر تحكم Git LFS

يخزّن Git LFS الملفات الكبيرة، كالصور والفيديو والنماذج، خارج المستودع ويضع مكانها ملفات مؤشر صغيرة. ويعدّه Git LFS… ويتتبّع الأنماط وينزّل المحتوى ويقفل الملفات ويقلّم المحتوى القديم.

استعراض ملفات المشروع وتحريرها

يعرض قسم الملفات في اللوحة الجانبية مجلدات مشروعك، ويعلّم ما فيه تغييرات. افتح ملفًا لقراءته أو تحريره في تبويب بجوار تبويب الرسم البياني، وبدّل عرضه بين الملف والتغييرات ونسب الأسطر والسجل.

فتح الملفات وتحريرها

كل ملف تفتحه في GitTree يحصل على تبويب بجوار تبويب الرسم البياني المثبّت. الملف من إيداع للقراءة فقط؛ ويفتح تحرير في مجلد العمل النسخة التي في مشروعك لتحريرها وحفظها. وإن تغيّر الملف على القرص في الأثناء لا يحفظ GitTree شيئًا ويترك لك الاختيار.

العودة إلى مخطط الإيداعات

تُفتح الفروق والملفات ونسب الأسطر والسجل والمقارنات وخطوط CI/CD وطلبات الدمج فوق المخطط. يغلق Esc العرض الأعلى ويعيدك إلى العرض الذي فتحه؛ ويزيلها العودة إلى الرسم البياني كلها دفعة واحدة. أما الملفات المفتوحة فتُخفى فقط: تبقى تبويباتها بجوار تبويب الرسم البياني.

استخدام الطرفية المدمجة

يفتح الطرفية في شريط الأدوات صدفة في جذر المستودع، في الدُرج تحت المخطط. شغّل هناك أي أمر، ومنها أوامر Git: يتحدّث المخطط وتغييراتك أولًا بأول. ولكل تبويب مستودع طرفياته.

ضبط الأدوات الخارجية

تختار التفضيلات › الأدوات الخارجية المحرّر وأداة الفروق وأداة الدمج التي يفتحها GitTree من قوائم الملفات وعرض التعارض. يستخدم تلقائي أول ما هو مثبّت من Visual Studio Code وCursor وAntigravity؛ ويشغّل مخصّص… أي برنامج بالوسائط التي تحددها.

إنشاء الإجراءات المخصّصة وتشغيلها

تشغّل الأوامر المخصّصة برامجك على مستودع من زر إجراءات مخصّصة ومن قوائم الإيداعات والفروع والملفات. يُمرَّر كل وسيط كما كُتب تمامًا، ولا تُستخدم أي صدفة (shell)، ويعرض التشغيل الأول للأمر ما سيُشغَّل بالضبط قبل تشغيله.

العثور على الإجراءات بلوحة الأوامر

تشغّل لوحة الأوامر أي أمر في GitTree بكتابة جزء من اسمه، وتنقلك أيضًا إلى الفروع والإيداعات والملفات والمستودعات المفتوحة. اضغط Ctrl+Shift+P (أو ⌘⇧P على Mac)، واكتب، ثم اضغط Enter.

اختصارات لوحة المفاتيح

لمعظم أوامر GitTree اختصار. اضغط Ctrl+/ (أو ⌘/ على Mac) للقائمة الكاملة داخل التطبيق، مصفّاة وأنت تكتب؛ ويغيّر تخصيص… هناك أيًّا منها. وتسرد الجداول أدناه الاختصارات الافتراضية.

فحص النشاط والإشعارات

يسرد سجل النشاط كل أمر git يشغّله GitTree، مع مخرجاته ومدته وهل فشل؛ وتُزال رموز الوصول وكلمات المرور وبيانات الاعتماد الواردة في عناوين URL. وتحفظ الإشعارات الرسائل المعروضة في هذه الجلسة، وتحدد التفضيلات › الإشعارات ما يظهر منها وهل يعرضها نظامك أيضًا.

استخدام دليل الميزات في التطبيق

يسرد دليل الميزات كل ما يستطيعه GitTree، وأين تجده، واختصاراته، مجمّعًا حسب المجال ومع مربع بحث. ينقلك أرني إلى الميزة في المستودع المفتوح؛ والميزات التي تحتاج إلى مستودع أو Pro أو حساب متصل تذكر ذلك.

ربط GitHub

يتيح ربط GitHub لـ GitTree عرض مستودعاتك وطلبات السحب والمشكلات والفحوص. سجّل الدخول عبر المتصفح (موصى به: توافق على GitTree في صفحة GitHub نفسها) أو استخدم رمز وصول شخصيًا. ولا يُحفظ الرمز إلا في سلسلة مفاتيح نظامك.

ربط GitLab

يرتبط GitTree بـ gitlab.com أو بمضيف GitLab مُدار ذاتيًا تحدده. سجّل الدخول عبر المتصفح من خلال تطبيق OAuth (يُستخدم تطبيق GitTree نفسه مع gitlab.com)، أو استخدم رمز وصول شخصيًا من ذلك المضيف. ولا يُستخدم الرمز إلا لذلك المضيف.

ربط Bitbucket Cloud

يرتبط GitTree بـ Bitbucket Cloud ‏(bitbucket.org) بثلاث طرق: تسجيل الدخول بحساب Bitbucket في المتصفح، أو رمز API من Atlassian مع البريد الإلكتروني للحساب، أو رمز وصول لمساحة عمل أو مشروع أو مستودع. ولا تُحفظ الرموز إلا في سلسلة مفاتيح نظامك.

ربط Bitbucket Data Center

لخادم Bitbucket Data Center في شركتك حدّد مضيفه، ثم استخدم رمز وصول HTTP شخصيًا منه، أو سجّل الدخول عبر المتصفح من خلال رابط تطبيق OAuth الوارد الذي أنشأه المسؤول لديك لـ GitTree. ولا يتواصل GitTree إلا مع ذلك المضيف.

ربط Azure DevOps

سجّل الدخول بحساب Microsoft في المتصفح، أو استخدم رمز وصول شخصيًا من Azure DevOps. يتواصل GitTree مع dev.azure.com ومع خدمة الملفات الشخصية لدى Microsoft للعثور على مؤسساتك، ثم يعرض مستودعاتها وطلبات السحب وخطوط CI/CD.

ربط الخوادم المؤسسية والمستضافة ذاتيًا

يرتبط GitTree بخوادم شركتك: GitHub Enterprise Server وGitLab المُدار ذاتيًا وBitbucket Data Center. تحدد المضيف؛ فلا يتواصل GitTree إلا مع https:// ذلك المضيف، ولا يُستخدم الرمز إلا له. ويحتاج تسجيل الدخول عبر المتصفح إلى تطبيق OAuth سجّله المسؤول لديك هناك.

التحقق من توفر التكاملات

لا يقدّم المزوّدون الأشياء نفسها كلها. يعرض تبويب التكاملات في دليل الميزات، لمزوّد المستودع المفتوح ولحسابك، ما هو متاحة، وما لا يقدّمها ذلك المزوّد، وما هو قريبًا.

استعراض مستودعات المزوّد وإنشاؤها

مع حساب مرتبط يعرض استنساخ مستودع مستودعات ذلك الحساب حسب المالك مع البحث، فلا تحتاج إلى نسخ عنوان URL. ويعمل نشر المستودع… في الاتجاه الآخر: ينشئ المستودع في حسابك، ويضيفه مستودعًا بعيدًا، ويدفع فرعك.

استخدام التفريعات من GitTree

التفريعة نسختك الخاصة من مستودع لدى المزوّد. يطلب إنشاء تفريعة… من المزوّد إنشاء واحدة؛ ويضيف إضافة مستودع بعيد من تفريعة… تفريعة موجودة مستودعًا بعيدًا. ولا يغيّر إنشاء التفريعة شيئًا في مستودعك حتى تضيفها، ولا يُستبدل أي مستودع بعيد موجود.

طلبات السحب

مع ربط حساب استضافة يسرد GitTree طلبات سحب المستودع في اللوحة الجانبية ويفتح كلًّا منها بجوار المخطط: المحادثة والإيداعات والملفات والفحوص، مع مراجعة… ودمج…. وطلبات السحب جزء من GitTree Pro.

إنشاء طلب سحب أو دمج

انقر فرعك بزر الفأرة الأيمن واختر بدء طلب سحب…. اختر ما يدمجه من وإلى، واكتب العنوان والوصف، وأضف مراجعين، وفعّل فتحه كمسودة إن أردت، واضغط إنشاء طلب السحب. ويُدفع أولًا الفرع غير الموجود على المستودع البعيد بعد.

مراجعة التغييرات ومناقشتها

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

دمج طلب سحب أو إغلاقه

يسأل دمج… المزوّد عن طرق دمج طلب السحب، ويعرض إن كان جاهز للدمج، ولا يعرض من طريقة الدمج إلا ما يسمح به المستودع. ولا يدمج GitTree إلا ما دام الرأس هو الإيداع الذي اطّلعت عليه؛ فإن وصلت إيداعات جديدة لا يُدمج شيء.

استخدام إجراءات المشكلات المتاحة

يسرد قسم المشكلات في اللوحة اليسرى المشكلات المفتوحة في المستودع. افتح واحدة لتقرأها وتعلّق عليها، أو أنشئ واحدة بـمشكلة جديدة…، أو ابدأ العمل بـإنشاء فرع من المشكلة…. أما إغلاق المشكلات وتحريرها فيتمّان في صفحة المزوّد: فتح المشكلة في المتصفح.

فحص الفحوص وحالة الإيداعات

يعرض GitTree حالة CI للإيداعات وطلبات السحب: نجحت الفحوص أو فشلت الفحوص أو الفحوص قيد التشغيل أو تُخطّيت الفحوص أو لا فحوص مُبلَّغ عنها، مع عدد ما نجح وفشل وما يعمل وما تُخطّي. حدّدها لترى التشغيلات، أو افتح سجل فحص، أو إعادة تشغيل الفحص.

تشغيلات CI/CD

يعرض GitTree تشغيلات CI/CD لدى مضيف مستودعك، مثل GitHub Actions، في اللوحة الجانبية وفي قائمة كاملة بجوار المخطط: ما نجح وما فشل ولماذا، مع إعادة تشغيل المهام الفاشلة وإلغاء التشغيل… وتشغيل سير العمل…. وCI/CD جزء من GitTree Pro.

استعراض التشغيلات وتصفيتها

تعرض قائمة CI/CD كل تشغيلات المستودع وتتحدّث من تلقاء نفسها ما دامت التشغيلات جارية. تضيّقها التصفية حسب الفرع وسير العمل والحالة والمحفِّز؛ ويُبقي تشغيلاتي تشغيلاتك؛ ويجعل مراقبة التشغيل يتحدّث في الخلفية ويخبرك حين ينتهي.

قراءة المهام والسجلات

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

إعادة تشغيل خط CI/CD أو إلغاؤه

من التشغيل يكرّر إعادة تشغيل المهام الفاشلة ما فشل فقط، ويكرّر إعادة تشغيل كل المهام كل شيء، وتعيد قائمة المهمة تشغيلها وحدها (إعادة محاولة الطور في أطوار نمط GitLab). يوقف إلغاء التشغيل… التشغيل؛ وينهيه إلغاء التشغيل قسريًا… دون أن تنظّف المهام. ولا يمكن التراجع عن أي إلغاء.

تشغيل سير عمل

يبدأ تشغيل سير العمل… سير عمل يمكن تشغيله يدويًا، مثل سير عمل في GitHub Actions له مُحفِّز workflow_dispatch أو خط أنابيب custom في Bitbucket. ويقرأ GitTree مدخلاته من ملف سير العمل عند الفرع الذي تختاره ويعرض حقلًا لكل منها.

تنزيل النواتج المتاحة

يسرد تبويب النواتج في التشغيل الملفات التي أنتجها، مع الاسم والحجم وموعد ينتهي. يسأل حفظ… عن مكان الحفظ وينزّله هناك كما يخزّنه المزوّد؛ فالملف المضغوط يُحفظ مضغوطًا ولا يفتحه GitTree.

فحص عمليات النشر والبيئات

يعرض التشغيل الذي ينشر يُنشر إلى … وتبويب البيئات: كل بيئة ونشرها وفرعها أو إيداعها ووقته. ويعرض النشر المنتظر بانتظار الموافقة؛ وإن كنت من مراجعيه يعمل عليه الموافقة على النشر… ورفض النشر…. وتغيّر هذه الأشياء للجميع ولا يمكن التراجع عنها.

إنشاء ملفات CI/CD وفحصها

يكتب ملف CI/CD جديد… ملفًا أوليًا حيث يقرؤه مزوّدك، مثل .github/workflows/ أو .gitlab-ci.yml؛ ولا يكتب فوق ملف موجود أبدًا. حرّره في GitTree، واضغط الفحص لدى … ليتحقق المزوّد منه، ثم أودِعه كأي ملف.

إدارة إعدادات CI/CD

تعرض إعدادات CI/CD ما يسمح المزوّد لتطبيق آخر بإدارته: المتغيّرات والأسرار والبيئات والمنفّذات والجداول الزمنية وذاكرات التخزين المؤقت والتعريفات والإصدارات. وتُكتب قيمة السرّ في نافذة نظام آمنة أو تُقرأ من ملف تختاره، وتذهب مباشرة إلى المزوّد؛ ولا يعرضها GitTree ولا يحفظها ولا يرسلها إلى مكان آخر.

استخدام أدوات الإصدار

تسرد إعدادات CI/CD › الإصدارات إصدارات المستودع. يسمّي إصدار جديد وسمًا (أو ينشئه من فرع أو إيداع)، مع العنوان والملاحظات (Markdown) وملفات ينزّلها الناس. ويُنشر الإصدار لكل من يرى المستودع ما لم تختر حفظ كمسودة.

سؤال نور عن فشل خط CI/CD

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

إعداد نور، المساعدة الذكية

نور هي المساعدة الذكية في GitTree. تشغّل واجهة سطر أوامر وكيل البرمجة التي تستخدمها، مثل Claude Code أو Codex أو Gemini CLI، باشتراكك أنت: ولا يرى GitTree مفاتيحك أبدًا. في وضع سؤال تكتفي نور بالاطلاع والإجابة، وفي وضع وكيل تستطيع التصرّف ضمن ما تسمح به. ونور جزء من GitTree Pro.

سؤال نور عن عملك

تعرف نور دائمًا مستودع المحادثة والفرع الحالي. اكتب @ لتشير إلى ملف أو مجلد أو فرع أو إيداع أو طلب سحب، أو أرفق ملفًا، أو أخبر نور بفروع أخرى. وتعرض الشارات فوق مربع الرسالة ما تُخبَر به نور؛ ويحدد منتقي النطاق المستودعات التي تشملها المحادثة.

مراجعة إجراءات نور في التطبيق

في وضع وكيل تستطيع نور التصرّف في GitTree عبر أوامره: فتح العروض، والتجهيز، والإيداع، والجلب، والدفع، وغيرها. ولكل إجراء نوع (الاطّلاع وتغيير يمكن التراجع عنه وخطِر) يتبع اختيارك له؛ وكل خطِر ينتظر نقرتك دائمًا على بطاقة موافقة.

صياغة إيداع أو طلب سحب

يستطيع مربع الإيداع ونافذة طلب السحب صياغة نصّهما بأداة سطر أوامر وكيل برمجة مثبّتة لديك: يقرأ إنشاء رسالة الإيداع باستخدام … تغييراتك المجهّزة، ويقرأ صياغة العنوان والوصف باستخدام … إيداعات فرعك. وتراجع المسودة وتحرّرها؛ ولا يُودَع شيء ولا يُفتح حتى تضغط الزر.

إدارة جلسات نور

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

مراجعة خصوصية نور والاستعادة

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

ضبط الوكلاء والنماذج

تسرد التفضيلات › نور (الذكاء الاصطناعي) › الوكلاء أدوات سطر أوامر الوكلاء التي وجدها GitTree، معلّمة مثبّت أو غير مثبّت. اختر الوكيل للمحادثات الجديدة، والنموذج لكل منها (الفارغ يستخدم النموذج الافتراضي للوكيل)، وترتيب الاختيار التلقائي الذي يتبعه أول وكيل مثبّت. ويتحقق اختبار من أن الوكيل يعمل على هذا الحاسوب.

العثور على التفضيلات وتغييرها

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

المظهر واللغة

يضبط التفضيلات › تخصيص الواجهة السمة (فاتحة وداكنة وبتباين عالٍ)، واتّباع مظهر النظام، واللغة (الإنجليزية أو العربية بتخطيط من اليمين إلى اليسار)، والتكبير، وطريقة عرض التواريخ، وتقليل الحركة.

ضبط سلوك Git والمستودع

تحوي التفضيلات › عام طريقة تشغيل GitTree لـ Git: برنامج Git التنفيذي ونمط السحب وفاصل الجلب التلقائي وخيارات إعادة التأسيس والمسارات الطويلة ونهايات الأسطر. وتتجاوز تفضيلات خاصة بالمستودع بعضها لمستودع واحد، مثل الفرع الأساسي والجلب التلقائي وقالب الإيداع وطريقة رصد تغييرات الملفات.

إدارة هويات Git وملفات التعريف

ملف التعريف اسم وبريد إلكتروني للإيداعات، مع مفتاح توقيع وأمر SSH اختياريين، يمكنك التبديل بينها. افتراضيًا يُمرَّر مع كل أمر git يشغّله GitTree، فلا يتغيّر ~/.gitconfig أبدًا ويبقى اسم المستودع أو بريده الخاص هو الغالب؛ ويجعل يُكتب في ~/.gitconfig كل أدوات git تستخدمه.

ضبط SSH في GitTree

تسرد التفضيلات › SSH المفاتيح في مجلد .ssh لديك، وتنشئ مفاتيح جديدة، وتعرض كل مضيف من إعدادات SSH، وتختبر الاتصال. لا يبدأ GitTree وكيل SSH أبدًا ولا يحرّر ~/.ssh/config ولا core.sshCommand؛ والمفتاح الذي تختاره للمستودعات البعيدة عبر SSH يُمرَّر إلى أوامر git التي يشغّلها.

ضبط توقيع الإيداعات والوسوم

تختار التفضيلات › توقيع الإيداعات التنسيق (OpenPGP أو مفتاح SSH أو X.509) والمفتاح، وهل توقيع كل إيداع وتوقيع كل وسم مشروح. ولا يُكتب شيء حتى تضغط التطبيق على إعدادات git العامة. ثم يعرض المخطط وتفاصيل الإيداع حالة توقيع كل إيداع.

ضبط الأدوات وترميز الملفات

تُقرأ الفروق والملفات غير المرمّزة بـ UTF-8 بـ التفضيلات › المحرّر › الترميز الافتراضي؛ وعلامة ترتيب البايتات لها الأولوية دائمًا، والبايتات التي لا تناسبه تظهر بالشكل �. ويحدد نهايات الأسطر ‏(core.autocrlf) كيف يحوّل git بين CRLF وLF، ويسمح المسارات الطويلة لـ git بإنشاء مسارات تتجاوز 260 حرفًا على Windows.

ضبط الإشعارات والسجل

تحدد التفضيلات › الإشعارات موضع ظهور الإشعارات، وهل إظهار إشعارات النجاح، وإشعارات سطح المكتب من نظامك. ويكتب السجلّ الموسّع في عام تفاصيل أكثر في السجل المحلي، من التشغيل التالي، للمساعدة في تشخيص مشكلة؛ ولا يُرسل شيء إلى أي مكان.

ضبط صلاحيات نور

يحدّ إعدادان من نور. يحدد ما يُسمح لنور بفعله في المستودع ما يفعله الوكيل نفسه هناك: قراءة فقط أو تعديل الملفات دون أوامر أو كل شيء، كما في الطرفية. ويحدد ما يُسمح لنور بفعله في GitTree لكل نوع ومجال من إجراءات التطبيق: أبدًا أو اسألني أولًا أو من تلقاء نفسها؛ والتغييرات الخطِرة تسأل دائمًا.

ضبط تحديث التكاملات

تتحكم التفضيلات › التكاملات في طريقة قراءة GitTree لحسابات الاستضافة: كم يمكن أن يتقادم ما يُعرض قبل تحديث طلبات السحب والمشكلات والفحوصات، وهل التحديث عند العودة، وإعدادات سجلات CI/CD الافتراضية، ومصدر صور المؤلفين. ولا تجري القراءة إلا ما دامت نافذة GitTree في الواجهة.

النسخ الاحتياطي للإعدادات واستيرادها وإعادة تعيينها

تصدّر التفضيلات › عام › النسخ الاحتياطي والاستعادة وإعادة التعيين إعدادات التطبيق وملفات التعريف وإعدادات git إلى ملف، وتستورد مثل هذا الملف، أو تعيد تعيين كل شيء. ولا يتضمّن التصدير أبدًا كلمات المرور أو رموز الوصول أو بيانات الحسابات، ولا إعدادات أي مستودع. ولا تُكتب إعدادات git من الاستيراد في ~/.gitconfig إلا بعد أن تراجعها.

البحث عن التحديثات وتثبيتها

لا يجد GitTree برنامج Git

يستخدم GitTree تثبيت Git الخاص بك ولا يضمّنه ولا يثبّته أبدًا. وإن لم يجده يعرض يحتاج GitTree إلى Git؛ وإن كان ما وجده أقدم من 2.39 يعرض إصدار Git هذا قديم جدًا. ثبّت Git أو حدّثه، أو اضغط تحديد موقع Git… لاختياره، ثم التحقق مجددًا.

مستودع لا يُفتح

حين يتعذّر فتح مجلد يذكر GitTree السبب ويعرض الخطوة التالية: هذا المجلد ليس مستودع Git (هيّئ واحدًا أو اختر غيره)، أو لا يمكن فتح هذا كمستودع (مسار مفقود)، أو لا يستطيع GitTree قراءة هذا المجلد (الأذونات)، أو هذا المستودع مملوك لمستخدم آخر (فحص الملكية في Git).

التغييرات لا تتحدّث

يرصد GitTree التعديلات التي تتم في برامج أخرى عبر إشعارات التغيير في نظامك. وعلى مجلدات WSL والمشاركات الشبكية لا تصل تلك الإشعارات، فيفحص تلقائي المجلد كل بضع ثوانٍ بدلًا منها. وإن ظلت التغييرات تتأخر فافرض وضع الفحص لذلك المستودع أو حدّث يدويًا.

فشلت محاولة المصادقة مع مستودع بعيد

يسجّل Git الدخول إلى المستودع البعيد بمساعد بيانات الاعتماد أو مفتاح SSH الخاص بك أولًا. تعني يطلب … منك تسجيل الدخول. أن لا شيء أجاب؛ وتعني رفض … بيانات الاعتماد المرسلة لهذا المستودع. أن ما أُرسل لم يعد صالحًا أو غير مسموح. أصلح بيانات الاعتماد التي يستخدمها Git؛ ولا يتدخّل الحساب المرتبط إلا حين لا يكون لدى مساعداتك شيء، أو حين تختاره لمستودع.

رُفض الدفع

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

عملية Git تحتاج إلى انتباهك

حين يتوقف دمج أو إعادة تأسيس أو انتقاء أو عكس أو بحث ثنائي في منتصفه، يعرض GitTree شريطًا مثل جارٍ إعادة تأسيس … على …، الخطوة 3 من 7 ويعلّم التبويب إعادة تأسيس قيد التنفيذ. وتنتظر معظم الأوامر حتى ينتهي: حُلّ أي تعارضات، ثم متابعة أو تخطّي الخطوة أو إيقاف… للعودة إلى حيث بدأت.

إجراء تكامل غير متاح

حين يتعذّر استخدام إجراء استضافة يذكر GitTree السبب بدل الفشل بصمت. والأسباب المعتادة: أنه جزء من GitTree Pro؛ أو لا يوجد حساب مرتبط لمضيف المستودع البعيد؛ أو الرمز يحتاج إلى إعادة ربط؛ أو دورك لدى المزوّد لا يسمح به؛ أو المزوّد لا يقدّمه؛ أو المزوّد يحدّ من الطلبات لبعض الوقت.

نور لا تبدأ أو لا تكمل

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

تعذّر تحميل خط CI/CD أو سجله

يذكر GitTree سبب غياب تشغيل أو سجل: مضيف هذا المستودع لا يعرض تشغيلات …. أو انتهت صلاحية هذا السجل على … أو لا يحق لهذا الحساب قراءة السجلات هنا. أو لا يتيح … سجلًا من خارج صفحته. أو أن المزوّد يحدّ من الطلبات. ولمعظمها حل واحد؛ وبعضها لا يفتح إلا صفحة المزوّد.

فشل طلب لسلسلة المفاتيح أو SSH

يحفظ GitTree رموز الحسابات وتسجيل دخوله وعبارات مرور SSH المتذكَّرة في سلسلة مفاتيح نظامك فقط: سلسلة مفاتيح macOS، أو مدير بيانات الاعتماد في Windows، أو خدمة Secret Service ‏(GNOME Keyring أو KeePassXC) على Linux. وحين ترفض سلسلة المفاتيح يطلب منك GitTree السماح بالوصول وإعادة المحاولة؛ ولا يلجأ إلى ملف أبدًا.

استخدام GitTree دون اتصال

GitTree محلي أولًا: كل ميزات Git المحلية تعمل دون اتصال، ومنها الإيداعات والفروع والدمج وإعادة التأسيس والمخابئ والسجل والتراجع. أما الجلب والسحب والدفع وتكاملات الاستضافة وCI/CD ومزوّد نور فتحتاج إلى الشبكة؛ ودون اتصال يعرض GitTree آخر بيانات قرأها ويذكر ذلك.

جمع تقرير دعم ومشاركته

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