rufio 1.1.0 → 1.4.0

data/README_ja.md

@@ -32,8 +32,10 @@ rufio は、ファイルを探すところからスクリプトの実行、結
 ### ファイルマネージャーとして
 
 - **Vimライクなキーバインド**: 直感的なナビゲーション
-- **リアルタイムプレビュー**: ファイル内容を即座に表示（`bat` によるシンタックスハイライト対応）
-- **高速検索**: fzf/rgaとの連携
+- **リアルタイムプレビュー**: ファイル内容を即座に表示（`bat` によるシンタックスハイライト対応、`.zip` はエントリ一覧）
+- **高速検索**: fzf/rgaとの連携に加え、PDF・Excel・PowerPointも読める全ブックマーク横断検索を内蔵
+- **ZIPの展開・圧縮**: 選択したアイテムをバックグラウンドで展開・圧縮
+- **パスへ移動**: コピーしたパスを `:cd` に貼り付けて移動
 - **ブックマーク**: よく使うディレクトリに素早くアクセス
 - **zoxide連携**: スマートなディレクトリ履歴
 
@@ -78,277 +80,38 @@ rufio /path/to  # 指定したディレクトリで起動
 
 ## キーバインド
 
-### 基本操作
+よく使うキーです。すべてのキーとモードは **[操作ガイド](./docs/guide_ja.md)** を参照するか、rufio の中で `?` を押してください。
 
-| キー | 機能 |
+| キー | 操作 |
 |------|------|
-| `j/k` | 上下移動 |
-| `h/l` | 親/子ディレクトリ |
-| `g/}` | 先頭/末尾 |
-| `Enter` | ディレクトリに入る/ファイルを開く |
-| `q` | 終了 |
-
-### ファイル操作
-
-| キー | 機能 |
-|------|------|
-| `Space` | 選択/選択解除 |
-| `o` | 外部エディタで開く |
-| `a/A` | ファイル/ディレクトリ作成 |
-| `r` | リネーム |
-| `d` | 削除 |
-| `m/c/x` | 移動/コピー/削除（選択済み） |
-
-### 検索・フィルター
-
-| キー | 機能 |
-|------|------|
-| `f` | フィルターモード |
-| `s` | fzfでファイル検索 |
-| `F` | rgaでファイル内容検索 |
-
-### ナビゲーション
-
-| キー | 機能 |
-|------|------|
-| `b` | ブックマーク追加 |
-| `B` | ブックマークメニュー |
-| `0` | 起動ディレクトリに戻る |
-| `1-9` | ブックマークにジャンプ |
-| `Tab` | 次のブックマークへ循環移動（Filesモード限定） |
-| `z` | zoxide履歴 |
-
-### ツールランタイム
-
-| キー | 機能 |
-|------|------|
-| `:` | コマンドモード |
-| `J` | ジョブモード |
-| `L` | 実行ログ表示 |
+| `j/k`、`h/l` | 上下移動 / 親ディレクトリ / ディレクトリに入る |
+| `g/}` | 先頭 / 末尾 |
+| `P` | 全画面プレビュー |
+| `Space` | 選択 |
+| `m/c/x` | 選択したアイテムの移動 / コピー / 削除 |
+| `z` | 選択したアイテムの展開・圧縮（`.zip`）。未選択時は zoxide 履歴 |
+| `a/A`、`r`、`d` | ファイル / ディレクトリ作成、リネーム、削除 |
+| `f`、`s`、`F` | フィルター、fzf でファイル名検索、rga で内容検索 |
+| `G` | 全ブックマーク配下のファイル名・内容（PDF・Excel・PowerPoint も）を横断検索 |
+| `b`、`B`、`1-9`、`Tab` | ブックマーク追加、メニュー、ジャンプ、次のブックマーク |
+| `:` | コマンドモード（`@スクリプト`、`rake:タスク`、`!シェル`、`cd <パス>`） |
+| `J`、`L`、`C` | ジョブ、ログ、設定ディレクトリ |
 | `?` | ヘルプ |
