images-convert 0.4.1

data/lib/images_convert.rb

@@ -0,0 +1,1557 @@
+  def clamp_pdf_density(value)
+    return ImagesConvert::Configuration.default_output_pdf_density if value.nil?
+    v = value.to_i
+    v = 1200 if v > 1200
+    v = 72 if v < 72
+    v
+  end
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require 'thor'
+require 'fileutils'
+require 'time'
+if ENV['IMGCONV_TEST_FAKE_MINIMAGICK'] == '1'
+  require_relative 'images_convert/mini_magick_stub'
+else
+  require 'mini_magick'
+end
+require 'rbconfig'
+require_relative 'images_convert/version'
+require_relative 'images_convert/configuration'
+require_relative 'images_convert/cleanup'
+require_relative 'waifu2x'
+
+# ImageMagickがインストールされているかチェック（未導入なら最小限の対話で導入を試みる）
+def imagemagick_installed?
+  system('which magick > /dev/null 2>&1') || system('which convert > /dev/null 2>&1')
+end
+
+unless imagemagick_installed?
+  puts "ImageMagick が見つかりません。今すぐインストールしますか？ [Y/n]"
+  print "> "
+  answer = (STDIN.gets || "").strip
+  answer = 'y' if answer.empty?
+
+  if answer.downcase.start_with?('y')
+    ostype = RbConfig::CONFIG['host_os']
+    success = false
+
+    if ostype =~ /darwin/
+      if system('which brew > /dev/null 2>&1')
+        puts "Homebrew で ImageMagick をインストールします..."
+        success = system('brew install imagemagick')
+      else
+        puts "Homebrew が見つかりません。https://brew.sh/ からインストールしてください。"
+      end
+    elsif ostype =~ /linux/
+      if system('which apt-get > /dev/null 2>&1')
+        puts "apt-get で ImageMagick をインストールします（sudo が必要な場合があります）..."
+        success = system('sudo apt-get update && sudo apt-get install -y imagemagick')
+      elsif system('which yum > /dev/null 2>&1')
+        puts "yum で ImageMagick をインストールします（sudo が必要な場合があります）..."
+        success = system('sudo yum install -y ImageMagick')
+      elsif system('which dnf > /dev/null 2>&1')
+        puts "dnf で ImageMagick をインストールします（sudo が必要な場合があります）..."
+        success = system('sudo dnf install -y ImageMagick')
+      else
+        puts "対応するパッケージマネージャが見つかりませんでした。"
+      end
+    else
+      puts "このOSでは自動インストールに対応していません。"
+      puts "Windows はインストーラから導入してください: https://imagemagick.org/script/download.php#windows"
+    end
+
+    if success && imagemagick_installed?
+      puts "ImageMagick のインストールが完了しました。"
+    else
+      puts "ImageMagick の自動インストールに失敗しました。手動でのインストールをお願いします。"
+      puts "  macOS: brew install imagemagick"
+      puts "  Ubuntu/Debian: sudo apt-get install -y imagemagick"
+      puts "  CentOS/RHEL/Fedora: sudo yum/dnf install -y ImageMagick"
+      exit 1
+    end
+  else
+    puts "ImageMagick が必要です。後で以下のいずれかでインストールしてください:"
+    puts "  macOS: brew install imagemagick"
+    puts "  Ubuntu/Debian: sudo apt-get install -y imagemagick"
+    puts "  CentOS/RHEL/Fedora: sudo yum/dnf install -y ImageMagick"
+    puts "  Windows: https://imagemagick.org/script/download.php#windows"
+    exit 1
+  end
+end
+
+# images_convert.rb: Thorベースの画像変換スクリプト
+# 形式やリサイズ、入出力ディレクトリは設定値を使用（config コマンドで変更可能）
+
+class ImagesConvertCLI < Thor
+  include Thor::Actions
+
+  DOWNLOADS_DIR = "#{ENV['HOME']}/Downloads"
+
+  # コマンド名を imgconv に設定（短縮形として imgconv を使用）
+  def self.command_name
+    'imgconv'
+  end
+
+  # `images-convert --version` / `images-convert -v` に対応
+  map %w[-v --version] => :version
+  # `images-convert --help` / `images-convert -h` に対応（Thor の help にマップ）
+  map %w[-h --help] => :help
+  # 引数なし実行時は help を表示
+  default_task :help
+  desc 'version', 'バージョン情報を表示'
+  def version
+    say "images-convert #{ImagesConvert::VERSION}"
+  end
+
+  def help(command = nil, subcommand = false)
+    if command
+      if command.to_s == 'convert'
+        say <<~HELP
+          Usage:
+            imgconv convert TARGET [DEST_DIR]
+
+          Options:
+            -i, --input-dir=INPUT_DIR        入力ディレクトリ（デフォルト: 設定値または ~/Downloads）
+            -o, --output=OUTPUT              出力ファイルパス（単一ファイル変換時、ディレクトリ指定時は出力ディレクトリ）
+                --output-dir=OUTPUT_DIR      出力ディレクトリ（単一ファイル時）
+            -d, --delete                     変換後に元のファイルを削除
+            -f, --overwrite                  既存の出力ファイルがある場合に上書き
+            -s, --suffix=SUFFIX              出力ファイル名の末尾に付与するサフィックス（例: _converted）
+                --recursive                  ディレクトリを再帰的に処理（一括変換時）
+                --resize=RESIZE              リサイズ値（例: 1920x, 50%）
+                --latest=N                   最新の画像ファイル N 件を変換（入力ディレクトリ内から）
+                --latest-exif                 最新 N 件の選定を EXIF 撮影日時に基づいて行う（--latest と併用）
+                --all                         入力ディレクトリ内の対象画像をすべて変換
+                --from=FROM                  入力形式（設定を一時的に上書き）
+                --to=TO                      出力形式（設定を一時的に上書き）
+
+          Description:
+            使い方:
+
+              images-convert [convert] TARGET [DEST_DIR] [オプション]
+              imgconv [convert] TARGET [DEST_DIR] [オプション]
+
+            動作:
+              - TARGET がファイル名/番号の場合は単一ファイル変換（-i/-o で入出力ディレクトリ指定可）
+              - TARGET がディレクトリの場合は一括変換（DEST_DIR 未指定時は in-place 変換）
+
+            主なオプション:
+              -i, --input-dir=DIR       入力ディレクトリ（単一ファイル時）
+              -o, --output-dir=DIR      出力ディレクトリ（単一ファイル時）
+              -d, --delete              変換後に元ファイルを削除
+              -f, --overwrite           既存の出力ファイルがある場合に上書き
+              -s, --suffix=SUFFIX       出力ファイル名の末尾に付与（例: _web）
+              --recursive               ディレクトリを再帰的に処理（一括変換時）
+
+            例:
+              # 1枚だけ変換（番号指定、入出力ディレクトリや変換形式は既定値）
+              images-convert [convert] 1234
+              # または短縮コマンド
+              imgconv [convert] 1234
+
+              # 1枚だけ変換（ファイル名指定、入出力ディレクトリを明示）
+              images-convert [convert] IMG_0001 ~/Downloads ~/Downloads
+
+              # 一括変換（in-place）
+              images-convert [convert] ./photos
+
+              # 一括変換（出力先を別ディレクトリ、再帰処理、サフィックス付与）
+              images-convert [convert] ./photos ./export --recursive --suffix _resized
+        HELP
+      else
+        super
+      end
+    else
+      say <<~HELP
+        Commands:
+          imgconv [convert] TARGET [INPUT_DIR] [OUTPUT_DIR]  # 単一ファイル変換（TARGET=ファイル名/番号）
+          imgconv [convert] INPUT_DIR [OUTPUT_DIR]           # 一括変換
+          imgconv config                                     # 現在の設定を表示
+          imgconv set FROM TO [RESIZE]                       # 変換形式、リサイズ値の既定値を設定
+          imgconv set-dir INPUT_DIR OUTPUT_DIR               # 入出力ディレクトリの既定値を設定
+          imgconv --help                                     # 利用可能なコマンド一覧を表示
+          imgconv [COMMAND] --help                           # 各コマンドの詳細を表示
+          imgconv --version                                  # バージョン情報を表示
+      HELP
+    end
+  end
+
+  method_option :scale, type: :numeric, desc: 'waifu2x の既定倍率を設定（set-waifu2x サブコマンドで使用）'
+  method_option :noise, type: :numeric, desc: 'waifu2x のノイズ除去レベル（set-waifu2x サブコマンドで使用）'
+  method_option :model, type: :string, desc: 'waifu2x のモデルエイリアス（set-waifu2x サブコマンドで使用）'
+  method_option :auto_scale_a4, type: :boolean, desc: 'A4自動スケールの有効/無効（set-waifu2x サブコマンド）'
+  method_option :a4_print, type: :boolean, desc: 'A4レイアウトPDFの有効/無効（set-waifu2x サブコマンド）'
+  method_option :image_format, type: :string, desc: 'waifu2x 出力フォーマット（set-waifu2x サブコマンドで使用）'
+  method_option :on_error, type: :string, enum: %w[skip stop], desc: 'waifu2x エラー時の動作（set-waifu2x サブコマンド）'
+  method_option :quality, type: :numeric, desc: 'waifu2x 出力品質（set-waifu2x サブコマンド）'
+  desc 'config [SUBCOMMAND]', '現在の設定を表示、または設定を変更（subcommand: set/set-dir/set-waifu2x/set-output/reset）'
+  method_option :force, type: :boolean, default: false, desc: '確認なしでリセットを実行'
+  def config(*args)
+    if args.first.to_s == 'reset'
+      unless options[:force]
+        say '設定ファイルを既定値に戻します。よろしいですか？ [y/N]'
+        print '> '
+        answer = (STDIN.gets || '').strip.downcase
+        unless %w[y yes].include?(answer)
+          say 'リセットをキャンセルしました。'
+          return
+        end
+      end
+
+      ImagesConvert::Configuration.reset_to_defaults
+      say '設定を既定値にリセットしました。'
+      say ''
+      say '現在の設定:'
+      show_config_summary
+      return
+    end
+
+    # サブコマンド: set FROM TO RESIZE
+    if args.first.to_s == 'set'
+      _, from, to, resize = args
+      unless from && to && resize
+        say "使い方: images-convert config set FROM TO RESIZE", :red
+        exit 1
+      end
+      ImagesConvert::Configuration.save_defaults(from: from, to: to, resize: resize)
+      say "設定を変更しました:"
+      say "  デフォルト入力形式: #{from}"
+      say "  デフォルト出力形式: #{to}"
+      say "  デフォルトリサイズ: #{resize}"
+      return
+    end
+
+    # サブコマンド: set-dir INPUT_DIR OUTPUT_DIR
+    if args.first.to_s == 'set-dir'
+      _, input_dir, output_dir = args
+      unless input_dir && output_dir
+        say "使い方: images-convert config set-dir INPUT_DIR OUTPUT_DIR", :red
+        exit 1
+      end
+      ImagesConvert::Configuration.save_directories(input_dir: input_dir, output_dir: output_dir)
+      say "ディレクトリ設定を変更しました:"
+      say "  デフォルト入力ディレクトリ: #{input_dir}"
+      say "  デフォルト出力ディレクトリ: #{output_dir}"
+      return
+    end
+
+    if args.first.to_s == 'set-latest-mode'
+      _, mode = args
+      unless mode
+        say "使い方: images-convert config set-latest-mode MODE (mtime/exif)", :red
+        exit 1
+      end
+
+      normalized = mode.to_s.downcase
+      begin
+        ImagesConvert::Configuration.save_latest_mode(normalized)
+      rescue ArgumentError => e
+        say "エラー: #{e.message}", :red
+        exit 1
+      end
+
+      say "最新判定モードを #{normalized} に設定しました。"
+      return
+    end
+
+    if args.first.to_s == 'set-waifu2x'
+      new_scale = if options[:scale]
+                    clamp_waifu2x_scale(options[:scale])
+                  else
+                    ImagesConvert::Configuration.default_waifu2x_scale
+                  end
+
+      new_noise = if options[:noise]
+                    clamp_waifu2x_noise(options[:noise])
+                  else
+                    ImagesConvert::Configuration.default_waifu2x_noise
+                  end
+
+      new_model = options[:model] || ImagesConvert::Configuration.default_waifu2x_model
+
+      auto_scale_default = ImagesConvert::Configuration.default_waifu2x_auto_scale_a4
+      new_auto_scale = options[:auto_scale_a4].nil? ? auto_scale_default : options[:auto_scale_a4]
+
+      a4_print_default = ImagesConvert::Configuration.default_waifu2x_a4_print
+      new_a4_print = options[:a4_print].nil? ? a4_print_default : options[:a4_print]
+
+      if options[:image_format]
+        normalized_format = normalize_waifu2x_output_format(options[:image_format])
+        unless %w[png jpg jpeg webp].include?(normalized_format)
+          say "エラー: waifu2x 出力フォーマットは png/jpg/jpeg/webp のいずれかを指定してください。", :red
+          exit 1
+        end
+      end
+      new_image_format = if options[:image_format]
+                           normalize_waifu2x_output_format(options[:image_format])
+                         else
+                           normalize_waifu2x_output_format(ImagesConvert::Configuration.default_waifu2x_image_format)
+                         end
+
+      new_on_error = options[:on_error] || ImagesConvert::Configuration.default_waifu2x_on_error
+
+      ImagesConvert::Configuration.save_waifu2x_settings(
+        scale: new_scale,
+        noise: new_noise,
+        model: new_model,
+        auto_scale_a4: new_auto_scale,
+        a4_print: new_a4_print,
+        image_format: new_image_format,
+        on_error: new_on_error
+      )
+
+      say "waifu2x 設定を更新しました:"
+      say "  拡大率: #{new_scale}"
+      say "  ノイズ除去レベル: #{new_noise}"
+      say "  モデル: #{new_model}"
+      say "  A4自動スケール: #{new_auto_scale}"
+      say "  A4レイアウトPDF: #{new_a4_print}"
+      say "  出力フォーマット: #{new_image_format}"
+      say "  エラー時の動作: #{new_on_error}"
+      return
+    end
+
+    if args.first.to_s == 'set-output'
+      new_image_quality = if options[:image_quality]
+                            clamp_output_quality(options[:image_quality])
+                          else
+                            ImagesConvert::Configuration.default_output_image_quality
+                          end
+
+      new_pdf_quality = if options[:pdf_quality]
+                          clamp_output_quality(options[:pdf_quality])
+                        else
+                          ImagesConvert::Configuration.default_output_pdf_quality
+                        end
+
+      new_pdf_compression = if options[:pdf_compression]
+                              normalized = options[:pdf_compression].to_s.strip.downcase
+                              %w[jpeg jpeg2000 zip].include?(normalized) ? normalized : ImagesConvert::Configuration.default_output_pdf_compression
+                            else
+                              ImagesConvert::Configuration.default_output_pdf_compression
+                            end
+
+      new_pdf_density = if options[:pdf_density]
+                          clamp_pdf_density(options[:pdf_density])
+                        else
+                          ImagesConvert::Configuration.default_output_pdf_density
+                        end
+
+      ImagesConvert::Configuration.save_output_settings(
+        image_quality: new_image_quality,
+        pdf_quality: new_pdf_quality,
+        pdf_compression: new_pdf_compression,
+        pdf_density: new_pdf_density
+      )
+
+      say "出力設定を更新しました:"
+      say "  画像品質: #{new_image_quality}"
+      say "  PDF 品質: #{new_pdf_quality}"
+      say "  PDF 圧縮方式: #{new_pdf_compression}"
+      say "  PDF DPI: #{new_pdf_density}"
+      return
+    end
+
+    # それ以外（引数なし）は現在の設定を表示
+    settings = ImagesConvert::Configuration.show_all_settings
+
+    # 初回実行時はメッセージが既に表示されているので、改行だけ
+    puts "" unless ImagesConvert::Configuration.first_run_message_displayed?
+
+    show_config_summary(settings)
+
+    say "設定を変更するには:"
+    say "  images-convert set FROM TO RESIZE"
+    say "  images-convert set-dir INPUT_DIR OUTPUT_DIR"
+    say "  images-convert set-latest-mode MODE (mtime/exif)"
+    say "  images-convert set-waifu2x [--scale N --noise N --model TYPE --no-auto-scale-a4 --no-a4-print --image-format FORMAT --on-error skip]"
+    say "  images-convert set-output [--image-quality N --pdf-quality N --pdf-compression TYPE --pdf-density DPI]"
+  end
+
+  desc 'setup', '対話形式で設定を更新'
+  def setup
+    say '=== images-convert 設定ウィザード ===', :green
+    say 'Enter キーのみで現在の設定値を維持できます。'
+    say ''
+
+    ImagesConvert::Configuration.load
+
+    updated_sections = []
+    changes = []
+
+    if prompt_yes_no('1) 入出力形式とリサイズを変更しますか？', default: true)
+      current_from = ImagesConvert::Configuration.default_from
+      current_to = ImagesConvert::Configuration.default_to
+      current_resize = ImagesConvert::Configuration.default_resize
+
+      new_from = prompt_string('  入力形式', current_from)
+      new_to = prompt_string('  出力形式', current_to)
+      new_resize = prompt_string('  リサイズ値', current_resize)
+
+      if [new_from, new_to, new_resize] != [current_from, current_to, current_resize]
+        record_change(changes, 'デフォルト入力形式', current_from, new_from) if new_from != current_from
+        record_change(changes, 'デフォルト出力形式', current_to, new_to) if new_to != current_to
+        record_change(changes, 'デフォルトリサイズ', current_resize, new_resize) if new_resize != current_resize
+        ImagesConvert::Configuration.save_defaults(from: new_from, to: new_to, resize: new_resize)
+        updated_sections << '基本設定'
+      end
+    end
+
+    if prompt_yes_no('2) 入出力ディレクトリを変更しますか？', default: false)
+      current_input = ImagesConvert::Configuration.default_input_dir
+      current_output = ImagesConvert::Configuration.default_output_dir
+
+      new_input = prompt_path('  入力ディレクトリ', current_input)
+      new_output = prompt_path('  出力ディレクトリ', current_output)
+
+      if [new_input, new_output] != [current_input, current_output]
+        record_change(changes, 'デフォルト入力ディレクトリ', current_input, new_input) if new_input != current_input
+        record_change(changes, 'デフォルト出力ディレクトリ', current_output, new_output) if new_output != current_output
+        ImagesConvert::Configuration.save_directories(input_dir: new_input, output_dir: new_output)
+        updated_sections << 'ディレクトリ'
+      end
+    end
+
+    if prompt_yes_no('3) 最新判定モードを変更しますか？', default: false)
+      current_latest = ImagesConvert::Configuration.default_latest_mode
+      new_latest = prompt_choice('  最新判定モード (mtime/exif)', current_latest, %w[mtime exif])
+
+      if new_latest != current_latest
+        record_change(changes, '最新判定モード', current_latest, new_latest)
+        ImagesConvert::Configuration.save_latest_mode(new_latest)
+        updated_sections << '最新判定モード'
+      end
+    end
+
+    if prompt_yes_no('4) 出力品質を変更しますか？', default: false)
+      current_image_quality = ImagesConvert::Configuration.default_output_image_quality
+      current_pdf_quality = ImagesConvert::Configuration.default_output_pdf_quality
+      current_pdf_compression = ImagesConvert::Configuration.default_output_pdf_compression
+      current_pdf_density = ImagesConvert::Configuration.default_output_pdf_density
+
+      new_image_quality = prompt_integer('  出力画像品質 (1-100)', current_image_quality, min: 1, max: 100)
+      new_pdf_quality = prompt_integer('  PDF 品質 (1-100)', current_pdf_quality, min: 1, max: 100)
+      new_pdf_compression = prompt_choice('  PDF 圧縮方式 (jpeg/jpeg2000/zip)', current_pdf_compression, %w[jpeg jpeg2000 zip])
+      new_pdf_density = prompt_integer('  PDF DPI (72-1200)', current_pdf_density, min: 72, max: 1200)
+
+      new_image_quality = clamp_output_quality(new_image_quality)
+      new_pdf_quality = clamp_output_quality(new_pdf_quality)
+      new_pdf_density = clamp_pdf_density(new_pdf_density)
+
+      if [new_image_quality, new_pdf_quality, new_pdf_compression, new_pdf_density] != [current_image_quality, current_pdf_quality, current_pdf_compression, current_pdf_density]
+        record_change(changes, '出力画像品質', current_image_quality, new_image_quality) if new_image_quality != current_image_quality
+        record_change(changes, 'PDF 品質', current_pdf_quality, new_pdf_quality) if new_pdf_quality != current_pdf_quality
+        record_change(changes, 'PDF 圧縮方式', current_pdf_compression, new_pdf_compression) if new_pdf_compression != current_pdf_compression
+        record_change(changes, 'PDF DPI', current_pdf_density, new_pdf_density) if new_pdf_density != current_pdf_density
+        ImagesConvert::Configuration.save_output_settings(
+          image_quality: new_image_quality,
+          pdf_quality: new_pdf_quality,
+          pdf_compression: new_pdf_compression,
+          pdf_density: new_pdf_density
+        )
+        updated_sections << '出力品質'
+      end
+    end
+
+    if prompt_yes_no('5) waifu2x の設定を変更しますか？', default: false)
+      current_scale = ImagesConvert::Configuration.default_waifu2x_scale
+      current_noise = ImagesConvert::Configuration.default_waifu2x_noise
+      current_model = ImagesConvert::Configuration.default_waifu2x_model
+      current_auto_scale = ImagesConvert::Configuration.default_waifu2x_auto_scale_a4
+      current_a4_print = ImagesConvert::Configuration.default_waifu2x_a4_print
+      current_image_format = ImagesConvert::Configuration.default_waifu2x_image_format
+      current_on_error = ImagesConvert::Configuration.default_waifu2x_on_error
+
+      new_scale = prompt_integer('  waifu2x 拡大率 (1-4)', current_scale, min: 1, max: 4)
+      new_noise = prompt_integer('  waifu2x ノイズ除去レベル (0-4)', current_noise, min: 0, max: 4)
+      new_model = prompt_string('  waifu2x モデル (anime/photo/anime_rgb/cunet/upresnet10)', current_model)
+      new_auto_scale = prompt_yes_no('  A4自動スケールを有効にしますか？', default: current_auto_scale, current_value: current_auto_scale)
+      new_a4_print = prompt_yes_no('  A4レイアウトPDFを適用しますか？', default: current_a4_print, current_value: current_a4_print)
+      new_image_format_raw = prompt_choice('  waifu2x 出力フォーマット (png/jpg/webp)', current_image_format, %w[png jpg jpeg webp])
+      new_on_error = prompt_choice('  waifu2x エラー時の動作 (stop/skip)', current_on_error, %w[stop skip])
+
+      new_scale = clamp_waifu2x_scale(new_scale)
+      new_noise = clamp_waifu2x_noise(new_noise)
+      new_image_format = normalize_waifu2x_output_format(new_image_format_raw)
+      current_image_format_normalized = normalize_waifu2x_output_format(current_image_format)
+
+      if [new_scale, new_noise, new_model, new_auto_scale, new_a4_print, new_image_format, new_on_error] != [current_scale, current_noise, current_model, current_auto_scale, current_a4_print, current_image_format_normalized, current_on_error]
+        record_change(changes, 'waifu2x 既定倍率', current_scale, new_scale) if new_scale != current_scale
+        record_change(changes, 'waifu2x ノイズ除去', current_noise, new_noise) if new_noise != current_noise
+        record_change(changes, 'waifu2x モデル', current_model, new_model) if new_model != current_model
+        record_change(changes, 'waifu2x A4自動スケール', current_auto_scale, new_auto_scale) if new_auto_scale != current_auto_scale
+        record_change(changes, 'waifu2x A4レイアウトPDF', current_a4_print, new_a4_print) if new_a4_print != current_a4_print
+        record_change(changes, 'waifu2x 出力フォーマット', current_image_format_normalized, new_image_format) if new_image_format != current_image_format_normalized
+        record_change(changes, 'waifu2x エラー時動作', current_on_error, new_on_error) if new_on_error != current_on_error
+        ImagesConvert::Configuration.save_waifu2x_settings(
+          scale: new_scale,
+          noise: new_noise,
+          model: new_model,
+          auto_scale_a4: new_auto_scale,
+          a4_print: new_a4_print,
+          image_format: new_image_format,
+          on_error: new_on_error
+        )
+        updated_sections << 'waifu2x'
+      end
+    end
+
+    if updated_sections.empty?
+      say ''
+      say '設定は変更されませんでした。', :yellow
+    else
+      say ''
+      say '更新された設定:'
+      updated_sections.each do |label|
+        say "  - #{label}"
+      end
+      if changes.any?
+        say ''
+        say '変更点の詳細:'
+        changes.each do |change|
+          say "  - #{change[:label]}: #{change[:before]} => #{set_color(change[:after], :green)}"
+        end
+      end
+    end
+
+    say ''
+    invoke :config
+  end
+
+  desc 'set FROM TO [RESIZE]', '変換形式やリサイズ値の既定値を設定'
+  def set(from = nil, to = nil, resize = nil)
+    unless from && to
+      say "使い方: imgconv set FROM TO [RESIZE]", :red
+      exit 1
+    end
+
+    resize ||= ImagesConvert::Configuration.default_resize
+    config('set', from, to, resize)
+  end
+
+  desc 'set-dir INPUT_DIR OUTPUT_DIR', '入出力ディレクトリの既定値を設定'
+  def set_dir(input_dir = nil, output_dir = nil)
+    unless input_dir && output_dir
+      say "使い方: imgconv set-dir INPUT_DIR OUTPUT_DIR", :red
+      exit 1
+    end
+
+    config('set-dir', input_dir, output_dir)
+  end
+
+  desc 'set-latest-mode MODE', '最新件数選定時の判定基準を設定 (mtime/exif)'
+  def set_latest_mode(mode = nil)
+    unless mode
+      say "使い方: imgconv set-latest-mode MODE (mtime/exif)", :red
+      exit 1
+    end
+
+    normalized = mode.to_s.downcase
+    unless %w[mtime exif].include?(normalized)
+      say "エラー: MODE には mtime または exif を指定してください。", :red
+      exit 1
+    end
+
+    ImagesConvert::Configuration.save_latest_mode(normalized)
+    say "最新判定モードを #{normalized} に設定しました。"
+  end
+
+  desc 'cleanup', '設定ファイルとディレクトリを削除'
+  def cleanup
+    ImagesConvert::Cleanup.run
+  end
+
+  # 自己アンインストール: 設定削除 → gem アンインストール
+  map 'self-uninstall' => :self_uninstall
+  desc 'self-uninstall', '設定を削除して gem もアンインストール'
+  def self_uninstall
+    ImagesConvert::Cleanup.run
+    say ''
+    say 'images-convert の gem をアンインストールしますか？ [Y/n]'
+    print '> '
+    answer = (STDIN.gets || '').strip
+    answer = 'y' if answer.empty?
+    if answer.downcase.start_with?('y')
+      system('gem uninstall images-convert')
+    else
+      say 'gem のアンインストールをキャンセルしました。'
+    end
+  end
+
+  desc 'convert TARGET [DEST_DIR]', '単一ファイル変換（TARGET=ファイル名/番号）または一括変換（TARGET=入力ディレクトリ, DEST_DIR=出力ディレクトリ）'
+  long_desc <<~DESC
+    使い方:
+
+      images-convert [convert] TARGET [DEST_DIR] [オプション]
+      imgconv [convert] TARGET [DEST_DIR] [オプション]
+
+    動作:
+      - TARGET がファイル名/番号の場合は単一ファイル変換（-i/-o で入出力ディレクトリ指定可）
+      - TARGET がディレクトリの場合は一括変換（DEST_DIR 未指定時は in-place 変換）
+
+    主なオプション:
+      -i, --input-dir=DIR       入力ディレクトリ（単一ファイル時）
+      -o, --output-dir=DIR      出力ディレクトリ（単一ファイル時）
+      -d, --delete              変換後に元ファイルを削除
+      -f, --overwrite           既存の出力ファイルがある場合に上書き
+      -s, --suffix=SUFFIX       出力ファイル名の末尾に付与（例: _web）
+          --recursive           ディレクトリを再帰的に処理（一括変換時）
+
+    例:
+      # 1枚だけ変換（番号指定、入出力ディレクトリや変換形式は既定値）
+      images-convert [convert] 1234
+      # または短縮コマンド
+      imgconv [convert] 1234
+
+      # 1枚だけ変換（ファイル名指定、入出力ディレクトリを明示）
+      images-convert [convert] IMG_0001 ~/Downloads ~/Downloads
+
+      # 一括変換（in-place）
+      images-convert [convert] ./photos
+
+      # 一括変換（出力先を別ディレクトリ、再帰処理、サフィックス付与）
+      images-convert [convert] ./photos ./export --recursive --suffix _resized
+  DESC
+  method_option :input_dir, aliases: '-i', desc: '入力ディレクトリ（デフォルト: 設定値または ~/Downloads）'
+  method_option :output, aliases: '-o', desc: '出力ファイルパス（単一ファイル変換時、ディレクトリ指定時は出力ディレクトリ）'
+  method_option :output_dir, type: :string, desc: '出力ディレクトリ（単一ファイル時）'
+  method_option :delete, aliases: '-d', type: :boolean, desc: '変換後に元のファイルを削除'
+  method_option :overwrite, aliases: '-f', type: :boolean, desc: '既存の出力ファイルがある場合に上書き'
+  method_option :suffix, aliases: '-s', type: :string, desc: '出力ファイル名の末尾に付与するサフィックス（例: _converted）'
+  method_option :recursive, type: :boolean, desc: 'ディレクトリを再帰的に処理（一括変換時）'
+  method_option :resize, type: :string, desc: 'リサイズ値（例: 1920x, 50%）'
+  method_option :output_mode, type: :string, enum: %w[images pdf both], default: 'images', desc: '出力モード（images/pdf/both）'
+  method_option :waifu2x_scale, type: :numeric, desc: 'waifu2x の拡大率 (1-4)'
+  method_option :waifu2x_noise, type: :numeric, desc: 'waifu2x のノイズ除去レベル (0-4)'
+  method_option :waifu2x_model, type: :string, desc: 'waifu2x モデルエイリアス（photo/anime/anime_rgb/cunet/upresnet10）'
+  method_option :waifu2x_processor, type: :string, default: 'waifu2x_ncnn_vulkan', desc: 'waifu2x プロセッサ'
+  method_option :waifu2x_bin, type: :string, desc: 'waifu2x バイナリへのパス'
+  method_option :waifu2x_models_path, type: :string, desc: 'waifu2x モデルディレクトリへのパス'
+  method_option :waifu2x_download_url, type: :string, desc: 'waifu2x 自動ダウンロード用URL'
+  method_option :waifu2x_auto_scale_a4, type: :boolean, desc: 'A4印刷を目安に拡大率を自動調整'
+  method_option :waifu2x_a4_print, type: :boolean, desc: 'A4レイアウトPDFを適用（--output-mode pdf/both）'
+  method_option :waifu2x_image_format, type: :string, desc: 'waifu2x 出力画像フォーマット（png/jpg/webp）'
+  method_option :waifu2x_verbose, type: :boolean, desc: 'waifu2x の詳細ログを表示'
+  method_option :waifu2x_on_error, type: :string, enum: %w[skip stop], desc: 'waifu2x 処理失敗時の動作'
+  method_option :quality, type: :numeric, desc: '出力画像の品質 (0-100, JPEG/WebP など)'
+  method_option :pdf_compression, type: :string, enum: %w[jpeg jpeg2000 zip], desc: 'PDF 埋め込み画像の圧縮方式'
+  method_option :pdf_quality, type: :numeric, desc: 'PDF 埋め込み画像の品質（0-100）'
+  method_option :pdf_density, type: :numeric, desc: 'PDF ページの DPI'
+  # 追加機能: 最新N件/全件変換をサポート（-N, -0/--all）
+  method_option :latest, type: :numeric, desc: '最新の画像ファイル N 件を変換（入力ディレクトリ内から）'
+  method_option :latest_exif, type: :boolean, default: false, negatable: false, desc: '最新 N 件の選定を EXIF 撮影日時に基づいて行う（--latest と併用）'
+  method_option :all, type: :boolean, default: false, negatable: false, desc: '入力ディレクトリ内の対象画像をすべて変換'
+  # オプションで from/to を一時的に上書き（ショートハンドや内部用途）
+  method_option :from, type: :string, desc: '入力形式（設定を一時的に上書き）'
+  method_option :to,   type: :string, desc: '出力形式（設定を一時的に上書き）'
+  def convert(target = nil, dest_dir = nil)
+    from   = options[:from]   || ImagesConvert::Configuration.default_from
+    to     = options[:to]     || ImagesConvert::Configuration.default_to
+    resize = options[:resize] || ImagesConvert::Configuration.default_resize
+    latest_mode = latest_mode_from_options
+    pdf_density = clamp_pdf_density(options[:pdf_density])
+
+    # 最新N件/全件変換（入力ディレクトリを走査）
+    if options[:all] || (options.key?(:latest) && options[:latest].to_s.strip != '')
+      # コマンドライン引数でディレクトリが指定されている場合は優先
+      input_dir = if target && File.directory?(target)
+                    File.expand_path(target)
+                  else
+                    options[:input_dir] || ImagesConvert::Configuration.default_input_dir
+                  end
+      output_dir = if dest_dir
+                     File.expand_path(dest_dir)
+                   else
+                     options[:output_dir] || ImagesConvert::Configuration.default_output_dir
+                   end
+
+      unless Dir.exist?(input_dir)
+        say "エラー: 入力ディレクトリ '#{input_dir}' が存在しません。", :red
+        exit 1
+      end
+
+      # 入力候補の列挙
+      exts = candidate_exts(from)
+      candidates = list_input_candidates(input_dir, exts)
+
+      if candidates.empty?
+        say "対象ファイルが見つかりませんでした (#{input_dir}, 拡張子: #{exts.uniq.join('/')})."
+        return
+      end
+
+      # 最新順の並べ替え（EXIF 対応）
+      sorted, exif_fallback_used = sort_candidates_by_mode(candidates, latest_mode)
+      sorted = sorted.uniq
+      mode, count = resolve_selection(sorted)
+      case mode
+      when :latest
+        say "最新の #{count} 件を変換します (#{input_dir}, 基準: #{latest_mode})"
+        if latest_mode == 'exif' && exif_fallback_used
+          say '  ※ EXIF 情報がないファイルはファイル更新日時で判定しました。'
+        end
+      when :all
+        say "すべての画像ファイルを変換します (#{input_dir})"
+      else
+        say "エラー: --latest N (N>=1) または --all / -0 を指定してください（--latest 0 は全件として扱います）", :red
+        exit 1
+      end
+
+      targets = sorted.first(count)
+
+      targets.each do |filepath|
+        base = File.basename(filepath, '.*')
+        perform_conversion(base, from, to, resize, input_dir, output_dir, suffix: options[:suffix], pdf_density: pdf_density)
+      end
+      return
+    end
+
+    # 一括変換（ディレクトリ指定）
+    if target && File.directory?(target)
+      src_dir = File.expand_path(target)
+      out_dir = dest_dir ? File.expand_path(dest_dir) : src_dir # 単一引数時は in-place
+      unless Dir.exist?(src_dir)
+        say "エラー: 入力ディレクトリ '#{src_dir}' が存在しません。", :red
+        exit 1
+      end
+      FileUtils.mkdir_p(out_dir)
+      perform_bulk_conversion(
+        src_dir,
+        out_dir,
+        from,
+        to,
+        resize,
+        overwrite: options[:overwrite],
+        suffix: options[:suffix],
+        recursive: options[:recursive],
+        delete: options[:delete],
+        pdf_density: pdf_density
+      )
+      return
+    end
+
+    # 単一ファイル変換: target はファイル名または番号（IMG_1234 を想定）
+    input_dir = options[:input_dir] || ImagesConvert::Configuration.default_input_dir
+    output_dir = if dest_dir
+                   File.expand_path(dest_dir)
+                 else
+                   options[:output_dir] || ImagesConvert::Configuration.default_output_dir
+                 end
+
+    # --output オプションが指定されている場合は出力ファイルを直接指定
+    if options[:output] && target
+      # --output で指定されたパスをフルパスに変換
+      output_file_path = File.expand_path(options[:output])
+      output_dir = File.dirname(output_file_path)
+      output_basename = File.basename(output_file_path, '.*')
+      # 出力ファイル名を指定されたものに変更
+      def self.custom_output_filename(input_file, to, output_dir, custom_basename, suffix: nil, create_dir: true)
+        basename = suffix && !suffix.empty? ? "#{custom_basename}#{suffix}" : custom_basename
+        FileUtils.mkdir_p(output_dir) if create_dir && !Dir.exist?(output_dir)
+        "#{output_dir}/#{basename}.#{to.downcase}"
+      end
+
+      # 入力がフルパス/実在パスなら input_dir 検証をスキップしてそのまま使う
+      input_path_like = target.to_s.include?('/') || File.exist?(target.to_s)
+      input_file = nil
+      if input_path_like
+        candidate = File.expand_path(target.to_s)
+        if File.exist?(candidate)
+          input_file = candidate
+        end
+      end
+
+      # まだ見つからない場合は従来どおり input_dir + base 名から探索
+      unless input_file
+        validate_arguments(target, input_dir)
+        input_file = find_input_file(target, from, input_dir)
+        unless input_file
+          say "エラー: 指定されたファイル '#{target}' (#{from} 形式) は #{input_dir} に存在しません。", :red
+          exit 1
+        end
+      end
+
+      normalized_to = normalized_to_format(to)
+      output_file = custom_output_filename(input_file, normalized_to, output_dir, output_basename)
+
+      if attempt_waifu2x_single(
+          input_file: input_file,
+          normalized_to: normalized_to,
+          resize: resize,
+          output_path: output_file,
+          overwrite: options[:overwrite],
+          delete_original: options[:delete],
+          settings: waifu2x_runtime_settings(target_format: normalized_to),
+          explicit_scale: options[:waifu2x_scale]
+        )
+        return
+      end
+
+      if File.exist?(output_file) && !options[:overwrite]
+        say "- 既存のためスキップ: #{output_file}（--overwrite で上書き可能）", :yellow
+        return
+      end
+
+      say "#{input_file} を #{output_file} に変換しています..."
+
+      begin
+        image = MiniMagick::Image.open(input_file)
+        image.resize resize unless resize.empty?
+        image.format normalized_to
+        apply_image_quality(image, effective_output_quality)
+        image.write output_file
+
+        say "変換成功! 新しいファイルは #{output_file} です。", :green
+
+        if options[:delete]
+          FileUtils.rm(input_file)
+          say "元のファイル #{input_file} は削除されました。", :yellow
+        else
+          say '元のファイルは削除されませんでした。削除するには --delete オプションを使用してください。', :blue
+        end
+      rescue => e
+        say "エラー: 変換に失敗しました。#{e.message}", :red
+        say 'ImageMagick のインストール状況を確認してください。', :red
+        return
+      end
+      return
+    end
+
+    perform_conversion(target, from, to, resize, input_dir, output_dir, suffix: options[:suffix], pdf_density: pdf_density)
+  end
+
+  private
+  
+  # 最新N件/全件の選定ロジック
+  # @return [Symbol,Integer] mode (:latest|:all|:none), count
+  def resolve_selection(sorted)
+    # --latest の明示（-N は preprocess で --latest N に展開済み）
+    latest_val = options[:latest]
+    if !(latest_val.nil? || latest_val.to_s.strip.empty?)
+      n = latest_val.to_i
+      return [:all, sorted.size] if n <= 0
+      return [:latest, n]
+    end
+
+    # --all
+    return [:all, sorted.size] if options[:all]
+
+    [:none, 0]
+  end
+  
+  # 入力拡張子の候補（jpeg の場合は jpg と jpeg の両方、大文字拡張子も含めて検出）
+  def candidate_exts(from)
+    from.to_s.match?(/\Ajpe?g\z/i) ? %w[jpg jpeg JPG JPEG] : [from.downcase, from.upcase]
+  end
+
+  # 出力拡張子の正規化（jpeg 系は jpg に統一）
+  def normalized_to_format(to)
+    to.to_s.match?(/\Ajpe?g\z/i) ? 'jpg' : to.downcase
+  end
+
+  def validate_arguments(base_name, input_dir)
+    unless base_name
+      say 'エラー: ファイル名または番号を指定してください。', :red
+      exit 1
+    end
+
+    unless Dir.exist?(input_dir)
+      say "エラー: 入力ディレクトリ '#{input_dir}' が存在しません。", :red
+      exit 1
+    end
+  end
+
+  def perform_conversion(base_name, from, to, resize, input_dir, output_dir, suffix: nil, pdf_density: ImagesConvert::Configuration.default_output_pdf_density)
+    input_file = find_input_file(base_name, from, input_dir)
+
+    unless input_file
+      say "エラー: 指定されたファイル '#{base_name}' (#{from} 形式) は #{input_dir} に存在しません。", :red
+      exit 1
+    end
+
+    # 拡張子とフォーマット名の正規化（jpeg は jpg に統一）
+    normalized_to = normalized_to_format(to)
+    output_file = output_filename(input_file, normalized_to, output_dir, suffix: suffix)
+
+    if attempt_waifu2x_single(
+        input_file: input_file,
+        normalized_to: normalized_to,
+        resize: resize,
+        output_path: output_file,
+        overwrite: options[:overwrite],
+        delete_original: options[:delete],
+        settings: waifu2x_runtime_settings(target_format: normalized_to),
+        explicit_scale: options[:waifu2x_scale]
+      )
+      return
+    end
+
+    if File.exist?(output_file) && !options[:overwrite]
+      say "- 既存のためスキップ: #{output_file}（--overwrite で上書き可能）", :yellow
+      return
+    end
+
+    say "#{input_file} を #{output_file} に変換しています..."
+
+    # MiniMagick で変換（リサイズを追加）
+    begin
+      image = MiniMagick::Image.open(input_file)
+      image.resize resize unless resize.empty?
+      image.format normalized_to
+      apply_image_quality(image, effective_output_quality)
+      image.write output_file
+
+      say "変換成功! 新しいファイルは #{output_file} です。", :green
+
+      if options[:delete]
+        FileUtils.rm(input_file)
+        say "元のファイル #{input_file} は削除されました。", :yellow
+      else
+        say '元のファイルは削除されませんでした。削除するには --delete オプションを使用してください。', :blue
+      end
+    rescue => e
+      say "エラー: 変換に失敗しました。#{e.message}", :red
+      say 'ImageMagick のインストール状況を確認してください。', :red
+      # バッチ処理継続のため、ここでは終了せず次へ
+      return
+    end
+  end
+
+  def find_input_file(base_name, from, input_dir)
+    input_file = nil
+
+    normalized_exts = candidate_exts(from).flat_map do |ext|
+      ext = ext.delete_prefix('.')
+      [ext.downcase, ext.upcase]
+    end.uniq
+
+    if base_name.match?(/\A\d+\z/)
+      # 数字のみの場合、IMG_プレフィックスを試す
+      candidates = normalized_exts.map { |ext| "#{input_dir}/IMG_#{base_name}.#{ext}" }
+    else
+      # 数字以外の場合、そのままファイル名を試す
+      candidates = normalized_exts.map { |ext| "#{input_dir}/#{base_name}.#{ext}" } + [
+        "#{input_dir}/#{base_name}"
+      ]
+    end
+
+    candidates.each do |candidate|
+      if File.exist?(candidate)
+        input_file = candidate
+        break
+      end
+    end
+
+    input_file
+  end
+
+  def output_filename(input_file, to, output_dir, suffix: nil, create_dir: true)
+    basename = File.basename(input_file, ".*")
+    basename = suffix && !suffix.empty? ? "#{basename}#{suffix}" : basename
+    FileUtils.mkdir_p(output_dir) if create_dir && !Dir.exist?(output_dir)
+    "#{output_dir}/#{basename}.#{to.downcase}"
+  end
+
+  # オプションから最新判定モードを決定する
+  def latest_mode_from_options
+    flag = options[:latest_exif]
+    flag = options['latest_exif'] if flag.nil?
+    flag = options['latest-exif'] if flag.nil?
+    flag ? 'exif' : ImagesConvert::Configuration.default_latest_mode
+  end
+
+  def waifu2x_runtime_settings(target_format: nil)
+    explicit_scale = options[:waifu2x_scale]
+    noise = options[:waifu2x_noise]
+    model = options[:waifu2x_model]
+    auto_scale_a4 = options.key?(:waifu2x_auto_scale_a4) ? options[:waifu2x_auto_scale_a4] : nil
+    a4_print = options.key?(:waifu2x_a4_print) ? options[:waifu2x_a4_print] : nil
+    image_format = options[:waifu2x_image_format]
+    on_error = options[:waifu2x_on_error]
+
+    {
+      scale: clamp_waifu2x_scale(explicit_scale || ImagesConvert::Configuration.default_waifu2x_scale),
+      noise: clamp_waifu2x_noise(noise.nil? ? ImagesConvert::Configuration.default_waifu2x_noise : noise.to_i),
+      model: model || ImagesConvert::Configuration.default_waifu2x_model,
+      auto_scale_a4: auto_scale_a4.nil? ? ImagesConvert::Configuration.default_waifu2x_auto_scale_a4 : auto_scale_a4,
+      a4_print: a4_print.nil? ? ImagesConvert::Configuration.default_waifu2x_a4_print : a4_print,
+      image_format: normalize_waifu2x_output_format(image_format || target_format || ImagesConvert::Configuration.default_waifu2x_image_format),
+      on_error: on_error || ImagesConvert::Configuration.default_waifu2x_on_error,
+      processor: options[:waifu2x_processor] || 'waifu2x_ncnn_vulkan',
+      download_url: options[:waifu2x_download_url],
+      bin: options[:waifu2x_bin],
+      models_path: options[:waifu2x_models_path],
+      quality: clamp_output_quality(options[:quality] || ImagesConvert::Configuration.default_output_image_quality)
+    }
+  end
+
+  def normalize_waifu2x_output_format(fmt)
+    return ImagesConvert::Configuration.default_waifu2x_image_format unless fmt
+    fmt.to_s.strip.downcase.then { |v| v == 'jpeg' ? 'jpg' : v }
+  end
+
+  def attempt_waifu2x_single(input_file:, normalized_to:, resize:, output_path:, overwrite:, delete_original:, settings:, explicit_scale: nil)
+    return false unless (options[:output_mode] || 'images').to_s == 'images'
+    return false unless waifu2x_supported_format?(normalized_to)
+
+    ratio = resize_ratio_for(input_file, resize)
+    return false if ratio <= 1.0 && explicit_scale.nil?
+
+    configured_scale = settings[:scale] || 1
+    auto_scale = waifu2x_scale_from_ratio(ratio, nil)
+
+    scale = if explicit_scale
+              clamp_waifu2x_scale(explicit_scale)
+            else
+              clamp_waifu2x_scale([auto_scale, configured_scale].max)
+            end
+    return false if scale <= 1
+
+    if File.exist?(output_path)
+      unless overwrite
+        say "- 既存のためスキップ: #{output_path}（--overwrite で上書き可能）", :yellow
+        return true
+      end
+      FileUtils.rm_f(output_path)
+    end
+
+    resolved = resolve_waifu2x_paths(settings: settings)
+    return false unless resolved
+
+    begin
+      Dir.mktmpdir('imgconv-waifu2x-in') do |tmp_in|
+        Dir.mktmpdir('imgconv-waifu2x-out') do |tmp_out|
+          temp_input = File.join(tmp_in, File.basename(input_file))
+          FileUtils.cp(input_file, temp_input)
+
+          Waifu2x::Processor.process_images(
+            tmp_in,
+            tmp_out,
+            scale: scale,
+            noise: settings[:noise],
+            model: settings[:model],
+            processor: settings[:processor].to_sym,
+            waifu2x_bin: resolved[:bin],
+            models_path: resolved[:models],
+            recursive: false,
+            auto_scale_a4: settings[:auto_scale_a4],
+            pdf_density: clamp_pdf_density(options[:pdf_density]),
+            verbose: options[:waifu2x_verbose],
+            image_format: settings[:image_format],
+            on_error: settings[:on_error]
+          )
+
+          produced = Dir.glob(File.join(tmp_out, "*.#{settings[:image_format]}"))
+          produced = produced.first || Dir.glob(File.join(tmp_out, '*')).first
+
+          unless produced && File.exist?(produced)
+            say 'waifu2x の出力が見つかりませんでした。MiniMagick で再試行します。', :yellow
+            return false
+          end
+
+          FileUtils.mkdir_p(File.dirname(output_path))
+          FileUtils.mv(produced, output_path, force: true)
+          say "waifu2x を使用して #{output_path} を生成しました。", :green
+
+          enforce_resize_after_waifu2x(output_path, resize, settings[:quality])
+
+          if delete_original
+            FileUtils.rm_f(input_file)
+            say "元のファイル #{input_file} は削除されました。", :yellow
+          end
+          return true
+        end
+      end
+    rescue StandardError => e
+      safe_msg = begin
+        e.message.to_s.encode('UTF-8', invalid: :replace, undef: :replace)
+      rescue StandardError
+        e.message.to_s
+      end
+      say "waifu2x の実行に失敗しました: #{safe_msg}。MiniMagick で再試行します。", :yellow
+      false
+    end
+  end
+
+  def waifu2x_supported_format?(normalized_to)
+    %w[png jpg jpeg webp].include?(normalized_to.to_s.downcase)
+  end
+
+  def resolve_waifu2x_paths(settings:)
+    Waifu2x::Setup.resolve_paths(
+      waifu2x_bin: settings[:bin],
+      models_path: settings[:models_path],
+      auto_download: true,
+      download_url: settings[:download_url],
+      model: settings[:model]
+    )
+  rescue StandardError => e
+    safe_msg = begin
+      e.message.to_s.encode('UTF-8', invalid: :replace, undef: :replace)
+    rescue StandardError
+      e.message.to_s
+    end
+    say "waifu2x の準備に失敗しました: #{safe_msg}。MiniMagick でフォールバックします。", :yellow
+    nil
+  end
+
+  def resize_ratio_for(path, resize)
+    resize = resize.to_s.strip
+    return 1.0 if resize.empty?
+
+    if (percent = resize.match(/\A(\d+(?:\.\d+)?)%\z/))
+      return percent[1].to_f / 100.0
+    end
+
+    width, height = image_dimensions(path)
+    return 1.0 if width.to_i <= 0 || height.to_i <= 0
+
+    cleaned = resize.tr('^0-9x', '')
+    parts = cleaned.split('x', 2)
+    target_w = parts[0].to_s.empty? ? nil : parts[0].to_i
+    target_h = parts[1].to_s.empty? ? nil : parts[1].to_i
+
+    ratios = []
+    ratios << (target_w.to_f / width) if target_w && width.positive?
+    ratios << (target_h.to_f / height) if target_h && height.positive?
+    ratio = ratios.compact.max
+    ratio && ratio > 0 ? ratio : 1.0
+  rescue StandardError
+    1.0
+  end
+
+  def image_dimensions(path)
+    @_waifu2x_dimension_cache ||= {}
+    return @_waifu2x_dimension_cache[path] if @_waifu2x_dimension_cache.key?(path)
+
+    image = MiniMagick::Image.ping(path)
+    dims = [image.width.to_i, image.height.to_i]
+    @_waifu2x_dimension_cache[path] = dims
+  rescue StandardError
+    @_waifu2x_dimension_cache[path] = [0, 0]
+  end
+
+  def waifu2x_scale_from_ratio(ratio, explicit_scale)
+    return clamp_waifu2x_scale(explicit_scale.to_i) if explicit_scale
+
+    return 1 if ratio <= 1.0
+    return 2 if ratio <= 2.0
+    4
+  end
+
+  def clamp_waifu2x_scale(value)
+    v = value.to_i
+    v = 4 if v > 4
+    v = 1 if v < 1
+    v == 3 ? 4 : v
+  end
+
+  def clamp_waifu2x_noise(value)
+    v = value.to_i
+    v = 4 if v > 4
+    v = 0 if v < 0
+    v
+  end
+
+  def clamp_output_quality(value)
+    return nil if value.nil?
+    v = value.to_i
+    v = 100 if v > 100
+    v = 1 if v < 1
+    v
+  end
+
+  def effective_output_quality
+    clamp_output_quality(options[:quality] || ImagesConvert::Configuration.default_output_image_quality)
+  end
+
+  def apply_image_quality(image, quality)
+    return if quality.nil?
+    image.quality(quality)
+  rescue StandardError
+    # ignore
+  end
+
+  def enforce_resize_after_waifu2x(path, resize, quality)
+    resize = resize.to_s.strip
+    return if resize.empty?
+
+    begin
+      image = MiniMagick::Image.open(path)
+      image.resize(resize)
+      apply_image_quality(image, quality)
+      image.write(path)
+    rescue StandardError => e
+      say "警告: waifu2x 出力の最終リサイズに失敗しました: #{e.message}", :yellow
+    end
+  end
+
+  # 入力ディレクトリから対象拡張子の候補を列挙
+  def list_input_candidates(input_dir, exts)
+    pattern = "*.{#{exts.join(',')}}"
+    Dir.chdir(input_dir) { Dir.glob(pattern) }
+      .map { |p| File.join(input_dir, p) }
+      .select { |f| File.file?(f) }
+  end
+
+  def perform_bulk_conversion(src_dir, out_dir, from, to, resize, overwrite:, suffix:, recursive:, delete:, pdf_density: ImagesConvert::Configuration.default_output_pdf_density)
+    start_time = Time.now
+    # 入力拡張子の候補（jpeg の場合は jpg と jpeg の両方）
+    exts = candidate_exts(from)
+    pattern = recursive ? "**/*.{#{exts.join(',')}}" : "*.{#{exts.join(',')}}"
+
+    candidates = Dir.chdir(src_dir) { Dir.glob(pattern) }.uniq
+                          .select { |p| File.file?(File.join(src_dir, p)) }
+
+    total = candidates.size
+    converted = 0
+    skipped = 0
+    failed = 0
+    deleted = 0
+
+    normalized_to = to.to_s.match?(/\Ajpe?g\z/i) ? 'jpg' : to.downcase
+
+    if total.zero?
+      say "対象ファイルが見つかりませんでした (#{src_dir}, 拡張子: #{exts.uniq.join('/')})."
+    end
+
+    candidates.each do |rel_path|
+      begin
+        in_path = File.join(src_dir, rel_path)
+        # 出力は out_dir 直下に相対パスを維持
+        out_path_dir = File.join(out_dir, File.dirname(rel_path))
+        FileUtils.mkdir_p(out_path_dir) unless Dir.exist?(out_path_dir)
+        out_basename = File.basename(rel_path, ".*")
+        out_basename = suffix && !suffix.empty? ? "#{out_basename}#{suffix}" : out_basename
+        out_path = File.join(out_path_dir, "#{out_basename}.#{normalized_to}")
+
+        if File.exist?(out_path) && !overwrite
+          skipped += 1
+          say "- 既存のためスキップ: #{out_path}（--overwrite で上書き可能）", :yellow
+          next
+        end
+
+        say "#{in_path} を #{out_path} に変換しています..."
+        image = MiniMagick::Image.open(in_path)
+        image.resize resize unless resize.to_s.empty?
+        image.format normalized_to
+        apply_image_quality(image, effective_output_quality)
+        image.write out_path
+        converted += 1
+        say "変換成功! 新しいファイルは #{out_path} です。", :green
+
+        if delete
+          FileUtils.rm(in_path)
+          deleted += 1
+          say "元のファイル #{in_path} は削除されました。", :yellow
+        end
+      rescue => e
+        failed += 1
+        say "エラー: 変換に失敗しました: #{rel_path} — #{e.message}", :red
+      end
+    end
+
+    elapsed = Time.now - start_time
+    say ""
+    say "処理結果サマリ:", :bold if respond_to?(:say)
+    say "  対象ファイル数: #{total}"
+    say "  変換成功:      #{converted}"
+    say "  スキップ:        #{skipped}"
+    say "  失敗:            #{failed}"
+    say "  削除:            #{deleted}"
+    say "  所要時間:        #{format('%.2f', elapsed)} 秒"
+  end
+
+  def prompt_yes_no(question, default: true, current_value: nil)
+    suffix = ' [y/n]'
+    meta = []
+    unless current_value.nil?
+      meta << "現在: #{current_value ? 'はい' : 'いいえ'}"
+    end
+    meta << "既定: #{default ? 'はい' : 'いいえ'}"
+    meta_text = meta.empty? ? '' : " (#{meta.join(' / ')})"
+    loop do
+      answer = ask("#{question}#{suffix}#{meta_text}:").to_s.strip.downcase
+      return default if answer.empty?
+      return true if %w[y yes].include?(answer)
+      return false if %w[n no].include?(answer)
+      say 'y または n を入力してください。', :yellow
+    end
+  end
+
+  def prompt_string(label, current_value, hint: nil)
+    hint_text = hint ? " #{hint}" : ''
+    response = ask("#{label} [現在: #{current_value}]#{hint_text} (Enterで維持):").to_s
+    trimmed = response.strip
+    trimmed.empty? ? current_value : trimmed
+  end
+
+  def prompt_integer(label, current_value, min:, max:)
+    loop do
+      response = ask("#{label} [現在: #{current_value}] (Enterで維持):").to_s.strip
+      return current_value if response.empty?
+      unless response.match?(/\A-?\d+\z/)
+        say '数値を入力してください。', :yellow
+        next
+      end
+      value = response.to_i
+      value = max if value > max
+      value = min if value < min
+      return value
+    end
+  end
+
+  def prompt_choice(label, current_value, choices)
+    normalized_choices = choices.map(&:downcase)
+    loop do
+      response = ask("#{label} [現在: #{current_value}] (Enterで維持):").to_s.strip
+      return current_value if response.empty?
+      idx = normalized_choices.index(response.downcase)
+      if idx
+        return choices[idx]
+      end
+      say "#{choices.join('/')} のいずれかを入力してください。", :yellow
+    end
+  end
+
+  def prompt_path(label, current_value)
+    loop do
+      response = ask("#{label} [現在: #{current_value}] (Enterで維持):").to_s.strip
+      return current_value if response.empty?
+      begin
+        expanded = File.expand_path(response)
+        return expanded
+      rescue StandardError => e
+        say "パスを解釈できませんでした: #{e.message}", :yellow
+      end
+    end
+  end
+
+  def show_config_summary(settings = nil)
+    settings ||= ImagesConvert::Configuration.show_all_settings
+
+    say "現在の設定:"
+    say "  デフォルト入力形式: #{settings[:defaults][:from]}"
+    say "  デフォルト出力形式: #{settings[:defaults][:to]}"
+    say "  デフォルトリサイズ: #{settings[:defaults][:resize]}"
+    say "  デフォルト入力ディレクトリ: #{settings[:directories][:input]}"
+    say "  デフォルト出力ディレクトリ: #{settings[:directories][:output]}"
+    say "  最新判定モード: #{settings[:selection][:latest_mode]}"
+    say "  waifu2x 既定倍率: #{settings[:waifu2x][:scale]}"
+    say "  waifu2x ノイズ除去: #{settings[:waifu2x][:noise]}"
+    say "  waifu2x モデル: #{settings[:waifu2x][:model]}"
+    say "  waifu2x A4自動スケール: #{settings[:waifu2x][:auto_scale_a4]}"
+    say "  waifu2x A4レイアウトPDF: #{settings[:waifu2x][:a4_print]}"
+    say "  waifu2x 出力フォーマット: #{settings[:waifu2x][:image_format]}"
+    say "  waifu2x エラー時動作: #{settings[:waifu2x][:on_error]}"
+    say "  出力画像品質: #{settings[:output][:image_quality]}"
+    say "  PDF 品質: #{settings[:output][:pdf_quality]}"
+    say "  PDF 圧縮方式: #{settings[:output][:pdf_compression]}"
+    say "  PDF DPI: #{settings[:output][:pdf_density]}"
+    say ""
+  end
+
+  def record_change(collection, label, before, after)
+    collection << {
+      label: label,
+      before: format_value(before),
+      after: format_value(after)
+    }
+  end
+
+  def format_value(value)
+    case value
+    when TrueClass
+      'はい'
+    when FalseClass
+      'いいえ'
+    when NilClass
+      'なし'
+    else
+      value.to_s
+    end
+  end
+
+  def sort_candidates_by_mode(candidates, mode)
+    if mode == 'exif'
+      fallback_used = false
+      sorted = candidates.sort_by do |path|
+        ts = exif_timestamp_for(path)
+        if ts.nil?
+          fallback_used = true
+          File.mtime(path)
+        else
+          ts
+        end
+      end.reverse
+      [sorted, fallback_used]
+    else
+      [candidates.sort_by { |f| File.mtime(f) }.reverse, false]
+    end
+  end
+
+  def exif_timestamp_for(path)
+    @_exif_timestamp_cache ||= {}
+    return @_exif_timestamp_cache[path] if @_exif_timestamp_cache.key?(path)
+
+    @_exif_timestamp_cache[path] = extract_exif_timestamp(path)
+  end
+
+  def extract_exif_timestamp(path)
+    image = MiniMagick::Image.open(path)
+    candidates = [
+      image['EXIF:DateTimeOriginal'],
+      image['EXIF:CreateDate'],
+      image['EXIF:DateTimeDigitized'],
+      image['EXIF:DateTime']
+    ]
+
+    candidates.each do |value|
+      parsed = parse_exif_datetime(value)
+      return parsed if parsed
+    end
+
+    nil
+  rescue StandardError
+    nil
+  end
+
+  def parse_exif_datetime(value)
+    return nil unless value
+    str = value.to_s.strip
+    return nil if str.empty?
+
+    str = str.delete("\u0000")
+
+    Time.strptime(str, '%Y:%m:%d %H:%M:%S')
+  rescue ArgumentError
+    Time.parse(str)
+  rescue ArgumentError
+    nil
+  end
+end
+
+# Thor 起動前に ARGV を前処理して、数値短縮フラグ（-1, -5, -0）を正式オプションへ変換
+def preprocess_argv!(argv)
+  if argv.empty?
+    argv.replace(['help'])
+    return
+  end
+
+  converted = []
+  argv.each do |arg|
+    if arg.is_a?(String) && (m = arg.match(/^(?:-)(\d+)$/))
+      n = m[1].to_i
+      if n == 0
+        converted << '--all'
+      else
+        converted << '--latest' << n.to_s
+      end
+    else
+      converted << arg
+    end
+  end
+
+  # 先頭にサブコマンドが無い場合（例: `images-convert -1`）は convert を補う
+  known_tasks = %w[convert config cleanup self-uninstall version help set-latest-mode setup]
+  first_non_option = converted.find { |a| !(a.to_s.start_with?('-')) }
+  global_flags = %w[-v --version -h --help]
+  has_global_flag = converted.any? { |a| global_flags.include?(a) }
+
+  if !has_global_flag && (first_non_option.nil? || !known_tasks.include?(first_non_option))
+    # FROM TO BASENAME のショートハンドをサポート（既知フォーマットに限る）
+    # 例: heic jpeg 1000 -> config set HEIC JPG <resize>; convert 1000
+    # 許可フォーマットとエイリアス
+    aliases = {
+      'jpeg' => 'JPG',
+      'jpg'  => 'JPG',
+      'png'  => 'PNG',
+      'gif'  => 'GIF',
+      'webp' => 'WEBP',
+      'heic' => 'HEIC',
+      'tiff' => 'TIFF',
+      'bmp'  => 'BMP',
+      'ico'  => 'ICO',
+      'pdf'  => 'PDF',
+    }
+    known_formats = aliases.values.uniq
+
+    non_opts = converted.select { |a| !(a.to_s.start_with?('-')) }
+    if non_opts.size >= 3
+      first_arg, second_arg, third_arg = non_opts[0,3]
+      # リサイズ値のパターン（数字+x、x数字、数字+%）
+      is_resize_value = third_arg.to_s.match?(/^(?:\d+[x%]|[x%]\d+)$/) || third_arg.to_s.match?(/^\d+%$/)
+
+      if is_resize_value
+        # INPUT_FILE OUTPUT_FILE RESIZE パターン
+        # 例: flower.jpg flower.webp 1024x -> convert flower.jpg --output flower.webp --resize 1024x
+        input_file = first_arg
+        output_file = second_arg
+        resize_value = third_arg
+
+        # 残りのオプション（元の順序を維持しつつ、最初の3つの非オプショントークンのみ取り除く）
+        rest = []
+        non_opt_seen = 0
+        converted.each do |tok|
+          if !(tok.to_s.start_with?('-')) && non_opt_seen < 3
+            non_opt_seen += 1
+            next
+          end
+          rest << tok
+        end
+        converted = ['convert', input_file, '--output', output_file, '--resize', resize_value] + rest
+      elsif (from_raw, to_raw, base_raw = non_opts[0,3])
+        from_nm = aliases[from_raw.to_s.downcase]
+        to_nm   = aliases[to_raw.to_s.downcase]
+        is_digits = base_raw.to_s.match?(/^\d+$/)
+        if from_nm && !to_nm && is_digits
+          # FROM は既知だが TO が未知（例: heic tif 1000）の場合は明示的にエラー
+          puts "エラー: 未知の出力形式 '#{to_raw}'. 利用可能な形式: #{known_formats.join('/')}"
+          exit 1
+        elsif from_nm && to_nm && is_digits && known_formats.include?(from_nm) && known_formats.include?(to_nm)
+          # 現在のリサイズ設定値（未作成ならここで作成される）
+          resize = ImagesConvert::Configuration.default_resize
+          # 構築: convert BASENAME --from FROM --to TO [残りのオプション]
+          # 残りのオプション（元の順序を維持しつつ、最初の3つの非オプショントークンのみ取り除く）
+          rest = []
+          non_opt_seen = 0
+          converted.each do |tok|
+            if !(tok.to_s.start_with?('-')) && non_opt_seen < 3
+              non_opt_seen += 1
+              next
+            end
+            rest << tok
+          end
+          converted = ['convert', base_raw, '--from', from_nm, '--to', to_nm] + rest
+        else
+          # 通常の convert 補完にフォールバック
+          converted.unshift('convert')
+        end
+      else
+        converted.unshift('convert')
+      end
+    else
+      converted.unshift('convert')
+    end
+  end
+
+  help_flags = (Thor::HELP_MAPPINGS + ['--help']).uniq
+  if converted.any? { |tok| help_flags.include?(tok) }
+    first_command = converted.find { |tok| !(tok.to_s.start_with?('-')) && !help_flags.include?(tok) }
+    if first_command
+      argv.replace(['help', first_command])
+    else
+      argv.replace(['help'])
+    end
+    return
+  end
+
+  argv.replace(converted)
+end
+
+# Thor コマンドを実行
+if __FILE__ == $0
+  preprocess_argv!(ARGV)
+  ImagesConvertCLI.start(ARGV)
+end