AskClean

كيفية مسح ذاكرة Hugging Face المؤقتة على Mac

فريق AskClean · آخر تحديث 2026-11-02

لاستعادة المساحة التي تشغلها ذاكرة Hugging Face المؤقتة على Mac، حدد الذاكرة التي يستخدمها تطبيقك فعلًا، وافحصها بالأمر hf cache ls، ثم عاين حذف مستودع أو نسخة (revision) محددة بالأمر hf cache rm --dry-run. احتفظ بالنماذج التي تحتاجها دون اتصال وبعملك الخاص، ولا تحذف ملفات blob المشتركة أو مجلد HF_HOME كله دون تمييز.

رسم تصوري لنسخ نماذج تتصل بكتل بيانات مشتركة، مع إبقاء ملفات المشروع منفصلة
قد تتشارك عدة نسخ الملفات نفسها. أبقِ نقاط الحفظ (checkpoints) وعمل مشاريعك في مكان منفصل. رسم تصوري.

حدد موقع الذاكرة واحمِ عملك الخاص

الموقع المعتاد لذاكرة Hub هو ~/.cache/huggingface/hub. يحدد HF_HUB_CACHE ذاكرة مستودعات Hub مباشرة، ويغيّر HF_HOME المجلد الرئيسي الأوسع لـ Hugging Face، وقد يؤثر XDG_CACHE_HOME في الموقع الافتراضي عند عدم ضبط HF_HOME، كما يمكن لوسيط cache_dir في التطبيق أن يختار مسارًا آخر. افحص التطبيقات ذات الواجهة الرسومية ونوى notebook ومشاريع سطر الأوامر كلًّا على حدة، فقد تختلف إعدادات بيئتها. وقد يتضمن HF_HOME بيانات مصادقة، فلا تحذفه كله لمسح تنزيلات النماذج، ولا تشارك محتواه في طلبات الدعم.

قبل حذف أي نموذج، تحقق من التطبيق أو بيئة Python التي تستخدمه، والنسخة التي يحتاجها مشروعك، واعتمادك عليه دون اتصال. ثم افصل التنزيلات عما أنشأته بنفسك: فنقاط الحفظ (checkpoints) المضبوطة والمهايئات (adapters) وتعديلات tokenizer ونواتج التحويل والبيانات الخاصة وإعدادات المشروع قد لا يمكن تنزيلها مجددًا. وتحقق من نسخك الاحتياطية، فبعض الأدوات تتخطى الذاكرات الموسومة بـ CACHEDIR.TAG. وإن لم تكن تعرف كيف تستعيد عنصرًا وتعيد التطبيق إلى العمل، فاحتفظ به الآن.

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

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

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

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

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

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

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

البيانات المعالجة في HF_DATASETS_CACHE مختلفة عن تنزيلات Hub، والتنزيلات إلى local_dir تذهب إلى وجهة تختارها أنت أو التطبيق، وتخزين نقل Xet منفصل أيضًا. افحص كل فئة على حدة واحتفظ بتعديلاتك المحلية، فالتنزيل الجديد لا يستعيدها. وحذف HF_HOME كله لا يغني عن هذا الفحص.

تأكد من أن النماذج المتبقية تعمل

كرر الجرد والقياسات، ثم حمّل نموذجًا ونسخة قررت الاحتفاظ بهما ونفّذ مهمة صغيرة ذات نتيجة معروفة؛ فنجاح استيراد مكتبة Python وحده لا يتحقق من ملفات النموذج. وإن كنت تحتاج إلى العمل دون اتصال، فاختبر ذلك بعد فصل الشبكة فعلًا. وإذا نزّل التشغيل التالي النموذج نفسه من جديد، فربما حذفت بيانات ما زال العمل يحتاج إليها؛ فأعد النظر في الاختيار أو السعة بدل تكرار الحذف والتنزيل. وعند فشل أي فحص، أوقف التنظيف، وسجّل النموذج والنسخة والمسار والخطأ، واستعد النسخة الاحتياطية أو نزّل النسخة اللازمة قبل حذف عنصر آخر.

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

كيف تحققنا من هذه الأوامر

