LightFile Nextコマンドの変更点
旧LightFileからLightFile Shotへのコマンドラインオプションの対応表
旧LightFile（v6.0.0未満）から新しいLightFile Shotへのコマンドラインオプションの主な変更点をまとめています。
基本構文の変更
旧LightFile
lightfile --file-system local --dir <path> [options]
# または
lightfile <path> [options]LightFile Shot
lightfile-shot [source] [destination] [options]LightFile Shotはローカルファイルシステムのみに対応しているため、ファイルシステムの指定は不要です。
主なオプションの変更
| 機能 | 旧LightFile | LightFile Shot | 備考 |
|---|---|---|---|
| ライセンス | |||
| ライセンス認証 | --serial <code> | --license-token <token> | 環境変数LF_TOKENも使用可能 |
| ファイルシステム | |||
| FS種類指定 | --file-system local | （指定不要） | ローカルのみ対応 |
| ディレクトリ指定 | --dir <path> | 位置引数[source] | - |
| 出力先指定 | （上書きのみ） | 位置引数[destination] | 省略時は上書き |
| ファイルフィルタ | |||
| ファイルサイズ | --file-size min-max | --min-size, --max-size | 個別のオプションに分離 |
| 対象パターン | --only <pattern> | --include <pattern> | - |
| 除外パターン | --ignore <pattern> | --exclude <pattern> | 名称変更 |
| 更新日時フィルタ | --recent <duration> | ❌ 廃止 | - |
| 画質設定 | |||
| 画質レベル | --quality <level> | --quality <level> | 変更なし |
| JPEG画質 | --jpeg-quality <level> | --jpeg-quality <level> | 変更なし |
| PNG画質 | --png-quality <level> | --png-quality <level> | 変更なし |
| ログ | |||
| ログレベル | --logging <level> | --log-level <level> | 名称変更 |
| 静音モード | --logging quiet | --quiet, -q | 短縮形追加 |
| ジャーナル出力 | ❌ なし | --journal <file> | 新機能 |
| 並列処理 | |||
| 順次処理 | --serial | デフォルト | - |
| 並列処理 | デフォルト | --concurrency N, -j N | 並列数を明示的に指定 |
| ドライラン | |||
| テスト実行 | --dry-run | --dry-run, -n | 短縮形追加 |
| 通知 | |||
| Email通知 | --fatal-notify-email | ❌ 廃止 | - |
| Slack通知 | --fatal-notify-slack-* | ❌ 廃止 | - |
ファイル指定の変更
旧LightFile
# ディレクトリを処理
lightfile --dir /path/to/images
# 単一ファイルを処理
lightfile --file /path/to/image.jpgLightFile Shot
# ディレクトリを処理（上書き）
lightfile-shot /path/to/images
# ディレクトリを処理（別ディレクトリに出力）
lightfile-shot /path/to/images /path/to/output
# 単一ファイルを処理（上書き）
lightfile-shot /path/to/image.jpg
# 単一ファイルを処理（別ファイルに出力）
lightfile-shot /path/to/image.jpg /path/to/output.jpgLightFile Shotは位置引数でソースと出力先を指定します。出力先を省略すると上書きモードになります。
廃止されたオプション
以下のオプションは新バージョンで廃止されました：
| 旧オプション | 理由 | 代替手段 |
|---|---|---|
--serial | ライセンス形式変更 | --license-tokenを使用 |
--file-system | ローカルのみ対応 | 指定不要 |
--recent | 使用頻度が低い | ファイルシステムの機能を利用 |
--analyze | 機能統合 | 自動的に分析実行 |
--http-verify | ローカルのみ対応 | 不要 |
--file-error-retry | 自動化 | リトライは自動実行 |
--pid | 自動化 | 排他制御は不要（Shot） |
--proxy | ローカルのみ対応 | 不要 |
--verify-size | 機能統合 | 自動的に検証 |
--logs-file-size | ログ出力方式変更 | ログはstdoutへ |
--logs-file-backups | ログ出力方式変更 | ログはstdoutへ |
--slack-log | 使用頻度が低い | 廃止 |
--fast-scan | デフォルト動作に統合 | 不要 |
--format | 使用頻度が低い | 廃止 |
--fatal-notify-email | 使用頻度が低い | 廃止 |
--fatal-notify-slack-* | 使用頻度が低い | 廃止 |
新しく追加されたオプション
LightFile Shotで新しく追加された主なオプション：
ジャーナル出力
lightfile-shot /path/to/images --journal results.ndjson処理結果をNDJSON（改行区切りJSON）形式で出力します。各行は以下の情報を含みます：
{"path":"image.jpg","status":"optimized","beforeSize":102400,"afterSize":51200}
{"path":"photo.png","status":"skipped","reason":"already optimized"}詳細はジャーナルファイルを参照してください。
言語選択
# 日本語ログ
LANG=ja lightfile-shot /path/to/images
# 英語ログ
LANG=en lightfile-shot /path/to/images詳細は言語設定を参照してください。
使用状況レポート無効化
lightfile-shot /path/to/images --no-reporting詳細は使用状況レポートを参照してください。
ライセンストークンの指定方法
優先順位
- コマンドラインオプション:
--license-token <token> - 環境変数:
LF_TOKEN - ファイル:
~/.lightfile-next/token
旧版との違い
旧LightFile:
lightfile --serial ABC123-XYZ789 /path/to/imagesLightFile Shot:
# オプションで指定
lightfile-shot --license-token 'username!base64_signature' /path/to/images
# 環境変数で指定（推奨）
export LF_TOKEN='username!base64_signature'
lightfile-shot /path/to/images
# ファイルで指定
echo 'username!base64_signature' > ~/.lightfile-next/token
lightfile-shot /path/to/images環境変数やファイルでの指定により、コマンドラインにライセンス情報を含める必要がなくなり、セキュリティが向上します。
ログレベルの変更
旧LightFile
lightfile --logging normal /path/to/images # 通常ログ
lightfile --logging debug /path/to/images # デバッグログ
lightfile --logging quiet /path/to/images # 静音モードLightFile Shot
lightfile-shot --log-level info /path/to/images # 通常ログ
lightfile-shot --log-level debug /path/to/images # デバッグログ
lightfile-shot --quiet /path/to/images # 静音モード--quietオプションはすべての出力を完全に無効化します（エラーメッセージも含む）。結果確認には--journalオプションの使用を推奨します。
詳細はログレベル設定を参照してください。
並列処理の変更
旧LightFile
# デフォルトで並列処理（CPUコア数に応じて自動）
lightfile /path/to/images
# 順次処理
lightfile --serial /path/to/imagesLightFile Shot
# デフォルトは順次処理
lightfile-shot /path/to/images
# 並列処理（4並列）
lightfile-shot --concurrency 4 /path/to/images
lightfile-shot -j 4 /path/to/images
# CPUコア数に応じて自動設定
lightfile-shot -j 0 /path/to/images新バージョンでは並列数を明示的に指定します。-j 0を指定すると、システムのCPUコア数に応じて自動的に並列数が設定されます。
出力先の変更
旧LightFileは常に上書きでしたが、LightFile Shotは別ディレクトリへの出力に対応しています。
上書きモード（旧版と同じ）
lightfile-shot /path/to/images別ディレクトリへの出力（新機能）
# ディレクトリを別ディレクトリに出力
lightfile-shot /path/to/images /path/to/output
# 単一ファイルを別ファイルに出力
lightfile-shot image.jpg optimized.jpg詳細はクイックスタートを参照してください。
次のステップ
- 旧LightFileからの移行 - 移行手順の詳細
- 機能比較表 - 機能の詳細比較
- クイックスタート - LightFile Shotの基本的な使い方