AssetDiet(オンデマンドローカルメディア監査・圧縮) は何をしますか?
092Abdullah/AssetDiet(npm: assetdiet-mcp)を、npx [email protected] を介して一時的な100%ローカルCLIとして厳密に使用します。クラウドへのアップロードは一切なく、チャットセッションに永続的な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拡張子を維持する必要があります。純粋なWebフォルダ(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)、ファイル拡張子をそのまま維持し、ソースコードのインポートには一切触れず、コード参照がゼロの場合にのみ重複バイトコピーを削除します。# オプションのドライランによるプレビュー 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のインポートを確認し、プロジェクトのビルド/型チェックを実行します。
ステップ 3: 即時ロールバックと .assetdiet/ のGit管理
optimizeによって出力されたRun IDを保存します。アセットが劣化したように見えたり、インポートが壊れたりした場合は、1つのコマンドでバイト単位のオリジナルを復元します。npx [email protected] restore --run <runId> --path <targetPath>.assetdiet/のバックアップをGitにコミットしないでください:.assetdiet/が.gitignoreにリストされていることを確認するか(または、ビジュアル/ビルド検証が合格し、ユーザーが確認したら.assetdiet/を削除してください)。