التعافي من أخطاء بعد الدفع

• أن تختار بين إصلاح بالإضافة وإعادة كتابة لخطأ مدفوع.
• أن تشرح ما يفحصه القفل ولماذا يهم الإيداع المتوقَّع.
• أن تتوقع رفض قفل قديم وتحافظ على عمل زميل.
• أن تعرف ما يحفظه GitTree قبل الدفع القسري.

حالتان على خادم تجريبي محلي. على shared دُفع إيداع سيئ وقد يملكه آخرون. وعلى lease دفعت مسودة ثم أعدت كتابتها محليًا، لكن ليو دفع إيداعًا أحدث إلى الفرع نفسه في هذه الأثناء.

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

نفّذ التغييرات في GitTree أو بأوامر Git الأصلية، لا بالطريقتين في النسخة نفسها. القراءة بعد التنفيذ آمنة دائمًا. تسميات القوائم مأخوذة من نصوص GitTree 2.0 نفسها، وشُغّلت الأوامر الأصلية بـ Git 2.43 في نسخ مؤقتة. لم تُشغَّل خطوات GitTree على macOS أو Windows أو Linux.

إن كان زملاؤك يملكون الإيداع السيئ فأصلحه بإيداع جديد (عكس، الدرس 28) وادفع دفعًا عاديًا: يبقى الخطأ في التاريخ ولا تُبطَل نسخة أحد. ولا تعد كتابة فرع منشور إلا إن كنت تملكه.

يجعل القفل الدفع القسري مشروطًا: لا يستبدل Git الفرع البعيد إلا إن كان ما زال حيث تتوقع. ويسمّي --force-with-lease=<ref>:<commit> الإيداع المتوقَّع. أما --force-with-lease المجرد فيستخدم مرجعك المتتبِّع للبعيد، وgit fetch يحرّك ذلك المرجع، فالجلب ثم الدفع قد يكتب فوق ما نزّلته للتو. ويثبّت GitTree الإيداع المجلوب أخيرًا ويعرضه في حواره ويحتفظ بالرأس المستبدَل تحت refs/ogt/trash.

ولا يقرر القفل هل يحق لك الكتابة فوق عمل زميل. هو يحميك فقط من الكتابة فوق شيء لم تره.

ابدأ من نسخة عادية منفصلة من ناتج الدرس 18 ومستودع محلي مجرّد جديد خادمًا وحيدًا. RECOVERY_BAD هي ورقة الأنماط السيئة؛ وLEASE_A وLEASE_B وLEASE_REWRITE ثلاث نسخ من ملاحظة.

احفظ كل ملف أدناه كما هو بالضبط: ترميز UTF-8 ونهايات أسطر LF وسطر نهائي واحد، دون أسطر أسوار Markdown. والملفات غير المدرجة تبقى بمحتواها في M.

styles.css — RECOVERY_BAD

:root {
  color-scheme: light;
  --page: #f7f8fa;
  --surface: #ffffff;
  --text: #f7f8fa;
  --link: #154ab5;
  --line: #bac4d0;
}

* {
  box-sizing: border-box;
}

body {
  margin: 0;
  background: var(--page);
  color: var(--text);
  font: 1rem/1.6 system-ui, sans-serif;
}

a {
  color: var(--link);
}

.site-header,
main,
footer {
  width: min(68rem, 100% - 2rem);
  margin-inline: auto;
}

.site-header {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
  gap: 1rem;
  padding-block: 1rem;
}

.hero {
  max-width: 48rem;
  padding-block: 3rem;
}

h1 {
  font-size: clamp(2rem, 5vw, 3.5rem);
  line-height: 1.2;
}

.cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(16rem, 100%), 1fr));
  gap: 1rem;
}

.feature-card {
  padding: 1rem;
  border: 1px solid var(--line);
  border-radius: 0.75rem;
  background: var(--surface);
}

section {
  margin-block-end: 2rem;
}

button,
input {
  font: inherit;
}

button,
input {
  padding: 0.5rem 0.75rem;
}

:focus-visible {
  outline: 3px solid var(--link);
  outline-offset: 3px;
}

form {
  display: grid;
  max-width: 28rem;
  gap: 0.5rem;
}

