rufio 1.3.0 → 1.4.0

data/info/keybindings.md

@@ -9,22 +9,24 @@ Complete reference of all keyboard shortcuts in **rufio**.
 | `j` / `Down` | Move down |
 | `k` / `Up` | Move up |
 | `h` / `Left` | Go to parent directory |
-| `l` / `Right` / `Enter` | Enter directory or open file |
+| `l` / `Right` / `Enter` | Enter directory |
 | `g` | Jump to top of list |
-| `G` | Jump to bottom of list |
+| `}` | Jump to bottom of list |
 
 ## File Operations
 
 | Key | Action |
 |-----|--------|
 | `o` | Open file with external editor |
-| `e` | Open in file explorer (system default) |
+| `e` | Open current directory in file explorer |
 | `R` | Refresh directory contents |
 | `r` | Rename file or directory |
 | `d` | Delete file or directory (with confirmation) |
 | `a` | Create new file |
 | `A` | Create new directory |
 
+`.zip` previews list the archive entries (size, method, modified time, name) without extracting them.
+
 ## File Selection
 
 | Key | Action |
@@ -33,7 +35,9 @@ Complete reference of all keyboard shortcuts in **rufio**.
 | `m` | Move selected items to current directory |
 | `c` | Copy selected items to current directory |
 | `x` | Delete selected items |
-| `z` | Extract selected `.zip` files / compress selected items into a `.zip` |
+| `z` | Extract selected `.zip` files (each into `<name>/`) / compress selected items into one `.zip` |
+
+ZIP extraction and compression run as background jobs. Check progress in Jobs mode (`J`).
 
 ## Filtering & Search
 
@@ -41,7 +45,9 @@ Complete reference of all keyboard shortcuts in **rufio**.
 |-----|--------|
 | `f` | Enter filter mode (type to filter) |
 | `s` | Search file names with fzf |
+| `/` | Search file names with fzf (same as `s`) |
 | `F` | Search file contents with rga |
+| `G` | Global search: file names or contents across all bookmarks |
 
 ## Bookmarks & Navigation
 
@@ -51,31 +57,33 @@ Complete reference of all keyboard shortcuts in **rufio**.
 | `B` | Bookmark menu (view/add/remove/script paths) |
 | `0` | Jump to startup directory |
 | `1-9` | Jump to bookmark 1-9 |
+| `Tab` | Cycle to next bookmark (Files mode) |
+| `Shift+Tab` | Cycle to previous bookmark (Files mode) |
 | `z` | Navigate using zoxide history (when nothing is selected) |
 
-## Command Mode & Tool Runtime
+## Modes & Tool Runtime
 
 | Key | Action |
 |-----|--------|
 | `:` | Enter command mode |
+| `G` | Global search mode |
+| `C` | Config mode: open `~/.config/rufio/` |
 | `J` | Job mode (view background jobs) |
 | `L` | View execution logs |
-
-## Mode Switching
-
-| Key | Action |
-|-----|--------|
-| `Tab` | Switch mode: Files -> Logs -> Jobs -> Help |
-| `Shift+Tab` | Switch mode (reverse direction) |
-| `?` | Enter help mode |
-| `ESC` | Exit current mode (help/filter/command) |
-| `q` | Quit rufio |
+| `?` | Open the floating help menu |
+| `q` | Quit rufio (with confirmation) |
 | `T` | Quit rufio and cd the shell to the current directory (requires `rufio --shell-init`) |
 
 ---
 
 ## Mode-Specific Keys
 
+### Preview
+- **P**: Open fullscreen file preview (hides the file list)
+- **j/k**: Scroll preview
+- **Ctrl+D/U**: Page down/up
+- **ESC**: Back to the file list
+
 ### Filter Mode
 - **Any character**: Add to filter query
 - **Backspace**: Remove last character
@@ -84,7 +92,7 @@ Complete reference of all keyboard shortcuts in **rufio**.
 
 ### Command Mode
 - **Any character**: Add to command input
-- **Tab**: Auto-complete (scripts, rake tasks, commands)
+- **Tab**: Auto-complete (scripts, rake tasks, commands, paths)
 - **Up/Down**: Navigate command history
 - **Enter**: Execute command
 - **Backspace**: Remove last character
