AssetDiet (주문형 로컬 미디어 감사 및 압축)
092Abdullah/AssetDiet (npm: assetdiet-mcp)을 에페메럴 100% 로컬 CLI로 엄격히 사용하세요 (npx [email protected]) — 클라우드 업로드 없음, 채팅 세션에 영구적인 16개 도구 MCP 스키마 블로트 없음.
1. 절대적 가드레일
- MCP 서버를 절대 등록하지 마세요:
assetdiet setup또는assetdiet mcp를 실행하지 마세요. 항상 CLI 하위 명령어를 직접 호출하세요 (audit,scan,optimize,restore,doctor). - 감사된 버전 고정 (
[email protected]): 자동화 실행 시 고정되지 않은@latest를 사용하지 마십시오. 공급망 동작이 감사된 릴리스와 일치해야 합니다. - 쓰기 전 읽기 전용 감사: 저장소 자산을 변경하기 전에 항상
audit를 먼저 실행하여 잠재적 절감량과 중복 그룹을 표시하십시오 (사용자가 즉시--policy safe적용을 명시적으로 요청하지 않은 경우). - Expo / React Native 및 앱 아이콘 보호: Expo / React Native 프로젝트(
app.json/app.config.ts)에서 네이티브 앱 아이콘, 스플래시 화면, 알림 아이콘 및 정적require('./foo.png')자산은 종종.png확장자가 필요합니다 — 순수 웹 폴더(public/,static/)를 대상으로 사용자의 명시적 승인 없이.webp변환을 하지 않는 한--policy safe(동일 확장자, 무손실/SSIM ≥ 0.98)를 유지하세요.
2. 단계별 워크플로우
1단계: 읽기 전용 감사 (파일 변경 없음)
# 빠른 3줄 점수판 요약 (전체 크기, 절감량, SHA-256 중복 그룹)
npx [email protected] audit <targetPath> --policy safe --summary
# 전체 파일별 분석 (또는 --json 추가하여 구조화된 필터링)
npx [email protected] audit <targetPath> --policy safe
2단계: 원자적 저널 및 백업으로 안전하게 최적화
safe정책 (기본값 — 권장): 제자리에서 압축 (Sharp무손실/85,viewBox유지하는SVGO), 정확한 파일 확장자 유지, 소스 코드 임포트는 건드리지 않으며, 코드 참조가 0개인 중복 바이트 복사본만 제거합니다:# 선택적 드라이런 미리보기 npx [email protected] optimize <targetPath> --policy safe --dry-run # 원자적 백업으로 실행 (.assetdiet/backups/<runId>/) npx [email protected] optimize <targetPath> --policy safebalanced정책 (웹 전용.png/.jpg→.webp+ 코드 참조 마이그레이션 — 먼저 확인 요청):npx [email protected] optimize <targetPath> --policy balanced --dry-run npx [email protected] optimize <targetPath> --policy balancedbalanced후 즉시 수정된 모든.ts/.tsx/.jsx/.css/.html임포트에 대해git status및git diff를 검사하고 프로젝트의 빌드/타입체크를 실행하세요.
3단계: 즉시 롤백 및 .assetdiet/ Git 위생
optimize가 출력한Run ID를 저장하세요. 자산이 손상되었거나 임포트가 깨진 경우 한 명령어로 바이트 단위 원본을 복원합니다:npx [email protected] restore --run <runId> --path <targetPath>.assetdiet/백업을 Git에 커밋하지 마세요:.assetdiet/가.gitignore에 나열되어 있는지 확인하세요 (또는 시각적/빌드 확인이 통과되고 사용자가 확인하면.assetdiet/를 삭제하세요).