CLI – Cache & Wartung
cleanup
Zusammenfassung: ai-i18n-tools cleanup [--dry-run] [--backup <path>]
Löscht die gesamte Tabelle markdown_source_issues und führt dann sync --force-update aus (Extrahieren, UI, SVG, Dokumente und translate-json, falls aktiviert), sodass Markdown-Probleme für aktuell konfigurierte Dokumente neu aufgefüllt werden; entfernt dann veraltete Segmentzeilen (null last_hit_at / leerer Dateipfad); löscht file_tracking-Zeilen, deren aufgelöster Quellpfad auf der Festplatte fehlt; entfernt Übersetzungszeilen, deren filepath-Metadaten auf eine fehlende Datei verweisen; bereinigt verwaiste translation_failures-Zeilen; und löscht Cache-Zeilen für nicht in der Konfiguration enthaltene Gebietsschemas (sourceLocale, Stamm-targetLocales und alle pro Block docs[] / json[] targetLocales). Nur Cache für eingestellte Gebietsschemas – generierte Dokumente, flache UI-Dateien und strings.json-Einträge bleiben erhalten (verwenden Sie purge-locale, um diese zu entfernen). Protokolliert die Bereinigungsanzahl nach der Synchronisierung (veraltete Segmente, verwaiste file_tracking, verwaiste Übersetzungen, verwaiste Fehler, nicht konfigurierte Gebietsschemas) sowie die anfängliche Anzahl der gelöschten Markdown-Probleme.
Schlüsseloptionen: --dry-run, --backup
--backup <path> schreibt eine SQLite-Sicherungskopie an diesen Pfad, bevor Änderungen vorgenommen werden (keine Sicherung, es sei denn, diese Option ist festgelegt).
clean-temp
Zusammenfassung: ai-i18n-tools clean-temp [-r | --root <path>] [-f | --force] [--dry-run]
Keine Konfiguration. Durchläuft einen Verzeichnisbaum (Standard: aktuelles Verzeichnis) nach *.log, *.tmp und cache.db.backup*.sqlite, gibt ./…-Pfade wie find -print aus. Mit Übereinstimmungen: fordert Delete these files? (y/n) auf, es sei denn, -f / --force (löschen ohne Aufforderung). Ohne Übereinstimmungen: beendet ohne Aufforderung. --dry-run: nur Auflisten, keine Aufforderung oder Löschung (überschreibt --force).
Schlüsseloptionen: -r / --root, -f / --force, --dry-run
purge-locale
Zusammenfassung: ai-i18n-tools purge-locale -l <code> [-l <code> …] [options]
Löscht alle zwischengespeicherten Zeilen für die angegebenen Sprachregionen aus translations, file_tracking und translation_failures und die generierten Artefakte für diese Sprachregion: übersetzte Dokumente (.md / .mdx / .astro-Ausgaben, die aus docs[] aufgelöst werden, einschließlich verwaister Ausgaben, deren Quelle entfernt wurde – gefunden durch das Durchlaufen jedes Blockausgabebaums, außer wenn eine benutzerdefinierte pathTemplate konfiguriert ist), die pro-Sprachregion-Flachdatei der Benutzeroberfläche (<flatOutputDir>/<locale>.json) und die Einträge der Sprachregion in strings.json.
Sprachregionen werden über wiederholbare -l / --locale (normalisiert auf BCP-47) übergeben. Gibt pro-Sprachregion-Zählungen (Zwischenspeicherzeilen, Dokumente, strings.json-Einträge, Flachdatei) aus; warnt (fehlt nicht) für Sprachregionen, für die nichts zu bereinigen ist. Fordert zur Bestätigung auf, es sei denn, -y / --yes / -f / --force. --dry-run: Zählungen und Dateien, die entfernt werden, melden, nichts löschen. --keep-files: nur den SQLite-Zwischenspeicher bereinigen, generierte Dateien und strings.json unberührt lassen. Es wird keine SQLite-Sicherungskopie erstellt, es sei denn, --backup <path> wird übergeben, die eine Sicherungskopie an diesem Pfad vor der Löschung schreibt.
Schlüsseloptionen: -l / --locale, --dry-run, -y / --yes, -f / --force, --keep-files, --backup