@@ -94,27 +102,45 @@ Complete reference of all keyboard shortcuts in **rufio**.
 - `@script` - Execute a registered or local script
 - `rake:task` - Execute a Rakefile task
 - `!command` - Execute a shell command
+- `cd <path>` - Go to a directory (paste a path; a file path selects the file, `cd -` goes back, `Tab` completes directories)
 - `command` - Execute a built-in or plugin command
 
-### Help Mode
-- **j/k/h/l**: Navigate help files
-- **ESC**: Exit help mode and return to previous directory
+### Global Search (G)
+- **Type**: Filter results (literal, case insensitive)
+- **Tab**: Switch between file names and content
+- **Up/Down** or **Ctrl+J/K or Ctrl+N/P**: Select a result
+- **Enter**: Go to the selected file in Files mode
+- **Ctrl+U**: Clear the query
+- **ESC**: Return to the previous mode
+- Content search also reads `.pdf`, `.xlsx` and `.pptx`
 
-### Job Mode
+### Config Mode (C)
+- Same navigation, preview and file operations as Files mode
+- Leaving `~/.config/rufio/` returns to Files mode
+
+### Job Mode (J)
 - **j/k**: Navigate through jobs
+- **g/G**: First / last job
+- **Space**: View job log
+- **`x`: Cancel** the selected job (including ZIP jobs)
 - **ESC**: Exit job mode
 
+### Help Menu (?)
+- **1/2/3** or **Tab/Shift+Tab**: Switch section (Controls / Modes / Scripts)
+- **j/k**: Scroll | **Ctrl+D/U**: Page down/up | **g/G**: Top / bottom
+- **ESC**, **q** or **?**: Close and keep your current mode and directory
+
 ---
 
 ## Tips
 
 - **Vim users**: Navigation keys (`hjkl`) work exactly like Vim
 - **Selection**: Use `Space` to mark multiple files, then operate on all at once
-- **Quick access**: Number keys `1-9` provide instant access to bookmarks
+- **Quick access**: Number keys `1-9` and `Tab` provide instant access to bookmarks
 - **Filtering**: Press `f` and start typing for real-time filtering
 - **Rake tasks**: Type `:rake:` then `Tab` to see available tasks
 - **Local scripts**: Scripts in the current directory are auto-detected with `@` prefix
 
 ---
 
-*Press `?` anytime to return to help mode*
+*Press `?` anytime to open the help menu*

data/info/welcome.md

@@ -10,6 +10,8 @@ A TUI file manager that executes and coordinates tools and scripts from files.
 - **Vim-like Keybindings** - Navigate with `j/k/h/l` keys
 - **Real-time Filtering** - Press `f` to filter files instantly
 - **Advanced Search** - Use `fzf` for file names and `rga` for content search
+- **Global Search** - Press `G` to search names or contents (including PDF/Excel/PowerPoint) across all bookmarks
+- **ZIP Support** - Preview `.zip` contents, extract or compress selected items with `z`
 - **Bookmark Support** - Quick access to favorite directories
 - **Job Management** - Run commands in the background
 - **Plugin System** - Extend functionality with custom plugins
@@ -24,12 +26,18 @@ A TUI file manager that executes and coordinates tools and scripts from files.
 | `s` | Search with fzf |
 | `b` | Add bookmark |
 | `B` | Bookmark menu |
+| `Tab` | Next bookmark |
 | `z` | zoxide history / extract or compress selected items |
+| `G` | Global search across bookmarks |
+| `C` | Config mode |
 | `:` | Command mode |
 | `J` | Job mode |
-| `?` | Help mode |
-| `Tab` | Switch mode (Files / Logs / Jobs / Help) |
+| `L` | Execution logs |
+| `?` | Help menu |
 | `q` | Quit |
+| `T` | Quit and cd to the current directory |
+
+In G mode, use `Ctrl+J` / `Ctrl+K` to select the next / previous result and `Enter` to open it.
 
 ## Command Mode
 
