Έλεγχος και καθαρισμός της cache Hugging Face σε Mac

Εντοπίστε δεδομένα και προστατέψτε την εργασία σας

Η συνήθης θέση είναι ~/.cache/huggingface/hub. Το HF_HUB_CACHE ορίζει την cache αποθετηρίων, ενώ το HF_HOME καλύπτει περισσότερα. Χωρίς HF_HOME, το XDG_CACHE_HOME μπορεί να επηρεάζει την προεπιλογή και το cache_dir να επιλέγει άλλη διαδρομή. Ελέγξτε γραφικές εφαρμογές, τερματικό και notebook χωριστά. Το HF_HOME μπορεί να περιέχει στοιχεία ταυτοποίησης· μην το διαγράφετε ολόκληρο ή δημοσιεύετε το περιεχόμενο.

Δικά σας checkpoint, adapter, αλλαγές tokenizer, μετατροπές, ιδιωτικά δεδομένα και ρυθμίσεις μπορεί να μην επαναλαμβάνονται με νέα λήψη. Ελέγξτε τα backup: ορισμένα εργαλεία παραλείπουν cache με CACHEDIR.TAG. Κρατήστε όσα δεν ξέρετε πώς αποκαθίστανται. Παλιός χρόνος πρόσβασης δεν αποδεικνύει περιττό μοντέλο.

Εμφανίστε πλήρη ID και προειδοποιήσεις

Σταματήστε εφαρμογές, λήψεις και εργασίες που χρησιμοποιούν την cache. Εκτελέστε hf cache ls --no-truncate και μετά hf cache ls --revisions --no-truncate --show-warnings. Η δοκιμασμένη έκδοση κρύβει λεπτομερείς προειδοποιήσεις από προεπιλογή. Χρησιμοποιήστε πάντα το ίδιο --cache-dir για προσαρμοσμένη θέση. Εξετάστε σφάλματα ανάγνωσης ή δομής, σημειώστε χρήση και ελεύθερο χώρο και μη δημοσιεύετε ιδιωτικές λίστες αποθετηρίων.

Ελέγξτε το εύρος πριν επιβεβαιώσετε

Το hf cache rm χρειάζεται πλήρες ID από το CLI. Κρατήστε model/ για αποθετήριο μοντέλου· όνομα φακέλου με models-- δεν το αντικαθιστά. Για μία αναθεώρηση χρησιμοποιήστε πλήρες hash και ελέγξτε το αποθετήριο. Ξεκινήστε με --dry-run. Το αποτέλεσμα συνοψίζει στόχους και εκτιμώμενο χώρο, όχι κάθε αρχείο. Στόχος αποθετηρίου περιλαμβάνει όλες τις αποθηκευμένες αναθεωρήσεις του.

Μετά τον έλεγχο αφαιρέστε μόνο το --dry-run, διατηρώντας στόχο, διαδρομή και ερώτημα επιβεβαίωσης. Αν αλλάξει η επιλογή ή αποτύχει η προεπισκόπηση, σταματήστε τη διαγραφή και βρείτε την αιτία. Τα αρχεία διαγράφονται απευθείας, χωρίς Κάδο· χρειάζεται backup ή νέα πρόσβαση λήψης για επαναφορά. Snapshot και μερικές φορές αποθετήρια μοιράζονται blob. Αφήστε τις αναφορές στον διαχειριστή και μην αθροίζετε απλώς τα μεγέθη.

Διαχωρίστε prune και άλλες cache

Στη δοκιμασμένη έκδοση 2.0.0 το hf cache prune --dry-run εμφανίζει detached αναθεωρήσεις και ημιτελείς λήψεις. Έργο μπορεί να απαιτεί ακριβή αναθεώρηση ακόμη χωρίς ονομασμένη αναφορά. Ελέγξτε κάθε στόχο και σταματήστε ενεργές λήψεις. Ξεκινήστε από ένα σαφώς ορισμένο στοιχείο.

Τα δεδομένα που παράγονται στο HF_DATASETS_CACHE διαφέρουν από λήψεις Hub. Εξετάστε χωριστά μεταφορές Xet και εξόδους local_dir, διατηρώντας τοπικές αλλαγές. Η διαγραφή όλου του HF_HOME δεν αντικαθιστά τον έλεγχο.

Φορτώστε πραγματικά τα μοντέλα που κρατήσατε

Επαναλάβετε τις μετρήσεις, φορτώστε απαραίτητα μοντέλα και αναθεωρήσεις και εκτελέστε μικρή εργασία γνωστού αποτελέσματος. Η εισαγωγή βιβλιοθήκης Python δεν αρκεί. Δοκιμάστε offline χρήση με αποσυνδεδεμένο δίκτυο. Σε αποτυχία σταματήστε τον καθαρισμό και ελέγξτε περιβάλλον, διαδρομές, αρχεία, πρόσβαση και χώρο πριν την επαναφορά. Συνεχής επαναλήψη λήψης αναγκαίου μοντέλου απαιτεί άλλο σχεδιασμό επιλογής ή χωρητικότητας.

Για εξωτερικό δίσκο ελέγξτε χώρο, δικαιώματα και συμβολικούς συνδέσμους. Αντιγράψτε συνδέσμους μαζί με τους στόχους, ρυθμίστε κάθε εφαρμογή και ελέγξτε μοντέλα πριν αφαιρέσετε το πρωτότυπο. Ο δίσκος πρέπει να παραμένει συνδεδεμένος κατά τη χρήση.

Τι ελέγχθηκε

Στις 2026-09-29 ελέγχθηκαν προσωρινές συνθετικές cache offline με huggingface_hub 2.0.0: λίστες, πλήρη ID, προειδοποιήσεις και dry-run. Οι προεπισκοπήσεις δεν άλλαξαν αρχεία· η αφαίρεση παλιάς αναθεώρησης διατήρησε την τρέχουσα και κοινά δεδομένα. Δεν ελέγχθηκαν πραγματική εκτέλεση μοντέλων, cache χρηστών, κοινά blob μεταξύ αποθετηρίων ή μεταφορά δίσκου. Δεν παρέχεται εγγύηση για συγκεκριμένη εξοικονόμηση χώρου. Ελέγξτε την έκδοσή σας με hf cache --help.

Τι να ελέγξετε πριν από τη διαγραφή

Ελέγξτε την πραγματική θέση, τη χρήση και τον τρόπο επαναφοράς. Ο πίνακας δεν αποτελεί λίστα αυτόματης διαγραφής ούτε υπόσχεση συγκεκριμένου ελεύθερου χώρου.

Συχνές ερωτήσεις