-| `G` | 全ブックマーク配下のファイル名・ファイル内容を横断検索 |
-| `C` | ~/.config/rufio/を開く（Configモード、操作はFilesと共通） |
-| `Shift+Tab` | モード切り替え（逆順） |
-
-### Gモード（横断検索）
-
-`G` を押すと、ブックマークした全ディレクトリの配下を再帰的に検索します。
-Tabで **File names（ファイル名）** と **Content（ファイル内容）** を切り替えます。
-大文字・小文字を区別しない文字列の部分一致で検索し、内容検索ではファイル名・行番号・一致した行を表示します。
-テキストはUTF-8として読み込み、先頭8 KBにNULバイトがあるファイルはバイナリとしてスキップします。
-上下矢印または `Ctrl+N/P` で選択、
-Enterで選んだファイルの場所へ移動します。`Ctrl+U` で検索語をクリアし、
-Escで元の表示に戻ります。検索はバックグラウンドで進みます。
-検索対象は `b` で登録したブックマークです。外部検索ツールは不要です。
-アクセスできないディレクトリはスキップし、ディレクトリのシンボリックリンクは辿りません。
-検索中は黄色の `Searching...` と動くスピナーを表示します。
-結果がまだ見つかっていない間も表示が動き、完了すると緑の `Search complete` に切り替わります。
-
-ファイル名検索・内容検索から特定の拡張子を除外するには、
-`~/.config/rufio/config.rb` に以下を追加してRufioを再起動します。
-
-```ruby
-GLOBAL_SEARCH_EXCLUDED_EXTENSIONS = %w[.png .jpg .zip .tar.gz .log].freeze
-```
-
-大文字・小文字は区別せず、先頭のドットは省略できます。デフォルトは `[]`（拡張子の除外なし）です。
-ディレクトリ名には適用しません。
-
-### Configモード（C）
-
-`C` で `~/.config/rufio/` を開きます。ディレクトリがなければ作成します。
-移動・プレビュー・ファイル操作はFilesモードと共通で、設定やスクリプトを直接編集できます。
-設定ディレクトリの外へ移動すると、モード表示がFilesに戻ります。
-
-## コマンドモード
-
-`:` でコマンドモードを起動し、様々なコマンドを実行できます。
-
-### スクリプト実行
-
-```
-:@build           # @で始まるとスクリプト補完
-:@deploy.rb       # 登録済みスクリプトを実行
-```
-
-### シェルコマンド
-
-```
-:!git status      # !で始まるとシェルコマンド
-:!ls -la          # バックグラウンドで実行
-```
-
-### 組み込みコマンド
-
-```
-:hello            # 挨拶メッセージ
-:stop             # rufioを終了
-```
-
-## スクリプトパス
-
-### スクリプトパスとは
-
-スクリプトファイルを配置するディレクトリを登録する機能です。登録したディレクトリ内のスクリプトは、コマンドモードで `@` プレフィックスを使って実行できます。
-
-### 管理方法
-
-`B` → `3` でスクリプトパス管理メニューを開きます：
-
-- 登録済みパスの一覧表示
-- `d`: パスを削除
-- `Enter`: ディレクトリにジャンプ
-- `ESC`: メニューを閉じる
-
-### 対応スクリプト
-
-| 拡張子 | 言語 |
-|--------|------|
-| `.rb` | Ruby |
-| `.py` | Python |
-| `.ps1` | PowerShell |
-| `.sh` | Shell (bash/zsh) |
-
-## DSLコマンド
-
-`~/.config/rufio/commands.rb` でカスタムコマンドを定義できます：
-
-```ruby
-command "hello" do
-  ruby { "Hello from rufio!" }
-  description "挨拶コマンド"
-end
-
-command "status" do
-  shell "git status"
-  description "Gitステータス"
-end
-
-command "build" do
-  script "~/.config/rufio/scripts/build.rb"
-  description "ビルド実行"
-end
-```
-
-## 設定
-
-### 設定ファイル構成
-
-```
-~/.config/rufio/
-├── config.rb         # メイン設定（スクリプトパス、カラー等）
-├── commands.rb       # DSLコマンド定義
-├── bookmarks.json    # ブックマーク
-├── scripts/          # スクリプトファイル
-└── logs/             # 実行ログ
-```
-
-### 設定例
-
-```ruby
-# ~/.config/rufio/config.rb
-
-# スクリプトパス - スクリプトを配置するディレクトリ
-SCRIPT_PATHS = [
-  '~/.config/rufio/scripts',
-  '~/my-scripts',
-  './scripts'
-].freeze
-
-# カラー設定（HSL形式推奨）
-COLORS = {
-  directory: { hsl: [220, 80, 60] },
-  file: { hsl: [0, 0, 90] },
-  executable: { hsl: [120, 70, 50] },
-  selected: { hsl: [50, 90, 70] },
-  preview: { hsl: [180, 60, 65] }
-}.freeze
-```
+| `q`、`T` | 終了、終了してシェルを現在のディレクトリへ移動 |
 