@@ -38,12 +46,13 @@ Press `:` to enter command mode:
 - `@script.sh` - Execute a script
 - `rake:test` - Execute a rake task
 - `!git status` - Run a shell command
+- `cd ~/projects` - Go to a pasted path
 - `Tab` - Auto-complete commands
 
 ## Getting Help
 
-Press `?` to enter **Help Mode** where you can browse all documentation files.
-Press `ESC` to exit Help Mode.
+Press `?` to open the floating **Help Menu** (Controls / Modes / Scripts).
+Switch sections with `1/2/3` or `Tab`, scroll with `j/k`, and close with `ESC`.
 
 ## More Information
 

data/lib/rufio/command_completion.rb

@@ -3,6 +3,9 @@
 module Rufio
   # コマンド補完機能を提供するクラス
   class CommandCompletion
+    # CommandMode が直接処理する（DSL コマンドではない）コマンド
+    NAVIGATION_COMMANDS = %w[cd].freeze
+
     # 初期化
     # @param history [CommandHistory, CommandMode, nil] 履歴、または単独で渡すコマンドモード
     # @param command_mode [CommandMode, nil] コマンドモード（スクリプト補完に使用）
@@ -28,6 +31,11 @@ module Rufio
                rake_candidates('')
       end
 
+      # ディレクトリ補完（cd で始まる場合）
+      if (match = input.match(/\A\s*cd\s+(.*)\z/))
+        return complete_cd(match[1])
+      end
+
       # シェルコマンド補完（!で始まる場合）
       if input.strip.start_with?('!')
         return complete_shell_command(input.strip)
@@ -45,7 +53,7 @@ module Rufio
       end
 
       # 通常のコマンド補完（内部コマンド + rakeタスク）
-      available_commands = @command_mode.available_commands.map(&:to_s)
+      available_commands = @command_mode.available_commands.map(&:to_s) + NAVIGATION_COMMANDS
       input_lower = input.downcase
       candidates = available_commands.select do |command|
         command.downcase.start_with?(input_lower)
@@ -87,6 +95,19 @@ module Rufio
     # スクリプト候補を取得（ScriptRunner + ローカルスクリプト）
     # @param prefix [String] 入力中の文字列
     # @return [Array<String>] スクリプト候補（@付き）
+    # :cd のディレクトリ補完。相対パスは閲覧中ディレクトリを基準にする
+    def complete_cd(argument)
+      if argument.start_with?('~', '/') || File.absolute_path?(argument)
+        candidates = @shell_completion.complete_path(argument, directories_only: true)
+      else
+        base = @command_mode.browsing_directory || Dir.pwd
+        prefix = File.join(base, '')
+        candidates = @shell_completion.complete_path(File.join(base, argument), directories_only: true)
+                                      .map { |path| path.delete_prefix(prefix) }
+      end
+      candidates.map { |path| "cd #{path}/" }
+    end
+
     def script_candidates(prefix)
       @command_mode.complete_script("@#{prefix}")
     end

data/lib/rufio/command_mode.rb

@@ -45,6 +45,7 @@ module Rufio
     # 閲覧中ディレクトリを更新
     # @param directory [String] 現在の閲覧ディレクトリ
     def update_browsing_directory(directory)
+      @browsing_directory = directory
       @local_script_scanner.update_directory(directory)
       @rakefile_parser.update_directory(directory)
     end
@@ -56,6 +57,11 @@ module Rufio
       # 空のコマンドは無視
       return nil if command_string.nil? || command_string.strip.empty?
 
+      # ディレクトリ移動 (cd <path>)。実際の移動は TerminalUI が行う
+      if (match = command_string.strip.match(/\Acd(?:\s+(.*))?\z/m))
+        return resolve_cd(match[1].to_s, working_dir)
+      end
+
       # スクリプト実行 (@ で始まる場合)
       if command_string.strip.start_with?('@')
         return execute_script(command_string.strip[1..-1], working_dir)
@@ -103,6 +109,9 @@ module Rufio
       "⚠️  コマンドが見つかりません: #{command_name}"
     end
 
+    # 閲覧中ディレクトリ（:cd の補完基準）
+    attr_reader :browsing_directory
+
     # 利用可能なコマンドのリストを取得
     def available_commands
       @commands.keys
