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扩展名——请保持--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 safebalanced策略(仅限 Web.png/.jpg→.webp+ 代码引用迁移——先请求确认):
执行npx [email protected] optimize <targetPath> --policy balanced --dry-run npx [email protected] optimize <targetPath> --policy balancedbalanced后,立即检查git status和git diff所有修改过的.ts/.tsx/.jsx/.css/.html导入,并运行项目的构建/类型检查。
第三步:即时回滚与 .assetdiet/ Git 卫生
- 保存
optimize打印的Run ID。如果任何资产看起来降级或导入出错,使用一条命令逐字节恢复原始文件:npx [email protected] restore --run <runId> --path <targetPath> - 切勿将
.assetdiet/备份提交到 Git: 确保.assetdiet/已在.gitignore中列出(或者一旦视觉/构建验证通过且用户确认,直接删除.assetdiet/)。
可选:诊断与完整性检查
# 验证所有引用资产确实存在于磁盘上
npx [email protected] doctor <targetPath>