سجل النسخ في مُبَرمِج — الحفظ والاسترجاع

أين تجد القسم

من الشريط الجانبي لمساحة عمل المشروع، ضمن مجموعة «متقدّم»، اضغط «النسخ». تفتح صفحة عنوانها «سجل النسخ» فيها لوحتان: «احفظ نسخة الآن» و«النسخ المحفوظة». القسم متاح في كل الباقات بلا قفل.

المتعاون الذي قَبِل دعوة المشروع يرى القائمة بأي دور. أما الحفظ والاسترجاع فيحتاجان دور «محرر» أو «مدير»، ويُرفض «مشاهد» برسالة «صلاحيتك في هذا المشروع للمشاهدة فقط».

حفظ نسخة يدوياً

1. في لوحة «احفظ نسخة الآن» اكتب وصفاً في حقل «وصف النسخة (اختياري)»، مثل «قبل تغيير الصفحة الرئيسية».
2. اضغط «احفظ نسخة».
3. تظهر رسالة «حُفظت النسخة»، وتُضاف النسخة في أعلى «النسخ المحفوظة» ويُفرَّغ حقل الوصف.

تحفظ النسخة ملفات المشروع كما هي محفوظة على الخادم لحظة الضغط، لا ما تكتبه في نافذة محرّر لم تحفظه بعد. النسخة بلا وصف تظهر باسم «نسخة بلا وصف». وللحفظ حد: عشرون نسخة في الدقيقة للمستخدم الواحد، وبعدها يرد الخادم «كثرة الطلبات».

تستطيع أيضاً عرض النسخ وحفظ نسخة لمشاريعك بمفتاح API عبر /api/v1/projects/<id>/versions: القراءة بنطاق projects:read والحفظ بنطاق projects:write، بالمنطق والحد نفسيهما. الاسترجاع غير متاح بالمفتاح، فهو من هذه الصفحة فقط. التفاصيل في واجهة API.

النسخ التي تُنشأ تلقائياً

قبل كل عملية تستبدل ملفاتك، يحفظ مُبَرمِج الحالة السابقة بوصف ثابت تعرفه به في القائمة:

• «تلقائي: قبل الاستعادة» — عند كل استرجاع من هذه الصفحة.
• «قبل تعديل مرئي» — عند حفظ تعديلات من المحرر المرئي، و«قبل مزامنة تعديل مرئي إلى Next.js» حين يكون المشروع Next.js.
• «قبل التحويل إلى …» و«قبل إنشاء نسخة المحرر المرئي» — قبل تحويل إطار المشروع.
• «قبل استنساخ الموقع» — قبل استنساخ موقع من رابط.
• نسخة باسم «عنوان الخطة — عنوان المرحلة» بعد اكتمال كل مرحلة في البناء بالذكاء الاصطناعي.

النسخ التي تأتي من الذكاء الاصطناعي (البناء بالمراحل واستنساخ موقع) لا تظهر إلا في الباقات المدفوعة، لأن الذكاء الاصطناعي متاح فيها فقط؛ وخطة «المجانية» ترد عليه بالرمز 402 (AI_PAID_ONLY).

أما النشر فلا يُنشئ نسخة في هذا السجل.

قراءة قائمة النسخ

كل صف يعرض: رقماً مثل v12 (الأحدث يحمل أكبر رقم)، ثم الوصف، ثم التاريخ والوقت، وعدد الملفات، والحجم. الحجم محسوب من طول محتوى الملفات، فهو تقريبي. وحين لا توجد نسخ ترى «لا توجد نسخ».

عنوان اللوحة يقول «يُحتفَظ بآخر ٥٠ نسخة؛ الأقدم تُحذف تلقائيًا»، وهذا الحد يشمل النسخ التلقائية أيضاً. فجلسة طويلة في المحرر المرئي قد تُخرج نسخاً يدوية قديمة من القائمة. ولأن الترقيم محسوب من القائمة الحالية، يتغيّر رقم النسخة حين تُحذف نسخ أقدم منها.

استرجاع نسخة

1. اضغط «استرجاع» بجانب النسخة. لا تظهر نافذة تأكيد، فالعملية تبدأ فوراً.
2. تقرأ الصفحة ملفات المشروع الحالية لتتأكد أنها ما زالت كما تراها.
3. يستبدل الخادم الملفات بملفات النسخة، ويحفظ حالتك السابقة كنسخة «تلقائي: قبل الاستعادة» في الخطوة نفسها.
4. تظهر رسالة «استُرجعت النسخة — حالتك السابقة حُفظت كنسخة جديدة».

لذلك الاسترجاع قابل للتراجع: استرجع النسخة «تلقائي: قبل الاستعادة» لتعود إلى ما كنت عليه.

حين يفشل الاسترجاع

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

النسخ والموقع المنشور

عنوان موقعك العام لا يعرض ملفات المحرر، بل لقطة الملفات التي حُفظت عند آخر نشر ناجح. لذلك:

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

أسئلة شائعة

هل يحذف الاسترجاع النسخ الأحدث؟

لا. تبقى كل النسخ في القائمة، وتُضاف نسخة «تلقائي: قبل الاستعادة». الحذف الوحيد هو حذف الأقدم بعد تجاوز الخمسين.

هل يختلف حد النسخ بين الباقات؟

لا. الحد ٥٠ نسخة لكل مشروع في كل الباقات.

هل أستطيع معاينة محتوى نسخة قبل استرجاعها؟

صفحة «سجل النسخ» لا تعرض محتوى النسخة، بل وصفها وتاريخها وعدد ملفاتها وحجمها فقط. أما عبر API فطلب القائمة مع ?versionId= يعيد نسخة واحدة بملفاتها دون استرجاعها.