@@ -185,6 +194,17 @@ module Rufio
     # @param command_name [Symbol] コマンド名
     # @param command [Hash] コマンド情報 { command: DslCommand, source: String }
     # @return [Hash] 実行結果
+    # :cd の引数を移動先に解決する
+    # @return [Hash] { cd: { directory:, file: } } / { cd: :previous }、失敗時はエラーメッセージ
+    def resolve_cd(argument, working_dir)
+      return { cd: :previous } if argument.strip == '-'
+
+      result = PathJump.resolve(argument, working_dir || @browsing_directory || Dir.pwd)
+      return "⚠️  #{result[:error]}" unless result[:directory]
+
+      { cd: { directory: result[:directory], file: result[:file] } }
+    end
+
     def execute_unified_command(command_name, command)
       dsl_cmd = command[:command]
 

data/lib/rufio/config_loader.rb

@@ -51,6 +51,7 @@ module Rufio
           refresh:         'R',
           # ファイル操作
           open_file:       'o',
+          preview:         'P',
           rename:          'r',
           delete:          'd',
           create_file:     'a',

data/lib/rufio/dialog_renderer.rb

@@ -19,6 +19,9 @@ module Rufio
     # @option options [String] :border_color Border color ANSI code
     # @option options [String] :title_color Title color ANSI code
     # @option options [String] :content_color Content color ANSI code
+    # @option options [Integer] :scroll_offset First visible content line
+    # @option options [Integer] :total_lines Total scrollable content lines
+    # @option options [Integer] :visible_lines Number of visible scrollable lines
     def draw_floating_window_to_buffer(screen, x, y, width, height, title, content_lines, options = {})
       draw_window_cells(x, y, width, height, title, content_lines, options,
                         put_cell: ->(cx, cy, ch, fg: nil) { screen.put(cx, cy, ch, fg: fg) },
@@ -66,6 +69,9 @@ module Rufio
 
       bottom_y = y + height - 1
       print "\e[#{bottom_y};#{x}H#{border_color}└#{'─' * inner_width}┘#{reset_color}"
+      draw_scroll_indicators(x, y, width, height, options) do |cx, cy, label|
+        print "\e[#{cy};#{cx}H#{border_color}#{label}#{reset_color}"
+      end
     end
 
     # Calculate center position for a window
@@ -217,6 +223,26 @@ module Rufio
 
       bottom_y = y + height - 1
       put_str.call(x, bottom_y, "└#{'─' * inner_width}┘", fg: border_color)
+      draw_scroll_indicators(x, y, width, height, options) do |cx, cy, label|
+        put_str.call(cx, cy, label, fg: border_color)
+      end
+    end
+
+    # 枠内に表示し、本文や操作ガイドの行を消費しない。
+    def draw_scroll_indicators(x, y, width, height, options)
+      total = options[:total_lines]
+      visible = options[:visible_lines]
+      return unless total && visible && total > visible
+      return if width < 3 || height < 2
+
+      offset = [[options.fetch(:scroll_offset, 0), 0].max, total - visible].min
+      [[offset > 0, y, '▲ 上に続く'],
+       [offset + visible < total, y + height - 1, '▼ 下に続く']].each do |shown, row, text|
+        next unless shown
+
+        label = TextUtils.truncate_to_width(text, width - 2)
+        yield x + 1 + (width - 2 - TextUtils.display_width(label)) / 2, row, label
+      end
     end
 
     # ASCII character range constants

data/lib/rufio/file_operations.rb

@@ -246,16 +246,17 @@ module Rufio
         dest_path = File.join(destination, item_name)
 
         begin
-          if File.exist?(dest_path)
-            error_messages << "#{item_name}: Already exists in destination"
-            next
-          end
-
           case operation
           when :move
+            if File.exist?(dest_path)
+              error_messages << "#{item_name}: Already exists in destination"
+              next
+            end
             FileUtils.mv(source_path, dest_path)
           when :copy
-            if File.directory?(source_path)
+            is_directory = File.directory?(source_path)
+            dest_path = resolve_copy_destination(destination, item_name, is_directory)
+            if is_directory
               FileUtils.cp_r(source_path, dest_path)
             else
               FileUtils.cp(source_path, dest_path)
@@ -281,6 +282,27 @@ module Rufio
       )
     end
 
