Communitygithub.com

AssetDiet

Auditieren, Komprimieren, Deduplizieren und Zurücksetzen von lokalen Repository-Medien-Assets (PNG/JPG/WebP/AVIF via Sharp, SVG via SVGO, MP4/WebM via FFmpeg, GLB/GLTF 3D via glTF-Transform) bei Bedarf über die CLI `npx [email protected]` ohne dauerhaften MCP-Overhead. Nur auslösen, wenn der Benutzer explizit nach einer Überprüfung, Komprimierung, Deduplizierung oder Reduzierung von Bildern, SVGs, Videos oder 3D-Assets fragt („asset-diet“, „assetdiet“, „rasmlarni siqib ber“, „media optimizatsiya“, „og'ir rasmlarni tekshir“).

Was ist AssetDiet?

AssetDiet ist ein On-Demand-Tool zur lokalen Medienprüfung und -komprimierung, das als CLI über `npx [email protected]` ausgeführt wird. Es ist für Entwickler gedacht, die Medien-Assets in ihren Projekten auditieren, komprimieren, deduplizieren und bei Bedarf wiederherstellen möchten – und das ohne dauerhafte MCP-Serverinstallation. Das Tool unterstützt eine breite Palette von Formaten, darunter PNG, JPG, WebP, AVIF (über Sharp), SVG (über SVGO), MP4, WebM (über FFmpeg) und 3D-Modelle in GLB/GLTF (über glTF-Transform). Der Arbeitsablauf beginnt immer mit einem schreibgeschützten Audit, das Einsparpotenziale und Duplikatgruppen aufzeigt, bevor Änderungen vorgenommen werden. Die eigentliche Optimierung erfolgt dann wahlweise mit den Richtlinien 'safe' (verlustfrei, gleiche Dateierweiterungen) oder 'balanced' (Web-Konvertierung zu WebP mit Quellcode-Migration). Ein wichtiges Feature ist die sofortige atomare Rollback-Funktion, die bytegenaue Originale wiederherstellt, falls etwas schiefgeht. Zudem wird empfohlen, das Backup-Verzeichnis `.assetdiet/` nicht in Git zu committen, um die Repository-Hygiene zu wahren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TursunboyevJahongir/tasted-skills/tree/HEAD/skills/asset-diet

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. Registrieren Sie NIEMALS den MCP-Server: Führen Sie niemals assetdiet setup oder assetdiet mcp aus. Rufen Sie CLI-Unterbefehle immer direkt auf (audit, scan, optimize, restore, doctor).
  2. Fixieren Sie die geprüfte Version ([email protected]): Vermeiden Sie unpinned @latest in automatisierten Abläufen, damit das Lieferkettenverhalten der geprüften Version entspricht.
  3. Schreibgeschütztes Audit vor Änderungen: Führen Sie immer zuerst audit aus 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 safe verlangt).
  4. 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 über require('./foo.png') oft die .png-Erweiterung – behalten Sie --policy safe bei (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 (Sharp verlustfrei/85, SVGO behält viewBox), behält die genauen Dateierweiterungen, berührt niemals Quellcode-Imports und entfernt doppelte Byte-Kopien nur dann, wenn sie 0 Code-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 safe
    
  • balanced-Richtlinie (Nur Web .png/.jpg → .webp + Quellcode-Referenz-Migration – zuerst um Bestätigung fragen):
    npx [email protected] optimize <targetPath> --policy balanced --dry-run
    npx [email protected] optimize <targetPath> --policy balanced
    
    Überprüfen Sie nach balanced sofort git status und git diff auf 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

  1. Speichern Sie die Run-ID, die von optimize ausgegeben 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>
    
  2. Committen Sie NIEMALS .assetdiet/-Backups in Git: Stellen Sie sicher, dass .assetdiet/ in .gitignore aufgeführt ist (oder löschen Sie .assetdiet/, sobald die visuelle/Build-Überprüfung bestanden ist und der Benutzer bestätigt hat).

Verwandte Skills