AssetDiet (Audit et compression locale de médias à la demande)
Utilisez 092Abdullah/AssetDiet (npm: assetdiet-mcp) strictement comme un CLI local éphémère et 100 % local via npx [email protected] — aucun transfert vers le cloud et zéro gonflement permanent de schéma 16 outils MCP dans les sessions de chat.
1. Garde-fous non négociables
- N'enregistrez JAMAIS le serveur MCP : N'exécutez jamais
assetdiet setupouassetdiet mcp. Invoquez toujours les sous-commandes CLI directement (audit,scan,optimize,restore,doctor). - Épinglez la version auditée (
[email protected]) : Évitez@latestnon épinglé dans les exécutions automatisées pour que le comportement de la chaîne d'approvisionnement corresponde à la version auditée. - Audit en lecture seule avant les écritures : Exécutez toujours
auditd'abord et affichez les économies potentielles + les groupes de doublons avant de modifier les ressources du dépôt (sauf si l'utilisateur a explicitement demandé d'appliquer--policy safeimmédiatement). - Protection des icônes d'application Expo / React Native : Dans les projets Expo / React Native (
app.json/app.config.ts), les icônes natives de l'application, les écrans de démarrage, les icônes de notification et les ressourcesrequire('./foo.png')statiques nécessitent souvent l'extension.png— conservez--policy safe(même extension, sans perte/SSIM ≥ 0.98) sauf si vous ciblez un dossier purement web (public/,static/) avec approbation explicite de l'utilisateur pour la conversion en.webp.
2. Workflow étape par étape
Étape 1 : Audit en lecture seule (aucune modification de fichier)
# Résumé rapide sur 3 lignes (taille totale, économies, groupes de doublons SHA-256)
npx [email protected] audit <cheminCible> --policy safe --summary
# Détail complet par fichier (ou ajouter --json pour un filtrage structuré)
npx [email protected] audit <cheminCible> --policy safe
Étape 2 : Optimisation sécurisée avec journal atomique et sauvegarde
- Politique
safe(Par défaut — Recommandée) : Compresse sur place (Sharpsans perte / 85,SVGOen conservantviewBox), conserve les extensions exactes des fichiers, ne touche jamais aux importations du code source, et supprime les copies en octets en double uniquement lorsqu'elles n'ont aucune référence de code :# Aperçu facultatif en mode dry-run npx [email protected] optimize <cheminCible> --policy safe --dry-run # Exécution avec sauvegarde atomique (.assetdiet/backups/<runId>/) npx [email protected] optimize <cheminCible> --policy safe - Politique
balanced(Web uniquement.png/.jpg→.webp+ migration des références de code — demander confirmation d'abord) :
Aprèsnpx [email protected] optimize <cheminCible> --policy balanced --dry-run npx [email protected] optimize <cheminCible> --policy balancedbalanced, inspectez immédiatementgit statusetgit diffsur tous les fichiers.ts/.tsx/.jsx/.css/.htmlmodifiés et exécutez la compilation/vérification de type du projet.
Étape 3 : Restauration instantanée et hygiène Git de .assetdiet/
- Enregistrez l'
ID de runaffiché paroptimize. Si une ressource semble dégradée ou qu'une importation se casse, restaurez les originaux octet par octet en une commande :npx [email protected] restore --run <runId> --path <cheminCible> - Ne commitez jamais les sauvegardes
.assetdiet/dans Git : Assurez-vous que.assetdiet/est listé dans.gitignore(ou supprimez.assetdiet/une fois que la vérification visuelle/de compilation est réussie et que l'utilisateur confirme).