-### ローカル設定
+Gモードでは `Ctrl+J` / `Ctrl+K` で次／前の検索結果を選択し、`Enter` で開きます。
 
-プロジェクトルートに `rufio.rb` を配置すると、そのプロジェクト専用のスクリプトパスを設定できます：
-
-```ruby
-# ./rufio.rb（プロジェクトルート）
-SCRIPT_PATHS = [
-  './scripts',
-  './bin'
-].freeze
-```
-
-## 外部ツール連携
-
-rufioは以下の外部ツールと連携して機能を拡張します。
-すべて**オプション**です。インストールなしでも rufio は正常動作します。
-
-| ツール | 用途 | キー | 必須 |
-|--------|------|------|------|
-| fzf | ファイル名検索 | `s` | オプション |
-| rga | ファイル内容検索 | `F` | オプション |
-| zoxide | ディレクトリ履歴 | `z` | オプション |
-| bat | プレビューのシンタックスハイライト | — | オプション |
-
-### bat — シンタックスハイライト
-
-`bat` をインストールすると、プレビューペインでコードファイルを開いた際に
-シンタックスハイライトが表示されます（Ruby、Python、Go、Rust、TypeScript など15言語以上対応）。
-
-ハイライトはバックグラウンドで非同期に読み込まれるため、大きなソースツリーでも
-カーソル移動が重くなりません。
-
-```bash
-# macOS
-brew install bat
+## ドキュメント
 
-# Ubuntu/Debian
-apt install bat
-```
-
-`rufio -c` を実行すると bat が正しく認識されているか確認できます。
-
-### インストール（全ツール）
-
-```bash
-# macOS
-brew install fzf bat rga zoxide
-
-# Ubuntu/Debian
-apt install fzf bat zoxide
-# rgaは別途インストール: https://github.com/phiresky/ripgrep-all
-```
-
-## 高度な機能
-
-### ネイティブスキャナー（実験的）
-
-高速なディレクトリスキャンのためのネイティブ実装をサポート：
-
-```bash
-rufio --native        # 自動検出
-rufio --native=zig    # Zig実装
-```
-
-### JITコンパイラ
-
-```bash
-rufio --yjit   # Ruby 3.1+ YJIT
-rufio --zjit   # Ruby 3.4+ ZJIT
-```
-
-### ヘルスチェック
-
-```bash
-rufio -c              # システム依存関係をチェック
-rufio --check-health  # 同上
-```
+- **[操作ガイド](./docs/guide_ja.md)**: キー・モード・コマンドモード・スクリプト・DSL コマンド・設定・シェル連携・ネイティブエンジン
+- **[CHANGELOG](./CHANGELOG.md)**: リリースノート
+- **[SECURITY.md](./SECURITY.md)**: セキュリティ設計
 
 ## 開発
 
 ### 必要な環境
 
 - Ruby 2.7.0以上
-- io-console, pastel, tty-cursor, tty-screen gems
 
 ### 開発版の実行
 

data/Rakefile

@@ -14,10 +14,23 @@ end
 # Default task
 task default: :test
 
+# Zig native library tasks
+namespace :native do
+  desc 'Cross-compile the Zig library for every bundled platform (requires zig)'
+  task :build do
+    sh 'make -C lib_zig/rufio_native dist'
+  end
+
+  desc 'Verify bundled Zig binaries for macOS, Linux and Windows'
+  task :check do
+    ruby '-I test -I lib test/test_native_platform_binaries.rb'
+  end
+end
+
 # Gem build and push tasks
 namespace :gem do
   desc 'Build the gem file'
-  task :build do
+  task :build => 'native:check' do
     puts "Building rufio v#{Rufio::VERSION}..."
     
     # Clean old gem files

data/bin/rufio

