AssetDiet (Auditoría y Compresión Local de Activos Multimedia Bajo Demanda)
Usa 092Abdullah/AssetDiet (npm: assetdiet-mcp) estrictamente como un CLI local efímero 100% local mediante npx [email protected] — sin subidas a la nube y sin sobrecarga permanente de esquema MCP de 16 herramientas en las sesiones de chat.
1. Reglas No Negociables
- NUNCA registres el servidor MCP: No ejecutes
assetdiet setupniassetdiet mcp. Siempre invoca los subcomandos del CLI directamente (audit,scan,optimize,restore,doctor). - Fija la versión auditada (
[email protected]): Evita@latestsin fijar en ejecuciones automatizadas para que el comportamiento de la cadena de suministro coincida con la versión auditada. - Auditoría de solo lectura antes de escribir: Ejecuta siempre
auditprimero y muestra los ahorros potenciales y grupos de duplicados antes de mutar los activos del repositorio (a menos que el usuario haya solicitado explícitamente aplicar--policy safede inmediato). - Protección de iconos de aplicaciones Expo / React Native: En proyectos Expo / React Native (
app.json/app.config.ts), los iconos de aplicaciones nativas, pantallas de inicio, iconos de notificación y activosrequire('./foo.png')estáticos a menudo requieren extensiones.png— mantén--policy safe(misma extensión, sin pérdida/SSIM ≥ 0.98) a menos que se apunte a una carpeta web pura (public/,static/) con aprobación explícita del usuario para conversión a.webp.
2. Flujo de Trabajo Paso a Paso
Paso 1: Auditoría de Solo Lectura (Sin Cambios en Archivos)
# Resumen rápido de 3 líneas (tamaño total, ahorros, grupos de duplicados SHA-256)
npx [email protected] audit <rutaDestino> --policy safe --summary
# Desglose completo por archivo (o añade --json para filtrado estructurado)
npx [email protected] audit <rutaDestino> --policy safe
Paso 2: Optimizar de Forma Segura con Diario Atómico y Respaldo
- Política
safe(Predeterminada — Recomendada): Comprime en el lugar (Sharpsin pérdida/85,SVGOmanteniendoviewBox), conserva las extensiones de archivo exactas, nunca toca las importaciones de código fuente y elimina copias duplicadas de bytes solo cuando tienen0referencias de código:# Vista previa opcional de simulación npx [email protected] optimize <rutaDestino> --policy safe --dry-run # Ejecutar con respaldo atómico (.assetdiet/backups/<runId>/) npx [email protected] optimize <rutaDestino> --policy safe - Política
balanced(Solo web.png/.jpg→.webp+ migración de referencias de código — pide confirmación primero):
Después denpx [email protected] optimize <rutaDestino> --policy balanced --dry-run npx [email protected] optimize <rutaDestino> --policy balancedbalanced, inspecciona inmediatamentegit statusygit diffen todas las importaciones modificadas.ts/.tsx/.jsx/.css/.htmly ejecuta la compilación/verificación de tipos del proyecto.
Paso 3: Reversión Instantánea e Higiene de Git de .assetdiet/
- Guarda el
ID de ejecuciónimpreso poroptimize. Si algún activo parece degradado o una importación se rompe, restaura los originales byte por byte en un solo comando:npx [email protected] restore --run <idEjecucion> --path <rutaDestino> - Nunca subas los respaldos de
.assetdiet/a Git: Asegúrate de que.assetdiet/esté listado en.gitignore(o elimina.assetdiet/una vez que la verificación visual/de compilación pase y el usuario lo confirme).