+    def resolve_copy_destination(destination, item_name, is_directory)
+      dest_path = File.join(destination, item_name)
+      return dest_path unless File.exist?(dest_path)
+
+      if is_directory
+        base = item_name
+        ext = ''
+      else
+        ext = File.extname(item_name)
+        base = File.basename(item_name, ext)
+      end
+
+      index = 1
+      loop do
+        candidate = File.join(destination, "#{base}_#{index}#{ext}")
+        return candidate unless File.exist?(candidate)
+
+        index += 1
+      end
+    end
+
     # Build delete operation message
     # @param success_count [Integer] Number of successfully deleted items
     # @param total_count [Integer] Total number of items

data/lib/rufio/global_search.rb

@@ -106,11 +106,11 @@ module Rufio
       when "\t"
         @search_type = @search_type == :filename ? :content : :filename
         start_scan
-      when "\r", "\n" then return @results[@selected_index]
+      when "\r" then return @results[@selected_index]
       when :down then @selected_index = [@selected_index + 1, [@results.length - 1, 0].max].min
       when :up then @selected_index = [@selected_index - 1, 0].max
-      when "\x0e" then handle_key(:down) # Ctrl+N
-      when "\x10" then handle_key(:up)   # Ctrl+P
+      when "\x0a", "\x0e" then handle_key(:down) # Ctrl+J / Ctrl+N
+      when "\x0b", "\x10" then handle_key(:up)   # Ctrl+K / Ctrl+P
       when "\x15" then update_query('')  # Ctrl+U
       when "\u007f", "\b" then update_query(@query[0...-1])
       else
@@ -169,7 +169,7 @@ module Rufio
         write_line(screen, 3, message, width)
       end
       write_line(screen, screen.height - 3, @results[@selected_index]&.[](:path) || @errors.first.to_s, width, "\e[90m")
-      write_line(screen, screen.height - 2, 'ESC: Back | Enter: Go to file | Up/Down: Select | Type: Search', width)
+      write_line(screen, screen.height - 2, 'ESC: Back | Enter: Go to file | Up/Down or Ctrl+J/K: Select | Type: Search', width)
     end
 
     private

data/lib/rufio/help_menu.rb

@@ -54,20 +54,23 @@ module Rufio
           'Navigation',
           "#{key(:move_down)}/#{key(:move_up)} or arrows: Move down/up",
           "#{key(:navigate_parent)}/#{key(:navigate_enter)}: Parent / enter directory",
-          'Enter: Open file preview | ESC: Back to file list',
+          "#{key(:preview)}: Fullscreen file preview | ESC: Back to file list",
           'Preview: j/k scroll, Ctrl+D/U page down/up',
           "#{key(:top)}/#{key(:bottom)}: First / last entry",
           "#{key(:open_file)}: Open in external editor",
+          "#{key(:open_explorer)}: Open directory in file explorer",
+          'Preview .zip: Entry list (size, method, date, name)',
           "#{key(:refresh)}: Refresh directory",
           '', 'Selection and file operations',
           "#{key(:select)}: Select / unselect file",
           "#{key(:copy_selected)}/#{key(:move_selected)}/#{key(:delete_selected)}: Copy / move / delete selected files",
           "#{key(:zoxide)}: Extract selected .zip files / compress selected items",
+          "  Runs as a job: #{key(:job_mode)} Jobs mode shows progress; x cancels",
           "#{key(:rename)}/#{key(:delete)}: Rename / delete current file",
           "#{key(:create_file)}/#{key(:create_dir)}: Create file / directory",
           '', 'Search and bookmarks',
           "#{key(:filter)}: Filter | Enter: Apply | ESC: Clear",
-          "#{key(:fzf_search)}: Filename search (fzf)",
+          "#{key(:fzf_search)} or #{key(:fzf_search_alt)}: Filename search (fzf)",
           "#{key(:rga_search)}: Content search (rga)",
           "#{key(:global_search)}: Search file names or contents across all bookmarks",
           "#{key(:add_bookmark)}/#{key(:bookmark_menu)}: Add / manage bookmarks",