@@ -19,6 +19,8 @@ start_directory = nil
 test_mode = false
 yjit_mode = false
 zjit_mode = false
+choosedir = nil
+shell_init = nil
 skip_next = false
 
 ARGV.each_with_index do |arg, idx|
@@ -49,6 +51,21 @@ ARGV.each_with_index do |arg, idx|
     end
   when /^--native=(rust|go|auto|ruby)$/
     native_mode = $1
+  when '--choosedir'
+    choosedir = ARGV[idx + 1]
+    skip_next = true
+  when /^--choosedir=(.+)$/
+    choosedir = $1
+  when '--shell-init'
+    # 次の引数がシェル名なら使い、なければ OS から判定する
+    if Rufio::ShellInit::SHELLS.include?(ARGV[idx + 1]) || ARGV[idx + 1] == 'pwsh'
+      shell_init = ARGV[idx + 1]
+      skip_next = true
+    else
+      shell_init = Rufio::ShellInit.detect
+    end
+  when /^--shell-init=(.+)$/
+    shell_init = $1
   when '-c', '--check-health', '--help', '-h', '--yjit', '--zjit'
     # これらは後で処理
   when /^--/
@@ -70,7 +87,15 @@ if ENV['RUFIO_NATIVE'] && defined?(Rufio::NativeScanner)
 end
 
 # コマンド処理
-if ARGV.include?('--check-health') || ARGV.include?('-c')
+if shell_init
+  begin
+    print Rufio::ShellInit.script(shell_init)
+    exit(0)
+  rescue ArgumentError => e
+    warn e.message
+    exit(1)
+  end
+elsif ARGV.include?('--check-health') || ARGV.include?('-c')
   # ヘルスチェック実行
   health_checker = Rufio::HealthChecker.new
   success = health_checker.run_check
@@ -87,6 +112,9 @@ elsif ARGV.include?('--help') || ARGV.include?('-h')
   puts "  --test                    Show FPS counter in footer (for performance testing)"
   puts "  --yjit                    Enable YJIT JIT compiler (Ruby 3.1+)"
   puts "  --zjit                    Enable ZJIT JIT compiler (Ruby 3.4+)"
+  puts "  --shell-init [SHELL]      Print the rf shell function (cd on T quit)"
+  puts "                            SHELL: bash|zsh|fish|powershell (default: by OS)"
+  puts "  --choosedir FILE          Write the directory to FILE when quitting with T"
   if defined?(Rufio::NativeScanner)
     puts "  --native[=MODE]           Enable native scanner (experimental)"
     puts "                            MODE: auto|rust|go (default: auto)"
@@ -117,11 +145,12 @@ elsif ARGV.include?('--help') || ARGV.include?('-h')
     puts "  RUFIO_NATIVE=rust rufio   # Use Rust via environment variable"
   end
   puts "  rufio -c                  # Check dependencies"
+  puts "  eval \"$(rufio --shell-init)\"  # Add rf to bash/zsh (T quits and cd)"
   exit(0)
 else
   start_directory ||= Dir.pwd
 
   # アプリケーション開始
-  app = Rufio::Application.new(start_directory)
+  app = Rufio::Application.new(start_directory, choosedir: choosedir)
   app.run(test_mode: test_mode)
 end

data/docs/fast_zip_design_ja.md

