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),除非目標為純網頁資料夾(public/、static/)且有明確的用戶批准轉換為.webp。
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,SVGO保留viewBox),保留精確的副檔名,絕不觸碰原始碼導入,且僅在重複位元組副本有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之後,立即檢查git status與git diff中所有修改過的.ts/.tsx/.jsx/.css/.html導入,並執行專案的建置/型別檢查。
步驟 3:即時回滾與 .assetdiet/ Git 衛生習慣
- 儲存
optimize印出的Run ID。如果任何資產看起來品質下降或導入中斷,使用一個命令按位元組還原原始檔案:npx [email protected] restore --run <runId> --path <targetPath> - 永遠不要將
.assetdiet/備份提交到 Git: 確保.assetdiet/已列在.gitignore中(或者在視覺/建置驗證通過且用戶確認後刪除.assetdiet/)。