docs/lease-note.md — LEASE_A

# Private release rehearsal

The reviewed draft is still private.

docs/lease-note.md — LEASE_B

# Private release rehearsal

Leo added a review that must not be overwritten.

docs/lease-note.md — LEASE_REWRITE

# Private release rehearsal

This alternative draft has not seen Leo's review.

افتح لوحة الأوامر بـ Command+Shift+P (وCtrl+Shift+P على Ubuntu).

1. ابنِ البروفة كما يبيّن القسم التالي: الإيداع السيئ مدفوعًا إلى shared، وفرع lease وعليه إيداع ليو الأحدث في الخادم.
2. إصلاح بالإضافة. على shared انقر الإيداع السيئ بزر الفأرة الأيمن واختر عكس الإيداع (Revert Commit) ثم اضغط دفع (Push). هذا دفع عادي؛ لا تختر دفع قسري آمن (with-lease)….
3. قفل قديم. على private/lease أعد كتابة المسودة محليًا ليخلو الفرع من الإيداع المدفوع وحاول دفعه بزر الدفع في الشريط. يسأل GitTree أولًا أين يدفع، لأن private/lease يتتبع origin/lease باسم مختلف: اختر الدفع إلى origin/lease. ثم يعرض حوار عنوانه «رفض المستودع البعيد private/lease» الخيارات جلب فقط وإعادة تأسيس ثم دفع ودمج ثم دفع ودفع قسري….
4. اختر جلب فقط أولًا واقرأ المخطط: في الفرع البعيد الآن إيداع ليو، وليس في إعادة كتابتك. هذا عمل زميل.
5. افتح دفع قسري…. يقول حوار «دفع private/lease قسريًا إلى origin/lease؟» إن الإيداعات التي ينقصها فرعك ستُزال من المستودع البعيد، وإن الدفع لا يمضي إلا ما دام البعيد عند الإيداع المعروض، وإن الرأس المستبدَل يُحفظ تحت refs/ogt/trash. اختر الإلغاء؛ فعمل ليو ليس لك لتستبدله.
6. أو وفِّق بدل ذلك: إعادة تأسيس ثم دفع يضع مسودتك فوق مسودة ليو، أو اسأله أولًا. وإن نُفّذ دفع قسري فعلًا فيقول الإشعار «اكتمل الدفع القسري. الرأس البعيد المستبدَل محفوظ في …» ويعدّ تراجع الدفع القسري تغييرًا لمستودع بعيد تدفع مجددًا لإرجاعه.

بعد العكس، على shared:

git revert --no-edit "$BAD_SHA"
git push origin HEAD:shared
git merge-base --is-ancestor "$BAD_SHA" HEAD; echo $?

الجواب 0: يبقى الخطأ في التاريخ ولم يُجبَر أحد على إصلاح نسخة.

على private/lease وإيداع ليو في الخادم، جرّب القفل المثبَّت بالإيداع الذي راجعته:

git push --force-with-lease=refs/heads/lease:"$EXPECTED_SHA" origin HEAD:lease; echo $?
git ls-remote origin refs/heads/lease
git status --short

 ! [rejected]        HEAD -> lease (stale info)
error: failed to push some refs to '../origin.git'
1

يرفض Git («stale info») وما زال الخادم يسمّي إيداع ليو والحالة خالية. والأمر git push --force-with-lease origin HEAD:lease المجرد يُرفض أيضًا ما دام مرجعك المتتبِّع قديمًا، لكن بعد git fetch origin lease يستبدل الأمر نفسه إيداع ليو، لأن الجلب حرّك المرجع الذي يقارن به. سمِّ الإيداع الذي راجعته، أو وفِّق بإعادة تأسيس.

أين تنتهي: الإيداع السيئ ما زال في تاريخ shared وفوقه عكس دُفع دفعًا عاديًا. وعلى lease رُفض الدفع المثبَّت، وما زال الخادم يحمل إيداع ليو، وإعادة كتابتك سليمة محليًا. ولم يُنفَّذ أي دفع قسري.

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

