نقاط الحفظ و `/rollback` — شبكة الأمان لمشروعك

هل سبق أن شاهدت وكيل ذكاء اصطناعي يُجري تعديلًا وفكّرت: “مهلاً، لم أقصد فعل ذلك”؟ كلنا مررنا بهذا الموقف. لهذا السبب، أصبح وكيل Hermes يتضمن الآن شبكة أمان مدمجة: نقاط الحفظ (Checkpoints). اعتبرها نقاط حفظ في لعبة فيديو — لقطات سريعة لمشروعك تُلتقط قبل العمليات الخطرة، جاهزة للاستعادة بأمر واحد.

ما هي نقاط الحفظ؟

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

أفضل جزء؟ تاريخ .git الحقيقي لمشروعك لا يُمس أبدًا. يستخدم Hermes مخزنًا ظلًا مشتركًا في ~/.hermes/checkpoints/store/ — وهو مستودع git منفصل يحافظ على تنظيم كل شيء ويزيل التكرار عبر المشاريع.

البدء: تفعيل نقاط الحفظ

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

فعّلها لجلسة واحدة:

hermes chat --checkpoints

أو فعّلها عالميًا في ~/.hermes/config.yaml:

checkpoints:
  enabled: true

متى يلتقط Hermes نقطة حفظ؟

يلتقط Hermes لقطات سريعة تلقائيًا قبل:

أدوات الملفات — write_file و patch
الأوامر الطرفية التدميرية — rm، rmdir، cp، install، mv، sed -i، truncate، dd، shred، إعادة توجيه الإخراج (>) و git reset/clean/checkout

لا تقلق بشأن الازعاج — الوكيل ينشئ نقطة حفظ واحدة على الأكثر لكل مجلد في كل جولة، لذا تبقى الجلسات الطويلة نظيفة.

استخدام `/rollback` داخل الجلسة

بمجرد تفعيل نقاط الحفظ، تحصل على أوامر slash قوية مباشرة في محادثتك:

الأمر	الوظيفة
`/rollback`	عرض جميع نقاط الحفظ مع إحصائيات التغييرات
`/rollback <N>`	الاستعادة إلى نقطة الحفظ N، مع الاحتفاظ بتعديلاتك اليدوية
`/rollback <N> --all`	استعادة كاملة — تستبدل تعديلاتك اليدوية أيضًا
`/rollback diff <N>`	معاينة التغييرات بين نقطة الحفظ N والآن
`/rollback <N> <file>`	استعادة ملف واحد من نقطة الحفظ N

هذا ما يبدو عليه عرض نقاط الحفظ:

📸 نقاط الحفظ لـ /path/to/project:

  1. 4270a8c  2026-03-16 04:36  قبل patch  (ملف واحد، +1/-0)
  2. eaf4c1f  2026-03-16 04:35  قبل write_file
  3. b3f9d2e  2026-03-16 04:34  قبل terminal: sed -i s/old/new/ config.py  (ملف واحد، +1/-1)

  /rollback <N>             استعادة إلى نقطة الحفظ N (يحتفظ بتعديلاتك اليدوية)
  /rollback <N> --all       استعادة كاملة، تستبدل تعديلاتك اليدوية أيضًا
  /rollback diff <N>        معاينة التغييرات منذ نقطة الحفظ N
  /rollback <N> <file>      استعادة ملف واحد من نقطة الحفظ N

إدارة المخزن من الطرفية

خارج الجلسة، استخدم CLI لفحص وإدارة مخزن نقاط الحفظ:

hermes checkpoints              # عرض الحجم، عدد المشاريع، التفاصيل
hermes checkpoints status       # نفس ما سبق
hermes checkpoints list         # اسم مستعار لـ status
hermes checkpoints prune        # تنظيف إجباري: الملفات اليتيمة، البيانات القديمة، حد الحجم
hermes checkpoints clear        # حذف كل شيء (يطلب تأكيدًا أولاً)
hermes checkpoints clear-legacy # إزالة أرشيفات الترحيل القديمة v1

مثال على الإخراج:

قاعدة نقاط الحفظ: /home/you/.hermes/checkpoints
الحجم الإجمالي:      142.3 MB
  store/         138.1 MB
  legacy-*       4.2 MB
المشاريع:        12

  WORKDIR                                                       COMMITS    آخر تعديل  الحالة
  /home/you/code/hermes-agent                                        20       2h ago  live
  /home/you/code/experiments/rl-runner                                8       1d ago  live
  /home/you/code/old-prototype                                        3       9d ago  orphan

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

اضبط نقاط الحفظ بدقة في ~/.hermes/config.yaml:

checkpoints:
  enabled: false              # المفتاح الرئيسي (الافتراضي: false)
  max_snapshots: 20           # الحد الأقصى لنقاط الحفظ لكل مشروع
  max_total_size_mb: 500      # سقف صارم للحجم الإجمالي للمخزن
  max_file_size_mb: 10        # تجاهل الملفات الأكبر من هذا الحجم

  # الصيانة التلقائية (مفعّلة افتراضيًا)
  auto_prune: true
  retention_days: 7
  min_interval_hours: 24

تريد تعطيل كل شيء؟

checkpoints:
  enabled: false
  auto_prune: false

كيف يعمل تحت الغطاء

عندما يكتشف Hermes أداة على وشك تعديل ملفات، فإنه:

يحدد جذر المشروع لهذا الملف
يهيئ أو يعيد استخدام المخزن الظل المشترك
يرحّل التغييرات، يبني شجرة، ويُجري commit إلى مرجع خاص بالمشروع (refs/hermes/<project-hash>)

هذه المراجع تشكل سجل نقاط الحفظ الخاص بك، جاهزة للفحص والاستعادة عبر /rollback.

أفكار أخيرة

نقاط الحفظ تمنحك راحة البال عندما تدع الوكيل يعمل على كودك. سواء كنت تجرّب، أو تعيد هيكلة، أو تريد فقط شبكة أمان، فإن /rollback في ظهرك. فعّلها، انسَ أمرها، وارتح بمعرفة أنك تستطيع دائمًا التراجع.

برمجة سعيدة — وتذكر، نقاط الحفظ موجودة لسبب ما!