العثور على إيداع ضائع بسجل المراجع (reflog)

• أن تقرأ سجل المراجع بوصفه سجل هذا المستودع لأماكن HEAD والفروع.
• أن تفحص محتوى إيداع مرشَّح قبل استعادته.
• أن تنشئ فرعًا عند الإيداع الذي قِسته دون التبديل إليه.
• أن تقول ما لا يعيده سجل المراجع: العمل غير المودَع والقيود المنتهية.

أنت على private/lost-signup، وهو فرع من ناتج الدرس 18 (M). أودعت ملاحظة، «docs: keep the signup recovery note»، أضافت docs/signup-recovery.md، ثم نفّذت إعادة تعيين كاملة إيداعًا واحدًا إلى الخلف. اختفت الملاحظة من الفرع ومن المخطط ومن ملفاتك. ليس لديك فرع حفظ بعد، ولم تغيّر شيئًا آخر.

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

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

سجل المراجع (reflog) مفكرة محلية لحركة المراجع. للـ HEAD سجل، ولكل فرع سجله. يسجّل «commit» و«checkout» و«reset» ونحوها مع الإيداع الذي انتهى إليه كل منها. لا يملك مستودع آخر مفكرتك. وقد يظل إيداع لا يسمّيه أي فرع موجودًا، وسجل المراجع هو طريقك إليه.

تعدّ المحدِّدات مثل HEAD@{1} القيود إلى الخلف من الآن، فتتغير مع كل عملية لاحقة. اقرأ الفعل والوقت والمعرّف والملف لأي مرشَّح قبل أن تستخدمه. ولا تحفظ رقمًا كوصفة.

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

إنشاء فرع عند الإيداع يضيف مرجعًا واحدًا لا غير. يبقى الفرع الحالي والفهرس وملفاتك حيث هي.

ابدأ من نسخة عادية منفصلة من ناتج الدرس 18 (M) وأبقِ أصلك دون مساس. أنشئ الفرع واحفظ DOC_LOST وأودِعه ثم نفّذ إعادة تعيين كاملة إيداعًا واحدًا إلى الخلف. هذا الإعداد المدمّر لنسخة مؤقتة فقط.

احفظ في المرحلة المحددة فقط بصيغة UTF-8 وLF وسطر نهائي. لا تلصق أسوار Markdown. ترث الملفات الثابتة نقطة البداية؛ لا تستبدل الأصل بنسخة إعادة منفصلة.

docs/signup-recovery.md — DOC_LOST

# Recovered signup work

Keep a branch name before leaving useful experimental work.

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

1. ابنِ البروفة كما يبيّن القسم التالي ودوّن عنوان الإيداع الضائع.
2. افتح لوحة الأوامر ونفّذ عرض سجل المراجع (reflog)… (View Reflog…). يفتح حوار «سجل المراجع (reflog)» وسجل المراجع لـ (Reflog of) على HEAD؛ والقيود الأحدث أولًا.
3. اقرأ القيود العليا. الأحدث يقول «reset» والذي تحته يقول «commit» بالعنوان «docs: keep the signup recovery note». استخدم عرض القيود الأقدم (Show Older Entries) إن طالت القائمة. ولا تفترض أن الصف الثاني هو الصحيح دائمًا.
4. حدّد قيد الإيداع. يعرض الحوار إظهار في المخطط (Show in Graph) واسم الفرع الجديد (New branch name). يستطيع إظهار في المخطط وضع إيداع يصل إليه فرع فقط، لذا يغلق الحوار لهذا الإيداع الضائع ويبقى المخطط على M: أعد فتح سجل المراجع للخطوة التالية. تقرأ ملف الإيداع بعد استعادته.
5. عد إلى الحوار وحدّد القيد نفسه، واكتب rescue/signup في اسم الفرع الجديد واختر استعادة كفرع (Restore as Branch). يقول الإشعار «تم إنشاء الفرع rescue/signup. يزيله التراجع مجددًا.»
6. افحص النتيجة: rescue/signup يشير إلى الإيداع الضائع، والفرع الحالي ما زال private/lost-signup على M، وملفاتك لم تتغير. حدّد الإيداع المستعاد وافتح ملفه docs/signup-recovery.md: هو DOC_LOST.
7. أبقِ فرع الحفظ مكانه. ولا تشغّل أي تنظيف لترتيب المخطط.

لكل إيداع عادي في الدورة: الملخّص (Summary) هو العنوان المحدد، والوصف (Description) خالٍ، وتبقى الخيارات تعديل الإيداع الأخير وتخطّي الخطّافات وإضافة Signed-off-by ومؤلف مختلف والدفع بعد الإيداع والسماح بإيداع فارغ معطّلة.

في نسخة منفصلة ونظيفة فقط من ناتج الدرس 18:

git switch --create private/lost-signup

احفظ DOC_LOST باسم docs/signup-recovery.md ثم:

