Communitygithub.com

asset-diet

在本地儲存庫中審計、壓縮、去重與回滾媒體資產(PNG/JPG/WebP/AVIF、SVG、MP4/WebM、GLB/GLTF),透過 `npx [email protected]` CLI 隨需執行,無需永久 MCP 開銷。

asset-diet 是什麼?

AssetDiet 是一個專為開發者設計的本地媒體資產最佳化工具,以 MCP(Model Context Protocol)伺服器形式封裝,但嚴格以臨時 CLI 模式操作(使用 `npx [email protected]`),避免在對話中引入永久性的 16 工具 MCP 結構膨脹。它支援對 PNG、JPG、WebP、AVIF(透過 Sharp)、SVG(透過 SVGO)、MP4、WebM(透過 FFmpeg)以及 GLB/GLTF 3D 模型(透過 glTF-Transform)進行安全審計、壓縮與去重。核心工作流程要求先執行唯讀審計以顯示潛在節省空間與重複群組,再以原子備份機制進行壓縮,並支援即時回滾。它特別保護 Expo/React Native 專案中的圖示與啟動畫面,預設採用安全策略(保留原副檔名、無損或 SSIM ≥ 0.98),僅在用戶明確同意下才轉換為 WebP 格式。

相容平台~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),除非目標為純網頁資料夾(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 safe
    
  • balanced 策略(僅網頁 .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 導入,並執行專案的建置/型別檢查。

步驟 3:即時回滾與 .assetdiet/ Git 衛生習慣

  1. 儲存 optimize 印出的 Run ID。如果任何資產看起來品質下降或導入中斷,使用一個命令按位元組還原原始檔案:
    npx [email protected] restore --run <runId> --path <targetPath>
    
  2. 永遠不要將 .assetdiet/ 備份提交到 Git: 確保 .assetdiet/ 已列在 .gitignore 中(或者在視覺/建置驗證通過且用戶確認後刪除 .assetdiet/)。

相關技能