Communitygithub.com

AssetDiet(本地媒体资源审计与压缩)

按需通过 `npx [email protected]` CLI 审计、压缩、去重和回滚本地仓库中的媒体资产(PNG/JPG/WebP/AVIF 使用 Sharp,SVG 使用 SVGO,MP4/WebM 使用 FFmpeg,GLB/GLTF 3D 使用 glTF-Transform),无需永久 MCP 开销。

AssetDiet(本地媒体资源审计与压缩) 是什么?

AssetDiet 是一个按需运行的本地媒体审计与压缩工具,专为不常进行媒体优化的开发者和 AI 代理设计。它支持 PNG、JPG、WebP、AVIF、SVG、MP4、WebM、GLB 和 GLTF 等格式。其核心优势在于瞬间启动:通过 `npx [email protected]` CLI 直接调用,不注册 MCP 服务器,因此对聊天会话的永久工具架构毫无影响。工作流程强调安全:先执行只读审计,显示潜在节省空间和重复分组;然后使用原子备份进行安全优化;如有问题,可通过一次命令完全回滚。它特别保护 Expo/React Native 项目中的应用图标和闪屏,并防止破坏代码中的路径引用。三种策略(安全、平衡、激进)逐步提供侵入性,确保用户可以逐个级别推进,直至满意结果。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

AssetDiet(按需本地媒体审计与压缩)

使用 092Abdullah/AssetDiet(npm: assetdiet-mcp)严格作为一次性 100% 本地 CLI 通过 npx [email protected] 运行——零云端上传,且在聊天会话中零永久 16 工具 MCP 架构膨胀。

1. 不可协商的护栏

  1. 切勿注册 MCP 服务器: 切勿运行 assetdiet setup 或 assetdiet mcp。始终保持直接调用 CLI 子命令(audit、scan、optimize、restore、doctor)。
  2. 锁定已审计版本([email protected]): 在自动化运行中避免使用未固定的 @latest,以确保供应链行为匹配审计版本。
  3. 写入前进行只读审计: 始终先运行 audit 并显示潜在节省空间和重复分组,然后再修改仓库资产(除非用户明确要求立即应用 --policy safe)。
  4. Expo / React Native 及应用图标保护: 在 Expo / React Native 项目(app.json / app.config.ts)中,原生应用图标、启动屏、通知图标以及静态 require('./foo.png') 资源通常需要保留 .png 扩展名——请保持 --policy safe(相同扩展名,无损/SSIM ≥ 0.98),除非目标是纯 Web 文件夹(public/、static/)且用户明确批准转换为 .webp。

2. 分步工作流程

第一步:只读审计(零文件更改)

# 快速三行摘要卡片(总大小、节省空间、SHA-256 重复分组)
npx [email protected] audit <targetPath> --policy safe --summary

# 完整逐文件细分(或添加 --json 进行结构化筛选)
npx [email protected] audit <targetPath> --policy safe

第二步:使用原子日志与备份安全优化

  • safe 策略(默认——推荐): 原地压缩(Sharp 无损/85,SVGO 保留 viewBox),保持完全相同文件扩展名,绝不触碰源代码导入,且仅在重复字节副本具有 0 个代码引用时删除它们:
    # 可选干运行预览
    npx [email protected] optimize <targetPath> --policy safe --dry-run
    
    # 执行,附带原子备份(.assetdiet/backups/<runId>/)
    npx [email protected] optimize <targetPath> --policy safe
    
  • balanced 策略(仅限 Web .png/.jpg → .webp + 代码引用迁移——先请求确认):
    npx [email protected] optimize <targetPath> --policy balanced --dry-run
    npx [email protected] optimize <targetPath> --policy balanced
    
    执行 balanced 后,立即检查 git status 和 git diff 所有修改过的 .ts/.tsx/.jsx/.css/.html 导入,并运行项目的构建/类型检查。

第三步:即时回滚与 .assetdiet/ Git 卫生

  1. 保存 optimize 打印的 Run ID。如果任何资产看起来降级或导入出错,使用一条命令逐字节恢复原始文件:
    npx [email protected] restore --run <runId> --path <targetPath>
    
  2. 切勿将 .assetdiet/ 备份提交到 Git: 确保 .assetdiet/ 已在 .gitignore 中列出(或者一旦视觉/构建验证通过且用户确认,直接删除 .assetdiet/)。

可选:诊断与完整性检查

# 验证所有引用资产确实存在于磁盘上
npx [email protected] doctor <targetPath>

相关技能