Communitygithub.com

AssetDiet (Dieta de Ativos)

Audite, comprima, deduplique e reverta ativos de mídia do repositório local (PNG/JPG/WebP/AVIF via Sharp, SVG via SVGO, MP4/WebM via FFmpeg, GLB/GLTF 3D via glTF-Transform) sob demanda via CLI `npx [email protected]`, sem sobrecarga permanente de MCP.

O que é AssetDiet (Dieta de Ativos)?

O AssetDiet é uma ferramenta de linha de comando local e efêmera para auditoria e compressão de ativos de mídia em repositórios de desenvolvimento. Ele suporta uma ampla gama de formatos: imagens (PNG, JPG, WebP, AVIF) via Sharp, SVG via SVGO, vídeos (MP4, WebM) via FFmpeg e modelos 3D (GLB, GLTF) via glTF-Transform. A ferramenta opera exclusivamente via `npx [email protected]`, eliminando a necessidade de registro permanente de servidor MCP, o que evita inflar sessões de chat com dezenas de ferramentas desnecessárias. O fluxo recomendado começa com uma auditoria somente leitura para identificar economias potenciais e grupos de duplicatas, seguida por otimização segura com política `safe` (compressão local, sem alteração de extensões) ou `balanced` (conversão para WebP e migração de referências de código, sujeita a confirmação). Um recurso crítico é o backup atômico e a restauração instantânea via ID de execução, garantindo que qualquer ativo degradado ou importação quebrada possa ser revertida para o original exato. O AssetDiet é ideal para desenvolvedores que precisam reduzir o tamanho de ativos em projetos Expo/React Native ou web, mantendo a integridade dos arquivos e a rastreabilidade.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. NUNCA registre o servidor MCP: Nunca execute assetdiet setup ou assetdiet mcp. Sempre invoque subcomandos CLI diretamente (audit, scan, optimize, restore, doctor).
  2. Fixe a versão auditada ([email protected]): Evite @latest sem trava em execuções automatizadas para que o comportamento corresponda ao release auditado.
  3. Auditoria somente leitura antes de gravações: Sempre execute audit primeiro 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 safe imediatamente).
  4. 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 ativos require('./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 (Sharp lossless/85, SVGO mantendo viewBox), 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êm 0 referê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):
    npx [email protected] optimize <caminhoDestino> --policy balanced --dry-run
    npx [email protected] optimize <caminhoDestino> --policy balanced
    
    Após balanced, inspecione imediatamente git status e git diff em todas as importações .ts/.tsx/.jsx/.css/.html modificadas e execute a build/typecheck do projeto.

Etapa 3: Reversão Instantânea e Higiene Git do .assetdiet/

  1. Salve o ID da Execução impresso por optimize. 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>
    
  2. 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).

Habilidades Relacionadas