@@ -99,14 +102,15 @@ module Rufio
           'GLOBAL_SEARCH_EXCLUDED_EXTENSIONS = %w[.zip .log]',
           'Applies to names and contents. Restart Rufio after editing.',
           'Extensions ignore case; leading dots are optional; [] excludes none.',
-          'Type to filter | Up/Down or Ctrl+N/P: Select',
+          'Type to filter | Up/Down or Ctrl+J/K or Ctrl+N/P: Select',
           'Enter: Go to the selected file in Files mode',
           'ESC: Return to the previous mode | Ctrl+U: Clear query',
           '', "[#{key(:log_viewer)}] Logs",
-          'Browse command logs. Enter opens a preview.',
+          "Browse command logs. #{key(:preview)} opens a fullscreen preview.",
           'ESC: Leave preview; ESC again: Return to Files.',
           '', "[#{key(:job_mode)}] Jobs",
           'View background commands and their status.',
+          'ZIP extract/compress jobs show progress here.',
           'Space: View log | x: Cancel job | ESC: Back',
           '', "[#{key(:help)}] Help",
           'This floating menu keeps your current mode and directory.',
@@ -115,6 +119,7 @@ module Rufio
           'Type a command, then Enter to run it.',
           'Tab: Complete | Up/Down: History | ESC: Cancel',
           ':!git status: Run a shell command',
+          ':cd <path>: Go to a pasted path (file: select it, cd -: back)',
           ':@hello.rb: Run a script in the current directory'
         ]
       when 'Scripts'
@@ -161,7 +166,8 @@ module Rufio
       DialogRenderer.new.draw_floating_window_to_overlay(
         screen, (screen.width - width) / 2, (screen.height - height) / 2,
         width, height, TextUtils.truncate_to_width(title, width - 2), visible,
-        border_color: "\e[36m", title_color: "\e[1;36m"
+        border_color: "\e[36m", title_color: "\e[1;36m",
+        scroll_offset: @scroll_offset, total_lines: lines.length, visible_lines: @page_size
       )
     end
 

data/lib/rufio/keybind_handler.rb

@@ -228,7 +228,7 @@ module Rufio
 
       entries = get_active_entries
 
-      # Enter キー（特殊処理: プレビューペインフォーカスまたはナビゲーション）
+      # Enter キー（ディレクトリ移動）
       if key == "\r" || key == "\n"
         return @nav_controller.handle_enter_key(current_entry, @in_help_mode, @in_log_viewer_mode)
       end
@@ -476,6 +476,7 @@ module Rufio
       when :top             then @nav_controller.move_to_top
       when :bottom          then @nav_controller.move_to_bottom(entries)
       when :refresh         then @nav_controller.refresh
+      when :preview         then focus_preview_pane
       when :open_file       then @nav_controller.open_current_file(current_entry)
       when :open_explorer   then @nav_controller.open_directory_in_explorer
       when :rename          then @file_op_controller.rename_current_file(current_entry)

data/lib/rufio/navigation_controller.rb

@@ -236,18 +236,14 @@ module Rufio
       end
     end
 
-    # Enterキーの処理：ファイルならプレビューフォーカス、ディレクトリならナビゲート
+    # Enterキーの処理：ディレクトリへ移動する
     # @param entry [Hash] 現在選択中のエントリ
     # @param in_help_mode [Boolean]
     # @param in_log_viewer_mode [Boolean]
     def handle_enter_key(entry, in_help_mode, in_log_viewer_mode)
       return false unless entry
 
-      if entry[:type] == 'file'
-        focus_preview_pane(entry)
-      else
-        navigate_enter(entry, in_help_mode, in_log_viewer_mode)
-      end
+      navigate_enter(entry, in_help_mode, in_log_viewer_mode)
     end
 
     private

