baoyu-compress-image

baoyu-compress-image

システムで利用可能な最適な CLI ツール（sips、cwebp、convert、または sharp）を使って、画像を自動圧縮します。

このスクリプトは、Obsidian Creator Vault 向けに特別に調整されています。

• Web 向けの高速処理：デフォルトでは、品質を 65 に設定した .jpg を生成します（ほとんどのプラットフォームの 1 MB 未満という制限に適しています）。
• Vault をすっきり保つ：デフォルトモード（置き換え）で実行しても、Assets/ に _original ファイルが増えることはありません。代わりに、変更前の元ファイルを Archive/Original-Images/ にバックアップします。
• 依存関係のサンドボックス化：ランタイムはすべて bun 経由で実行され、.agents/skills 内に隔離されます。

インストールとシステム要件

このスクリプトは OS を自動検出し、次の順序で利用可能な最速かつ最高品質の画像エンジンを使用します。

1. macOS sips（組み込み、強く推奨）
   macOS には sips が標準搭載されています。インストールは不要です。
   （内部では sips -s format jpeg -s formatOptions 65 <input> --out <output> を実行します）

2. cwebp（WebP 形式を出力する場合に最適）

   • macOS：brew install webp
   • Ubuntu/Debian：sudo apt install webp

3. ImageMagick（convert）

   • macOS：brew install imagemagick
   • Linux：sudo apt install imagemagick

4. sharp（Windows／ネイティブ環境以外での Node.js フォールバック）
   ローカルで bun install コマンドを実行すると、自動的にインストールされます。sharp エンジンは外部バイナリを必要とせず、libvips を使って圧縮します。

初回セットアップ（TS 環境）：

cd .agents/skills/baoyu-compress-image
bun install

使い方

Vault のルートから bun を使ってスクリプトを実行します。

bun .agents/skills/baoyu-compress-image/scripts/main.ts <input> [options]

オプション

オプション	短縮形	説明	デフォルト
<input>		入力対象（ファイルまたはディレクトリ）	必須
--output	-o	出力先のファイルパスを指定	入力と同じディレクトリ
--format	-f	出力形式（jpeg、webp、png）	jpeg
--quality	-q	品質レベル 0-100	65
--keep	-k	元ファイルをその場に保持（アーカイブしない）	false
--recursive	-r	ディレクトリを再帰的に処理	false

使用例とワークフロー

1. 生成した AI 画像を公開用に圧縮する（デフォルト）

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/cover-draft.png

効果：Assets/cover-draft.jpg を作成し、cover-draft.png は安全に移動して Archive/Original-Images/ に保管します。

2. 画像を圧縮し、WebP 形式で保持する

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/screenshot.png -f webp

3. 品質を手動で変えてテストし、元ファイルをその場に保持する

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/photo.png -q 80 --keep

4. ディレクトリ全体を一括圧縮する

bun .agents/skills/baoyu-compress-image/scripts/main.ts "00 Inbox/" -r