في 2026-09-29 أنشأنا دون اتصال ذاكرة اصطناعية بنمط Hub تضم نسختين وملف blob مشتركًا وملفًا خاصًا بكل نسخة. وباستخدام huggingface_hub 2.0.0 نجح سرد النسخ، ولم تغيّر معاينات rm وprune الملفات، وحافظ حذف النسخة القديمة على النسخة الحالية وبياناتها المشتركة. كما أظهر الخيار --show-warnings عنصرًا تالفًا عمدًا، وحافظ --no-truncate على المعرّف الكامل. افحص إصدارك بالأمر hf cache --help، وإن اختلفت أوامره أو خياراته فاتبع وثائقه.

لم تختبر هذه الفحوص تنزيلات نماذج حقيقية أو الاستدلال أو ذاكرة مستخدم فعلية أو نقل القرص أو حذف ملفات blob المشتركة بين المستودعات، ولا تتنبأ بمقدار المساحة التي سيحررها جهازك. يساعدك AskClean على رؤية ما يستهلك المساحة على Mac؛ والفحص والمعاينة مجانيان، أما تحليل الذكاء الاصطناعي والتنظيف فيتطلبان Pro. ويحذف تنظيف القرص العناصر التي تؤكدها نهائيًا، لذا أدِر النسخ المخزنة وملفاتها المشتركة عبر سطر أوامر Hugging Face، وأبقِ عمل مشروعك الأصلي خارج اختيار التنظيف.

ما يمكن إعادة إنشائه وما يجب الاحتفاظ به

افحص كل فئة على حدة. يوضح الجدول ما تحتاج إلى حفظه أو استعادته، ولا يحدد ملفات للحذف التلقائي.

العنصرمكان الفحصما تتحقق منه قبل الحذف
مستودع أو نسخة في Hubhf cache ls --revisionsتحقق من الاختيار الدقيق؛ قد تتطلب استعادته تنزيلًا جديدًا وصلاحية الوصول إلى المستودع نفسه.
ملفات blob واللقطات المشتركةذاكرة Hub التي تحققت منهااستخدم مدير الذاكرة؛ فالنسخ، وفي بعض البنى المستودعات، قد تتشارك الملفات المخزنة نفسها.
النسخ المنفصلة (detached)hf cache prune --dry-runقد يظل المشروع بحاجة إلى نسخة بعينها حتى إن لم يشر إليها أي مرجع مسمى في الذاكرة.
ذاكرة مجموعات البيانات المُنشأةHF_DATASETS_CACHEمنفصلة عن تنزيلات Hub، وقد تتطلب إعادة إنشائها وقت معالجة وبيانات المصدر.
نقاط الحفظ والمهايئات والمصادر الخاصةمشروعك ومواقع نسخك الاحتياطيةاحتفظ بعملك الأصلي وتحقق من أن النسخ الاحتياطية تشمله، خاصة إن كان مخزنًا داخل مجلد ذاكرة.
المجلد الرئيسي لـ Hugging Face وبيانات المصادقةHF_HOMEلا تحذف المجلد الرئيسي كله لإزالة عناصر من ذاكرة النماذج.

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

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

هل يمكنني حذف ~/.cache/huggingface على Mac؟

لا تعامل المجلد كله على أنه قابل للحذف. حدد ذاكرة Hub النشطة، واحتفظ ببيانات المصادقة وعملك الأصلي، ثم عاين حذف مستودعات أو نسخ محددة بالأمر hf cache المثبت لديك.

لماذا يحرر حذف نسخة واحدة مساحة أقل من حجمها المعروض؟

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

هل تعني النسخة المنفصلة (detached) أن أي تطبيق لا يستخدمها؟

لا. قد يثبّت المشروع نسخة بعينها حتى إن لم يكن لها مرجع مسمى في الذاكرة المؤقتة، فراجع متطلبات المشروع قبل استخدام prune.

هل ستبقى نماذجي متاحة دون اتصال بعد التنظيف؟

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

هل قد يحذف hf cache rm نموذجي المضبوط؟

نعم، إن كانت ملفاتك المخصصة داخل عنصر الذاكرة المحدد. أبقِ نقاط الحفظ والمهايئات والملفات المعدلة خارج العناصر التي تنوي حذفها، وتحقق من نسخها الاحتياطية؛ فالمجلد المسمى cache قد يحوي النسخة الوحيدة من عمل مهم.

المصادر

المزيد من أدلة مساحة النماذج والمطوّرين