فحص ذاكرة Hugging Face المؤقتة وتنظيفها على Mac

حدّد الموقع واحمِ عملك

الموقع المعتاد هو ~/.cache/huggingface/hub. يحدد HF_HUB_CACHE ذاكرة المستودعات، بينما يشمل HF_HOME بيانات أوسع. عند غياب HF_HOME قد يؤثر XDG_CACHE_HOME في الموقع الافتراضي، ويمكن أن يحدد cache_dir مسارًا آخر. افحص التطبيقات الرسومية والطرفية وnotebook منفصلة. قد يتضمن HF_HOME بيانات مصادقة؛ لا تحذفه كله ولا تنشر محتواه.

قد لا يمكن تنزيل checkpoint المعدلة وadapter وتغييرات tokenizer والتحويلات والبيانات الخاصة وإعدادات المشروع مجددًا. تحقق من النسخ الاحتياطية؛ بعض الأدوات تتجاوز الذاكرة الموسومة CACHEDIR.TAG. احتفظ بما لا تعرف كيف تستعيده، ولا تعتبر تاريخ الوصول القديم دليلًا على عدم الحاجة إلى النموذج.

اعرض المعرّفات كاملة والتحذيرات

أوقف التطبيقات والتنزيلات والمهام التي تستخدم الذاكرة. شغّل hf cache ls --no-truncate ثم hf cache ls --revisions --no-truncate --show-warnings. يخفي الإصدار المختبر التحذيرات المفصلة افتراضيًا. استخدم --cache-dir نفسه دائمًا للموقع المخصص. افحص أخطاء القراءة أو البنية، وسجّل المساحة المستخدمة والحرة، ولا تنشر قوائم المستودعات الخاصة.

راجع نطاق الحذف قبل التأكيد

يحتاج hf cache rm إلى المعرّف الكامل من CLI. أبقِ بادئة model/ لمستودع النماذج؛ اسم مجلد يبدأ بـ models-- لا يحل محلها. ولنسخة واحدة استخدم hash كاملًا وتحقق من مستودعها. ابدأ بإضافة --dry-run. الناتج ملخص للأهداف والمساحة المقدرة، وليس قائمة بكل ملف. استهداف مستودع يشمل جميع نسخه المخزنة مؤقتًا.

بعد الفحص أزل --dry-run فقط مع إبقاء الهدف والمسار وطلب التأكيد. إذا تغير الاختيار أو فشلت المعاينة، أوقف الحذف وابحث عن السبب. تُحذف الملفات مباشرة دون سلة المهملات؛ الاستعادة تحتاج نسخة احتياطية أو وصولًا جديدًا للتنزيل. تتشارك snapshot، وأحيانًا المستودعات، ملفات blob؛ دع مدير الذاكرة يعالج المراجع ولا تجمع الأحجام المعروضة ببساطة.

ميّز prune عن أنواع التخزين الأخرى

في الإصدار 2.0.0 المختبر، يعاين hf cache prune --dry-run النسخ detached والتنزيلات غير المكتملة. قد يثبت المشروع نسخة دقيقة حتى دون مرجع مسمى. راجع كل هدف وأوقف التنزيلات النشطة. ابدأ بهدف واحد واضح.

البيانات المُنشأة في HF_DATASETS_CACHE تختلف عن تنزيلات Hub. افحص بيانات نقل Xet ومخرجات local_dir منفصلة مع الاحتفاظ بالتعديلات المحلية. حذف HF_HOME كله لا يغني عن هذا الفحص.

شغّل النماذج التي احتفظت بها

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

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

نطاق التحقق

في 2026-09-29 اختُبرت ملفات مؤقتة اصطناعية دون شبكة باستخدام huggingface_hub 2.0.0: القوائم والمعرّفات الكاملة والتحذيرات وdry-run. لم تغير المعاينات الملفات، وحافظ حذف نسخة قديمة على الحالية والبيانات المشتركة. لم يُختبر الاستدلال الحقيقي أو بيانات المستخدم أو تنظيف blob المشتركة بين المستودعات أو نقل القرص. لا يضمن ذلك مقدارًا ثابتًا من المساحة. افحص إصدارك بأمر hf cache --help.

ما يجب التحقق منه قبل الحذف

تحقق من الموقع الفعلي والغرض من الملفات وطريقة استعادتها. هذا الجدول ليس قائمة للحذف التلقائي ولا يضمن توفير مساحة محددة.

الأسئلة الشائعة