AssetDiet (On-Demand Lokale Medienprüfung & Komprimierung)
Verwenden Sie 092Abdullah/AssetDiet (npm: assetdiet-mcp) streng als ephemere 100% lokale CLI über npx [email protected] – keine Cloud-Uploads und keine dauerhafte MCP-Schema-Blähte mit 16 Tools in Chat-Sitzungen.
1. Unverhandelbare Leitplanken
- Registrieren Sie NIEMALS den MCP-Server: Führen Sie niemals
assetdiet setupoderassetdiet mcpaus. Rufen Sie CLI-Unterbefehle immer direkt auf (audit,scan,optimize,restore,doctor). - Fixieren Sie die geprüfte Version (
[email protected]): Vermeiden Sie unpinned@latestin automatisierten Abläufen, damit das Lieferkettenverhalten der geprüften Version entspricht. - Schreibgeschütztes Audit vor Änderungen: Führen Sie immer zuerst
auditaus und zeigen Sie potenzielle Einsparungen + Duplikatgruppen an, bevor Sie Repository-Assets verändern (es sei denn, der Benutzer hat explizit die sofortige Anwendung von--policy safeverlangt). - Expo / React Native & App-Symbolschutz: In Expo / React Native-Projekten (
app.json/app.config.ts) benötigen native App-Symbole, Startbildschirme, Benachrichtigungssymbole und statische Assets überrequire('./foo.png')oft die.png-Erweiterung – behalten Sie--policy safebei (gleiche Erweiterung, verlustfrei/SSIM ≥ 0.98), es sei denn, Sie arbeiten in einem reinen Web-Ordner (public/,static/) mit expliziter Benutzerzustimmung zur.webp-Konvertierung.
2. Schritt-für-Schritt-Workflow
Schritt 1: Schreibgeschütztes Audit (Keine Dateiänderungen)
# Kurze 3-zeilige Scorecard-Zusammenfassung (Gesamtgröße, Einsparungen, SHA-256-Duplikatgruppen)
npx [email protected] audit <targetPath> --policy safe --summary
# Vollständige Aufschlüsselung pro Datei (oder --json für strukturierte Filterung)
npx [email protected] audit <targetPath> --policy safe
Schritt 2: Sicher optimieren mit atomarem Journal & Backup
safe-Richtlinie (Standard – Empfohlen): Komprimiert direkt (Sharpverlustfrei/85,SVGObehältviewBox), behält die genauen Dateierweiterungen, berührt niemals Quellcode-Imports und entfernt doppelte Byte-Kopien nur dann, wenn sie0Code-Referenzen haben:# Optionaler Dry-Run-Vorschau npx [email protected] optimize <targetPath> --policy safe --dry-run # Ausführen mit atomarem Backup (.assetdiet/backups/<runId>/) npx [email protected] optimize <targetPath> --policy safebalanced-Richtlinie (Nur Web.png/.jpg→.webp+ Quellcode-Referenz-Migration – zuerst um Bestätigung fragen):
Überprüfen Sie nachnpx [email protected] optimize <targetPath> --policy balanced --dry-run npx [email protected] optimize <targetPath> --policy balancedbalancedsofortgit statusundgit diffauf allen geänderten.ts/.tsx/.jsx/.css/.html-Imports und führen Sie den Build/Typprüfung des Projekts aus.
Schritt 3: Sofortiges Rollback & .assetdiet/-Git-Hygiene
- Speichern Sie die
Run-ID, die vonoptimizeausgegeben wird. Wenn ein Asset degradiert aussieht oder ein Import fehlschlägt, stellen Sie die bytegenauen Originale mit einem Befehl wieder her:npx [email protected] restore --run <runId> --path <targetPath> - Committen Sie NIEMALS
.assetdiet/-Backups in Git: Stellen Sie sicher, dass.assetdiet/in.gitignoreaufgeführt ist (oder löschen Sie.assetdiet/, sobald die visuelle/Build-Überprüfung bestanden ist und der Benutzer bestätigt hat).