LightFile Shotの概要

LightFile Shotは、ローカルファイルシステム上の画像ファイルを自動的に最適化するCLIツールです。

主な特徴

• 画像形式のサポート - JPEG、PNG形式の画像ファイルを最適化
• 2つの動作モード - 上書きモード（デフォルト）/ 複製モード
• 柔軟なフィルタリング - ファイルサイズ、拡張子、パターンマッチングによる対象ファイルの絞り込み
• 品質設定 - 低・中・高の3段階で画質を調整可能
• 並列処理 - 複数ファイルの同時処理に対応
• ライセンス管理 - トークンベースのライセンス認証

実行ファイル名

このプログラムの実行ファイル名は lightfile-shot です。

# LightFile Shotの概要
lightfile-shot /path/to/images

# ヘルプ表示
lightfile-shot --help

# バージョン表示
lightfile-shot --version

動作モード

上書きモード（デフォルト）

元のファイルを最適化して上書き保存します。

# 単一ディレクトリの最適化
lightfile-shot /path/to/images

# カレントディレクトリの最適化
lightfile-shot .

# 単一ファイルの最適化
lightfile-shot /path/to/image.jpg

複製モード

別のディレクトリに最適化したファイルを保存します。元のファイルは変更されません。

# ディレクトリからディレクトリへ
lightfile-shot /path/to/source /path/to/destination

# ファイルからファイルへ
lightfile-shot /path/to/source.jpg /path/to/optimized.jpg

注意事項:

• 第1引数がファイルの場合、第2引数も出力ファイルパスを指定してください（既存ディレクトリを指定するとエラーになります）
• 第1引数がディレクトリの場合、第2引数も出力ディレクトリパスを指定してください（既存ファイルを指定するとエラーになります）

処理の流れ

1. ライセンス検証 - ライセンストークンの有効性を確認
2. 設定検証 - コマンドライン引数と設定ファイルの整合性をチェック
3. スキャンフェーズ - 対象ファイルを検索・リストアップ
4. 最適化フェーズ - 各ファイルを順次または並列で最適化
5. 結果レポート - 処理結果のサマリーを表示

対応画像形式

対応拡張子（デフォルト）: .jpg, .jpeg, .jfif, .png

注意: GIFやWebPは最適化対象外です。--extオプションで明示的に追加することはできますが、処理すると「unsupported image format」としてエラー記録されます。

最適化の仕組み

JPEG最適化

• 画質を保ちながらファイルサイズを削減
• メタデータの最適化
• プログレッシブJPEGへの変換オプション

PNG最適化

• 可逆圧縮による最適化
• カラーパレットの最適化
• 不要なチャンクの削除

処理済みファイルの管理

lightfile-shotは処理済みファイルの情報を記録しません。毎回すべてのファイルを対象として処理を試みますが、すでに最適化されているファイルはスキップされます。