AssetDiet (Auditoria e Compressão Local de Mídia Sob Demanda)
Use 092Abdullah/AssetDiet (npm: assetdiet-mcp) estritamente como um CLI local efêmero 100% local via npx [email protected] — sem uploads para a nuvem e sem inflar sessões de chat com 16 ferramentas MCP permanentes.
1. Diretrizes Inegociáveis
- NUNCA registre o servidor MCP: Nunca execute
assetdiet setupouassetdiet mcp. Sempre invoque subcomandos CLI diretamente (audit,scan,optimize,restore,doctor). - Fixe a versão auditada (
[email protected]): Evite@latestsem trava em execuções automatizadas para que o comportamento corresponda ao release auditado. - Auditoria somente leitura antes de gravações: Sempre execute
auditprimeiro e mostre a economia potencial + grupos de duplicatas antes de modificar ativos do repositório (a menos que o usuário peça explicitamente para aplicar--policy safeimediatamente). - Proteção de Expo / React Native e ícones de aplicativos: Em projetos Expo / React Native (
app.json/app.config.ts), ícones nativos, telas de splash, ícones de notificação e ativosrequire('./foo.png')estáticos geralmente exigem extensões.png— mantenha--policy safe(mesma extensão, lossless/SSIM ≥ 0.98) a menos que esteja segmentando uma pasta web pura (public/,static/) com aprovação explícita do usuário para conversão para.webp.
2. Fluxo de Trabalho Passo a Passo
Etapa 1: Auditoria Somente Leitura (Zero Alterações em Arquivos)
# Resumo rápido de 3 linhas (tamanho total, economia, grupos de duplicatas SHA-256)
npx [email protected] audit <caminhoDestino> --policy safe --summary
# Detalhamento completo por arquivo (ou adicione --json para filtragem estruturada)
npx [email protected] audit <caminhoDestino> --policy safe
Etapa 2: Otimizar com Segurança usando Journal Atômico e Backup
- Política
safe(Padrão — Recomendada): Comprime no local (Sharplossless/85,SVGOmantendoviewBox), mantém as extensões de arquivo exatas, nunca toca em importações de código-fonte e remove cópias de bytes duplicadas apenas quando elas têm0referências de código:# Visualização opcional de dry-run npx [email protected] optimize <caminhoDestino> --policy safe --dry-run # Executa com backup atômico (.assetdiet/backups/<runId>/) npx [email protected] optimize <caminhoDestino> --policy safe - Política
balanced(Apenas web:.png/.jpg→.webp+ migração de referências de código — peça confirmação primeiro):
Apósnpx [email protected] optimize <caminhoDestino> --policy balanced --dry-run npx [email protected] optimize <caminhoDestino> --policy balancedbalanced, inspecione imediatamentegit statusegit diffem todas as importações.ts/.tsx/.jsx/.css/.htmlmodificadas e execute a build/typecheck do projeto.
Etapa 3: Reversão Instantânea e Higiene Git do .assetdiet/
- Salve o
ID da Execuçãoimpresso poroptimize. Se algum ativo parecer degradado ou uma importação quebrar, restaure os originais byte por byte em um comando:npx [email protected] restore --run <idExecucao> --path <caminhoDestino> - Nunca faça commit dos backups
.assetdiet/no Git: Certifique-se de que.assetdiet/esteja listado em.gitignore(ou exclua.assetdiet/assim que a verificação visual/build for aprovada e o usuário confirmar).