Hugging Face -välimuistin tarkistaminen ja siivoaminen Macissa

Paikanna tiedot ja suojaa oma työ

Tavallinen sijainti on ~/.cache/huggingface/hub. HF_HUB_CACHE määrittää Hub-varastojen välimuistin; HF_HOME kattaa enemmän. Ilman HF_HOME-asetusta XDG_CACHE_HOME voi vaikuttaa oletukseen; cache_dir voi valita toisen polun. Tarkista graafiset sovellukset, pääte ja notebook erikseen. HF_HOME voi sisältää tunnistautumistietoja: älä poista kaikkea tai julkaise sisältöä.

Omat checkpointit, adapterit, tokenizer-muutokset, muunnokset, yksityiset tiedot ja asetukset eivät välttämättä ole ladattavissa uudelleen. Tarkista varmuuskopio: jotkin työkalut ohittavat CACHEDIR.TAG-merkityt välimuistit. Säilytä tiedot, joiden palautustapaa et tunne. Vanha käyttöajankohta ei osoita mallia tarpeettomaksi.

Näytä täydet tunnisteet ja varoitukset

Pysäytä välimuistia käyttävät sovellukset, lataukset ja työt. Suorita hf cache ls --no-truncate ja sitten hf cache ls --revisions --no-truncate --show-warnings. Testattu versio piilottaa yksityiskohtaiset varoitukset oletuksena. Käytä mukautetulle sijainnille aina samaa --cache-dir-arvoa. Tutki luku- ja rakenneongelmat, kirjaa käytetty ja vapaa tila äläkä julkaise yksityisiä varastoluetteloita.

Tarkista laajuus ennen vahvistusta

hf cache rm tarvitsee CLI:n täydellisen tunnisteen. Säilytä mallivaraston model/-alku; kansion nimi, joka alkaa merkkijonolla models--, ei korvaa tunnistetta. Käytä yhdelle revisiolle täyttä hash-arvoa ja tarkista sen varasto. Aloita --dry-run-valinnalla. Tulos on kohteiden ja arvioidun tilan yhteenveto, ei tiedostokohtainen lista. Varastokohde kattaa kaikki sen välimuistissa olevat revisiot.

Poista tarkistuksen jälkeen vain --dry-run ja säilytä kohde, polku ja vahvistuskysymys. Jos valinta muuttuu tai esikatselu epäonnistuu, pysäytä poisto ja selvitä syy. Tiedostot poistetaan suoraan ilman roskakoria; palautus vaatii varmuuskopion tai uuden latausoikeuden. Snapshotit ja joissakin rakenteissa varastot jakavat blob-tiedostoja. Jätä viittaukset välimuistinhallinnalle äläkä laske näyttökokoja suoraan yhteen.

Erota prune ja muut välimuistit

Testatussa versiossa 2.0.0 hf cache prune --dry-run näyttää detached-revisiot ja keskeneräiset lataukset. Projekti voi lukita tarkan revision ilman nimettyä viittaustakin. Tarkista jokainen kohde ja pysäytä aktiiviset lataukset. Aloita yhdestä selvästi rajatusta kohteesta.

HF_DATASETS_CACHE-hakemistossa tuotetut tiedot eroavat Hub-latauksista. Tarkista Xet-siirtotiedot ja local_dir-tulosteet erikseen ja säilytä paikalliset muutokset. Koko HF_HOME-hakemiston poistaminen ei korvaa tätä tarkistusta.

Lataa säilytetyt mallit käyttöön

Toista mittaukset, lataa tarvittavat mallit ja revisiot ja suorita pieni tehtävä, jonka tulos tunnetaan. Python-kirjaston tuonti ei yksin riitä. Testaa offline-käyttö todella ilman verkkoyhteyttä. Pysäytä siivous virheen sattuessa ja tarkista ympäristö, polut, tiedostot, oikeudet ja tila ennen palautusta. Tarpeellisen mallin jatkuva uudelleenlataus edellyttää valinnan tai kapasiteetin arviointia.

Ulkoiselle levylle siirrettäessä tarkista tila, oikeudet ja symboliset linkit. Kopioi linkit kohteineen, määritä jokainen sovellus ja testaa sen mallit ennen alkuperäisen poistamista. Levyn on oltava kytkettynä käytön aikana.

Mitä on tarkistettu

Päivänä 2026-09-29 testattiin tilapäisiä synteettisiä välimuisteja offline-tilassa paketilla huggingface_hub 2.0.0: luettelot, täydet tunnisteet, varoitukset ja dry-run. Esikatselut eivät muuttaneet tiedostoja; vanhan revision poisto säilytti nykyisen ja yhteiset tiedot. Oikeaa malliajoa, käyttäjän välimuistia, varastojen yhteisiä blob-tiedostoja tai levysiirtoa ei testattu. Tiettyä tilansäästöä ei taata. Tarkista oma versiosi komennolla hf cache --help.

Tarkista ennen poistamista

Varmista todellinen sijainti, käyttötarkoitus ja palautustapa. Taulukko ei ole automaattinen poistolista eikä lupaa tiettyä määrää vapaata tilaa.

UKK