git add -- docs/signup-recovery.md
git commit --quiet -m "docs: keep the signup recovery note"
git reset --hard HEAD~1
git reflog show --format=%gs -2 HEAD

reset: moving to HEAD~1
commit: docs: keep the signup recovery note

اسرد المرشَّحين مع معرّفاتهم وافحص الذي تظنه الضائع:

git reflog show --format='%H %gs' HEAD
git show "<lost-sha>:docs/signup-recovery.md"

استبدل <lost-sha> بالمعرّف في السطر «commit: docs: keep the signup recovery note». في هذا المثال الفوري يكون HEAD@{1} هو الإيداع نفسه، لكن ذلك الرقم ليس قاعدة. أنشئ فرع الحفظ دون التبديل إليه:

git branch rescue/signup "<lost-sha>"
git show rescue/signup:docs/signup-recovery.md
git symbolic-ref --short HEAD
git status --short

الملف هو DOC_LOST، والفرع المطبوع هو private/lost-signup، والحالة خالية. لا تُظهر ملفاتك الملاحظة لأن HEAD بقي على M. ولا أمر إنهاء أو تنظيف ضمن هذا الدرس.

أين تنتهي: rescue/signup يشير إلى الإيداع الضائع وملفه هو DOC_LOST. الفرع الحالي والفهرس وملفاتك كما كانت بعد إعادة التعيين تمامًا، ولم يُدفع شيء.

• استخدام HEAD@{1} وصفةً ثابتة بدل قراءة القيد.
• إعادة التعيين أو التبديل مرة أخرى قبل حفظ فرع، فتُضاف قيود أكثر وتُدفن التي تريدها.
• توقع أن يحمل سجل المراجع تعديلًا لم يُودَع قط.
• تشغيل أوامر تنظيف أثناء البحث.

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

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

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

   السؤال 1 من 6

   ما هو سجل المراجع؟

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

   سجل مشترك تُبقيه كل نسخة والخادم متزامنًا

   نسخة احتياطية من ملفاتك

   سجل محلي لأماكن إشارة HEAD وكل فرع

   هو نفسه مخطط الإيداعات

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

   السؤال 2 من 6

   أي مما يلي صحيح عن سجل المراجع؟

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

   يخزّن تعديلات لم تودعها قط

   للـ HEAD ولكل فرع سجله

   تنتهي القيود القديمة

   لا تملك نسخة أخرى من المشروع قيودك

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

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

   وجدت الإيداع الضائع في سجل المراجع واستخدمت استعادة كفرع باسم rescue/signup. ماذا ترى؟

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

   يشير rescue/signup إلى الإيداع الضائع، وما زلت على private/lost-signup عند M وملفاتك لم تتغير

   أنت الآن على rescue/signup والملاحظة عادت إلى ملفاتك

   يتقدم private/lost-signup إلى الإيداع الضائع

   يُحذف قيد سجل المراجع

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

   السؤال 4 من 6

   غيّر المُدخل: لم تودع الملاحظة قط ثم نفّذت الإعادة الكاملة. هل يعيدها سجل المراجع؟

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

   نعم، عبر عرض القيود الأقدم

   نعم، بـ HEAD@{1}

   لا. يشير سجل المراجع إلى إيداعات، وهذا المحتوى لم يكن في أي منها

   نعم، بتبديل سجل المراجع لـ إلى الفرع

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

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

   نفّذت عمليات أخرى ثم شغّلت git branch rescue HEAD@{1}، والملف ليس الذي تريده. ماذا حدث؟

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

   HEAD@{1} هو دائمًا الإيداع الصحيح بعد إعادة تعيين

   سجل المراجع تالف

   حُذف الإيداع الضائع بسبب الفرع الجديد

   يعدّ HEAD@{1} إلى الخلف من الآن، فيغيّر كل عملية جديدة ما يسمّيه. اقرأ القائمة واستخدم معرّف الإيداع الضائع

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

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

   بعد إنشاء فرع الحفظ، أي قراءات تبيّن أنه عمل كما يقول الدرس؟

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

   أصبح docs/signup-recovery.md موجودًا في ملفاتك

   يطبع git show rescue/signup:docs/signup-recovery.md الملاحظة المستعادة، وتبدأ بـ «# Recovered signup work»

   لا يطبع git status --short شيئًا

   يطبع git symbolic-ref --short HEAD الاسم private/lost-signup

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

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

• سجل المراجع مفكرة محلية لحركة المراجع.
• افحص المرشَّح ثم أنشئ منه فرعًا.
• يجد الإيداعات لا التعديلات غير المحفوظة.

• إعادة التعيين: ناعمة ومختلطة وكاملة (الدرس 27)
• اقرأ التاريخ دون تحريك HEAD (الدرس 8)
• تنزيل GitTree

Reflog — سجل المراجع; rescue branch — فرع حفظ; selector — محدِّد.