@@ -0,0 +1,167 @@
+# FastZip 実装検討（rufio 1.3）
+
+ブランチ: `v1.3.0`
+ステータス: Phase 1〜5 実装済み（Pure Ruby の一覧・展開・作成、`z` キー、Zig エンジンの並列展開・圧縮、8 プラットフォームのバイナリ同梱）
+
+「FastZip 開発構想メモ（Ruby × Zig ネイティブ拡張アーカイバ）」を rufio 1.3 の機能として取り込む前提で、既存コードとの整合と実装方針を整理する。
+
+---
+
+## 1. 結論
+
+| 項目 | 構想メモ | 本検討での方針 |
+|------|----------|----------------|
+| 置き場所 | 独立Gem `fast_zip` | まず rufio 内の機能として実装。ABIが Ruby 非依存なので、後から Gem に切り出せる |
+| Ruby との接続 | C拡張（`Init_fast_zip` + `rb_thread_call_without_gvl`） | **既存の流儀に合わせて Fiddle + Ruby ABI 非依存の C 関数** |
+| GVL 解放 | 自前で `rb_thread_call_without_gvl` | Fiddle が既定で解放する（下記 2.3）。長時間処理は既存スキャナと同じ「ハンドル＋ポーリング」型にしてキャンセル可能にする |
+| ネイティブ非搭載環境 | 記載なし | **Pure Ruby 実装を必須のフォールバック兼リファレンス**とする（Phase 1 で実装済み） |
+| 最初のユーザー価値 | — | `.zip` をプレビューペインで一覧表示（`unzip -l` 相当）※実装済み |
+
+### 1.1 決定事項（2026-10-31）
+- C 拡張にはしない。既存の Zig 連携（Fiddle + Ruby ABI 非依存の C 関数）で実装する
+- Pure Ruby 版は残す（ネイティブ非搭載環境のフォールバック兼、互換性の基準）
+- 展開時の安全対策を入れる（4.2）
+- ネイティブバイナリはビルド済みのものを Gem に同梱して配る（1.2 の `make dist` の 8 プラットフォーム）
+- 操作は Files モードで選択後に `z`（すべて .zip なら展開、それ以外は圧縮）。暗号化エントリはスキップのまま
+- 展開上限は現在の値（合計 16GiB / 10 万エントリ / 1MiB 超で 1000:1）で確定。対応方式は Stored と Deflate のみ
+
+---
+
+## 2. 現状調査（事実）
+
+### 2.1 rufio のアーカイブ対応
+- `FilePreview#determine_file_type` は `.zip` 等を `archive` と判定するが、実際はバイナリ判定が先に走り「Binary file / Cannot preview」と表示されていた。
+- 圧縮・展開機能はない。
+
+### 2.2 既存の Zig ネイティブ拡張（1.2.0 時点）
+- ソース: `lib_zig/rufio_native/src/`（`main.zig` がエクスポート、`search.zig` がコンテンツ検索、`os.zig` が OS 差分の吸収）。Ruby ヘッダは include せず、`core_async_*` / `core_search_*` / `core_cache_*` という **Ruby ABI 非依存の C 関数**をエクスポートしている。
+- Ruby 側: `lib/rufio/native_scanner_zig.rb` が `Fiddle::Importer` でロード。関数グループごとに `search_available?` のような判定があり、古いバイナリでも Ruby 実装に切り替わる。
+- ビルド: Zig 0.17。`make -C lib_zig/rufio_native dist` で macOS（arm64/x86_64）・Linux（x86_64/aarch64、glibc 2.17+ と musl）・Windows（x64/arm64）の 8 種類をクロスコンパイルし、`lib/rufio/native/<platform>/` に同梱する。
+- `test/test_native_platform_binaries.rb` が各バイナリの形式・CPU・必須エクスポート（`REQUIRED_EXPORTS`）を検証している。
+- 1.2.0 で `rubyzip`（`>= 2.4, < 3.0`）が G モードの `.pptx` 読み取り用に依存関係に入った。ただし rubyzip 2.4 はファイル名を ASCII-8BIT で保持し、UTF-8 文字列で引けない（このブランチのテストで確認）。プレビュー・展開・作成は本実装を使い、rubyzip は相互運用テストの相手として使う。
+
+### 2.3 Fiddle と GVL
+- 本環境の fiddle 1.1.8 の `ext/fiddle/function.c` では、`need_gvl` の既定値が `Qfalse` で、その場合 `rb_thread_call_without_gvl` 経由で関数を呼ぶ。`Fiddle::Importer#extern` は `need_gvl` を指定しないので、**既存の Zig 関数呼び出しは GVL を解放して実行されている**。
+- したがって構想メモの「GVL 解放のための C 拡張化」は、Fiddle 経由でも同じ効果が得られる。C 拡張にすると Ruby のマイナーバージョンごとにバイナリが必要になるデメリットの方が大きい。
+- ただし Fiddle の GVL 解放ではキャンセル（unblock 関数）が指定できない。TUI から中断できるようにするため、展開・圧縮は既存スキャナと同じ非同期ハンドル方式を採る。
+
+### 2.4 Ruby 標準 zlib でできること
+- 構想メモの「zlib は ZIP 構造を扱えない」は正しいが、ZIP のコンテナ構造（EOCD / Central Directory / Local Header）は数百行の Ruby で扱える（Phase 1 で実装）。
+- `Zlib::Inflate.new(-Zlib::MAX_WBITS)` / `Zlib::Deflate.new(level, -Zlib::MAX_WBITS)` で raw DEFLATE を扱え、`Zlib.crc32` もある。つまり **Pure Ruby + zlib だけで Store / Deflate の展開・作成まで実装できる**。ネイティブ実装は「速度のための加速器」という位置づけになる。
+
+---
+
+## 3. 実装内容（このブランチ）
+
+### 3.1 `Rufio::ZipArchive`（`lib/rufio/zip_archive.rb`）
+読み取り専用。ファイル本体は読まず、末尾と Central Directory だけを読む。
+
+- EOCD の後方探索（末尾 22 + 65535 バイト）。コメント長が整合し、かつ指す先に Central Directory シグネチャがある候補のみ採用（コメント内の偽シグネチャ対策）
+- ZIP64（ZIP64 EOCD Locator / ZIP64 EOCD / ZIP64 拡張フィールド 0x0001）
+- ファイル名のエンコーディング: 汎用フラグ bit 11 → UTF-8、Info-ZIP Unicode Path 拡張（0x7075、CRC 一致時のみ）、UTF-8 として不正なら CP932（Windows 日本語環境で作られた ZIP）として解釈、それも失敗したら置換文字
+- DOS 日時の変換、ディレクトリ・暗号化フラグの判定
+- `limit:` で先頭 N 件だけ読む（プレビュー用。総数は EOCD から得る）
+- 範囲外オフセット・切り詰められたファイルは `ZipArchive::FormatError`
+- マルチディスク（分割）ZIP は非対応
+
+### 3.2 プレビュー統合
+- `FilePreview#preview_file` で拡張子 `.zip` または先頭が `PK\x03\x04` / `PK\x05\x06` のファイルを `type: "archive"` として一覧表示（最大 200 件、超過分は件数のみ）
+- 壊れた ZIP は `Invalid ZIP archive: <理由>` をエラー表示
+- `UIRenderer#extract_preview_lines` が `archive` を表示対象に追加
+
+### 3.3 テスト（`test/test_zip_archive.rb`）
+フィクスチャはテスト内の最小 ZIP ライタで生成し、外部コマンドに依存しない。加えて `zip` / `unzip` がある環境では `unzip -Z1` の一覧と完全一致することを確認する（ない環境では skip）。
+
+### 3.4 計測（参考値）
+環境: このクラウドコンテナ（Linux x86_64, Ruby 3.3.6）、`zip -qr` で作成した 20,001 エントリ / 3.2MB の ZIP。各 5 回平均。
+
+| 処理 | 時間 |
+|------|------|
+| `ZipArchive.list`（全 20,001 件） | 176 ms |
+| `ZipArchive.list(limit: 200)` | 1.9 ms |
+| `FilePreview#preview_file`（200 件表示） | 1.9 ms |
+| 参考: `unzip -l`（全件を標準出力へ、`time` の real） | 55 ms |
+
+プレビュー用途では Pure Ruby で十分速い。ネイティブ化の効果が出るのは「全件走査」と「展開・圧縮（データ本体の処理）」である。
+
+---
+
+### 3.5 Phase 2: 展開・作成（Pure Ruby）
+- `Rufio::ZipExtractor`（`lib/rufio/zip_extractor.rb`）: Stored / Deflate の展開。安全対策は 4.2 をすべて実装。書き込み前に全エントリを検証し、危険なエントリが 1 件でもあれば何も書かない。進捗コールバックとキャンセルに対応。
+- `Rufio::ZipWriter`（`lib/rufio/zip_writer.rb`）: ファイル・ディレクトリから ZIP を作成。UTF-8 名、縮まないファイルは Stored、ZIP64（4GiB 超・65535 件超）、シンボリックリンクと出力先自身はスキップ、一時ファイル経由で失敗時に残骸を残さない。
+- テスト: `test/test_zip_extractor.rb` / `test/test_zip_writer.rb`。`zip` コマンド製（データディスクリプタ付きを含む）の展開、作成物の `unzip -t` 通過、rubyzip での読み取り、70,000 件での ZIP64 を確認。
+
+## 4. 計画
+
+| Phase | 内容 | 実装 | 備考 |
+|-------|------|------|------|
+| 2 | Store / Deflate の展開・作成 | Pure Ruby + zlib | **実装済み**。ネイティブ版のテストオラクルにする |
+| 3 | Zig コア（展開・圧縮のデータ処理） | Zig + Fiddle | **実装済み**。同じテストを両実装で回す |
+| 4 | 並列展開・並列圧縮 | Zig（ワーカースレッド） | **実装済み**。最大 16 スレッド、既定は CPU 数 |
+| 5 | 配布・ベンチマーク | — | **実装済み**。`make dist` で 8 プラットフォーム分を同梱、`REQUIRED_EXPORTS` に `core_zip_*` を追加 |
+
+### 4.1 TUI への組み込み（実装済み）
+- Files モードで `Space` で選択してから `z`。選択がすべて `.zip` なら展開、それ以外は圧縮（`lib/rufio/archive_controller.rb`）
+  - 展開: 確認ダイアログの後、各 ZIP を現在のディレクトリの `<名前>/` に展開（既にあれば `<名前> 2/` …）。失敗・キャンセル時は作った展開先を削除する
+  - 圧縮: アーカイブ名を入力（空 Enter で 1 件なら `<名前>.zip`、複数なら `Archive.zip`）。同名ファイルがあればエラー通知
+  - `..` は対象外
+- 選択がなければ `z` は従来どおり zoxide（キー設定 `zoxide` を共用）
+- 処理は `JobManager` のジョブとしてバックグラウンドスレッドで実行。ジョブ名に 5% 刻みで進捗を表示し、Jobs モードのキャンセルで中断できる。完了時に通知し、表示中のディレクトリなら一覧を再読み込みする
+- 暗号化エントリはスキップ（決定事項）
+
+### 4.2 安全性要件（実装済み。Ruby と Zig で共通）
+- **Zip Slip**: `..`、絶対パス、Windows のドライブレター・`\` 区切りを含むエントリを拒否し、展開先ディレクトリ外に書かない
+- **シンボリックリンク**: 外部属性で symlink を示すエントリは展開しない。展開先に既にあるシンボリックリンクも辿らない
+- **ZIP 爆弾**: 展開後合計サイズ・圧縮率・エントリ数の上限。Central Directory 上のサイズを信用せず、実際に書いたバイト数で打ち切る。Local Header の範囲が重なるエントリ（重複参照型の爆弾）を拒否
+- **CRC-32 検証**: 不一致なら展開したファイルを削除してエラー
+- **既存ファイルの上書き**: 既定は拒否（`overwrite: true` で上書き）。UI では確認ダイアログを出す想定
+- **ファイルモード**: 実行権限だけを引き継ぎ、setuid / setgid / sticky と他者書き込み権限は付けない
+- 暗号化エントリ（ZipCrypto / AES）は初期は非対応としてスキップ
+
+### 4.3 Zig エンジン（実装済み）
+`lib_zig/rufio_native/src/zip.zig`。役割分担は次のとおりで、安全性の検証は Ruby 実装と共通にした。
+
+| 処理 | 担当 |
+|------|------|
+| Central Directory の解析、パス正規化、上限・重複範囲・シンボリックリンクの検証、ディレクトリ作成 | Ruby |
+| ZIP 内のデータ範囲を読み、伸長し、宣言サイズ超過で打ち切り、CRC-32 を検証して一時ファイルに書く | Zig（エントリ単位で並列） |
+| 一時ファイルの rename、権限・日時の設定、失敗時の一時ファイル削除 | Ruby |
+| ファイルを raw DEFLATE で一時ファイルへ圧縮し、CRC-32 とサイズを返す（1MiB 以上のファイルのみ） | Zig（ファイル単位で並列） |
+| ローカルヘッダ・Central Directory・ZIP64 を書いてアーカイブを組み立てる | Ruby |
+
+- エクスポート: `core_zip_extract_create` / `core_zip_deflate_create` / `core_zip_state` / `core_zip_progress` / `core_zip_status` / `core_zip_deflate_result` / `core_zip_cancel` / `core_zip_destroy`
+- Ruby 側は `NativeScannerZigFFI.zip_available?` で関数グループの有無を判定し、ない場合（古いバイナリ）や `RUFIO_NATIVE_ZIP=0` では Pure Ruby を使う
+- DEFLATE は Zig 標準ライブラリの `std.compress.flate`、CRC-32 は `std.hash.Crc32`。libdeflate は同梱していない
+- ファイル操作は `os.zig` に追加（Linux は直接システムコール、macOS は libc、Windows は Win32。位置指定読み込み・排他作成・書き込み）
+- `flate.Compress` は約 230KB あり初期化時にスタックへ載るため、ワーカースレッドのスタックは 4MB
+- 1MiB 未満のファイルの圧縮は Ruby の zlib で行う。小さいファイルを Zig に渡すと、一時ファイルの作成・コピー・削除の分だけ遅くなった（2 万ファイルで 0.98 秒 → 5.26 秒）ため
+- テスト: `test/test_zip_extractor.rb` / `test/test_zip_writer.rb` の全テストを `TestZipExtractorNative` / `TestZipWriterNative` で Zig 実装でも実行。Debug ビルド（安全チェック有効）でも全件通過を確認
+
+### 4.4 計測（このクラウドコンテナ、4 CPU、Linux x86_64、ReleaseFast、各 3 回の最小値）
+
+| データ | 処理 | Ruby | Zig | zip / unzip |
+|--------|------|------|-----|-------------|
+| 8 ファイル × 64MB のテキスト | 圧縮 | 15.36 秒 | 3.34 秒 | 20.20 秒 |
+| 同上 | 展開 | 3.03 秒 | 0.94 秒 | 4.11 秒 |
+| 2 万ファイル・計 79MB | 圧縮 | 0.93 秒 | 0.90 秒 | 0.30 秒 |
+| 同上 | 展開 | 5.82 秒 | 5.00 秒 | 4.62 秒 |
+
+- 圧縮後サイズは Zig の方がやや大きい（512MB → Ruby/zlib 67MB、Zig 71MB）。同じレベル指定でも実装が異なるため
+- 小さいファイル大量の展開はファイル作成が律速で、計測ごとのばらつきが大きい（`sync` を挟まない計測では unzip 1.4〜1.8 秒、Ruby/Zig 3〜6 秒）。ファイルごとの Ruby 側処理（rename・chmod・utime）が残るため、unzip との差は縮め切れていない
+
+## 5. 技術的な注意点（構想メモへのコメント）
+
+- **libdeflate はストリーミング API を持たない**（バッファ全体を一度に処理する設計）。巨大エントリを扱うにはエントリ全体をメモリに載せるか mmap が必要。メモリ上限の設計とセットで検討する。ライセンスは MIT。
+- **CRC-32**: 自前の SIMD 実装より、libdeflate の `libdeflate_crc32`（CPU 機能に応じた高速版を内部で選択）を使う方が保守コストが低い。
+- **mmap**: POSIX と Windows で API が異なる。Windows 対応を続けるなら抽象化が必要（rufio は Windows 対応の修正を継続的に入れている）。
+- **Zig のバージョン固定**: 既存 `build.zig` は `addExecutable(.{ .root_source_file = ... })` の書式。Zig はリリースごとにビルド API・標準ライブラリ（`std.compress.flate` 含む）が変わっているため、採用前に対象バージョンを決めて動作確認する必要がある（本検討では未確認）。
+- **圧縮率**: 構想メモの通り DEFLATE は 32KB 窓・エントリ単位圧縮なので 7z には勝てない。比較軸は速度と OS 標準互換性に絞る。
+
+---
+
+## 6. 要判断事項
+1. **独立 Gem 化のタイミング**: rufio 内で安定させてからか、`fast_zip` として切り出すか
+
+## 7. 未確認事項
+- Zig 版は Linux x86_64（このコンテナ）でのみ実行・計測した。macOS / Windows / aarch64 向けはクロスコンパイルとバイナリ形式・エクスポートの検証（`rake native:check`）までで、実機では動かしていない。特に Windows のファイル操作（`CreateFileW` / 位置指定 `ReadFile`）は未実行
+- 計測は 1 環境・1 種類のデータのみ。CPU 数やストレージによって倍率は変わる