إن استبدل دفع قسري الرأس الخطأ فالإيداع المستبدَل محفوظ تحت refs/ogt/trash (وفي الدفع الأصلي في سجل المراجع ونسخة الزميل). أخبر الزميل واستعد الرأس فرعًا وادفعه من جديد باتفاقكما. والدفع المرفوض لم يغيّر شيئًا.

أجب عن كل سؤال ثم اقرأ السبب. الأسئلة المعلَّمة «مطلوب» تُحتسب لإكمال الدرس.

1. السؤال 1 من 6

   السؤال 1 من 6

   إيداع سيئ على الفرع المشترك بالفعل. ما أأمن إصلاح؟

   اختر إجابة واحدة.

   أعد تعيين الفرع وادفع قسرًا

   احذف الفرع البعيد

   أضف إيداع عكس وادفع دفعًا عاديًا

   انتظر حتى يلاحظ أحد

   تحقّق من الإجابة
2. السؤال 2 من 6

   السؤال 2 من 6

   أي مما يلي صحيح عن --force-with-lease؟

   اختر كل إجابة صحيحة.

   يطلب إذن الزميل

   يستبدل الفرع البعيد فقط إن كان ما زال حيث تتوقع

   القفل المجرد يثق بمرجعك المتتبِّع الذي يحرّكه الجلب

   يسمّي <ref>:<commit> الإيداع المتوقَّع

   تحقّق من الإجابة
3. السؤال 3 من 6

   السؤال 3 من 6مطلوب

   تدفع بقفل مثبَّت على الإيداع الذي راجعته، لكن ليو دفع بعد ذلك. ماذا يحدث؟

   اختر إجابة واحدة.

   يرفضه Git بوصفه معلومات قديمة ويحتفظ الخادم بإيداع ليو

   يكتب Git فوق إيداع ليو

   يدمج Git الإيداعين

   يحذف Git الفرع

   تحقّق من الإجابة
4. السؤال 4 من 6

   السؤال 4 من 6

   غيّر المُدخل: تنفّذ git fetch origin lease ثم git push --force-with-lease origin HEAD:lease المجرد. ماذا يحدث؟

   اختر إجابة واحدة.

   يدمج Git إيداع ليو أولًا

   يُرفض الدفع مرة أخرى

   ينجح الدفع ويستبدل إيداع ليو لأن الجلب حرّك المرجع الذي يقارن به القفل

   يسأل Git ليو

   تحقّق من الإجابة
5. السؤال 5 من 6

   السؤال 5 من 6مطلوب

   يقول زميل «القفل يجعل الدفع القسري آمنًا للجميع». ما الرد الصحيح؟

   اختر إجابة واحدة.

   خطأ، القفل لا يُرفض أبدًا

   صحيح، القفل يغني عن الحديث مع أحد

   صحيح، التراجع يعكس أي دفع قسري

   يحميك فقط من الكتابة فوق إيداعات لم تَرها؛ اتفق مع المالك أولًا وثبّت الإيداع الذي راجعته

   تحقّق من الإجابة
6. السؤال 6 من 6

   السؤال 6 من 6مطلوب

   بعد الدفع المثبَّت، أي قراءات تبيّن أن شيئًا لم يضع؟

   اختر كل إجابة صحيحة.

   طبع الدفع (stale info) وانتهى برمز 1

   حالة git status --short خالية

   ما زال git ls-remote origin refs/heads/lease يعرض إيداع ليو

   يعرض ls-remote إيداعك المعاد كتابته

   تحقّق من الإجابة

اذكر فحص السلف على shared، ورمز الخروج ورسالة الدفع المثبَّت، والإيداع الذي يعرضه ls-remote للفرع lease، وهل كان القفل المجرد سيُرفض قبل الجلب وبعده.

• فضّل إيداعًا جديدًا لكل ما قد يملكه الآخرون.
• ثبّت القفل على الإيداع الذي راجعته.
• القفل يحميك لا نية زميلك.

• ادفع الإيداعات وانشر فرعًا (الدرس 13)
• عكس تغيير في تاريخ مشترك (الدرس 28)
• العثور على إيداع ضائع بسجل المراجع (reflog) (الدرس 29)
• تنزيل GitTree

Lease — قفل; stale info — معلومات قديمة; replaced tip — الرأس المستبدَل.