data/lib/rufio/path_jump.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Rufio
+  # :cd に貼り付けられたパスを移動先に解決する。
+  # 引用符・末尾の改行・バックスラッシュエスケープされた空白・file:// URL を受け付け、
+  # ファイルを指す場合はその親ディレクトリとファイル自体を返す。
+  module PathJump
+    QUOTE_PAIRS = [%w[' '], %w[" "]].freeze
+
+    class << self
+      # @param input [String] 貼り付けられたパス（空なら ホーム）
+      # @param base_dir [String] 相対パスの基準ディレクトリ
+      # @return [Hash] { directory:, file: } または { directory: nil, error: }
+      def resolve(input, base_dir)
+        path = normalize(input.to_s)
+        path = '~' if path.empty?
+        expanded = File.expand_path(path, base_dir)
+
+        if File.directory?(expanded)
+          { directory: expanded, file: nil }
+        elsif File.file?(expanded)
+          { directory: File.dirname(expanded), file: expanded }
+        else
+          { directory: nil, error: "Path not found: #{path}" }
+        end
+      rescue ArgumentError => e
+        { directory: nil, error: "Invalid path: #{e.message}" }
+      end
+
+      private
+
+      def normalize(text)
+        path = text.strip
+        QUOTE_PAIRS.each do |open, close|
+          if path.length >= 2 && path.start_with?(open) && path.end_with?(close)
+            path = path[1..-2]
+            break
+          end
+        end
+        path = from_file_url(path) if path.start_with?('file://')
+        path = path.gsub(/\\(.)/, '\1') unless Gem.win_platform?
+        path
+      end
+
+      def from_file_url(url)
+        uri = URI.parse(url)
+        URI.decode_www_form_component(uri.path.to_s.gsub('+', '%2B'))
+      rescue URI::InvalidURIError
+        url.delete_prefix('file://')
+      end
+    end
+  end
+end

data/lib/rufio/terminal_ui.rb

@@ -617,6 +617,8 @@ module Rufio
 
     # マウス左クリックを処理する
     def handle_mouse_left_click(col, row)
+      return if @keybind_handler.preview_focused?
+
       left_width = left_panel_col_width
 
       if col <= left_width
@@ -662,10 +664,8 @@ module Rufio
     end
 
     # マウスホイールスクロールを処理する
-    def handle_mouse_scroll(direction, col, _row)
-      left_width = left_panel_col_width
-
-      if col > left_width && @keybind_handler.preview_focused?
+    def handle_mouse_scroll(direction, _col, _row)
+      if @keybind_handler.preview_focused?
         # プレビューペインのスクロール
         case direction
         when :up   then @keybind_handler.scroll_preview_up
@@ -790,6 +790,9 @@ module Rufio
 
       result = @command_mode.execute(command_string, working_dir: working_dir)
 
+      # :cd はディレクトリを移動してコマンドモードを閉じる
+      return change_directory(result[:cd]) if result.is_a?(Hash) && result.key?(:cd)
+
       # バックグラウンドコマンドの場合は結果表示をスキップ
       # (完了通知は別途メインループで表示される)
       if result && !result.to_s.include?("🔄 Running in background")
@@ -802,6 +805,28 @@ module Rufio
       # 使用するとコマンドプロンプトの枠線が残る不具合が発生する
     end
 
+    # :cd の移動先へ移動する。ファイルが指定されていればそのファイルを選択する
+    # @param target [Hash, Symbol] { directory:, file: } または :previous（cd -）
+    def change_directory(target)
+      if target == :previous
+        return @command_mode_ui.show_result('⚠️  No previous directory') unless @previous_directory
+
+        target = { directory: @previous_directory, file: nil }
+      end
+
+      origin = @directory_listing&.current_path
+      unless @keybind_handler.navigate_to_directory(target[:directory])
+        return @command_mode_ui.show_result("⚠️  Cannot open directory: #{target[:directory]}")
+      end
+
+      @previous_directory = origin
+      index = target[:file] && @keybind_handler.get_active_entries.index { |entry| entry[:path] == target[:file] }
+      @keybind_handler.select_index(index || 0)
+      @keybind_handler.unfocus_preview_pane
+      @tab_mode_manager&.switch_to(@keybind_handler.config_mode? ? :config : :files)
+      deactivate_command_mode
+    end
+
     # Tab補完を処理
     def handle_tab_completion
       # 補完候補を取得