# Zenith Filer ユーザマニュアル

Zenith Filer は、効率的なファイル操作を追求した Windows 用の 2 画面タブ型ファイルエクスプローラーです。標準のエクスプローラーに近い操作感を維持しつつ、パワーユーザー向けの高度なカスタマイズ機能を提供します。

> **このマニュアルの見方**: 左側の目次をクリックすると、該当セクションへスムーズにジャンプします。本文をスクロールすると、現在読んでいるセクションが目次で自動的にハイライトされます。

---

## 1. 画面構成

![メイン画面](../screenshots/main_default.png)

### 1-0. 起動シーケンス
初回起動時はウェルカムウィンドウが表示され、機能紹介・テーマ選択・EULA 同意を経てメインウィンドウへ遷移します。2回目以降はメインウィンドウが直接表示され、ステータスバーに短いウェルカムアニメーション（約3.5秒）が流れます（演出設定でオフにすると即表示）。サービス（タスクトレイ・自動更新等）はレンダリング完了後に遅延初期化されるため、起動直後の画面表示がスムーズです。
- **二つ名ウェルカムグリーティング**: 起動時にチャレンジで獲得した二つ名がステータスバーにウェルカムメッセージとして表示されます。

### 1-1. タイトルバー
メインウィンドウのタイトルバーには、アプリ名・バージョンに続けて、**現在フォーカスがあるペイン**のフォルダのフルパスが表示されます（例: `Zenith Filer - C:\Users\...\Desktop`）。パスが空のときや起動直後はアプリ名とバージョンのみ表示されます。Tab キーでペインを切り替えると、表示されるパスも切り替わります。
- **レベルバナー**: チャレンジの経験値から算出したレベル（Lv.）がタイトルバーに表示されます。クリックするとチャレンジページに遷移します（設定でオフ可能）。レベルアップ時にはバナーがアクセントカラーでグロー演出（パルス）します。
- **二つ名バナー**: チャレンジで獲得した AI 二つ名がタイトルバーに表示されます。ホバーするとバックストーリーのツールチップが表示されます。クリックすると二つ名履歴を直接開けます（設定でオフ可能）。チャレンジ達成時には二つ名バナーも同様にアクセントカラーでグロー演出します。
- **アイコンのホバー色**: タイトルバーのアイコンボタン（設定・マニュアル等）はホバー時にテーマカラーに応じたアイコン色に変化します。
- **フィードバックボタン**: タイトルバーのアイコン群にフィードバックボタンを配置。クリックでアプリ設定のフィードバックページを直接開けます。
- **AIマニュアルボタン**: マニュアルボタンの横にAIマニュアルボタンを配置。AIマニュアルを直接開けます。
- **ウィンドウ復帰メニュー**: タイトルバーのシステムメニュー（右クリック）に「メイン画面に移動」「カーソルのある画面に移動」を追加。ウィンドウが画面外に出た際のリカバリに使用できます。タスクバーの右クリック JumpList やトレイアイコンメニューからも同様の操作が可能です。

### 1-2. ファイルペイン (Aペイン / Bペイン)
メインエリアは、左右に独立したファイル表示領域（ペイン）で構成されます。各ペインはタブブラウジングに対応しています。
- **タブ機能**: 複数のフォルダをタブとして開き、切り替えながら作業できます。
- **Aペイン（左側）/ Bペイン（右側）**: それぞれ独立して動作し、**クリック**またはタブキー（`Tab`）でフォーカスを切り替えます。フォーカス中のペイン（A/B のみ。ナビペインは対象外）は背景がわずかに濃く、文字色が黒で表示されます。上部メニュー（タブヘッダー・アクション行・アドレスバー）は一覧部分よりわずかに濃い色で表示され、どのペインがアクティブか判別しやすくなっています。
- **ペインヘッダー（2行レイアウト）**: 各ペインの上部ヘッダーは**2行構成**です。1行目はアクション行で、機能ごとに5つのグループ（**ナビゲーション**［戻る／進む／上へ］、**ショートカット**［ホーム／デスクトップ／ダウンロード］、**作成・編集**［新規フォルダ／フォルダを取り込む］、**管理**［更新／エクスプローラーで開く］、**表示設定**［アダプティブ列／フォルダを先に］）に分類され、セパレーターで区切られて配置されています。**ホーム**ボタンはアプリ設定で設定したフォルダに移動します。未設定時は A ペインはデスクトップ、B ペインはダウンロードへ移動します。右端には**検索ボックス**があります。キーワードを入力して **Enter を押す**と検索が実行されます（設定した検索挙動に応じて新規タブまたは現在タブに結果が表示されます）。検索ボックス内右端にはヒットした件数がリアルタイムで表示され、結果を即座に把握できます。検索中はリストの列構成が専用のもの（名前・場所・パス・更新日時・サイズ）に切り替わります。これらのヘッダーをクリックすることで、検索結果を各項目で並び替える（ソート）ことが可能です。また、ヘッダーの境界線をドラッグして列幅を自由に調整したり、ダブルクリックして自動調整（AutoFit）することもできます（手動調整時はウィンドウ幅に合わせた自動伸縮が無効になります）。パス列は幅に合わせて最適化され末尾が優先表示されます。2行目は通常時はアドレスバー（ブレッドクラム／パス入力）を横幅いっぱいに配置した「アドレスバー行」となっており、マウス操作やアイコン数にかかわらず**常に一定のレイアウトで表示**されます。アドレスバー左端には「パスを編集」ボタン（鉛筆アイコン）、右側には「お気に入りに追加」ボタン（★）と「パスをコピー」ボタンが配置され、ワンクリックで各操作が可能です。**検索実行時**はアドレスバーの代わりに**フィルターバー**が表示され、検索結果をファイル種類で絞り込めます。
    - **検索履歴ドロップダウン**: 検索ボックスに**フォーカス**すると、過去の検索キーワード（最大100件）がドロップダウン表示されます。**虫眼鏡アイコン**は通常検索で実行した履歴、**雷アイコン**はインデックス検索で実行した履歴です。同一キーワードでも通常とインデックスは別履歴として表示されます。また、同じキーワードでもサイズ・日付フィルタの条件が異なる場合は別の履歴として記録されます。履歴から項目を選択（クリックまたは Enter）すると、その履歴が記録された検索モード（通常/インデックス）とフィルタ条件に自動で切り替わり、そのキーワードで再検索されます。履歴表示中に**下キー**でリストにフォーカスし、上下キーで項目を移動、Enter またはクリックで決定できます。検索ボックスにフォーカスしている間の上キーでは履歴には移りません。**Enter で検索を実行すると、検索履歴ドロップダウンは自動的に閉じます。**
    - **検索フィルターバー**: 検索実行時、2行目のアドレスバーがフィルターバーに置き換わります。フォルダ・Excel・Word・PPT・PDF・TXT・EXE・BAT・JSON・画像・その他のチェックボックスで表示するファイル種類を絞り込めます。左端の「全選択」ボタンで全種類を表示、「全解除」ボタンで全種類を非表示にできます。チェックを外した種類のファイルは検索結果一覧に表示されません。**フィルターの選択状態は settings.json に保存され、次回の検索時およびアプリ再起動後に自動で復元されます。**検索バー右端の × ボタンまたは Esc キーで検索条件をクリアできます。
    - **ブレッドクラムバー**: 現在のパスを階層ごとにボタン形式で表示します。各階層をクリックすることで、そのフォルダへ直接移動できます。**ファイル一覧で選択した項目をドラッグし、パンくずの特定の階層（セグメント）にドロップ**すると、その階層のフォルダへコピーまたは移動できます（左ドラッグ時は Ctrl でコピー、なしで移動。右ドラッグでドロップするとメニューで選択）。各階層の右側にある**下向き矢印（▼）**をクリックすると、そのフォルダ直下のサブフォルダ一覧がドロップダウン表示され、一覧から選択するとそのフォルダへ移動できます（Windows エクスプローラーと同じ動作）。パスが長くなり表示幅を超えた場合は、先頭階層から自動的に省略（「...」）されます。
- **横スクロール**: ファイルリストやブレッドクラムバーなど、横にスクロール可能な領域では、マウスホイールの左右チルト（右スクロール・左スクロール）で横方向のスクロールが可能です。
- **省略された階層の表示**: 省略ボタン（「...」）をクリックすると、隠れている階層がドロップダウンメニューで表示され、選択して移動できます。
- **パス編集モード**: アドレスバー左端にある「鉛筆アイコン（トグル式）」をクリックするか、バーの空白部分をクリックすると、パスを直接テキスト入力できるモードに切り替わります。オンにすると鉛筆アイコンが右矢印アイコン（ブレッドクラム表示への戻り）に変わります。モード切替アイコンを左側に固定しているため、パス編集時も常に同じ位置で切り替え可能です。バー右側の「フォルダを開いたアイコン」は現在のフォルダをエクスプローラーで開くボタン、「取り込みアイコン」はエクスプローラーで表示中のフォルダをアプリに取り込むボタンです。
- **オーバーレイ・スクロールバー**: ファイルリストの垂直スクロールバーはコンテンツ（サイズ列など）の上に重なる形式で表示されます。これにより、スクロールバーが表示されてもファイル名列の幅が変動せず、常に安定したレイアウトで閲覧できます。
- **お気に入り登録ボタン（★）**: A/B ペインそれぞれのアドレスバー右側（コピーボタンの左）に配置されています。クリックすると「お気に入りに追加」ダイアログが開き、名前と概要説明（任意）を入力して登録できます。登録成功時にはナビペインがお気に入りビューへ自動切り替えし、追加された項目が一時的に強調表示されます。お気に入りビューがロック中でも登録可能です。
- **上下2画面分割**: ステータスバーのレイアウト切替ボタンで、従来の左右2画面に加えて上下2画面分割が選択できます。1画面モードとの切替も可能です（ショートカット: Ctrl+1 で1画面、Ctrl+2 で左右2画面、Ctrl+Shift+2 で上下2画面）。

### 1-3. ナビペイン (サイドバー)
画面左側の領域で、以下の 4 つのモード（左側のラジオボタン）を切り替えて使用します。アプリ設定は右側の歯車アイコン（標準: Ctrl+Shift+O）で「Control Deck」として全画面オーバーレイで開きます。
- **お気に入りビュー (標準: Ctrl+Shift+1)**: よく使うフォルダやファイルを登録・整理できます。ドラッグ＆ドロップでの登録や、仮想フォルダによる階層化が可能です。各フォルダには**概要説明**を追加でき、似た名前のフォルダを識別しやすくなります（例: 「BOX用スクリプト (週次報告用)」）。リスト上部の**検索ボックス**にキーワードを入力すると、一覧を絞り込み表示します（検索中はツリー階層が解除され、ヒットした項目がフラットな一覧で表示されます）。**検索モード**はナビペイン右下のボタン（ナビ幅ロックの左）で切り替えられます。**名前・概要**モードではフォルダ名または概要にキーワードが含まれる場合にヒットし、**フルパス・概要**モードではフルパスまたは概要に含まれる場合にヒットします。Esc キーまたは検索ボックス右端の×ボタンで検索をクリアできます。
- **ツリービュー (標準: Ctrl+Shift+2)**: PC 内の全ドライブとフォルダ階層をツリー形式で表示します。各フォルダはフルパスで一意に管理され、同じフォルダが二重に表示されることなく、もれなく一覧できます。A/Bペインのファイル一覧でフォルダを作成・リネーム・移動・削除すると、ツリーにも即座に反映され、常にファイルシステムの状態と一致します。このビューにしたときは、深いパスが省略されないようにナビペインの幅がアニメーションで広がり、お気に入りに戻すと滑らかに元の幅に戻ります。ツリービュー表示時のみ、右下に**ツリービューロック**（南京錠）ボタンが表示され、ロック中はフォルダのドラッグ＆ドロップ移動・リネーム（F2）・削除（Delete）が禁止されます。禁止操作を試みると**ナビペインロック仕様**に従い、ステータスバーに「ロック中のため〜できませんでした。」と表示され南京錠付近で点滅・矢印の解除促しが表示されます。
  - **ツリービューの操作（クリック・表示先）**: 各フォルダ行は**展開用の矢印（▶／▼）**と**行本体（アイコン・フォルダ名）**で構成されています。操作は次のとおりです。
    - **ワンクリック**: 行のどこをクリックしても、そのフォルダが**選択**されるだけです。ペインには表示されません。
    - **展開矢印のクリック／ダブルクリック**: 矢印（▶／▼）をクリックまたはダブルクリックすると、**ツリーの展開・折りたたみのみ**行われ、ペインには表示されません。子フォルダの有無にかかわらず、矢印で開閉だけを切り替えたいときに使います。
    - **行本体のダブルクリック**: アイコンやフォルダ名の部分をダブルクリックすると、そのフォルダが**フォーカス中のペイン**に表示されます。ツリーの展開状態は変わりません（誤って折りたたまれないようにしています）。
    - **Ctrl+ダブルクリック**: 行本体を Ctrl を押しながらダブルクリックすると、そのフォルダが**反対側のペイン**に表示されます。1ペイン表示のときは自動で2ペインに切り替わります。
    - **Enter キー**: フォルダを選択した状態で Enter を押すと、そのフォルダが**フォーカス中のペイン**に表示されます。
    - **Shift+クリック**: フォルダを Shift を押しながらクリックすると、そのフォルダが**フォーカス中のペイン**に**大アイコン（アイコンビュー）**で表示されます。
    - **Shift+Ctrl+クリック**: フォルダを Shift と Ctrl を押しながらクリックすると、そのフォルダが**反対側のペイン**に**大アイコン（アイコンビュー）**で表示されます。1ペイン表示のときは自動で2ペインに切り替わります。
    - **右クリックメニュー**: フォルダを右クリックすると「Aペインに表示」「Bペインに表示」などが表示されます。表示先を明示的に指定したいときに使います。
  - 各フォルダにマウスを載せると、上記の操作方法をツールチップで確認できます。
- **参照履歴 (標準: Ctrl+Shift+3)**: 過去にアクセスしたフォルダの履歴を日別に表示します。日付グループは「2026/02/04(水)」のように曜日付きで表示されます。上部の検索ボックスにキーワードを入力すると、履歴全体から検索して一覧表示（参照日付の降順）に切り替わります（入力中は日付グループ分けが解除されます）。このビューにしたときは、横スクロールが出ないようにナビペインの幅がアニメーションで広がり、お気に入りに戻すと滑らかに元の幅に戻ります。お気に入りビュー時の幅はスプリッターで変更でき、設定に保存されます。参照履歴をすべて削除するゴミ箱（履歴削除）ボタンは、過去履歴ビューの**右下**にあります。ビュー切り替え時の幅変更は、約0.4秒のスムーズなアニメーションで行われます。
- **最近開いたファイル**: A/B ペインでファイルを開いた履歴を最大100件表示します。カラムヘッダ（名前／開いた日時／回数）をクリックするとソート順を昇順・降順で切り替えられます。上部の検索ボックスにキーワードを入力すると、ファイル名やパスで絞り込み表示します（Esc キーまたは×ボタンでクリア）。右クリックメニューから「もう一度開く」でファイルを再度開く、「格納フォルダを開く」でエクスプローラーでファイルの場所を表示、「親フォルダをA/Bペインに表示」で該当ペインにフォルダを表示できます。右下のゴミ箱ボタンで履歴をクリアできます。
- **インデックス検索設定 (標準: Ctrl+Shift+4)**: インデックス検索の対象にするフォルダを登録・管理します。このビューに切り替えると、ナビペインの幅がアニメーションで広がり、お気に入りに戻すと滑らかに元の幅に戻ります。「フォルダを追加」でツリーからフォルダを選択して追加、「現在のフォルダを追加」で A/B ペインで表示中のフォルダを追加できます。ファイル一覧やフォルダのコンテキストメニューから「インデックス検索でこのフォルダを検索」を選ぶと、未登録の場合は自動で登録され、このビューへ切り替わって追加項目が一時的に強調表示されます。一覧で項目を選択して「削除」ボタンまたは右クリックメニューから削除できます。右クリックメニューでは「インデックスを再作成」でそのフォルダのインデックスを一度削除してから再作成（削除済みファイルを反映）、「インデックスを差分更新」で削除せずに新規・更新分だけを反映できます。「インデックス登録確認」を選ぶと、そのフォルダの登録内容を A ペインの新規タブに自動で一覧表示します（タブ名は「結果確認：（フォルダ名）」、ロード完了時にステータスバーで通知）。登録した一覧は設定に保存され、次回起動時に復元されます。ここで登録したフォルダが、インデックス検索（Ctrl+Shift+F）時の検索対象として利用されます。**インデックスの状態**ブロックでは、現在の状態（インデックス完了／差分更新中／一時停止中）と総件数を表示します。「未インデックスを作成」で、まだ一度もインデックスされていないフォルダだけを手動でインデックスし、「一時停止」でインデックス作成を止め、「再開」で再開します（検索は一時停止中も利用可能）。Box フォルダの場合は、スキャン開始前に暖気運転（スタブ生成の促し）を自動実行するため、フォルダを手動で開かなくてもインデックスが完了します。メニュー（⋯）から「フル再構築を実行…」で全フォルダを最初から再インデックス、「インデックスの設定を開く」でオプション設定ビューのインデックス関連項目を開きます。各フォルダの行には、左端にフォルダアイコン、中央にフォルダ名（太字）と最終インデックス完了日時（「最終更新: 2026/02/27 08:05」形式）、右端にステータスバッジが表示されます。ステータスは「作成中...（件数）」（スピナー回転＋青色強調）、「待機中」（薄色イタリック）、件数＋✔（完了）、「未作成」（アンバー色）の4種類で、どのフォルダが今処理中か、いつ最後に更新されたかが一画面で把握できます。
- **アプリ設定 (Ctrl+Shift+O)**: ナビペイン右側の歯車アイコン（マニュアルの左）をクリックするか、`Ctrl+Shift+O`（オー）で切り替え可能。このビューに切り替えると、ナビペインの幅がアニメーションで広がり、お気に入りに戻すと滑らかに元の幅に戻ります。**1. 基本設定 (General)** では**コンテキストメニュー**で、ファイル一覧の右クリック時に表示するメニューを選択できます。「アプリ独自メニュー（推奨）」では開く・コピー・削除・名前の変更・お気に入り・インデックス検索など基本操作を即表示し、Shift+右クリックまたはメニュー内の「エクスプローラのコンテキストメニューを表示する」でエクスプローラ互換メニューに遷移できます。「エクスプローラ互換メニュー」では 7-Zip など Windows の標準右クリックメニュー（シェル拡張含む）を表示します。Aペイン・Bペインのホームアドレスもここで設定します。「表示中のフォルダを設定」で A/B ペインで表示中のフォルダをホームに設定、「フォルダを選択」でダイアログからフォルダを選択して設定できます。**操作**では「シングルクリックでフォルダを開く」（オンにするとシングルクリックでフォルダ移動、オフはダブルクリック）、「ファイル削除時に確認ダイアログを表示する」（オフにするとシェルの確認を省略してごみ箱へ移動）、「起動時に前回のタブを復元する」（オフにするとホームフォルダのみで起動）を設定できます。**表示**では「タイトルバーにパスを表示する」（フォーカス中のペインのフルパスをタイトルバーに表示）、「拡張子を表示する」（オフにするとファイル名から拡張子を非表示）、「隠しファイル・フォルダを表示する」（Windows の隠し属性ファイルの表示切替）、「ダウンロードフォルダを更新日時で並べる」（オンにするとダウンロードフォルダに移動した際、自動的に更新日時の新しい順にソートし、他のフォルダに移動すると元のソート順に戻ります）を設定できます。**常駐モード**をオンにすると、ウィンドウの×ボタンを押してもアプリが終了せずシステムトレイに最小化されます。トレイアイコンをダブルクリックで復元、右クリックメニューの「終了」または `Ctrl+Alt+F4` で完全に終了します。**通知の表示時間**では短め(1.5秒)／標準(3秒)／長め(5秒) から選択できます。**2. 検索 (Search UI)** では、**検索の挙動**で検索実行時の表示先を 3 パターンから選択できます。「同一ペイン・新規タブ」は Enter で新規タブに検索結果を表示（従来どおり）。「同一ペイン・現在タブで即時検索」は Enter で検索実行し現在のタブで結果を表示、検索をクリアすると一覧に戻る。「反対ペイン・新規タブ」は Enter で反対ペインに検索結果を表示、1ペイン時は自動で 2 ペインに切替。**検索結果のパスクリック時の挙動**で、検索結果一覧のパス列をクリックした際の表示先を 3 パターンから選択できます。「同一タブで表示」は検索結果ビューから通常一覧に切り替え、「同一ペイン・新規タブ」は従来どおり同一ペインに新規タブ、「反対ペイン・新規タブ」は反対ペインに新規タブで表示（1ペイン時は自動で2ペインに切替）。**検索時の表示設定**で「検索時に自動的に1画面モードに切り替える」をオンにすると、検索実行時に自動的に1ペインモードに切り替えて検索結果を広く表示します。Bペインで検索した場合は検索タブがAペインに表示されます。**3. インデックス (Indexing &amp; Freshness)** では、**インデックスの更新タイミングと負荷**で、インデックスをいつ・どの程度の負荷で更新するかを設定します。「変更を自動で取り込む」はファイル変更を監視して即時差分更新。「一定間隔でまとめて更新する」は 1 時間／2 時間／4 時間／1 日ごとに登録フォルダ全体を再スキャン。「必要なときだけ更新する」はインデックスビューの「未インデックスを作成」または「フル再構築…」を押したときのみ更新し、起動時やフォルダ追加時の自動インデックスは行いません。**パフォーマンスと負荷**では「省エネモードでインデックスを更新する」をオンにすると CPU とディスクの使用を抑え、他アプリへの影響を小さくします。「ネットワークドライブは軽めに処理する」をオンにすると UNC やマップドドライブの LAN・クラウドフォルダをローカルよりゆっくり処理し、ネットワーク帯域やサーバ負荷を抑えます。**フル再インデックス最短間隔**で、手動のフル再構築を実行しても、この間隔より短い間隔では実際のフルスキャンを行わないようにできます（6時間／12時間／24時間）。**検索結果の鮮度**で、「できるだけ最新の状態を保つ（鮮度優先）」をオンにすると、インデックス検索時に全ターゲットフォルダの差分更新・未インデックス作成をバックグラウンドで開始し、検索と並行してインデックスを更新します。「インデックスが古い可能性があるときにメッセージを表示する」をオンにすると、未インデックスのフォルダがある場合に検索結果ビュー上に注意メッセージを表示します。表示された警告は右端の×ボタンで閉じることができます。**6. 表示 (Display)** では**新規タブのデフォルト表示**で「フォルダを先頭に表示する」とデフォルトのソート順（名前／更新日／サイズ／拡張子・昇順／降順）を設定できます。Ctrl+T やパスを指定して開いた新規タブに適用され、検索結果タブには適用されません（既存タブにも影響しません）。**ファイル一覧の行高**を超コンパクト(20px)／コンパクト(24px)／標準(32px)／ゆったり(40px)から選択できます。変更は即座に A/B ペイン両方に反映され、アプリ再起動後も保持されます。**7. 演出 (Effects)** では、アプリ内の演出効果を9カテゴリに分類し、カテゴリ別にON/OFFトグルで制御できます。**A. 起動・全体**（ウェルカムアニメーション、ローディングオーバーレイ）、**B. GlowBar**（進捗バーのフェード・補間・グロー）、**C. スキャンバー**（フォルダ読み込み時のスキャンバー）、**D. タブ操作**（タブインジケータースライド、コンテンツフェード、D&Dマーカー）、**E. ペイン・トランジション**（ペインフェード、Control Deck展開/閉じ、サイドバー幅アニメーション）、**F. テーマ**（テーマ切替オーバーレイ、テーマトースト通知）、**H. クイックプレビュー**（プレビュー開閉アニメーション）、**I. ファイル一覧**（ホバーエフェクト、コンテキストメニューアニメ）、**L. ドラッグ＆ドロップ**（ドラッグアドーナー表示）。各カテゴリをオフにすると該当する演出がスキップされ、動作が軽くなる場合があります。設定は次回起動時に復元されます。旧設定（マイクロアニメーション・一覧表示アニメーション・ウェルカムアニメーション）からの自動マイグレーションに対応しています。**8. ショートカットキー (Shortcut)** では、25種類のアクションに対してキーボードショートカットを自由にカスタマイズできます。各アクションの入力欄をクリックしてキーを押すだけで変更でき、個別にリセットすることも可能です。**エクスポート**ボタンで現在のキーバインド設定を JSON ファイルに書き出し、**インポート**ボタンで JSON ファイルから読み込んで一括適用できます。他の環境への設定移行やバックアップに便利です。**9. 生成AI (AI)** では、テーマ自動生成などの AI 機能で使用する API の設定を行います。**プロバイダ**で Claude / OpenAI / Azure OpenAI / Gemini の4種類から選択できます。**API キー**に各プロバイダのキーを入力して「保存」ボタンで保存します。キーは DPAPI で暗号化されローカルに保存され、外部に送信されることはありません。「削除」ボタンで保存済みキーをクリアできます。Azure OpenAI を選択した場合は**エンドポイント**入力欄が表示され、Azure リソースの URL を指定します。**テスト接続**ボタンで API キーの有効性を検証できます。**モデル**ではプロバイダごとに利用可能なモデルをドロップダウンから選択できます（空の場合はデフォルトモデルを使用）。**10. 利用統計 (Statistics)** では、検索・ファイル操作・タブ操作・テーマ変更など21種類のアクションの使用回数を確認できます。「リセット」ボタンで全統計をクリアできます。フォルダ TOP50（最も多く閲覧したフォルダのランキング）も表示されます。**11. このアプリについて (About)** では、現在のバージョン、このバージョンの更新内容（CHANGELOG から自動取得）、および自動アップデートの設定を確認・変更できます。「自動アップデートを有効にする」チェックボックスで定期チェックの ON/OFF、「アップデートを確認」ボタンで手動チェック、新バージョンのダウンロード完了後は「再起動して適用」ボタンが表示されます。
- **お気に入り「よく使う」セクション**: お気に入りアイテムが6件以上ある場合、検索バーとツリーの間に「よく使う」セクションが表示されます。履歴DBのアクセス頻度と最近度でスコアリングした上位5件をコンパクトに表示します。ダブルクリックでナビゲート、ミドルクリックで新しいタブ、右クリックでA/Bペイン選択が可能です。ツールバーのピンアイコン（Pin／PinOff）で表示/非表示を切り替えられ、設定は次回起動時に復元されます。検索中は自動的に非表示になります。
- **お気に入り「最近追加」セクション**: 「よく使う」セクションの下に、過去7日以内に登録されたお気に入りアイテムを最大5件表示します。各アイテムには相対日付（今日・昨日・N日前）が表示されます。ダブルクリックでナビゲート、ミドルクリックで新しいタブ、右クリックでA/Bペイン選択が可能です。ヘッダーの時計アイコン（Clock）で表示/非表示を切り替えられ、お気に入り設定ダイアログからも切り替え可能です。設定は次回起動時に復元されます。検索中は自動的に非表示になります。
- **お気に入りABC順ソート**: お気に入りビューのヘッダーにあるツリー/ABC切替アイコン（FolderTree／ArrowDownAZ）で、手動ツリー表示とABC順フラットリスト表示を切り替えられます。ABC順モードではコンテナ（仮想フォルダ）を除く全アイテムがアルファベット順（日本語かな対応）でフラット表示され、各アイテムの下にパス情報がサブテキストで表示されます。ダブルクリックでナビゲート、ミドルクリックで新しいタブ、右クリックでA/Bペイン選択、ドラッグ操作が可能です。ABC順モード中は「よく使う」「最近追加」セクションは非表示になります。設定は次回起動時に復元されます。
- **カラータグ**: お気に入りアイテムに7色のカラーラベル（レッド・オレンジ・イエロー・グリーン・ブルー・パープル・グレー）を割り当てて視覚的に分類できます。アイテムを右クリックして「カラータグ」サブメニューから色を選択すると、アイテム名の左側にカラードットが表示されます。「なし」を選ぶとタグを解除できます。ツリー・ピン留め（よく使う）・最近追加・ABC順ソート・検索結果の全ビューでカラードットが表示されます。検索ボックスに `tag:red` のように入力すると、指定した色のタグが付いたアイテムだけに絞り込めます（色名は英語で指定：red, orange, yellow, green, blue, purple, gray）。`tag:` だけ入力するとタグ付きの全アイテムを表示します。設定は JSON に永続化され、次回起動時に復元されます。
- **全展開/全折りたたみ**: お気に入りツリーの空白部分を右クリックすると、「すべて展開」「すべて折りたたみ」メニューが表示されます。ツリー内のすべての仮想フォルダ（コンテナ）の展開状態を一括で変更できます。
- **お気に入り検索モード**: お気に入りビュー時、ナビペイン右下の**ナビ幅ロックの左**に検索モード切替ボタン（Type／Route アイコン）があります。オフ時は「名前・概要」でヒット、オン時は「フルパス・概要」でヒットします。状態は次回起動時に復元されます。
- **お気に入り設定ダイアログ**: お気に入りビューのヘッダー行にある歯車アイコンからダイアログを開きます。フォントファミリ・フォントサイズの変更、概要説明・ツリーライン・アクセス回数バー・アイテム数バッジの表示/非表示切替、削除確認の有無、ロック設定が可能です。アイテム数バッジは仮想フォルダ（コンテナ）に含まれるリーフアイテム数を表示します。設定はリアルタイムに反映されます。
- **AIお気に入り整理**: お気に入りビューのヘッダー行にある Sparkles アイコンからダイアログを開きます。統計情報（総数・壊れたリンク数・フォルダ数・未分類数）を即座に表示し、以下の操作が可能です。
  - **壊れたリンクのみ削除**: AI不要。存在しないパスを一括削除します。
  - **AIで整理**: AIがツリー構造を分析し、壊れたリンクの除去、関連アイテムのフォルダグループ化、論理的なソート、検索用タグの自動付与を提案します。変更プレビューで確認後に適用できます。ユーザー指示（例：「プロジェクト別にグループ化」）も入力可能です。
  - タグは各アイテムの Description に「AI: タグ1, タグ2」形式で付与され、お気に入り検索でヒットしやすくなります。既存の Description がある場合は末尾に追記されます。
  - Pro機能（無料版は1日2回まで）。
- **下段固定（ドック）**: ナビペインを上下分割しているとき、下段ヘッダーの右端にドックトグルアイコンが表示されます。有効にすると下段がコンテンツサイズに合わせて自動調整され（GridSplitter 非表示）、上段が残りのスペースを占有します。プロパティや最近開いたフォルダなど高さが決まっているビューを下部にピッタリ配置したい場合に便利です。設定はアイテムごとに永続化され、次回起動時に復元されます。
- **プロパティビュー**: ナビペインの「プロパティ」ドロップアイテムは、A/Bペインで選択中のファイルやフォルダのプロパティ（フルパス・サイズ・種類・更新日時・作成日時・属性）を表示します。フルパス欄は6行分の固定高さを確保し、長いパスはスクロールで全文を確認可能。コピーボタンでクリップボードにコピーできます。アイテム未選択時はアクティブペインのカレントフォルダのプロパティを自動表示します。
  - **起動グリーティング**: アプリ起動後5秒間、時間帯に応じた挨拶メッセージ（朝・午前・午後・夕方・夜の6パターン）を表示し、フェードアウト後にカレントフォルダのプロパティに切り替わります。
  - **AIグリーティング**: プロパティビューのヘッダー右端にある歯車アイコンから設定画面を開き、「AIでメッセージを生成」を有効にすると、起動時にAIが時間帯に合わせたオリジナルの励ましメッセージを生成します。メッセージはアプリの言語設定に応じた言語で出力されます。AI応答待ちの間は「Preparing...」と表示され、応答到着後にふわっとメッセージが切り替わり5秒間表示されます。
  - **グリーティングトーン調整**: AI グリーティングのトーンを7段階（カジュアル〜フォーマル）で調整できます。AI設定の概要タブから設定します。
  - 設定はプロパティビューのヘッダー歯車アイコンから変更でき、次回起動時に復元されます。
- **ナビペイン幅自動設定**: ナビペインの幅は手動で調整できるほか、コンテンツに合わせて自動調整するオプションがあります。
- **ナビペイン下段固定機能**: ナビペインのビューを上段・下段に分割して配置できます。下段にビューを固定すると、上段のビュー切替に影響されず常時表示されます。
- **ナビ幅ロック**: お気に入りビュー時のみ、ナビペイン右下にパネルアイコン（開いたパネル／閉じたパネル）のトグルが表示されます。オンにするとナビペインの幅をスプリッターで変更できなくなります。ツリー・履歴への切り替え時の自動拡張はロック時も有効です。状態は次回起動時に復元されます。
- **ナビペインロック仕様（共通）**: お気に入りロック・ツリービューロックはいずれも同じ仕様に従います。ロック中に禁止操作を試みると、**ポップアップは出さず**、**ステータスバー**に「ロック中のため〜できませんでした。」と表示され、南京錠アイコン付近で矢印＋点滅の解除促しアニメーションが約3秒間表示されます。アニメーション中でも南京錠をクリックすれば即座にロック解除され、点滅も停止します。
- **ロック機能はビューごとに独立**: **お気に入りロック**は**お気に入りビュー (Ctrl+Shift+1)** 内での仮想フォルダ追加・削除・並び替えのみを制限します。登録・名前変更・概要変更はロック時も行えます。**ツリービューロック**は**ツリービュー (Ctrl+Shift+2)** 表示時のみ、サイドバー右下に南京錠アイコンが表示され、フォルダの移動・リネーム・削除を禁止します。お気に入りをロックしたままツリービューでフォルダを整理したり、その逆も可能です。
- **ターミナルタブ（A/Bペイン）**: ファイル一覧のタブバーにある SquareTerminal アイコンをクリックすると、A/Bペイン内にターミナル（PowerShell）タブを追加できます。現在表示中のフォルダを作業ディレクトリとして起動し、フォルダタブとターミナルタブをシームレスに切り替えられます。複数のターミナルタブを開くことも可能で、ワーキングセットとの併用にも対応しています。無料版では新しいターミナルタブの作成が1日3回までに制限されます（ナビペインのターミナルと共通カウント）。
- **ターミナルビュー（ナビペイン）**: ナビペインに埋め込みのターミナル（PowerShell）を表示します。A/Bペインで閲覧中のフォルダをワーキングディレクトリとして、CLI ツール（Claude Code 等）を直接実行できます。無料版では新しいターミナルタブの作成が1日5回までに制限されます。
  - **タブ管理**: 上部のタブバーで複数のターミナルセッションを管理できます。「+」ボタンで新しいタブを追加、各タブの「×」ボタンでセッションを終了します。各タブは独立した PowerShell プロセスを持ちます。
  - **フル機能ターミナル**: ANSI カラー、マウス操作、スクロールバック（5000行）、URL クリック等をサポートする本格的なターミナルエミュレータです。
- **ターミナル共通機能（全ペイン共通）**:
  - **A/B cd ドロップダウン**: 全ターミナル（A/Bペイン・ナビペイン）のアクションバーに「A cd」「B cd」ボタンを配置。クリックすると対応するペインのフォルダタブ一覧がドロップダウン表示され、選択したフォルダへ即座に `cd` 実行。2画面ファイラーの利点を活かし、どのターミナルからも両ペインのフォルダにアクセス可能。
  - **ペイン別設定**: アクションバー右端の歯車アイコンから設定ポップアップを開き、フォントファミリ・フォントサイズ・背景色・文字色・テーマ連動をペインごとに個別設定可能。カラーピッカーでリアルタイムプレビュー。
  - **全ターミナルで共通オプション**: 設定ポップアップの「全ターミナルで共通」チェックボックスで、設定を全ペインで共有するか個別にするかを切り替え。デフォルトは共有（ON）。OFF にすると該当ペインのみ独立した設定を持つ。
  - **テーマ連動**: 「テーマ色に連動」を有効にすると、アプリのテーマ切替時にターミナルの背景色・文字色も自動変更。無効時はカスタム色を保持。
- **ビュー名ヘッダーとバッジ**: 各ビューの上部にはビュー名がヘッダーとして表示されます。AI 機能を持つビューには紫色の **AI バッジ**（Sparkles アイコン）が、Pro（ライセンス対象）機能には オレンジ色の **Pro バッジ**（Lock アイコン）がヘッダーやナビペインのアイコンバーに表示されます。バッジドットの表示/非表示は設定 → 基本設定 →「バッジドットを表示する」（ShowBadgeDots）で切り替えられます。
- **AIフォルダオーガナイザー**: フォーカスペインの現在フォルダをAIが分析し、整理提案（フォルダ作成・ファイル移動・名前変更）を行うビューです。
  - **分析**: 「分析」ボタンを押すと、フォルダ内の全アイテム（名前・種別・サイズ・日付）をAIに送信し、整理方法を提案します。テキスト入力欄に追加指示（例: 「写真だけ年月別に」）を入力して送信することもできます。
  - **提案アクション**: AIの提案はチェックボックス付きリストで表示されます。フォルダ作成・ファイル移動・名前変更の3種類のアクションがあり、個別に選択/解除できます。「全選択」ボタンで一括切替が可能です。
  - **実行**: 「実行」ボタンで選択したアクションを一括実行します。実行前に確認ダイアログが表示され、GlowBar で進捗を表示します。
  - **Undo**: 実行した操作は Undo（Ctrl+Z）で一括巻き戻しが可能です。
  - **安全性**: パスが現在フォルダ配下であることの検証、移動先の同名ファイル存在チェック、分析時と実行時のフォルダパス一致確認を行います。
- **AIマニュアル**: アプリの使い方を自然言語で質問できるチャット型ヘルプビューです。質問を入力すると、マニュアル内容を自動検索して回答を生成します。回答は Markdown レンダリング（見出し・太字・箇条書き・コードブロック）で表示され、長い回答はセクションごとに複数バブルに分割表示されます。会話履歴（直近3往復）を保持します。Pro 機能（無料版 3回/日）。
- **AIタブ管理**: タブの利用パターン（アクセス頻度・滞在時間・直近性）をスコアリングし、タブの整理を提案するビューです。ロック推奨（緑インジケーター）/ クローズ推奨（オレンジインジケーター）で各タブの状態を可視化します。「すべて適用」で提案を一括操作できます。ワーキングセット自動検出（A+B ペインの共起パターン）や関連フォルダ提案（共起履歴から検出）も行います。各提案タイプは個別にON/OFF可能です。Pro 機能（無料版 3回/日）。
- **タブ管理ビュー**: A/Bペインのタブを一覧表示し、ドラッグ＆ドロップで並べ替え可能。タブのアクティビティ（使用時間）をプログレスバーで可視化し、AI が推薦するタブにドットマーカーを表示します。現在のタブ構成と一致するワーキングセットがあればバッジで表示し、ワンクリックで保存できます。1画面モード時はAペインのタブのみ表示されます。A/Bペイン各ヘッダーの＋ボタンで新規タブを追加できます。ペインのタブバーからタブ管理ビューへのドラッグ＆ドロップによるタブ移動・並べ替えにも対応しています。エクスプローラーやナビペイン（お気に入り・履歴・よく使うフォルダ・ツリー）からフォルダをドロップして新規タブを追加することも可能です。
- **プレビュービュー**: 選択中のファイルを常時プレビュー表示するペインです。画像・テキスト・PDF・Markdown・SVG・動画サムネイルに対応。コード系ファイルは AvalonEdit による構文ハイライト付きで表示され、Markdown ファイルはレンダリング表示されます。画像ファイルでは EXIF メタデータ（撮影日時・カメラ情報等）もプロパティペインに表示されます。
- **レイアウトプリセット**: ナビペインのビュー配置をプリセットとして保存・復元できます。ビルトインプリセット4種（標準・検索特化・AI特化・ミニマル）に加え、ユーザーが現在の配置をカスタムプリセットとして保存可能です。

### 1-4. ヘルプ・ドキュメントビューア
メインウィンドウのタイトルバー右側にある「マニュアル」アイコンから、アプリのヘルプウィンドウ（総合ドキュメントビューア）を開くことができます。また、配布フォルダに同梱される **ZenithDocViewer.exe** を直接起動すると、本体を起動せずにマニュアルと更新履歴のみを閲覧できます（DB やインデックスを読み込まないため起動が軽く、事前にドキュメントを確認したいときに便利です）。

- **総合ドキュメントビューア**: これまで別々だった「ユーザーマニュアル」と「更新履歴（CHANGELOG）」を、**1つのウィンドウ内で切り替えて閲覧できるビューア**です。マニュアルと更新履歴では**スクロール位置がそれぞれ個別に保持**され、タブを切り替えても前の続きから読めます。
- **上部ヘッダー**:
  - 左側にアプリ名とドキュメント用アイコン（BookOpen）が表示されます。
  - 中央付近に「マニュアル」「更新履歴」の 2 つのセグメントボタンがあり、クリックで表示内容を切り替えます。選択中のモードは、ファイルリストと同じアクセントカラー（青）で強調されます。
  - 右側にはキーワード検索ボックスがあります（今後のハイライト拡張用）。入力したテキストはドキュメントビューア内の検索クエリとして保持されます。
  - 一番右端には「×」ボタンがあり、Esc キーと同様にウィンドウを閉じられます。
- **左ペイン（目次）**:
  - マニュアルモードでは、`H1〜H3` レベルの見出しを自動解析し、「1. 画面構成」「2. 基本的なファイル操作」などのセクションが階層付きリストとして表示されます。
  - 更新履歴モードでは、`CHANGELOG.md` 内のバージョン見出し（例: `## [0.3.66] - 2026-02-06`）から、`v0.3.66` のようなラベルを生成して一覧表示します。見出しの末尾に「 : 概要」を追記すると、目次にもその内容が表示されます。上から新しい順（降順）に並びます。
  - いずれのモードでも、項目をクリックすると右ペインの該当セクションへスムーズにスクロールし、本文スクロールに応じて現在読んでいるセクションが自動的にハイライトされます。
  - 左ペインの幅はスプリッターで調整でき、スクロールバーは右端に配置されています。ウィンドウと左ペインはデフォルトで大きめに表示され、長い見出しも途切れにくいレイアウトです。
- **右ペイン（本文）**:
  - Markdown ベースのレンダリングエンジンを共通利用しており、マニュアルと更新履歴の両方で、**ワンポイントの青のアクセントカラー**・テーブルのパディング・`kbd` ライクなショートカット表記・行間やドット（Bullet）デザインなどが統一されています。
  - 更新履歴の「Added」「Changed」「Fixed」などのリスト項目も、マニュアルと同様に読みやすい行間と青色のドットが適用され、一貫したドキュメント体験を提供します。
- **操作とショートカット**:
  - Esc キー、またはヘッダー右側の「×」ボタンでウィンドウを閉じます。
  - マニュアル／更新履歴の切り替えはマウスクリックで行います（キーボードショートカットはメインウィンドウ側のものと干渉しません）。

### 1-5. ステータスバー
画面下部の領域で、以下の情報を表示し、設定を変更できます。
- **通知メッセージ（中央）**: ファイルのコピーや移動、お気に入り登録などの操作を完了した際、中央にメッセージがふわっと表示されます。表示から3秒経過すると自然に消去されます。
- **ウィンドウ配置制御**: ステータスバーの左端にあるボタンで、ウィンドウの配置を素早く変更できます。
  - **左半分に配置**: ウィンドウを画面の左半分にスナップします。
  - **最大化**: ウィンドウを画面全体に広げます（もう一度押すと元のサイズに戻ります）。
  - **下半分に配置**: ウィンドウを画面の下半分にスナップします。
  - **右半分に配置**: ウィンドウを画面の右半分にスナップします。
  - **左下に配置（画面の1/4）**: ウィンドウを画面の左下 1/4 にスナップします。
  - **右下に配置（画面の1/4）**: ウィンドウを画面の右下 1/4 にスナップします。
- **最大化状態からのドラッグ解除時の挙動**: ウィンドウが最大化された状態でタイトルバーをドラッグして引き剥がすと、直前の通常サイズが有効な場合はそのサイズに、そうでない場合は現在のディスプレイ作業領域の約75%幅・16:10付近の比率になるよう自動的にリサイズされます。このときマウスカーソルがタイトルバーの左右中央付近に来るようにウィンドウ位置が補正されるため、最大化からの引き剥がし直後もマウスとウィンドウの位置関係が崩れず、そのまま自然にドラッグを続けられます。
- **マルチディスプレイ環境での自動レスキュー**: Zenith Filer は、前回と異なるディスプレイ構成で起動した場合でも、保存されているウィンドウ位置が現在接続されているいずれのディスプレイとも交差しないときは「画面外にある」と判断し、メインディスプレイの作業領域内（中央付近・適切なサイズ）に自動的に再配置します。これにより、自宅（3画面）で終了したあとに会社（2画面）やカフェ（1画面）で起動しても、Alt+Space+M などで無理やりウィンドウを探す必要がなく、必ず見えている画面内から操作を開始できます。
- **項目情報**: 現在選択されているファイル数や、合計ファイルサイズが表示されます。
- **画面分割切り替え**: 1 画面モード（A ペインのみ）と 2 画面モード（A・B 両方）をボタンで切り替えられます。初期状態は 2 画面モードです。
- **レイアウト切替ボタン**: ステータスバー右端のボタンで1画面/左右2画面/上下2画面を切替できます。現在のレイアウトがアイコンで表示されます。
- **ナビペイン表示切替**: 左右のナビペインを個別に表示・非表示できます。ステータスバーに「左ナビ」（PanelLeft アイコン）と「右ナビ」（PanelRight アイコン）の 2 つのトグルボタンがあり、それぞれ独立して切り替え可能です。右ナビボタンは右ナビにアイテムがある場合のみ表示されます。非表示にすると、ファイルペインがその分広がります。
- **進捗表示の種類**: Zenith Filer では処理の性質に応じて 3 種類の進捗インジケーターを使い分けています。
  - **スピナー**: ステータスバー右側（ログフォルダボタンの左）に表示される小さな回転アニメーション。ファイル検索・読み込み・CSV 出力スキャンなど、所要時間が不定の一般的な非同期処理中に表示されます。
  - **スキャンバー**: ステータスバー最上部に表示される横伸びのライン。「[CSV出力準備中] フォルダの最新情報を物理スキャンしています...」のような処理状況メッセージを伴い、完了時間が読めない大規模スキャン処理中に表示されます。スピナーと同時表示されることがあります。
  - **グロウバー**: ファイルのコピー・移動中、ステータスバー最上部に表示される細い発光プログレスバー（アクセントカラー＋シアンのグロー）。バイト数・件数ベースで進捗をリアルタイムに反映します。キャンセル時はバーが現在位置から 0% へ急加速しながら戻る「吸い込まれ」演出（逆行アニメーション）の後にフェードアウトします。
- **インデックス作成中アイコン**: インデックス作成中は、ステータスバー右側に進捗メッセージ（「インデックス作成中: 〇〇件 (フォルダ名)」）と回転アニメーションが表示されます。一般のローディングインジケータとは別枠で、作成中は専用の進捗表示のみが表示されます。中断後に再開した場合は、前回までに登録済みの件数からカウントを続けて表示するため、途中から再開したことが分かります。このアイコンをクリックすると確認ダイアログが表示され、「はい」を選択するとインデックス作成を中止できます。アプリ再起動後は、設定に登録済みのフォルダの未完了分が自動的に再開されます。作成が完了すると、ステータスバーに「〇〇件をインデックスに追加しました」と件数が表示されます。
- **常に最前面に表示**: ピンアイコンをクリックすると、他のウィンドウよりも常に手前に表示されるようになります。リネーム入力やマニュアル・更新履歴など、アプリから開くポップアップは最前面固定時もメインウィンドウより前面に表示されます。
- **表示モード切り替え**: 各ペインのツールバー（アドレスバー上のアイコン群）の「フォルダを取り込む」の右、「列を自動補正」の左に、一覧ビューへの切り替えボタン（Rows3 アイコン）と、小・中・大アイコンの3つのボタンが並んでいます。一覧ビューをクリックするとそのペインが詳細一覧（名前・更新日時・種類・サイズなどの列表示）に切り替わります。小・中・大のいずれかをクリックするとそのペインのアイコン表示サイズが切り替わり、選択中のモードはボタンのハイライトで判別できます。アイコンモードはエクスプローラーに近いレイアウトで、大・中・小アイコンで明確なサイズ差があり、ペイン端との余白も確保したゆとりのあるレイアウトで表示されます。アイテムは詰めて配置し、余白は右端に集約されるため、窮屈な印象を抑えています。文字は通常サイズ・長い名前は「...」で省略されます。**フォルダ・文書など非画像**ではカード高さを固定し、アイコンとファイル名の開始位置を揃えて表示します。ファイル名は最大4行まで表示し、それ以上は省略されます。**画像ファイル**（jpg, png, gif, bmp, webp 等）はサムネイルがカード全面に表示され、通常時はファイル名を非表示にし、ホバー時に下部オーバーレイで名前・詳細がスムーズにフェードイン。ホバー時は枠とシャドウで強調され、下部オーバーレイで名前・詳細が表示されます。フルファイル名は、そのオーバーレイ部分にホバーして約2秒後にツールチップで表示されます。**フォルダや画像以外のファイル**（文書など）は四角枠なしでアイコンを上部に、ファイル名をその下の固定位置に常時表示するため、見分けがつきやすくなっています（WindowsAPICodePack-Shell ライブラリを用いた安定したサムネイル表示）。フォルダ移動後やアイコンビュー切り替え後も、確実にサムネイルが表示されます。ファイル数が少ない場合も上から詰めて表示され、多い場合と同じレイアウト密度で表示されます。選択時のハイライトとクリックで選択される範囲はカード（サムネイル＋名前）部分のみで、カード外の余白をクリックしても選択されません。**アイコンビュー中**は、一覧での F5 キーおよび矢印・Enter・Back 等のキー操作は無効です。更新はツールバーの「更新」ボタン（マウスクリック）で行えます。一覧の操作はマウスのみとなります。詳細表示に切り替えると F5 キーも含め従来通り利用できます。**表示モードの状態は次回起動時にも引き継がれ**、AペインとBペインはそれぞれ独立して保存されます（例: Aペインは一覧、Bペインはアイコンビューの状態で終了すると、次回起動時も同じ状態で開きます）。新規タブを開いた際も、そのペインの表示モードが自動で適用されます。
- **ツールチップ**: ボタンやアイコンにマウスを乗せると、クリックで行える操作を端的に示すツールチップが表示されます。ロック・固定・表示切替など状態が変わるボタンは、現在の状態に応じてツールチップの文言が切り替わります。

### 1-6. 確認・エラーダイアログ
アプリ内の確認ダイアログやエラーメッセージは、Windows 標準の MessageBox ではなく、アプリ独自のカスタムダイアログで表示されます。セピア調の背景（#F5F1E3）・角丸（8px）・ドロップシャドウを備えたモダンなデザインで、アプリ全体の外観と統一されています。アイコン（情報・警告・エラー・確認）とボタン（OK / OK・キャンセル / はい・いいえ）はダイアログの用途に応じて自動的に切り替わります。Esc キーでキャンセル、タイトルバー部分のドラッグで移動が可能です。
- **エラーフィードバック**: 予期しないエラーが発生した場合、エラーダイアログに「フィードバックを送信」ボタンが表示されます。エラーの詳細情報（スタックトレース等）が自動的に添付され、開発者に直接報告できます。

---

## 2. 基本的なファイル操作

### 2-1. ナビゲーション
- **フォルダを開く**: ダブルクリック、または `Enter` キー。
- **戻る**: ツールバーの「←」ボタン、または `Alt + ←` キー。戻った先の一覧では、直前に入ったフォルダにフォーカスが当たり、上下キーでその位置から操作を続けられます。
- **進む**: ツールバーの「→」ボタン、または `Alt + →` キー。
- **上の階層へ**: ツールバーの「↑」ボタン、または `Backspace` キー。戻った先の一覧では、直前に入ったフォルダにフォーカスが当たり、上下キーでその位置から操作を続けられます。ドライブルート（C:\ 等）で「上へ」を実行すると、全ドライブを一覧表示する「PC」ビューに移動します。
- **PC（マイコンピュータ）ビュー**: ドライブルートの上位にある仮想的な最上位階層です。PC 上の全ドライブ（ローカルディスク、ネットワークドライブ、リムーバブルディスク等）が一覧表示され、ダブルクリックまたは Enter でそのドライブルートに移動できます。パンくずリストの先頭に「PC」セグメントが常に表示され、クリックで PC ビューに移動できます。パンくずの「PC」右の▼からドライブ一覧をドロップダウン選択することも可能です。アドレスバーに「PC」と入力して Enter でも移動できます。PC ビューでは「上へ」ボタンは無効化されます。
- **お気に入りに追加**: ペインヘッダー 1 行目（アクション行）にある「★」ボタンを押すと、現在表示中のフォルダをお気に入りに登録します。
- **ホームへ移動**: ツールバーのホームアイコンをクリックすると、アプリ設定で設定したホームフォルダへ移動します。未設定時は A ペインはデスクトップ、B ペインはダウンロードへ移動します。
- **デスクトップへ移動**: ツールバーのモニターアイコンをクリックすると、デスクトップフォルダへ移動します。
- **ダウンロードへ移動**: ツールバーのダウンロードアイコンをクリックすると、ダウンロードフォルダへ移動します。
- **エクスプローラーで表示**: ツールバーのフォルダを開いたアイコンをクリックすると、現在表示しているフォルダを Windows 標準のエクスプローラーで開きます。
- **エクスプローラーのフォルダを取り込む**: ツールバーの取り込みアイコン（フォルダを開くアイコンの右隣）をクリックすると、現在開いている Windows エクスプローラーのフォルダをアプリ側に取り込みます。取り込んだフォルダは常に**新規タブ**で表示されます。1 件のみの場合はそのフォルダを新規タブで表示してエクスプローラーを閉じ、2 件以上の場合は選択ダイアログで取り込む対象を選び、選択したフォルダをそれぞれ新規タブで表示したうえで対象のエクスプローラーを閉じます。
- **パスをコピー**: アドレスバー右端のコピーアイコンをクリックすると、現在のフォルダのフルパスをクリップボードにコピーします。
- **更新**: `F5` キー、またはツールバーの更新ボタン（フォルダ内容の変更は自動検知されますが、手動更新も可能です）。詳細表示時は F5 キーもボタンも有効。アイコンビュー時は**ボタンのみ有効**（F5 キーは無効）です。ネットワークドライブ等でフォルダ監視の接続が切断された場合は、指数バックオフ（1秒→2秒→4秒…最大30秒）で自動再接続を試みます。再接続の進行状況はステータスバーに通知されます（「ネットワーク切断を検出。再接続を試行中...」→成功時「フォルダ監視を再開しました」）。最大試行回数（10回）に達した場合は「フォルダ監視が停止しました。F5で更新してください」と表示され、F5 キーまたは更新ボタンで手動再接続できます。

### 2-2. タブ操作
- **新しいタブを開く**: タブバー右の「＋」ボタン、または `Ctrl + T`。タブバーの空白部分をダブルクリックすることでも新しいタブを開けます。
- **タブを閉じる**: タブの「×」ボタン、または `Ctrl + W`。
- **タブ一覧の表示**: タブバー右端（＋ボタンの右）にあるタブ一覧ボタン（Listアイコン）をクリックすると、プルダウンメニューで全タブの一覧が即座に表示されます。一覧はリスト表示ボタンの直下に、各タブの「×」ボタンがリスト表示ボタンと縦に揃う位置で表示されます。一覧からタブをクリックするとそのタブに切り替わり、各タブの右側にある「×」ボタンで削除できます。現在選択中のタブは青くハイライト表示され、ロックされたタブは削除ボタンが非表示になります。タブ一覧メニュー外をクリックするか、タブを選択すると自動的に閉じます。
- **タブのロック**: タブを右クリックして「ロック」を選択すると、そのタブを閉じることができなくなります。ロックされたタブには南京錠アイコンが表示され、「×」ボタンが非表示になります。ロックを解除するには、再度右クリックして「ロック解除」を選択します。ロック状態は次回起動時にも引き継がれます。
- **このペインのタブを全てお気に入りに追加**: タブを右クリックして「このペインのタブを全てお気に入りに追加」を選択すると、そのペインの全タブのパスを新規仮想フォルダにまとめてお気に入りに登録できます。フォルダ名と概要説明（任意）をダイアログで入力してから保存します。存在しないパスや既にお気に入りに登録済みのパスはスキップされます。
- **タブを反対ペインに移動**: タブを右クリックして「反対ペインに移動」を選択すると、そのタブを反対側のペインに移動します。1ペイン表示時は自動的に 2ペイン表示に切り替わります。
- **タブの切り替え**: タブをクリック、または `Ctrl + Tab`（次のタブ）。切り替え時にはコンテンツがフェードインし、タブヘッダー下のインジケータ（下線）が選択タブへスライドして表示されます。
- **タブの移動**: タブをドラッグして左右に移動することで、タブの並び順を自由に変更できます。
- **ドラッグ＆ドロップで開く**: フォルダをタブバーの空白部分にドラッグ＆ドロップすると、新しいタブでそのフォルダを開きます。
- **タブ一覧ポップアップ**: `Ctrl+Shift+A` でタブ一覧をポップアップ表示します。キーボードの上下キーで選択、Enter で切替できます。Aペイン・Bペインそれぞれの一覧を `Ctrl+Shift+Q`（Aペイン）/ `Ctrl+Shift+W`（Bペイン）で個別に開くことも可能です。
- **タブ切替ショートカット**: `Ctrl+Tab` で次のタブ、`Ctrl+Shift+Tab` で前のタブに切り替えます。

#### タブバー表示設定
タブの表示方法を「タブ」カテゴリの設定でカスタマイズできます:
- **タブ幅モード**: 均等幅（タブバーを等分）または固定幅（指定ピクセル）から選択できます。
- **固定幅サイズ**: 固定幅モード時のタブ幅をピクセル単位で指定します。
- **折り返しモード**: タブが1行に収まらない場合の動作を設定します。「スクロール」（横スクロール）または「折り返し」（複数行表示）から選択できます。
- **行高さ同期**: 折り返しモード時に、AペインとBペインのタブバーの高さを自動的に揃えます。
- **タブ管理ビュー表示時にタブバーを非表示**: ナビペインのタブ管理ビューを表示している間、A/Bペインのタブバーを非表示にできます。タブ管理ビューでタブを一元管理したい場合に便利です。

### 2-3. 標準的なファイル操作
右クリックメニュー、またはショートカットキーを使用して以下の操作が可能です。デフォルトでは**アプリ独自の軽量メニュー**が即座に表示され、開く・コピー・削除・名前の変更・お気に入り・インデックス検索など基本操作を素早く実行できます。詳細は「**2-4. 独自コンテキストメニュー**」を参照してください。
- **コピー・切り取り・貼り付け**: Windows 標準と同様（`Ctrl+C`, `Ctrl+X`, `Ctrl+V`）。操作後もフォーカスはファイルリストに残り、コピー・切り取り時は操作した項目に、ペースト完了後はペーストしたファイルにフォーカスが当たります。ペースト後はリストがそのファイルまで自動スクロールし、すぐに視認できるようにしています。フォルダ監視による自動更新後もフォーカスが維持され、他ペインに奪われないようにしています。
- **新規フォルダ**: `Ctrl+Shift+N` を押すと即座に名前の変更ダイアログが表示され、そのままフォルダ名を入力して OK で現在のフォルダに作成します（フォルダ作成処理自体はバックグラウンドで実行されるため、ネットワークドライブなど高負荷時でもダイアログの表示・入力は極力ブロックされません）。作成後はそのフォルダにフォーカスが当たります。エクスプローラーのコンテキストメニューから新規作成した場合は、従来どおりフォルダ作成後に名前の変更ダイアログが開きます。
- **名前の変更**: `F2` キー、またはメニューから実行。専用のリネームダイアログが表示されます。ファイルの場合はファイル名と拡張子が分離表示され、それぞれ個別に編集できます。拡張子の変更忘れや誤変更を防止します。フォルダの場合は名前全体を編集できます。ダイアログはアプリ内で共有される軽量なウィンドウとしてキャッシュされており、瞬時に表示されます。ダイアログ上部には **定型入力ボタン** が並んでおり、**日付ボタン3種**（`YYYYMMDD` / `YYYYMMDD_` / `_YYYYMMDD`）を押すと本日の日付が即入力されます。さらに **コンテキストボタン2種**（親フォルダ名 / `YYYYMMDD_議事ログ_親フォルダ名`）で、現在のフォルダ名を活用した定型名を素早く入力できます（ドライブルートでは非表示）。テキストボックスにフォーカスすると **入力履歴ポップアップ** が自動表示され、過去にリネームで使用した名前を選択して再利用できます（最大100件、最近使用した順）。
- **削除**: `Delete` キー。Windows 標準の確認ダイアログが表示され、ごみ箱へ送られます。
- **ショートカットの作成**: 選択した項目のショートカットを現在のフォルダに作成します。
- **プロパティ表示**: Windows 標準のプロパティ画面を表示します。
- **エクスプローラーで開く**: 現在のフォルダを Windows 標準のエクスプローラーで開きます。
- **ファイル操作エラー時のプロセス表示**: ファイルのリネーム・削除・コピー・移動・ドラッグ＆ドロップ時に、他のアプリケーションがファイルを使用中でエラーが発生した場合、そのファイルをロックしているプロセス名（例: 「EXCEL がこのファイルを使用中のため、操作を完了できません」）がエラーメッセージに表示されます。Windows Restart Manager API を利用してプロセスを特定するため、ファイルを閉じるべきアプリケーションが一目で分かります。アクセス権限不足やディスク容量不足の場合も、原因に応じた分かりやすいメッセージが表示されます。

### 2-4. 独自コンテキストメニュー

Zenith Filer では、ファイル一覧の右クリック時に表示されるコンテキストメニューを、**アプリ独自の軽量メニュー**と**エクスプローラ互換メニュー**の2種類から選択できます。デフォルトでは、体感のレスポンスを重視したアプリ独自メニューが表示されます。

#### 2-4-1. メニューの種類と切り替え

- **アプリ独自メニュー（推奨）**: よく使う操作を即座に表示する軽量なメニューです。開く・コピー・削除・名前の変更・お気に入り・インデックス検索など、基本操作を素早く実行できます。Windows 11 風のモダンなスタイル（角丸・余白・透明感を活かしたデザイン）で、右クリックした位置に待機時間なく即座に表示されます。
- **エクスプローラ互換メニュー**: Windows 標準の右クリックメニューを表示します。7-Zip などのシェル拡張や、アプリ固有のコンテキストメニュー項目も利用できます。

**切り替え方法**:
- **アプリ設定で変更**: Control Deck (標準: Ctrl+Shift+O)→「基本設定」→「コンテキストメニュー」で選択できます。設定は次回起動時にも引き継がれます。
- **一時的に切り替え**: アプリ独自メニューがデフォルトの場合、**Shift+右クリック**でエクスプローラ互換メニューを表示できます。また、独自メニュー内の「エクスプローラのコンテキストメニューを表示する」を選択しても切り替えられます。
- **Box フォルダでの共有リンク自動整形**: Box Drive 領域内の項目で **Shift+右クリック** すると、エクスプローラメニュー表示と並行して、最大20秒間クリップボードの変化を監視します。メニューから「共有」→「共有リンクをコピー」を選ぶと、Box が `box.com` を含む URL をクリップボードに書き込んだタイミングで自動的に「1行目: Box相対パス、2行目: 共有URL」の2行形式に置き換えられます。整形成功時はペインにグリーンフラッシュが表示され、ステータスバーに「BoxパスとURLを結合しました」と表示されます。20秒以内に URL が検知されない場合は通知なく監視を終了します。

#### 2-4-2. アプリ独自メニューの項目

アプリ独自メニューは、選択した項目の種類や数に応じて、適切な操作項目を自動的に表示します。メニュー内は区切り線で **開く・表示** → **クリップボード** → **名前・パスのコピー**（ファイル名をコピー・フルパスをコピー。Box 領域では「連携用BOXパスをコピー」も表示）→ **編集・変更** → **アプリ固有** → **その他・システム** の6グループに分かれており、目的の操作を素早く見つけやすくなっています。Box の実アドレス（URL）が必要な場合は、**Shift+右クリック**でエクスプローラメニューを表示し、「共有」→「共有リンクをコピー」を選ぶと、20秒監視により「Boxパス＋URL」の2行形式に自動整形されます。

**ファイル・フォルダを選択した場合**:
- **開く**: ファイルまたはフォルダを開きます（ファイルの場合は既定アプリで開きます）。
- **新しいタブで開く**（フォルダのみ）: 選択したフォルダを新しいタブで開きます。
- **反対ペインで開く**（フォルダのみ）: 選択したフォルダを反対側のペインで開きます。1ペイン表示時は自動的に2ペイン表示に切り替わります。
- **テキストエディタで開く**（テキスト系ファイルのみ）: `.txt`, `.md`, `.json`, `.html` などのテキスト系ファイルを、常に `.txt` の既定アプリ（OS の「既定のアプリ」で設定したメモ帳やサクラエディタなど）で開きます。複数選択時は、すべてテキスト系ファイルの場合に表示されます。
- **テキスト比較**（テキスト系ファイル2つ選択時のみ）: 2つのテキストファイルを選択した状態で表示されます。サイドバイサイドの差分ビューアが開き、挿入行（緑）・削除行（赤）がハイライト表示されます。左端には差分ミニマップが表示され、ファイル全体の差分位置を挿入（緑）・削除（赤）・変更（黄）の色で俯瞰できます。ミニマップのクリック/ドラッグで該当箇所にジャンプ可能です。`Esc` キーまたは背景クリックで閉じます。ファイルサイズ上限は 5MB です。Free 版では 3 回まで利用可能です。
- **〈ファイル名〉と比較**（2ペインモード・テキスト系ファイル1つ選択時）: 2ペイン表示で、右クリックしたペインに1つのテキストファイルを選択し、反対側のペインにも1つのテキストファイルが選択されている場合に表示されます。クリックすると両ペインのファイルをサイドバイサイドで比較します。
- **ペインターで開く**（画像系ファイルのみ）: `.png`, `.jpg`, `.bmp` などの画像系ファイルを、OS で標準設定した画像編集用のアプリで開きます。複数選択時は、すべて画像系ファイルの場合に表示されます。
- **コピー**: 選択した項目をクリップボードにコピーします（`Ctrl+C` と同じ）。
- **切り取り**: 選択した項目をクリップボードに切り取ります（`Ctrl+X` と同じ）。
- **貼り付け**: クリップボードの内容を現在のフォルダに貼り付けます（`Ctrl+V` と同じ）。
- **ファイル名をコピー**: 選択した項目の名前（ファイル名・フォルダ名）をクリップボードにコピーします。複数選択時は改行区切りでコピーします。
- **フルパスをコピー**: 選択した項目のフルパスをクリップボードにコピーします。複数選択時は改行区切りでコピーします。
- **連携用BOXパスをコピー**（Box 領域のみ）: 現在のフォルダが Box ドライブ内のときのみ表示されます。他ユーザーと共有する際に使う「Box\～」形式のパス（例: `Box\Folder\file.txt`）をクリップボードにコピーします。複数選択時は改行区切りでコピー。実アドレス（URL）を含めた2行形式が必要な場合は、**Shift+右クリック**→「共有」→「共有リンクをコピー」で20秒監視による自動整形を利用してください。
- **削除**: 選択した項目を削除します（`Delete` キーと同じ）。Windows 標準の確認ダイアログが表示されます。
- **名前の変更**: 選択した項目の名前を変更します（`F2` キーと同じ）。単一選択時のみ表示されます。
- **ショートカットの作成**: 選択した項目へのショートカットを現在のフォルダに作成します。
- **このフォルダをAペインのホームに設定**（フォルダのみ）: 選択したフォルダを A ペインのホームフォルダに設定します。
- **このフォルダをBペインのホームに設定**（フォルダのみ）: 選択したフォルダを B ペインのホームフォルダに設定します。
- **お気に入りに追加**（フォルダ・ファイル）: 選択したフォルダまたはファイルをお気に入りに登録します。既に登録されている場合は「お気に入りから解除」が表示されます。
- **PDFに変換して同フォルダへ保存**（単一ファイル・変換対応形式のみ）: 選択したファイルを PDF に変換し、**同一フォルダ**へ「元のファイル名.pdf」として保存します。対応形式は画像（`.jpg`, `.jpeg`, `.png`, `.bmp`, `.gif`）および Office 文書（`.docx`, `.doc`, `.docm`, `.xlsx`, `.xls`, `.xlsm`, `.pptx`, `.ppt`, `.pptm`）です。Office 文書の変換には Microsoft Office のインストールが必要です。変換中はグロウバーと進捗メッセージが表示されます。
- **PDFに変換して結合・同フォルダへ保存**（複数ファイル・すべて変換対応形式の場合）: 選択した複数ファイル（画像・Office 文書）をそれぞれ PDF へ変換した後、全ページを 1 つのファイルに結合して「Combined_yyyyMMddHHmmss.pdf」として**同一フォルダ**へ保存します。
- **インデックス検索でこのフォルダを検索**（フォルダのみ）: 選択したフォルダをインデックス検索の対象として検索します。
- **このフォルダ以下の一覧をCSV出力**（フォルダのみ）: 選択したフォルダを起点にサブフォルダを含む全ファイルをスキャンし、CSV を生成します（仕様の詳細は背景右クリック版と同仕様）。
- **このフォルダ以下の一覧をExcel出力**（フォルダのみ）: 選択したフォルダを起点にサブフォルダを含む全ファイルをスキャンし、Excel（.xlsx）を生成します（仕様の詳細は背景右クリック版と同仕様）。
- **プロパティ**: Windows 標準のプロパティ画面を表示します。単一選択時のみ表示されます。
- **エクスプローラのコンテキストメニューを表示する**: エクスプローラ互換メニューに切り替えます。

**背景（空きスペース）を右クリックした場合**:
- **新しいフォルダ**: 現在のフォルダに新しいフォルダを作成します（`Ctrl+Shift+N` と同じ）。作成直後にリネームダイアログが自動表示されます。キャンセルすると作成したフォルダを自動削除します。
- **新しいテキストファイル**: 現在のフォルダに空のテキストファイル（`.txt`）を作成します。作成直後にリネームダイアログが自動表示されます。キャンセルすると作成したファイルを自動削除します。
- **新規作成 ▶**（サブメニュー）: Windows にインストールされたアプリケーション（Word、Excel、PowerPoint 等）のテンプレートからファイルを作成できるサブメニューです。レジストリの ShellNew エントリから自動的にアイコン付きで一覧を取得します。選択するとテンプレートをコピーして新しいファイルを作成し、リネームダイアログが自動表示されます。アプリ起動時にバックグラウンドでスキャンするため、初回右クリック時にはまだ読み込み中の場合は表示されません。
- **貼り付け**: クリップボードの内容を現在のフォルダに貼り付けます。
- **フルパスをコピー**: 現在のフォルダのフルパスをクリップボードにコピーします。
- **フォルダ内の一覧をコピー（名前）**: 現在のフォルダ内に表示されている項目の名前（ファイル名・フォルダ名）を、改行区切りでクリップボードにコピーします。ファイル種類フィルタやソートが有効な場合は、その表示内容に従います。検索結果タブのときは検索結果一覧の名前をコピーします。
- **フォルダ内の一覧をコピー（フルパス）**: 現在のフォルダ内に表示されている項目のフルパスを、改行区切りでクリップボードにコピーします。表示内容の扱いは「名前」と同じです。
- **連携用BOXパスをコピー**（Box 領域のみ）: 現在のフォルダが Box ドライブ内のときのみ表示されます。現在のフォルダの「Box\～」形式のパスをクリップボードにコピーします。
- **インデックス検索でこのフォルダを検索**: 現在のフォルダをインデックス検索の対象として検索します。
- **このフォルダ以下の一覧をCSV出力**: 現在のフォルダを起点にサブフォルダを含む全ファイルをファイルシステムから直接スキャンし、UTF-8 BOM 付きの CSV ファイル（列: 項番・ファイル名・相対フォルダパス・更新日時・サイズ）を生成します。パス列はカレントフォルダ起点の相対パス（`.\Sub\` 形式）で出力されるため、Box 等でユーザー名が異なる環境でもフィルタが共通利用可能です。スキャン中はステータスバー上端の**スキャンバー**と右側の**スピナー**が同時に表示されます。拡張子のないファイルは対象外です（件数上限なし）。
- **このフォルダ以下の一覧をExcel出力**: 現在のフォルダを起点にサブフォルダを含む全ファイルをスキャンし、Excel（.xlsx）ファイル（列: 項番・ファイル名・相対フォルダパス・更新日時・サイズ・フォルダを開く）を生成します。パス列はカレントフォルダ起点の相対パス（`.\Sub\` 形式）で出力されるため、Box 等でユーザー名が異なる環境でもフィルタが共通利用可能です。「フォルダを開く」列は相対パス形式の HYPERLINK 関数で出力され、Excel ファイルとフォルダ構造を一緒に共有した際にどの PC からでもリンクが機能します。ヘッダー行は固定表示・オートフィルタ付きです。
- **プロパティ**: 現在のフォルダのプロパティ画面を表示します。
- **エクスプローラのコンテキストメニューを表示する**: エクスプローラ互換メニューに切り替えます。

**クラウドサービス連携メニュー**（Box / SharePoint / OneDrive フォルダのみ）:
- Box ドライブや SharePoint / OneDrive 同期フォルダ内でファイルやフォルダを右クリックすると、クラウドサービス固有のメニュー項目（「Box で共有」「バージョン履歴」等）がメニュー下部に自動追加されます。項目はシェル拡張から非同期で取得されるため、メニュー表示後に少し遅れて追加される場合があります。1.5秒以内に取得できない場合は表示されません。
- **Box 共有リンクのリッチコピー**: Box フォルダ内で「共有 ▶ 共有リンクをコピー」を選択すると、選択した各アイテムの個別 Box 共有 URL を順次取得し、HTML 形式＋プレーンテキスト形式の両方でクリップボードに格納します。Teams・Outlook・Slack 等のリッチエディタに貼り付けるとアイテム名がクリック可能なハイパーリンクとして表示され、クリック一つで Box のそのファイルを直接開けます。メモ帳等のプレーンエディタでは「アイテム名 ( URL )」形式でフォールバックします。構成は「親フォルダの Box 相対パス → 親フォルダ共有 URL → 各アイテム名（個別リンク付き）」の3層です。背景右クリック時はフォルダ内全アイテム名が付与されます。整形完了時に「Box共有情報をコピーしました」の通知とグリーンフラッシュが表示されます。

#### 2-4-3. メニューの表示位置とスタイル

- **表示位置**: メニューは右クリックした位置を起点に表示されます。画面の右端・下端にはみ出す場合は、自動的に左・上に寄せて表示され、見切れを防ぎます。
- **表示速度**: アプリ独自メニューは待機時間なく即座に表示され、体感のレスポンスを重視した設計になっています。
- **デザイン**: Windows 11 風のモダンなスタイル（角丸・余白・透明感を活かしたデザイン）で統一されています。各項目にはアイコンが表示され、区切り線でグループ分けされているため操作内容が一目で分かります。

#### 2-4-4. エクスプローラ互換メニューについて

エクスプローラ互換メニューは、Windows 標準の右クリックメニューをそのまま表示します。以下のような場合に便利です：
- 7-Zip などのシェル拡張を利用したい場合
- 特定のアプリが追加したコンテキストメニュー項目を使用したい場合
- Windows 標準の動作に慣れている場合

エクスプローラ互換メニューでは、リネームや削除などの操作もアプリ側で適切に処理されるため、操作感はアプリ独自メニューと同様です。

### 2-5. ドラッグ＆ドロップ
- **複数選択とドラッグ**: `Ctrl` キーや `Shift` キーを使い、ファイルリストで複数の項目を同時に選択できます。選択した状態でドラッグを開始すると、選択されているすべてのファイル・フォルダがコピー／移動の対象となります。
- ペイン間、または外部アプリケーションとの間でファイルをドラッグ＆ドロップしてコピー・移動が可能です。
- **ブラウザからの URL ドロップ**: ブラウザのアドレスバーやリンクをファイルリスト、またはブレッドクラムバーにドラッグ＆ドロップすると、その URL へのインターネットショートカット（`.url` ファイル）を作成して保存します。
- **ドラッグ中のガイド表示**: ファイルやフォルダをドラッグし始めると、マウスカーソルのすぐ横に「n件の項目をコピー/移動先にドロップしてください」（例: 「5件の項目をコピー/移動先にドロップしてください」）というガイドメッセージが表示されます。これにより、ドラッグ操作中であることと現在ドラッグしている件数が視覚的に明確になります。
- **操作の種類**（Windows 標準に準拠）：
  - **Ctrl なしでドロップ** → 移動
  - **Ctrl を押しながらドロップ** → コピー
- **ナビゲーション用ドロップ**: お気に入り・参照履歴・フォルダツリーの項目をファイルリストにドロップすると、そのフォルダへ遷移します。検索結果や履歴一覧を表示している最中でもドロップ可能で、検索が自動的に解除され通常表示に戻ったうえで、ドロップしたフォルダの内容が即座に表示されます。
- **一覧からナビペインへのドロップ**: ファイル一覧から**お気に入りビュー**へドロップすると、フォルダまたはファイルをお気に入りに登録します（お気に入りロック中でも登録可能）。**ツリービュー**へドロップすると、ドロップ先のフォルダへファイル・フォルダを移動します（お気に入り登録にはなりません）。ツリービューロックON時は、一覧からツリーへのドロップも無効となり、ステータスバーに「ロック中のため操作不可」と表示されます。
- **一覧からパンくずへのドロップ**: ファイル一覧で選択した項目をドラッグし、**パンくずリストの任意の階層**（例: 「ダウンロード」「ユーザー」など）にドロップすると、その階層のフォルダへコピーまたは移動できます。左ドラッグ時は Ctrl なしで移動、Ctrl 押下でコピー。右ドラッグでドロップすると「ここにコピー」「ここに移動」「キャンセル」のメニューが表示されます。
- **ドライブのドラッグ＆ドロップ**: PC（マイコンピュータ）ビューのドライブリストから、ドライブをペインにドラッグ＆ドロップすると、そのドライブのルートフォルダを開きます。
- ドラッグはマウスを約 10px 以上動かしたときのみ開始されるため、クリック時のわずかな動きによる誤操作を抑制しています。
- Windows 標準のダイアログが表示されるため、上書き確認やプログレスバーも安全に動作します。
- **右クリックドラッグ＆ドロップ（右ドラッグ）**: ファイルを**右クリックしたまま**ドラッグしてドロップすると、ドロップした位置にメニューが表示されます。
  - **ここにコピー** … ドロップ先にコピーします。
  - **ここに移動** … ドロップ先に移動します。
  - **ここにショートカットを作成** … 元のファイルを参照するショートカット（例: `元の名前 - ショートカット.lnk`）をドロップ先に作成します。
  - **キャンセル** … 何もしません。
  - 同一ペイン内・左右（または上下）のペイン間のどちらでも利用できます。ドロップ先がフォルダ行の場合はそのフォルダ内、それ以外は現在表示中のフォルダが対象になります。

### 2-6. テキスト比較（Diff）
2つのテキストファイルをサイドバイサイドで比較し、差分をハイライト表示する機能です。

- **起動方法**: Aペインでファイルを選択し、コンテキストメニューから「テキスト比較」を実行。比較先ファイルを選択すると Diff ビューが開きます。
- **差分ミニマップ**: 画面右端にファイル全体の差分概要がミニマップとして表示され、変更箇所の位置を俯瞰できます。
- **同期スクロール**: 左右のパネルは同期スクロールし、対応する行が常に横に並びます。

---

## 3. 高度な機能

### 3-1. お気に入り管理
- **保存先**: お気に入りはアプリ実行フォルダの `settings.json` に保存されます。このファイルをバックアップすれば、別の PC や新バージョンへの移行時に、お気に入りを含む設定を簡単に引き継げます。
- **自動バックアップ**: アプリ終了時に、現在の `settings.json` が `backups` フォルダへ自動でコピーされます。ファイル名は `settings_yyyyMMdd_HHmmss.json` 形式（例: `settings_20260205_092500.json`）です。アプリ設定の「4. 設定ファイルリカバリ」から一覧を確認し、任意の時点の設定に復元できます。
- **追加**: 
  - アドレスバーの「★」ボタンをクリックすると「お気に入りに追加」ダイアログが開き、名前と概要説明（任意）を入力して現在のフォルダを登録できます。
  - ファイルペインのフォルダまたはファイルを**お気に入りビュー**（サイドバーで「お気に入り」表示時）へドラッグ＆ドロップするとお気に入りに登録できます（この場合は名前・概要のダイアログは表示されず、フォルダ名・ファイル名のまま登録されます。お気に入りロック中でも登録可能）。**ツリービュー**へドロップした場合はお気に入り登録ではなく、ドロップ先のフォルダへファイル・フォルダを移動します（ツリービューロックON時は移動も含め全て無効）。
  - ファイル一覧でファイルを右クリックし「お気に入りに追加」を選択すると、そのファイルをお気に入りに登録できます（フォルダと同様に選択時のみ表示）。
  - お気に入りビューの空きスペースを右クリックして「新しいフォルダ」を実行すると、ツリーの**末尾（ルート直下）**に仮想フォルダが作成され、即座に「新しいフォルダ」ダイアログが開きます。名前と概要説明（任意）を入力して登録できます。デフォルトで「新しいフォルダ」または「新しいフォルダ (n)」が入力され、概要は空欄でも登録可能です。
  - お気に入り内の任意の項目を右クリックして「新しいフォルダ」を実行すると、その項目と**同じ階層の直下**に新しい仮想フォルダが挿入されます（フォルダの「中」ではなく、「すぐ下」に並ぶ形で追加されます）。作成されたフォルダは自動的に選択され、そのまま「新しいフォルダ」ダイアログで名前と概要を入力して登録できます。
  - お気に入りビュー下部のアイコン群の**左端**（スプレッドシートアイコン）をクリックすると、お気に入りデータを Excel 形式でバックアップ保存できます。保存先は SaveFileDialog で指定します。出力される列は No・グループ・表示名・フルパス・種類・開くリンクの6列で、グループ階層は「親 > 子」形式で展開されます。「開く」列はフルパス列を参照する HYPERLINK 関数で出力されます。整理用フォルダも含む全項目が対象です。処理中は GlowBar で進捗を表示します。
  - お気に入りビュー下部のダウンロードアイコンをクリックすると、エクスプローラの**クイックアクセス**（ピン留めしたフォルダ等）の項目をまとめてお気に入りに取り込めます。取り込んだ項目は、名前「インポート」・概要「エクスプローラのクイックアクセスからインポート」のフォルダ内に追加されます（フォルダがなければ自動作成、既にあればその中に追記）。既に登録済みのパスはスキップされます。
- **整理**: お気に入り内で「新しいフォルダ（仮想フォルダ）」を作成し、階層化して整理できます。作成時の名前は、お気に入り内の既存フォルダ名を考慮して「新しいフォルダ」「新しいフォルダ (2)」「新しいフォルダ (3)」…のように自動採番されます。
- **概要説明**: 各お気に入りフォルダには任意の概要説明（例: 「週次報告用」）を追加できます。フォルダ名の横に控えめに表示され、似た名前のフォルダを識別しやすくします。右クリックメニューから「概要を編集」を選択すると、概要専用のダイアログ（「概要説明を入力してください:」）が開き、いつでも追加・変更・削除ができます。マウスホバー時に ToolTip でパスと概要の全文を確認できます。
- **カテゴリ見出しとしての第1階層フォルダ**: お気に入りツリーの**第1階層にある仮想フォルダ**は、ナビペインの左端から右端手前（スクロールバー領域を除く）までを貫く「スリムな全幅帯」として描画されます。通常の行よりわずかに高い程度のスリムな帯ですが、落ち着いた濃いグレーの背景と、左端のアクセントライン・白いセミボールドのフォルダ名・明るいグレーの概要説明により、カテゴリの区切りを一目で、かつ上品に判別できるようになっています。左右と上下に控えめなマージンと角丸を設けることで、Windows 11 のモダンな UI に調和した「浮き上がった帯」のような外観を提供します。
- **ツリー関係線（Tree Lines）**: カテゴリ内の子アイテムには、親子関係を示す控えめなガイド線（縦線＋水平コネクタ）が表示されます。末尾の子アイテムは L 字型の接続線、それ以外は全高の縦線が描画され、どのアイテムがどのカテゴリに属するかを一目で判別できます。第1階層のカテゴリヘッダー自体には線は表示されません。カテゴリを折りたたむと線も自動的に非表示になります。
- **ファイルの環境アイコン**: お気に入りに登録したファイルは、ファイルアイコンの左側に環境（場所）アイコン（ローカル／ネットワーク／Box／SPO）が表示され、どのストレージのファイルか一目で判別できます。
- **パス不正の視覚的警告**: お気に入りに登録したパスが削除・リネーム等で存在しなくなった場合、名前の右側に警告アイコン（⚠）がひっそりと表示されます。パスが正常な場合はアイコンは完全に非表示となり、横幅を占有しません。
- **パス未検出時の自動確認**: お気に入りからフォルダを開く際、そのパスがリネームや削除によって見つからない場合は、「パスが見つかりません。この項目をお気に入りから削除しますか？」という確認メッセージが表示されます。「はい」を選択すると、お気に入りロック状態であっても即座に削除が反映されます。ファイル・フォルダいずれも同様です。BOX Drive や OneDrive（SPO）などクラウドドライブのパスの場合は、オンデマンドダウンロード（ハイドレーション）の遅延を考慮し、自動的に最大2回リトライしてからパス未検出の判定を行います。
- **フォルダとファイルの操作の違い**: お気に入りからフォルダをダブルクリックすると、そのフォルダが A/B ペインに表示されます。ファイルをダブルクリックすると、関連付けられたアプリで開きます。**整理用フォルダ（仮想フォルダ）**は行をダブルクリックすると展開/折りたたみされます（矢印のクリックでも開閉可能）。「Aペインで開く」「Bペインで開く」でファイルを選択した場合は、そのファイルの親フォルダがペインに表示されます。**ホイールクリック（中クリック）**すると、フォルダはそのフォルダを、ファイルは親フォルダを、アクティブペインの**新しいタブ**で開きます（ツリー・検索結果のどちらでも利用可能）。
- **ナビ幅ロック**: お気に入りビュー時のみ、サイドバー右下の**左側**のパネルアイコンで、ナビペインの幅をスプリッターで変更できないようにロックできます。幅変更可能時は開いたパネル、固定時は閉じたパネルで表示されます。ツリー・履歴の自動拡張はロック時も有効です。状態は保存され次回起動時に復元されます。
- **お気に入りロック**: **お気に入りビュー表示時のみ**、サイドバー右下に南京錠アイコンが表示されます。クリックすると、**お気に入りビュー内での**仮想フォルダ追加・削除・並び替えを一時的に禁止し、誤操作を防げます。登録・名前変更・概要変更はロック中でも行えます。ツリービューやファイルペインでの操作には影響しません。ロック中に禁止操作を試みた場合は**ナビペインロック仕様**に従い、ステータスバーに「ロック中のため〜できませんでした。」と表示され、南京錠付近で点滅と矢印で解除を促します。アニメーション中でも南京錠をクリックすれば即座にロック解除され、点滅も停止します。
- **ツリービューロック**: **ツリービュー表示時のみ**、サイドバー右下に南京錠アイコン（ツリービューロック）が表示されます。お気に入りロックとは別の設定で、ロック中はツリービュー内でのフォルダのドラッグ＆ドロップによる移動、リネーム（F2・右クリック「名前の変更」）、削除（Delete・右クリック「削除」）に加え、**ファイル一覧からツリーへのドラッグ＆ドロップ**も含め全ての変更操作を禁止します。**ロック解除時**は、ツリー上でフォルダを別のフォルダの上（子として）や前後にドロップすると実フォルダが移動し、ファイル一覧からツリーのフォルダへドロップすると、そのフォルダへファイル・フォルダを移動します。ロック中に禁止操作を試みた場合は**ナビペインロック仕様**に従い、ステータスバーに「ロック中のため〜できませんでした。」と表示され、南京錠付近で点滅・矢印で解除を促します。状態は次回起動時に復元されます。
- **削除確認**: サイドバー右下のメッセージアイコンで、削除時の確認メッセージ表示を切り替えられます。
- **カラータグ**: お気に入りアイテムに7色のカラーラベルを設定できます。コンテキストメニューから色を選択し、一覧で視覚的に分類できます。ナビペインの検索ボックスで `tag:赤` のように色名で絞り込みも可能です。
- **カスタムアイコン**: お気に入りのコンテナ（フォルダグループ）に64種のプリセットアイコンから選択して設定できます。AI お気に入り整理使用時には自動でアイコンが付与されます。
- **アイテム数バッジ**: コンテナ名の横にアイテム数がバッジ表示されます。
- **参照回数表示**: お気に入りアイテムの参照回数が表示されます。
- **「最近追加」セクション**: 最近追加したお気に入りが専用セクションに表示されます。
- **ABC 順ソート**: トグルボタンでアルファベット順ソートに切替可能です。
- **エクスプローラーからのD&D登録**: エクスプローラーからフォルダをナビペインのお気に入りエリアにドラッグ＆ドロップして直接登録できます。
- **「よく使う」ピン件数カスタマイズ**: お気に入り設定ダイアログ（歯車アイコン）から、よく使うアイテムの表示件数を3〜15件で調整できます。
- **お気に入り設定ダイアログ**: 歯車アイコンから、カラータグ表示・バッジ表示・参照回数表示・最近追加セクション表示などの各種表示設定を切り替えられます。

### 3-2. 表示オプション
- **アダプティブ列**: ウィンドウ幅を狭めると「サイズ」「種類」「更新日時」「場所」の順に列が自動的に非表示になり、最終的にファイル名だけが表示される粘り強いレイアウトに切り替わります（検索結果時は「サイズ」「更新日時」「場所」「名前」の順に非表示になり、パス列が最後まで表示されます）。
- **フォルダを先に表示**: フォルダをファイルよりも常に上に表示するか、名前順で混在させるかを切り替えられます。
- **フォルダ別表示設定の自動復元**: フォルダごとにソート順・表示モード・フォルダ先頭設定を自動記憶し、再訪問時に自動適用します。設定でON/OFF切替が可能です。
- **列自動非表示の動的制御**: ウィンドウ幅が狭い場合、名前列に最低250pxを確保しつつ、優先度の低い列（種類・属性等）を自動的に非表示にします。ウィンドウを広げると自動的に復元されます。
- **検索バー2段目表示**: 設定でヘッダーの2行目にサイズフィルタ・日付フィルタを常時表示するオプションを追加。検索時にフィルタ条件をすばやく設定できます。

### 3-3. 検索機能
Zenith Filer には、用途の異なる 2 つの検索モードがあります。

- **通常検索（オンデマンドファイルシステム検索）**: 
    - **目的**: 現在開いているフォルダ（およびそのサブフォルダ）の中から目的の項目を素早く見つけるための検索です。
    - **動作**: リアルタイムでファイルシステムを走査するオンデマンド検索です。検索対象フォルダの配下を再帰的に検索します。検索ボックスにキーワードを入力し **Enter を押す**と新規タブで検索が開始されます。検索結果タブでは入力と同時に即時検索が実行され、Enter を押す必要はありません。検索結果のフォルダやパスをクリックした際の表示先は、アプリ設定の「検索結果のパスクリック時の挙動」で選択できます（同一タブで表示／同一ペイン・新規タブ／反対ペイン・新規タブ）。
    - **検索クエリ構文**: 複数キーワードの AND 検索（スペース区切り）、OR 検索（`|` 区切り）、除外（`-キーワード`）、拡張子フィルタ（`ext:pdf`）に対応しています。
    - **検索バー2段目**: 設定で検索バーの2段目表示を有効にすると、サイズフィルタや日付フィルタを常時表示できます。
    - **検索結果**: ファイルとフォルダの両方がヒットし、更新日時が新しい順に表示されます。拡張子のないファイル（一時ファイル・キャッシュ等）は検索結果に含まれません。列ヘッダーをクリックすると、名前順など他の並びに変更できます。
- **インデックス検索モード（横串検索）**:
    - **目的**: カレントフォルダに関わらず、あらかじめ**登録した複数のフォルダ群全体から**項目を横断的に検索するためのモードです。
    - **検索対象**: ナビペインの **「インデックス検索設定」(標準: Ctrl+Shift+4)** で登録したすべてのパスが対象となります。ファイルとフォルダの両方がインデックスされ、検索結果に含まれます。このビューにはインデックスに登録されているファイル・フォルダの総件数が表示され、各フォルダごとに「作成中」「〇〇件」などの状態と件数が一覧表示されます。
    - **操作**: 検索バー左端の虫眼鏡アイコンをクリックするか `Ctrl+Shift+F` を押すと、インデックス検索モード（⚡アイコン・背景色変化）に入ります。
    - **検索スコープセレクター**: インデックス検索モード時、検索バーの⚡アイコンの右隣にフォルダアイコンとバッジ（例: 3/10）が表示されます。このボタンをクリックすると、登録フォルダの一覧がポップアップ表示され、チェックボックスで検索対象に含めるフォルダを個別に選択・解除できます。絞り込み中はアイコンとバッジがアンバー色で強調されます。「すべて選択」「すべて解除」ボタンで一括操作も可能です。選択を変更すると検索結果がリアルタイムで再描画されます。選択状態はアプリ終了時に自動保存され、次回起動時に復元されます。ロック済みフォルダも選択対象に含まれ、凍結データから検索ヒットします。ポップアップは外部クリックやウィンドウの非アクティブ化で自動的に閉じます（スマート・クローズ）。
    - **検索結果**: ファイルとフォルダの両方がヒットし、更新日時が新しい順に表示されます。列ヘッダーをクリックすると、名前順など他の並びに変更できます。
- **インデックスの技術仕様**:
    - **保存場所**: アプリ実行フォルダ内の `index` フォルダに共通のインデックスが保持されます（ポータブル性を高めるため、以前の `%AppData%\ZenithFiler\Index` から変更されました）。
    - **日本語検索**: 日本語キーワード（例：「自由自在」）の検索では、複数語に分割されてもすべての語を含むファイルをヒットするよう精度を改善しています。また、トークン化しない `name_raw` フィールドによるワイルドカード検索を用いて、パースエラー時でも部分一致が確実にヒットするようにしています。
    - **ファイル構成**: `segments_N`, `_N.cfs`, `write.lock` および `zenith.db` (履歴DB) 等のファイルで構成されます。
    - **自動更新**: ファイル操作（追加・削除・リネーム）に応じて、登録済みフォルダのインデックスはバックグラウンドで自動更新されます。
    - **検索対象のフィルタリング**: 拡張子のないファイル（一時ファイル・キャッシュ・アプリケーション内部のハッシュ名ファイルなど）はインデックスに登録されず、検索結果にも表示されません。これにより、Excel・PDF・画像などユーザーが通常使用するファイルを素早く見つけやすくなっています。
    - **パフォーマンスへの配慮**: 複数フォルダを登録している場合、インデックス作成は1件ずつ順次実行されます。これによりステータスバーの進捗表示が安定し、ネットワークドライブ等への負荷を抑えられます。また、インデックス作成時には一定件数ごとに待機時間を設ける「スロットリング」を行い、`.git` や `node_modules` などの大規模な中間フォルダは自動的にスキップされます。アプリ設定の「省エネモード」「ネットワークドライブは軽めに処理する」をオンにすると、この待機時間が長くなり CPU・ディスク・ネットワークへの負荷をさらに抑えられます。
    - **インデックス作成中の検索**: フォルダのインデックス作成がバックグラウンドで進行中でも、100件ごとに検索用インデックスへ反映されるため、作成済み分は検索結果にヒットします。ステータスバーのアニメーションアイコンでインデックス作成中であることを確認でき、クリックすると確認の上で中止できます。
    - **作成結果・件数の確認**: インデックス作成が完了すると、ステータスバーに「〇〇件をインデックスに追加しました」と通知されます。ナビペインの「インデックス検索設定」ビューでは、インデックスに登録されているファイル・フォルダの総件数を閲覧できます。
    - **作成中の進捗**: インデックス作成中は、ステータスバーに「インデックス作成中: 〇〇件 (フォルダ名)」と進捗が表示され、100件ごとに更新されます。
    - **フォルダ別の状態・件数**: インデックス検索設定の一覧では、各フォルダごとに「作成中」「未作成」、またはインデックス済みの場合は「〇〇件」が表示されます。ロック（アーカイブ）されたフォルダは、ロック時点の件数と日時が凍結保持され、南京錠アイコンとともに表示されます。複数フォルダを登録している場合でも、各フォルダのインデックス作成が完了するたびに一覧が即座に更新されます。
    - **フォルダ別の手動更新**: 一覧でフォルダを右クリックし、「インデックスを再作成」でそのフォルダのインデックスを一度削除してから再作成（削除済みファイルも反映）、「インデックスを差分更新」で削除せずに新規・更新分だけを反映できます。差分更新は高速ですが削除済みファイルはインデックスに残ります。削除済みを反映したい場合は再作成を選択してください。
- **サイズ・日付フィルタ**: 検索バーのスコープボタン右隣に、サイズフィルタボタン（天秤アイコン）と日付フィルタボタン（カレンダーアイコン）があります。クリックするとポップアップが表示され、以下の絞り込みが可能です。フィルタ適用中はアイコンが濃色（#1A1A1A）に変わり、アイコン下に 1px charcoal gray のアンダーラインが表示されます（0.1s フェード）。フィルタ状態はアプリ終了時に自動保存され、次回起動時に復元されます。通常検索・インデックス検索の両方で一貫して動作します。
    - **サイズフィルタ**: Min（最小サイズ）と Max（最大サイズ）のテキスト入力方式。サフィックス `k`（KB）、`m`（MB）、`g`（GB）に対応し、未指定時は MB として解釈します（例: `500k` → 500 KB、`2.5g` → 2.5 GB）。入力中にリアルタイムで変換プレビューが表示されます。クイックチップ（< 100 KB / 100 KB ~ 10 MB / 10 MB ~ 1 GB / > 1 GB）をクリックすると Min/Max に自動入力されます。ポップアップ展開時は Min テキストボックスに自動フォーカスされ、Enter キーで閉じられます。フォルダはサイズフィルタの対象外です。
    - **日付フィルタ**: 開始・終了のテキスト入力方式。`yyyyMMdd`（例: `20260228`）、`MMdd`（例: `0228` → 今年）、`yyyy/M/d` などの柔軟な形式に対応し、入力中にリアルタイムで変換プレビュー（→ 2026/02/28）が表示されます。業務特化型プリセットチップ 9 種を 3 行配置: 短期（今日 / 昨日 / 直近 3 日）、中期（直近 7 日 / 直近 14 日 / 直近 30 日）、期間（今月 / 先月 / 今年）。クリックで開始・終了に即反映されます。ポップアップ下部には Calendar が常時表示され、テキスト入力とカレンダー選択が双方向に連動します（テキスト→カレンダーの選択状態反映、カレンダー→テキストへの書き戻し）。ポップアップ展開時は開始テキストボックスに自動フォーカスされ、Tab で終了へ遷移、Enter キーで閉じられます。
    - **Lucene レベルフィルタ**: インデックス検索モードでは NumericRangeQuery / TermRangeQuery をクエリ段階で適用し、不要なドキュメントを事前に除外します。
    - **ICollectionView フィルタ**: 通常検索モードでは検索結果のポストフィルタとして適用されます。
    - ポップアップ内の「リセット」ボタンでフィルタを解除できます。
    - **右クリックリセット**: サイズフィルタアイコン（天秤）または日付フィルタアイコン（カレンダー）を右クリックすると、該当するフィルタのみを即座にクリアします（アンダーラインも連動して消去）。
- **検索プリセット**: 検索バーの★アイコンをクリックすると、検索プリセットのポップアップが表示されます。「現在の条件を保存」ボタンで、現在の検索条件（キーワード・サイズフィルタ・日付フィルタ・拡張子フィルタ・ソート設定・スコープ）を名前付きプリセットとして保存できます。保存済みのプリセット名をクリックすると、すべての条件が一括で復元され、検索が自動実行されます。プリセットは通常検索用とインデックス検索用に自動分類され、現在のモードに合致するプリセットのみが表示されます。プリセットにカーソルを合わせると右端に × ボタンが表示され、クリックで削除できます。プリセットはアプリ再起動後も復元されます。プリセットが保存されている場合、★アイコンが濃色に変わりアンダーラインが表示されます。プリセットにマウスをホバーすると、キーワード・サイズ・日付・フィルタ・スコープ・ソートの設定内容がプレビューポップアップで確認できます（サイズは `1 GB` 形式、日付は `yyyy/MM/dd` 形式に自動変換）。プリセット適用時は、サイズ・日付フィルタのアイコンアンダーラインが即座に正しい状態に同期されます。
- **ファイル内容検索（grep）**:
    - **目的**: 現在開いているフォルダ内のファイルの**中身**（テキスト内容）をキーワードで検索します。ファイル名ではなく、ファイル内のテキストを対象とする点が通常検索と異なります。
    - **エンジン**: ripgrep (rg.exe) を使用し、高速かつ日本語テキスト（UTF-8 / Shift-JIS 等）にも対応しています。
    - **操作**: 通常検索モード時、検索バー左端の虫眼鏡アイコンの右隣にある FileSearch アイコンをクリックするか `Ctrl+Shift+G` を押すと、内容検索モード（ティール色のアイコン点灯・背景色変化）に入ります。インデックス検索モード中は grep トグルは非表示です。
    - **検索結果**: 検索結果にはマッチしたファイルが一覧表示されます。Match 列には最初のマッチ行のプレビュー（行番号 + テキスト）とファイル内のマッチ数が表示されます。
    - **制限事項**: バイナリファイルは自動的にスキップされます。ファイルサイズの上限は 50MB（デフォルト）です。rg.exe が tools/ フォルダに配置されていない場合、grep モードは自動的に無効化されます。
- **検索履歴**: 通常検索（虫眼鏡）・インデックス検索（雷）・内容検索（FileSearch）は別々に履歴（最大100件）が保持されます。検索時にサイズフィルタ・日付フィルタが設定されていた場合、履歴のキーワード右側に「プリセット: [名前]」「サイズ: [略称]」「日付: [略称]」がカラム形式で表示されます。プリセット名は保存済みプリセットの条件と動的に照合され、手動設定でも一致すれば自動表示されます。履歴から項目を選択すると、検索モード・サイズフィルタ・日付フィルタが検索時の状態に自動復旧されて再検索されます。

#### 3-3-1. 検索の挙動（Control Deck で変更可能）

Control Deck（標準: Ctrl+Shift+O）の「検索」→「検索の挙動」では、検索実行時の表示先と挙動を次の 3 パターンから選択できます。**デフォルトは「同一ペイン・新規タブ」**です。

| オプション | 動作 | 向いている用途 |
| :--- | :--- | :--- |
| **同一ペイン・新規タブ** | Enter で検索実行。同じペインに検索結果タブを新規作成。検索結果タブ上で検索バー右端の × を押すと、その検索結果タブを閉じて元の一覧タブに戻ります。 | 検索したペイン内で完結するため、予測しやすく文脈が保てます。初心者にもおすすめのデフォルトです。 |
| **同一ペイン・現在タブで即時検索** | Enter で検索実行。現在のタブで検索結果を表示。検索バー右端の × を押すと検索結果ビューが解除され、現在フォルダの一覧を自動で再読込して通常表示に戻ります。 | 検索と通常表示の切り替えが素早く、タブを増やさずに済みます。 |
| **反対ペイン・新規タブ** | Enter で検索実行。Aペインで検索→Bペインに、Bペインで検索→Aペインに新規タブで表示。1ペイン時は自動で2ペインに切替。反対ペイン側の検索結果タブ上で検索バー右端の × を押すと、その検索結果タブを閉じて同じペイン内の元のタブに戻ります。 | 比較作業や上級者向け。検索結果と元の一覧を左右ペインで同時に見比べたい場合に便利です。 |

#### 3-3-1-1. 検索時の表示設定（Control Deck で変更可能）

Control Deck（標準: Ctrl+Shift+O）の「検索」→「検索時の表示設定」では、検索実行時の画面モードに関する追加オプションを設定できます。

- **検索時に自動的に1画面モードに切り替える**（デフォルト：オフ）: オンにすると、検索実行時に自動的に1ペインモードへ切り替えて検索結果を画面全体に広く表示します。Bペインで検索した場合は検索タブがAペインに移動されます。検索結果タブをすべて閉じると、元の2ペインモードへ自動的に復元されます。

#### 3-3-2. 検索結果のパスクリック時の挙動（Control Deck で変更可能）

Control Deck（標準: Ctrl+Shift+O）の「検索」→「検索結果のパスクリック時の挙動」では、検索結果一覧のパス列をクリックした際の表示先を次の 3 パターンから選択できます。**デフォルトは「同一ペイン・新規タブ」**です。

| オプション | 動作 | 向いている用途 |
| :--- | :--- | :--- |
| **同一タブで表示** | 検索結果ビューから通常の一覧に切り替え、そのパスを同一タブで表示。 | タブを増やさずに済み、検索結果から素早くフォルダへ移動できます。 |
| **同一ペイン・新規タブ** | 同じペインに新規タブを開く（従来の挙動）。 | 検索結果タブを残したまま、クリックしたパスを別タブで開けます。検索との併用がしやすいデフォルトです。 |
| **反対ペイン・新規タブ** | Aペインの検索結果→Bペインに、Bペインの検索結果→Aペインに新規タブで表示。1ペイン時は自動で2ペインに切替。 | 比較作業や上級者向け。検索結果と開いたフォルダを左右で同時に見比べたい場合に便利です。 |

#### 3-3-3. サイズフィルタの詳細

検索バーのスコープボタン右隣にある**天秤アイコン**をクリックすると、サイズフィルタのポップアップが開きます。ファイルサイズの範囲を指定して検索結果を絞り込めます。フォルダはサイズフィルタの対象外です。フィルタ適用中はアイコンが濃色に変わり、アイコン下にアンダーラインが表示されます。フィルタ状態はアプリ終了時に自動保存され、次回起動時に復元されます。通常検索・インデックス検索の両方で動作します。

##### 入力方式

Min（最小サイズ）と Max（最大サイズ）の 2 つのテキストボックスで範囲を指定します。ポップアップを開くと Min テキストボックスに自動フォーカスされます。

- **単位サフィックス**: 数値の末尾に `k`（KB）、`m`（MB）、`g`（GB）を付けて単位を指定します
- **未指定時のデフォルト単位**: サフィックスなしの場合は MB として解釈されます
- **小数値**: `2.5g`（= 2.5 GB）のように小数も使用できます
- **入力例**:

| 入力値 | 解釈 |
| :--- | :--- |
| `500k` | 500 KB |
| `10` | 10 MB（サフィックスなし = MB） |
| `2.5g` | 2.5 GB |
| `100m` | 100 MB |

##### リアルタイムプレビュー

テキストボックスに入力すると、右側に変換結果がリアルタイムで表示されます（例: `500k` → `→ 500 KB`）。入力値が不正な場合はテキストボックスの枠が赤色に変わります。Min が Max を超えている場合は「Min が Max を超えています」とエラーメッセージが表示されます。

##### クイックチップ

よく使うサイズ範囲をワンクリックで入力できるボタンが 4 つ用意されています。

| チップ | 設定される範囲 |
| :--- | :--- |
| **< 100 KB** | Max = 100 KB（Min は空） |
| **100 KB ~ 10 MB** | Min = 100 KB、Max = 10 MB |
| **10 MB ~ 1 GB** | Min = 10 MB、Max = 1 GB |
| **> 1 GB** | Min = 1 GB（Max は空） |

##### キーボード操作

- `Tab`: Min → Max テキストボックスへ移動
- `Enter`: ポップアップを閉じて検索バーにフォーカスを戻す
- `Escape`: ポップアップを閉じる

##### リセット

ポップアップ内右上の「リセット」ボタンをクリックすると、Min・Max の値がクリアされフィルタが解除されます。

#### 3-3-4. 日付フィルタの詳細

検索バーのサイズフィルタボタン右隣にある**カレンダーアイコン**をクリックすると、日付フィルタのポップアップが開きます。ファイルの更新日時の範囲を指定して検索結果を絞り込めます。フィルタ適用中はアイコンが濃色に変わり、アイコン下にアンダーラインが表示されます。フィルタ状態はアプリ終了時に自動保存され、次回起動時に復元されます。通常検索・インデックス検索の両方で動作します。

##### 入力方式

開始と終了の 2 つのテキストボックスで日付範囲を指定します。ポップアップを開くと開始テキストボックスに自動フォーカスされます。以下の柔軟な日付形式に対応しています。

| 入力形式 | 入力例 | 解釈 |
| :--- | :--- | :--- |
| `yyyyMMdd`（8桁） | `20260228` | 2026/02/28 |
| `MMdd`（4桁） | `0228` | 今年の 02/28 |
| `yyyy/M/d` | `2026/2/28` | 2026/02/28 |
| `yyyy-MM-dd` | `2026-02-28` | 2026/02/28 |
| `M/d` または `MM/dd` | `2/28` | 今年の 02/28 |

##### リアルタイムプレビュー

テキストボックスに入力すると、右側に変換結果がリアルタイムで表示されます（例: `20260228` → `→ 2026/02/28`）。入力値が不正な場合はテキストボックスの枠が赤色に変わります。開始日が終了日を超えている場合は「開始が終了を超えています」とエラーメッセージが表示されます。

##### プリセットチップ

業務でよく使う日付範囲をワンクリックで入力できるボタンが 9 種、3 行に配置されています。クリックすると開始・終了テキストボックスに即反映されます。

| 分類 | チップ |
| :--- | :--- |
| **短期** | 今日 / 昨日 / 直近 3 日 |
| **中期** | 直近 7 日 / 直近 14 日 / 直近 30 日 |
| **期間** | 今月 / 先月 / 今年 |

##### カレンダー連動

ポップアップ下部にはカレンダーが常時表示されています。テキスト入力とカレンダー操作は双方向に連動します。

- **テキスト → カレンダー**: テキストボックスに有効な日付を入力すると、カレンダー上の対応する日付範囲が自動的に選択状態になります
- **カレンダー → テキスト**: カレンダー上で日付をクリックまたはドラッグすると、テキストボックスに `yyyyMMdd` 形式で書き戻されます。フォーカス中のテキストボックス（開始または終了）に対して反映されます

##### キーボード操作

- `Tab`: 開始 → 終了テキストボックスへ移動
- `Enter`: ポップアップを閉じる
- `Escape`: ポップアップを閉じる

##### リセット

ポップアップ内右上の「リセット」ボタンをクリックすると、開始・終了の値がクリアされフィルタが解除されます。

#### 3-3-5. 検索プリセットの詳細

検索バーの**★アイコン**をクリックすると、検索プリセットのポップアップが開きます。ポップアップは**ビルトインプリセット**（上段）と**ユーザー作成プリセット**（下段）の2セクション構成で、罫線とラベルで視覚的に区別されています。ビルトインプリセットは「今日更新」「7日間」「30日間」「巨大ファイル」「画像」「Office文書」「実行ファイル」「小ファイル」の8種が同梱されており、削除できません。日付系ビルトインプリセットは適用時に日付を動的計算するため、常に最新の日付範囲で検索できます。ユーザー作成プリセットでは、現在の検索条件を名前付きで保存し、後からワンクリックで復元できます。プリセットはアプリ再起動後も復元されます。

##### 保存される条件

プリセットには以下の検索条件が保存されます。

| 項目 | 内容 |
| :--- | :--- |
| **モード** | 通常検索 or インデックス検索 |
| **キーワード** | 検索テキスト |
| **サイズ** | Min / Max のサイズフィルタ値 |
| **日付** | 開始 / 終了の日付フィルタ値 |
| **拡張子フィルタ** | フォルダ・Excel・Word・PPT・PDF・TXT・EXE・BAT・JSON・画像・その他の各種有効状態 |
| **ソート** | 並び替えの列（名前・更新日・サイズ・拡張子）と方向（昇順↑ / 降順↓） |
| **スコープ** | インデックス検索時の対象フォルダ選択状態 |

##### プリセットの保存

1. 検索条件を設定した状態で★アイコンをクリックしてポップアップを開く
2. ポップアップ下部の「現在の条件を保存」ボタンをクリック
3. プリセット名の入力ダイアログが表示される
4. 名前を入力して確定すると、保存される条件の一覧（モード・キーワード・サイズ・日付・フィルタ・スコープ・ソート）が確認ダイアログに表示される
5. 「OK」をクリックするとプリセットが保存され、トースト通知で保存完了が通知される

プリセットは通常検索用とインデックス検索用に自動分類されます。ポップアップには現在のモードに合致するプリセットのみが表示されます。

##### プリセットの適用

ポップアップのプリセット一覧から項目をクリックすると、保存されたすべての条件が一括で復元され、検索が自動実行されます。適用時は、サイズ・日付フィルタのアイコン状態（アンダーライン等）も即座に正しい状態に同期されます。

##### プリセットのプレビュー

プリセット一覧の項目にマウスをホバーすると、保存されている条件の内容がツールチップで確認できます。表示される項目はキーワード・サイズ・日付・フィルタ・スコープ・ソートで、値が設定されている項目のみ表示されます。サイズは `1 GB` 形式、日付は `yyyy/MM/dd` 形式に自動変換されて表示されます。

##### プリセットの削除

ユーザー作成プリセット一覧の項目にカーソルを合わせると、右端に × ボタンが表示されます。クリックすると確認なしで即座に削除され、トースト通知で削除完了が通知されます。ビルトインプリセットは削除できません。

##### 条件のリセット

ポップアップ下部左側の「条件をリセット」ボタンをクリックすると、現在の検索条件を一括で初期状態に戻せます。

| 項目 | リセット後の状態 |
| :--- | :--- |
| **キーワード** | 空欄にクリア |
| **サイズフィルタ** | Min / Max ともにクリア |
| **日付フィルタ** | 開始 / 終了ともにクリア |
| **ソート** | 更新日時の降順（デフォルト）に戻る |
| **拡張子フィルタ** | 全種類を有効に戻す |
| **検索モード** | 変更しない（維持される） |
| **スコープ** | 変更しない（維持される） |

リセット完了時はトースト通知で「全検索条件をリセットしました」と通知されます。

### 3-4. テーマ（配色カスタマイズ）

Control Deck（標準: `Ctrl+Shift+O`）→「テーマ」から、アプリ全体の配色テーマを切り替えられます。テーマを選択するだけで即座に UI 全体の色が反映され、再起動は不要です。選択中のテーマは次回起動時にも自動で復元されます。

#### テーマの選び方
テーマ一覧はタイル状のカード形式で表示されます。各カードには**テーマ名**（太字）、**著者**、および**代表4色のカラーチップ**（背景色・サイドバー色・アクセント色・テキスト色）が表示されており、配色を一目で比較しながら選択できます。選択中のテーマはアクセントカラーの枠線で強調されます。

#### テーマのカスタマイズ（GUI）
テーマカードを**右クリック** →「**テーマのカスタマイズ**」で、全色キーを個別に編集できるカスタマイズダイアログが開きます。無料版ではテーマカスタマイズの利用が1日5回までに制限されます。色キーは7つのセクション（基本 UI 要素・ファイル一覧・検索・アクセント/エラー・右クリックメニュー・ナビペイン/コントロールデッキ・その他）にタブ分けされています。各セクション内では色項目がサブグループ（背景・テキスト・ボタン等）ごとにグループヘッダー付きで分類されており、目的の色を素早く見つけられます。各行のカラースウォッチをクリックするとカラーピッカーが表示されます。変更した色は即座にライブプレビューされるため、保存前に仕上がりを確認できます。

変更は元テーマを書き換えず、`themes/_custom/{テーマ名}.json` に差分のみが保存されます。カスタマイズ済みテーマはカード上にパレットアイコンで識別でき、右クリック →「**デフォルトに戻す**」でカスタマイズを一括リセットできます。

#### テーマのエクスポート（上級者向け）
テーマ一覧の下にある「テーマをエクスポート」ボタンを押すと、現在適用中の配色が `themes/` フォルダに JSON ファイルとして書き出されます。このファイルをテキストエディタで編集し、カラーコード（`#RRGGBB` / `#AARRGGBB` / 色名）を変更すれば、オリジナルテーマを作成できます。`themes/` フォルダに `.json` ファイルを追加するだけで、テーマ一覧に自動的に表示されます。

JSON ファイルの先頭にある `Description`（説明）と `Author`（著者）を書き換えると、テーマ一覧のカードに反映されます。

#### テーマ一覧（50種類・5カテゴリ）

テーマは以下の5カテゴリに分類されています。

##### Standard（スタンダード）— 万人向け実用ワークスペース
| テーマ名 | 説明 |
| :--- | :--- |
| **standard** | Zenith Filer 標準の落ち着いたベージュ基調のテーマ |
| **SolarizedLight** | 長時間のテキストブラウジングをサポートする、計算された色彩設計 |
| **Nordic** | 氷河のような清潔感と静寂を併せ持つ、クリアな配色 |
| **PaperWhite** | 紙とインクのコントラストを再現した、文字情報の整理に特化したテーマ |
| **Daylight** | 自然光のもとで作業するような、明るく開放的なテーマ |
| **CloudGray** | 曇り空のようなニュートラルグレーで、目に優しい落ち着いたテーマ |
| **Snowfield** | 雪原のような白を基調とした、清涼感のあるテーマ |
| **Limestone** | 石灰岩のような温かみのあるグレーベージュのテーマ |
| **SilverBirch** | 白樺の樹皮をイメージした、柔らかいシルバーグレーのテーマ |
| **Graphite** | 鉛筆の芯のようなダークグレーを基調とした、引き締まったテーマ |

##### Lifestyle（ライフスタイル）— 色のある柔らかい生活感
| テーマ名 | 説明 |
| :--- | :--- |
| **Espresso** | 深煎りコーヒーとラテの配色。書斎で落ち着いて作業するためのテーマ |
| **MilkTeaPearl** | ローズベージュとパールの質感。温かみのある「大人可愛い」コージー・スタイル |
| **Sakura** | 和を感じさせる柔らかなピンクと白の、心落ち着くエレガントな配色 |
| **MintSorbet** | ミントグリーンとピュアホワイト。清潔感あふれる、軽やかでアクティブなスタイル |
| **LavenderMist** | 優雅なラベンダーとミスティグレーが織りなす、上品で落ち着いたフェミニン・スタイル |
| **Horizon** | 夕焼けの地平線をイメージした、暖色グラデーションのテーマ |
| **Apricot** | あんずの果実のような柔らかなオレンジとクリームの配色 |
| **SkyCanvas** | 晴れた空を描いたキャンバスのような、爽やかなブルー系テーマ |
| **Honeydew** | ハニーデューメロンのような淡いグリーンの、自然体なテーマ |
| **RoseDust** | バラの花びらが褪せたような、くすみピンクの上品なテーマ |

##### Professional（プロフェッショナル）— 集中のためのダークモード
| テーマ名 | 説明 |
| :--- | :--- |
| **midnight** | 暗所での集中力を高める、目に優しいダークモード |
| **SlateBlue** | 深夜のオフィスのような静寂と、高度な情報処理をイメージした濃紺 |
| **Monochrome** | 色によるバイアスを排除し、データの形だけに集中するための作業環境 |
| **blueprint** | 知的な設計図（青写真）をイメージした、製図用ブルーとホワイトの構成 |
| **Obsidian** | 黒曜石のような深い漆黒を基調とした、没入感のあるダークテーマ |
| **Pewter** | 錫のような渋みのあるメタリックグレーのダークテーマ |
| **IronSteel** | 鍛鉄のような硬質感のある、クールなダークグレーテーマ |
| **Basalt** | 玄武岩のような重厚なダークグレーを基調としたテーマ |
| **DarkAmber** | 琥珀色のアクセントが映える、温かみのあるダークテーマ |
| **Nightfall** | 日没後の薄暮をイメージした、深みのあるダークブルーテーマ |

##### Premium（プレミアム）— 主張のあるダーク
| テーマ名 | 説明 |
| :--- | :--- |
| **ImperialGold** | 漆黒の闇に黄金が煌めく、圧倒的な重厚感と気品を兼ね備えた至高のテーマ |
| **CrimsonPeak** | 濃いグレーと鮮烈なクリムゾンの対比。決断力を促すエグゼクティブ・ダーク |
| **Forest** | 深い緑と土の茶色を基調とした、目に優しく落ち着いた環境 |
| **Sapphire** | サファイアのような深い青が輝く、高貴なダークテーマ |
| **Amethyst** | アメジストの紫を基調とした、神秘的で上品なダークテーマ |
| **Copper** | 銅の温かみのあるメタリック感が映える、落ち着いたダークテーマ |
| **Jade** | 翡翠のような深みのある緑が美しい、東洋的なダークテーマ |
| **Burgundy** | ブルゴーニュワインのような深い赤紫の、重厚なダークテーマ |
| **RoseGold** | ローズゴールドの華やかさと暗い背景のコントラストが美しいテーマ |
| **Mahogany** | マホガニー材のような深い赤褐色の、クラシカルなダークテーマ |

##### RetroTech（レトロテック）— レトロ or サイバー
| テーマ名 | 説明 |
| :--- | :--- |
| **Terminal** | プログラミングやシステム管理の没入感を高める、ハイテク・ダーク |
| **CyberNeon** | 漆黒の闘にネオンが輝く、高エネルギーな近未来サイバーパンク・スタイル |
| **AmberConsole** | 80年代の端末を彷彿とさせる、漆黒に琥珀色が浮かぶレトロコンソール |
| **Retro95** | クラシックなOSのUIを現代の解釈で再構築したノスタルジックな配色 |
| **DeepSea** | 深く静かな青の中に、重要な情報が浮かび上がるサイバーな配色 |
| **PhosphorBlue** | 古いモニターの青色蛍光体を再現した、レトロなブルースクリーンテーマ |
| **Vaporwave** | ヴェイパーウェイヴ美学を取り入れた、ピンクとシアンのレトロフューチャー |
| **LaserRed** | レーザー光線のような鮮烈な赤が闇に走る、サイバーパンクテーマ |
| **Ultraviolet** | 紫外線のような深い紫とネオンの組み合わせ、幻想的なテーマ |
| **HoloGrid** | ホログラムのグリッドが浮かぶ、未来的なサイバースペーステーマ |

#### テーマスケジュール切替
時間帯を指定して昼用テーマと夜用テーマを自動切替できます。テーマ設定で「スケジュール」モードを選択し、切替時刻と各スロットのテーマを設定します。

#### テーマストア
コミュニティが作成したテーマを閲覧・ダウンロード・評価できるオンラインストアです。テーマ設定の「テーマストア」タブからアクセスします。自分が作成・カスタマイズしたテーマをアップロードして共有することも可能です（Pro 機能）。ダウンロード数順・評価順・新着順でソートでき、プレビューで適用前に確認できます。
- **テーマ作者名表示**: テーマカードに作者名（Design by ○○）が表示されます。
- **テーマストア版テーマ診断**: インストール済みテーマについてストア版との差分を確認できます。

#### デフォルトテーマの自動更新
ビルトインテーマはストアから最新版を自動ダウンロードして更新されます。

#### テーマカスタマイズの自動ナビゲーション
テーマカスタマイズ画面で色項目をクリックすると、その色が使用されているUI箇所が自動的にハイライト表示されます。すべての色キーに「→ 使用箇所」の説明が付いています。

#### AI 生成テーマ
AI にテーマを自動生成させることができます。テキストの指示や画像からテーマカラーを生成し、プレビューで確認後にインストールできます。

---

### 3-5. 生成AI連携機能

Zenith Filer は生成 AI を活用した8種類の支援機能を搭載しています。AI 機能は Control Deck → 生成AI で API プロバイダーとキーを設定してから利用します。

#### 3-5-0. AI プロバイダー設定
- **設定場所**: Control Deck → 生成AI
- **対応プロバイダー**: Claude / OpenAI / Azure OpenAI / Gemini / Ollama の5種類
- **API キー管理**: DPAPI で暗号化し、ローカルにのみ保存（外部送信なし）。「削除」で保存済みキーをクリア
- **テスト接続**: API キー区分内の「テスト接続」ボタンで API キーの有効性を検証。失敗時は HTTP ステータスコード別の具体的なガイド（キー無効、権限不足、レート制限など）を表示
- **モデル選択**: プロバイダごとにドロップダウンから選択（空の場合はデフォルトモデルを使用）
- **モデル検証**: モデル区分内の「モデル検証」ボタンで、選択したモデルが実際に使用可能かを検証。モデル名の誤りやアクセス権の問題を事前に確認可能
- **AI ON/OFF**: ステータスバーの Sparkles アイコンで AI 機能の有効/無効を切り替え。長押しで設定画面を直接開く
- **Ollama（ローカル LLM）プロバイダー**: API キー不要でローカル実行可能な Ollama プロバイダーに対応。ワンクリック自動インストール、推奨モデルのダウンロード管理、サーバーの自動起動・停止が可能です。Ollama タブでは、未インストール時にセットアップガイドが表示されます:
  1. **Ollama をインストール** — ワンクリックで自動ダウンロード・インストール
  2. **サーバーを起動** — インストール完了後にサーバーを起動
  3. **モデルをダウンロード** — 推奨モデルから選択してダウンロード

  各ステップは完了状態に応じて表示が切り替わります。サーバー起動後はガイドが消え、通常の設定画面（エンドポイント・モデル選択・推奨モデル一覧）が表示されます
- **AI 設定の6タブ構成**: AI 設定は概要・Ollama・Gemini・Azure OpenAI・OpenAI・Claude の6サブタブに分かれています。概要タブでは自動機能別トグル（グリーティング・リネーム提案・二つ名生成・バックストーリー生成・バックアップサマリー）を個別にオン/オフできます

#### 3-5-1. AI テーマ診断
- **操作**: Control Deck → テーマ → AI テーマ診断
- **しくみ**: 3〜5回の多肢選択式質問に回答すると、50テーマの中からベストマッチを推薦します
- 推薦理由を添えてテーマを提案し、そのまま適用可能
- Pro 機能（無料版 3回/日、テーマ生成と共有）

#### 3-5-2. AI テーマ生成
- **操作**: Control Deck → テーマ → AI テーマ生成
- **しくみ**: 自然言語（例:「宇宙をイメージした暗めのテーマ」）で指示すると、52色のオリジナルテーマを生成します
- ライブプレビューで即座に確認 → 微調整リクエスト → 保存
- 生成テーマは「AI Generated」カテゴリに追加され、カテゴリは色彩解析で自動分類されます
- WCAG コントラスト基準による自動検証が行われ、読みやすさが確保されます

#### 3-5-3. AI テーマ調整
- **操作**: テーマカードを右クリック →「AIで調整」
- **しくみ**: 自然言語で色味の変更を指示（例:「もう少し暗く」「アクセントを赤系に」）
- 即座にプレビューに反映されます
- カスタマイズダイアログは非モーダルで表示されるため、ダイアログを開いたままアプリのファイル一覧やナビペインを操作し、実際の画面で適用結果を確認してから保存できます
- WCAG コントラスト基準による自動検証が行われ、読みやすさが確保されます

#### 3-5-4. AI フォルダ分析
- **場所**: ナビペインの AIフォルダ分析ビュー（AIフォルダオーガナイザー）
- **分析**: 「分析」ボタンで、フォルダ内容を AI が3セクション構造（📊 現状分析 / ⚠️ 問題点 / 💡 改善提案）でレポート
- **アクション生成**: YES/NO で承認すると、具体的なアクション（フォルダ作成・移動・名前変更、最大30件）を生成
- **実行**: チェックボックスで個別選択 → 一括実行 → Undo（Ctrl+Z）対応
- チャット形式で追加指示が可能。チャット履歴の Markdown エクスポートにも対応
- Pro 機能（無料版 3回/日）

#### 3-5-5. AI マニュアル（ヘルプ Q&A）
- **場所**: ナビペインの AI マニュアルビュー、またはドキュメントビューアのダイアログから利用
- **しくみ**: 自然言語でアプリの使い方を質問すると、マニュアル内容を自動検索し的確に回答
- アプリの設定項目・キーバインド・テーマ一覧なども回答対象
- Markdown レンダリング対応、長い回答はバブル分割表示
- Pro 機能（無料版 3回/日）

#### 3-5-6. AI タブ管理
- **場所**: ナビペインの AI タブ管理ビュー
- **スコアリング**: 頻度30% + 滞在時間30% + 直近性40% でタブを評価し、ロック/クローズを提案
- **ワーキングセット検出**: A+B ペインの共起パターンからワーキングセットを自動検出
- **関連フォルダ提案**: 共起履歴から関連フォルダを提案
- タブヘッダーにインジケーター表示、「すべて適用」で一括操作
- Pro 機能（無料版 3回/日）

#### 3-5-7. AI 稼働統計分析
- **操作**: Control Deck → 統計 → 上部の「AI 稼働統計分析」セクション
- **しくみ**: 「分析」ボタンで7データソースをクロス分析し、最大7種のインサイトを提供
- **インサイト例**: お気に入り未登録の頻出フォルダ検出、隠れたワークフロー発見、検索最適化提案、Quick-flip タブ検出、未活用機能の提案、死んだお気に入り検出、操作スタイルの偏り分析、2画面活用度の評価
- 各インサイトは「発見 + 具体的アクション提案」のセットで表示
- Pro 機能（無料版 3回/日）

#### 3-5-8. AI ファイル名提案
- **場所**: ファイル/フォルダ名前変更ダイアログ内の「AI 提案」セクション
- **しくみ**: 親フォルダの構造、兄弟ファイルの命名規則、リネーム履歴を考慮し、3〜5件の候補を提案
- 回数制限なし（無料）

#### 3-5-9. AI お気に入り整理
- **場所**: ナビペインの AI お気に入り整理ビュー
- **しくみ**: お気に入りの構成を AI に分析・最適化させることができます。コンテナの分類提案、名前の改善、カスタムアイコンの自動付与に対応しています

#### 3-5-10. AI バックアップサマリー
- **場所**: 設定バックアップ時に自動実行
- **しくみ**: 設定バックアップ時に、変更内容の要約を AI が自然文で自動生成します。バックアップ一覧で各バージョンの変更概要を確認できます

#### 3-5-11. AI フォルダ生成
ペインヘッダーのフォルダ作成アイコン横の ✨ ボタンから、AIにフォルダ構成の生成を依頼できます。

- **プロンプト入力**: 作成したいフォルダの用途や目的を自然言語で記述します。できるだけ具体的に（対象期間、分類基準、命名規則の希望など）記載すると精度が上がります
- **重視ポイント**: 「適合度」「構造」「命名」「拡張性」の4つのチップボタンで、AIの提案方針を調整できます。何も選択しなければAIが自動判断します
- **自己評価**: AIが提案内容を4軸（適合度・構造・命名・拡張性）+総合で自己評価し、星評価とコメントをプレビュー上部に表示します
- **既存フォルダとの統合**: 既存フォルダがある場合、新規作成（🟢）・維持（🔵）・リネーム（🟡）の3種類のアクションを使い分けた提案を行います。リネームは命名規則の統一（番号プレフィックス付与等）のためにのみ提案されます
- **ファイルパターン分析**: フォルダ内の既存ファイル名とタイムスタンプをAIに送信し、年月・連番等のパターンを分析して網羅的なフォルダ構成を提案します
- **追加指示による再生成**: プレビュー表示後、「追加指示」ボタンから条件を追加して再生成できます（例: 「2024〜2026年分すべて作って」）
- **チェックボックスで個別除外**: 各フォルダのチェックを外すことで、実行対象から除外できます
- **Undo対応**: 生成したフォルダはUndoで一括削除できます

#### AI トークン統計
- AI 設定の概要タブで、月別・モデル別の使用トークン数と推定料金を確認できます

#### AI/Pro バッジについて
- AI 機能には紫色の **Sparkles バッジ**、Pro（ライセンス対象）機能にはオレンジ色の **Lock バッジ**が表示されます
- ナビペインアイコンバー・ビューヘッダー・設定画面に表示
- 設定 → 基本設定 →「バッジドットを表示する」でON/OFF切替

---

## 4. インデックス検索のしくみとチューニング

インデックス検索の概念、設定の詳細、技術的なしくみをまとめて説明します。操作や設定の選び方が一通りわかる初学者向けの内容と、実装やチューニングに興味がある上級者向けの技術説明の両方を含みます。

### 4-1. インデックス検索とは

**インデックス検索**とは、あらかじめフォルダ内のファイル情報をデータベース（インデックス）に蓄えておき、**大量のファイルからでも一瞬で検索結果を返す**ための機能です。

| 検索モード | 特徴 | 向いている用途 |
| :--- | :--- | :--- |
| **通常検索** | その場でフォルダを走査する。常に最新だが、フォルダが大きいと時間がかかる。 | 小～中規模のフォルダを開いた状態で、その場で検索したい場合。 |
| **インデックス検索** | 事前に作成したインデックスを使う。非常に高速だが、「いつ・どのくらい更新するか」のチューニングが必要。 | 登録済みの複数フォルダを横断して、横串で検索したい場合。 |

Zenith Filer のインデックス機能は **Lucene.NET**（Apache Lucene の .NET 移植版）をベースとした全文検索エンジンを使用しており、日本語ファイル名やパスについても高精度に検索できるようチューニングされています。

### 4-2. インデックスのライフサイクル

インデックスは、フォルダの登録から更新、再構築まで、次のような流れで管理されます。

- **登録**: 「インデックス検索設定」(標準: Ctrl+Shift+4) でフォルダを追加すると、そのフォルダが検索対象として登録されます。この時点ではまだインデックスは作成されません。
- **初回インデックス**: 「未インデックスを作成」ボタンを押すと、まだ一度もインデックスされていないフォルダだけを対象に、ディスク上のファイルをスキャンしてインデックスを作成します。
- **差分更新**: 設定した更新モードに応じて、FileSystemWatcher による即時検知、一定間隔での再スキャン、または手動実行時にのみインデックスを更新します。
- **フル再構築**: メニュー（⋯）から「フル再構築を実行…」を選択すると、全フォルダのインデックスを一度削除してから最初から作り直します。「フル再インデックス最短間隔」の設定以内に再実行した場合は、実際のフルスキャンはスキップされます。
- **一時停止・再開**: 「一時停止」で新規のインデックス作成を止め、「再開」で再開できます。既存のインデックスはそのまま利用され、検索は停止中も可能です。

**インデックスの状態**は、インデックス検索設定ビューで次のように表示されます。

| 状態 | 意味 |
| :--- | :--- |
| **未インデックス** | まだ一度もインデックスを作成していません。検索結果に含まれない可能性があります。 |
| **インデックス完了** | 現時点での内容に対するインデックス作成が完了しています。 |
| **差分更新中** | 変更検出や一定間隔のスキャンにより、最新状態へ追いつこうとしています。 |
| **一時停止中** | インデックス更新を一時停止しています。既存のインデックスはそのまま利用できます。 |

### 4-3. インデックス検索設定ビューの詳細

インデックス検索設定ビュー (標準: Ctrl+Shift+4) では、検索対象フォルダの登録・削除、状態確認、手動更新を行います。

- **フォルダの追加・削除**: 「フォルダを追加」でツリーからフォルダを選択、「現在のフォルダを追加」で A/B ペインで表示中のフォルダを追加できます。一覧で項目を選択して「削除」ボタンまたは右クリックメニューから削除できます。
- **右クリックメニュー**:
  - **インデックスを再作成** … そのフォルダのインデックスを**一度完全に削除**し、ディスク上のファイルを最初からスキャンし直します。**削除済みファイルを正しく反映したいとき**や、インデックスの構造が変わった（バージョンアップ時など）場合に使用します。
  - **インデックスを差分更新** … 既存のインデックスを維持したまま、**新規・更新分だけ**を反映します。日常的な「最近の変更を取り込みたい」ケースでは、こちらを優先してください。
- **インデックスの状態ブロック**: 現在の状態（インデックス完了／差分更新中／一時停止中）と総件数を表示します。検索対象フォルダが1件も登録されていない場合は総件数は0として表示されます。「未インデックスを作成」で未インデックスのフォルダだけを手動でインデックスし、「一時停止」「再開」でインデックス作成の制御ができます。メニュー（⋯）から「フル再構築を実行…」「インデックスの設定を開く」にアクセスできます。

### 4-4. アプリ設定「インデックス & 検索結果の鮮度」の詳細

Control Deck (標準: Ctrl+Shift+O) の「インデックス」カテゴリでは、インデックスの更新タイミング、負荷、鮮度に関するオプションを設定できます。

#### 4-4-1. インデックスの更新タイミングと負荷

| オプション | 向いているケース | 内部動作 |
| :--- | :--- | :--- |
| **変更を自動で取り込む** | 開発用フォルダやドキュメントなど、頻繁に更新されるディレクトリを常に最新で検索したい。 | FileSystemWatcher で変更を検出し、そのたびに対象フォルダのインデックスを**差分更新**します。大量更新が続くと更新回数が増えるため、負荷が気になる場合は「一定間隔」モードを検討してください。 |
| **一定間隔でまとめて更新する** | 夜間などにまとめて変更が入る共有フォルダ、頻繁に更新されるがリアルタイム性は不要な場合。 | 指定した間隔（1h / 2h / 4h / 1day）ごとに対象フォルダ全体をスキャンし、インデックスを最新化します。CPU・ディスク負荷は一時的に上がりますが、更新回数は抑えられます。 |
| **必要なときだけ更新する** | 極力バックグラウンド処理を抑えたい、共有サーバーに負荷をかけたくない。 | 自動更新は行わず、「未インデックスを作成」または「フル再構築…」を実行したときだけインデックスを更新します。 |

#### 4-4-2. パフォーマンスと負荷

- **省エネモードでインデックスを更新する** … バックグラウンド処理の粒度を調整し、一定件数ごとに待機時間を入れることで、CPU・ディスクの連続使用を避けます。
- **ネットワークドライブは軽めに処理する** … UNC やマップドドライブに対しては、ローカルディスクよりも長めの待機を入れてスキャンすることで、**ネットワーク帯域やサーバ負荷を抑えつつ**インデックスを更新します。

#### 4-4-3. 検索結果の鮮度

- **できるだけ最新の状態を保つ（鮮度優先）** … ON のとき、インデックス検索を実行すると、検索とは別スレッドで以下をバックグラウンド実行します。検索対象の各フォルダについて、インデックス作成済みなら**差分更新**、まだ一度もインデックスしていないフォルダは**「未インデックスを作成」と同等の処理**を自動実行します。目的は、検索結果を返す速度を維持したまま、その後徐々にインデックスを最新状態へ追いつかせることです。
- **インデックスが古い可能性があるときにメッセージを表示する** … ON のとき、次の条件を満たす場合のみ検索結果画面の上部に黄色の警告バーを表示します。（1）インデックス検索モードである、（2）上記の鮮度設定が ON である、（3）検索対象フォルダの中に**まだ一度もインデックスされていないフォルダ**が含まれている。OFF のときは、インデックスの状態にかかわらず警告バーは表示されません。表示された警告は右端の **× ボタンで一時的に非表示**にできます（その検索タブ内のみ有効）。

### 4-5. 検索実行時の動き（通常検索 vs インデックス検索）

**インデックス検索タブで Enter を押したときの流れ（概要）**:

1. まず、**既存のインデックスだけ**を使って高速にヒット候補を取得し、結果一覧に表示します。
2. （通常検索モードの場合のみ）必要に応じてフォルダのインデックスを作成し直し、結果が変わる場合は一覧を差し替えます。
3. 「鮮度優先」が ON の場合、フォアグラウンドの検索とは別に、バックグラウンドでインデックスの差分更新を実行し、次回以降の検索の精度と鮮度を高めます。

**通常検索**では、そのフォルダが未インデックスの場合、まずインデックスを作成してから検索を実行します。インデックス済みの場合は即座に検索結果を表示します。

### 4-6. 検索結果の鮮度警告バー

インデックス検索結果の上部に表示される黄色のバーは、**「検索結果が古い可能性がある」ことを示す注意喚起**です。

- 対象フォルダの一部がまだインデックスされていない場合のみ表示されます。
- インデックス自体は安全に利用できますが、「未インデックスを作成」などで一度インデックスを作成しておくと、今後の検索結果が安定します。
- メッセージが不要な場合は、バー右端の **× ボタンで閉じる**か、アプリ設定で「インデックスが古い可能性があるときにメッセージを表示する」を OFF にしてください。

### 4-7. トラブルシューティングとベストプラクティス

| 現象 | 考えられる原因 | 確認・対応 |
| :--- | :--- | :--- |
| 検索してもファイルがヒットしない | インデックスがまだ作成されていない、または対象フォルダが登録されていない。 | インデックス検索設定で該当フォルダを登録し、「未インデックスを作成」を実行してください。 |
| 結果が明らかに古い | 削除・移動したファイルがまだインデックスに残っている。 | 該当フォルダを右クリックし「インデックスを再作成」を実行してください。 |
| 警告バーが頻繁に出て気になる | 未インデックスのフォルダが登録されている。 | 警告を「×」で閉じるか、アプリ設定で「インデックスが古い可能性があるときにメッセージを表示する」を OFF にしてください。または「未インデックスを作成」で一度インデックスを作成しておくと、以後は警告が出なくなります。 |
| サーバーが重くなる／バックグラウンド負荷が心配 | 鮮度優先や自動更新が頻繁に動作している。 | 「必要なときだけ更新する」や「鮮度優先」を OFF にし、ネットワークドライブの場合は「ネットワークドライブは軽めに処理する」を ON にしてください。 |
| ショートカットキーが効かなくなる | ターミナルペインや特定のコントロールにフォーカスが残っている。 | アプリを再起動してください。別のペインやファイル一覧をクリックしてフォーカスを戻すことでも回復する場合があります。 |

### 4-8. 技術的なしくみ（開発者・上級者向け）

このセクションは技術的な詳細に興味がある方向けです。操作や設定の理解には不要です。

#### 4-8-1. 使用ライブラリとバージョン

| ライブラリ | バージョン | 用途 |
|---|---|---|
| Lucene.Net | 4.8.0-beta00017 | 全文検索エンジン本体 |
| Lucene.Net.Analysis.Kuromoji | 4.8.0-beta00017 | 日本語形態素解析（トークナイズ） |
| Lucene.Net.QueryParser | 4.8.0-beta00017 | クエリ文字列のパース |
| sqlite-net-pcl | 1.9.172 | SQLite 非同期データベースアクセス |
| SQLitePCLRaw.bundle_green | 2.1.11 | SQLite ネイティブバインディング |
| .NET 8 / WPF | — | アプリケーション基盤 |
| CommunityToolkit.Mvvm | 8.2.2 | MVVM フレームワーク |

#### 4-8-2. インデックスの物理構造

インデックスはアプリ実行フォルダ内の `index/` ディレクトリに保存されます。Lucene の `FSDirectory`（ファイルシステムベース）を使用し、`CREATE_OR_APPEND` モードで開きます。

**ディレクトリ内のファイル構成:**

| ファイル | 説明 |
|---|---|
| `segments_N` | Lucene セグメントマニフェスト（N はジェネレーション番号） |
| `_N.cfs` | Compound File Storage（セグメントデータ本体） |
| `write.lock` | Lucene ライターの排他ロックファイル |
| `indexed_roots.json` | インデックス済みルートの永続化データ |
| `last_full_rebuild.txt` | 最終フルリビルドの ISO8601 タイムスタンプ |
| `zenith.db` | SQLite データベース（履歴・検索履歴・利用統計等） |

**indexed_roots.json のフォーマット:**

```
{
  "C:\\Users\\example\\Documents": "2026-03-07T10:30:00|locked|5428"
}
```

値は `|` 区切りで、ISO8601 タイムスタンプ（最終インデックス日時）、`locked` フラグ（アーカイブロック時のみ）、ドキュメント数スナップショットの 3 要素で構成されます。

#### 4-8-3. ドキュメントスキーマ（Lucene フィールド定義）

各ファイル・フォルダは 1 つの Lucene ドキュメントとして登録されます。フィールド構成は以下の通りです。

| フィールド名 | 型 | トークン化 | 格納 | 用途 |
|---|---|---|---|---|
| `path` | StringField | No | Yes | ファイル/フォルダのフルパス。一意識別子として `UpdateDocument` の Term に使用。`PrefixQuery` によるパススコープ絞り込みにも利用 |
| `name` | TextField | Yes（JapaneseAnalyzer） | Yes | ファイル名/フォルダ名。メイン検索対象。Kuromoji 形態素解析でトークン化される |
| `name_raw` | StringField | No | Yes | ファイル名の小文字化コピー（トークン化なし）。`WildcardQuery` による部分一致検索のフォールバック用 |
| `size` | Int64Field | — | Yes | ファイルサイズ（バイト単位）。フォルダは 0。`NumericRangeQuery` によるサイズフィルタで使用 |
| `modified` | StringField | No | Yes | 最終更新日時。`DateTools.DateToString` で SECOND 精度の文字列に変換して格納。`TermRangeQuery` による日付フィルタで使用 |
| `is_dir` | Int32Field | — | Yes | ディレクトリフラグ（0=ファイル、1=フォルダ） |

#### 4-8-4. 日本語トークナイズ

検索の `name` フィールドには `JapaneseAnalyzer`（Kuromoji 形態素解析エンジン）を使用しています。これにより、日本語テキストを意味のある単語単位に分割し、「議事録」で「第3回議事録.docx」がヒットするといった自然な検索が可能です。

**トークナイズの流れ:**

1. `JapaneseAnalyzer` で `GetTokenStream("name", keyword)` を呼び出す
2. `ICharTermAttribute` を取得し、`IncrementToken()` でトークンを順次読み出す
3. 得られたトークン列から `PhraseQuery`（複数トークン時）または `TermQuery`（単一トークン時）を構築する

この処理は `QueryParser.Parse()` が `ParseException` を投げた場合のフォールバックとして `BuildQueryFromTokenized()` メソッドで実行されます。ワイルドカード文字（`*`、`?`）やブーリアン演算子を含むクエリがパースエラーになった場合でも、トークナイズベースの検索に自動的に切り替わります。

#### 4-8-5. クエリ構築パイプライン

検索キーワードからLuceneクエリが構築されるまでの全過程を解説します。

**ステップ 1: クエリパース**

`QueryParser`（フィールド: `name`、アナライザ: `JapaneseAnalyzer`）でキーワードをパースします。初期設定は以下の通りです。

- `DefaultOperator = Operator.AND`（すべてのキーワードを含む結果のみ）
- `AllowLeadingWildcard = true`（`*報告書` のような先頭ワイルドカードを許可）

**ステップ 2: パースエラー時のフォールバック**

`ParseException` が発生した場合、`BuildQueryFromTokenized()` でキーワードを形態素解析し、トークンベースのクエリを構築します（4-8-4 参照）。

**ステップ 3: ハイブリッドクエリの構築**

パース結果に加え、`name_raw` フィールドへの `WildcardQuery`（`*keyword*`）を SHOULD 条件で組み合わせます。

```
BooleanQuery {
  SHOULD: parsedQuery        ← name フィールド（形態素解析済み）
  SHOULD: WildcardQuery      ← name_raw フィールド（部分一致）
}
```

これにより、形態素解析で分割できない英数字やカタカナの部分一致も確実にヒットします。

**ステップ 4: パススコープの適用**

- **通常検索**: 現在のフォルダパスを `PrefixQuery("path", "C:\\current\\path\\")` として MUST 条件で追加。そのフォルダ配下のみに限定
- **インデックス検索**: `GetScopePathsForSearch()` で取得した複数のインデックスルートを、各ルートの `PrefixQuery` を SHOULD で結合した `BooleanQuery` として MUST 条件で追加

**ステップ 5: フィルタの適用（`ApplySearchFilter`）**

検索フィルタが設定されている場合、以下のクエリが MUST 条件で追加されます。

- **サイズフィルタ**: `NumericRangeQuery.NewInt64Range("size", min, max, true, true)`
- **日付フィルタ**: `TermRangeQuery("modified", minStr, maxStr, true, true)` — 日付は `DateTools.DateToString` で SECOND 精度文字列に変換

**ステップ 6: AND→OR フォールバック**

AND 検索で結果が 0 件かつキーワードにスペースが含まれる場合、`DefaultOperator` を `Operator.OR` に切り替えて自動的に再検索します。「会議 報告」で AND ヒットなしでも、「会議」または「報告」を含むファイルが表示されます。

**検索結果の上限とソート:**

- 通常検索: 最大 500 件
- 検証用（キーワードなし）: 最大 1,000 件
- CSV エクスポート: `maxResultsOverride` パラメータで上限を指定可能
- ソート順: 更新日時の降順（`SortField("modified", SortFieldType.STRING, true)`）

**具体例:**

| 入力 | 構築されるクエリ | 説明 |
|---|---|---|
| `議事録` | `name:議事録 OR name_raw:*議事録*` | 形態素解析 + 部分一致の OR |
| `会議 資料` | `(name:会議 AND name:資料) OR name_raw:*会議 資料*` | AND で検索、0 件なら OR に切り替え |
| `*.xlsx`（フォルダ C:\Work 内） | `name_raw:*.xlsx* AND path:C:\Work\*` | ワイルドカード + パススコープ |
| サイズ 1MB 以上 + 今月 | メインクエリ `AND size:[1048576 TO *] AND modified:[20260301… TO 20260307…]` | Lucene レベルでフィルタ適用 |

#### 4-8-6. 通常検索とインデックス検索の実装差異

| 項目 | 通常検索 | インデックス検索 |
|---|---|---|
| スコープ | 現在のフォルダ 1 つ（`PrefixQuery` で限定） | 登録済み全ルート（複数 `PrefixQuery` の OR 結合） |
| データソース | Lucene インデックス（同一エンジン） | Lucene インデックス（同一エンジン） |
| フィルタ方式 | サイズ・日付: Lucene クエリレベル | サイズ・日付: Lucene クエリレベル |
| 拡張子フィルタ | UI レベル（`ICollectionView` フィルタ、11 カテゴリ） | UI レベル（`ICollectionView` フィルタ、11 カテゴリ） |
| 最大件数 | 500 件 | 500 件 |

通常検索・インデックス検索ともに同じ Lucene エンジンを使用しますが、スコープの広さが異なります。通常検索は `rootPath = CurrentPath` で単一フォルダ配下に限定されるのに対し、インデックス検索は登録された全ルートを横断して検索します。

#### 4-8-7. インデクシングパイプライン

フォルダをインデックスに登録してから完了するまでの処理フローです。

1. **登録**: フォルダを `_pendingRoots` キューに追加
2. **排他制御**: `SemaphoreSlim(1,1)` で 1 タスクのみ実行。取得後 `_inProgressRoots` に移動
3. **Box Drive 暖気運転**: Box Drive パスの場合、`WarmUpBoxDirectoryAsync()` で全ディレクトリを事前に再帰列挙。スタブファイルの実体化を促し、本スキャン時の「アクセス不能」エラーを防止
4. **ツリー走査**: スタックベースの非再帰走査でフォルダツリーを深さ優先で探索
5. **列挙オプション**: `EnumerationOptions` で `IgnoreInaccessible = true`、`AttributesToSkip = FileAttributes.System | FileAttributes.Temporary` を指定
6. **ドキュメント登録**: `UpdateDocument`（upsert）でファイル/フォルダを Lucene ドキュメントとして追加・更新
7. **コミット**: 一定件数ごとに `IndexWriter.Commit()` を実行。コミット間隔はドライブ種別で異なる:
   - ローカルドライブ: 500 件ごと
   - ネットワークドライブ: 100 件ごと
   - Box Drive: 50 件ごと
8. **スロットリング**: バッチ処理後に待機時間を挿入し、CPU・ディスク・ネットワークへの負荷を制御:
   - ローカル: 15ms（省エネモード時 50ms）
   - ネットワーク: 50ms（省エネモード時 100ms）
   - Box Drive: 200ms（ネットワーク低優先モード時 +150ms、省エネモード時 +50ms、最大 400ms）
9. **スレッド優先度**: スキャン中は `Thread.CurrentThread.Priority = ThreadPriority.BelowNormal` に下げ、完了後に元に戻す
10. **完了処理**: `_indexedRoots` に追加し、`indexed_roots.json` に永続化。タイムスタンプとドキュメント数を記録

**除外対象（自動スキップ）:**

以下のフォルダ・ファイルはインデックス対象から自動的に除外されます。

- **フォルダ**: `.git`、`.svn`、`.hg`、`node_modules`、`bower_components`、`.vs`、`obj`、`bin`、`.nuget`、`__pycache__`、`.mypy_cache`、`venv`、`.venv`、`.next`、`.nuxt`、`.gradle`、`$Recycle.Bin`、`System Volume Information`、`Recovery`、`PerfLogs`、`$` で始まるフォルダ全般
- **ファイル**: `desktop.ini`、`Thumbs.db`、`.DS_Store`、`NTUSER.DAT`、`~$` で始まる Office 一時ファイル、拡張子 `.tmp`/`.temp`/`.bak`/`.swp`/`.swo`、拡張子なしのファイル

#### 4-8-8. 同時実行制御とスレッド管理

- **SemaphoreSlim(1, 1)**: インデックス作成タスクを同時 1 件に制限。ステータスバーの進捗表示の安定とサーバ負荷の軽減を実現
- **lock(_lockObj)**: `IndexWriter` やコレクション（`_indexedRoots`、`_inProgressRoots` 等）への同時アクセスを保護
- **Thread.Priority = BelowNormal**: スキャン中はスレッド優先度を下げ、UI の応答性を維持
- **CancellationToken の連鎖**: `CancellationTokenSource.CreateLinkedTokenSource` でグローバルキャンセルトークンとユーザー操作のキャンセルトークンを結合。どちらからでもキャンセル可能
- **CpuIdleService 連携**: Interval モードで `IdleOnlyExecution` が有効な場合、CPU 使用率が閾値（既定 20%）以下になるまでインデックス実行を待機
- **fire-and-forget の例外処理**: Auto モードの差分更新タスクには `ContinueWith(OnlyOnFaulted)` で例外を観測し、`UnobservedTaskException` を防止

#### 4-8-9. SQLite データベース（zenith.db）

アプリの各種履歴・統計データは `index/zenith.db`（SQLite）に保存されます。

| テーブル名 | 用途 | 主なカラム |
|---|---|---|
| `HistoryRecord` | フォルダ参照履歴 | `Path`(PK)、`LastAccessed`、`SourceType`（Local/Server/Box/SPO）、`AccessCount` |
| `SearchHistoryRecord` | 検索履歴 | `Key`(PK)、`Keyword`、`IsIndexSearch`、`IsGrepSearch`、`LastSearched`、`PresetName`、`MinSizeText`、`MaxSizeText`、`StartDateText`、`EndDateText` |
| `RenameHistory` | リネーム履歴 | `Name`、`LastUsed` |
| `CustomRenameButton` | カスタムリネームボタン定義 | ユーザー定義のリネームテンプレート |
| `UsageRecord` | ライセンス使用記録 | `Id`(PK, AutoIncrement)、`FeatureKey`(indexed)、`UsedAt`(ISO8601) |
| `ActionStat` | 利用統計 | `ActionKey`、`Count`、`LastUsedAt` |

`SearchHistoryRecord` の `Key` は `keyword + "\u0001" + (isIndexSearch ? "1" : "0")` の複合キーで、同じキーワードでも通常検索とインデックス検索を区別して保存します。V2 マイグレーションでフィルタ条件カラム（`PresetName`、サイズ・日付テキスト）が追加されています。

#### 4-8-10. FileSystemWatcher 連携（フォルダ監視）

各タブは `FileSystemWatcher` で現在のフォルダを監視し、外部からのファイル変更をリアルタイムに反映します。

**監視設定:**

- `NotifyFilter`: `FileName`、`DirectoryName`、`LastWrite`、`Size`
- `InternalBufferSize`: 64KB（65,536 バイト）
- 監視イベント: `Created`、`Deleted`、`Changed`、`Renamed`

**Auto モード時のインデックス連携:**

インデックスの更新モードが Auto の場合、ファイル変更イベントに応じてインデックスを即時更新します。

- `Created` / `Changed` → `AddFileToIndex(fullPath)`
- `Deleted` → `RemoveFileFromIndex(fullPath)`
- `Renamed` → `RemoveFileFromIndex(oldPath)` + `AddFileToIndex(newPath)`

Interval / Manual モードでは、定例スケジュールまたは手動トリガーのみでインデックスが更新されます。

**エラー時の自動再接続:**

監視エラー発生時は指数バックオフで自動再接続を試みます。

- 待機時間: 1 秒 → 2 秒 → 4 秒 → 8 秒 → … → 最大 30 秒
- 最大リトライ回数: 10 回
- 全リトライ失敗後は監視を停止し、タブがアクティブになった際にリフレッシュで補完

### 4-9. 設定バックアップ・リカバリ

Control Deck（標準: Ctrl+Shift+O）の「リカバリ」カテゴリから、設定のバックアップと復元を管理できます。

#### バックアップの作成

| タイミング | 動作 |
| :--- | :--- |
| **アプリ終了時（自動）** | アプリを閉じるたびに `backups/settings_yyyyMMdd_HHmmss.json` が自動生成されます |
| **「今すぐバックアップ」ボタン** | 現在の `settings.json` を即時バックアップします。要約は「手動バックアップ」となります |

#### 変更概要（差分サマリ）

各バックアップには、直前のバックアップとの差分を日本語で示す概要が `.desc` ファイルに保存されます（例：「Aペインホーム、検索挙動を更新」）。初回バックアップの場合は「初回バックアップ」と記録されます。

#### バックアップ一覧（インライン表示）

「リカバリ」カテゴリを開くと、設定画面内にバックアップの一覧が表示されます。

- **列構成**: 日時 / ロック状態（錠アイコン）/ 変更概要 / 編集ボタン / 復元ボタン
- **概要の編集**: 鉛筆ボタンをクリックすると変更概要をインラインで編集できます。Enter で確定、Escape でキャンセル。ロック中のバックアップは編集できません
- **復元**: 回転矢印ボタンをクリックすると確認ダイアログが表示され、選択した時点の設定に復元します。復元後は再起動を促すダイアログが表示され、「はい」を選ぶと自動的に再起動します
- **ロック / ロック解除**: 錠アイコンをクリックしてロック状態を切り替えます。ロックしたバックアップは 30 日自動削除ポリシーの対象外になります。重要な設定はロックして保護してください

#### 自動クリーンアップ

アプリ起動時に、作成から **30 日以上**経過したバックアップが自動削除されます。ただし `.lock` ファイルが存在するバックアップ（ロック済み）は削除されません。

#### エラー画面からのフィードバック報告
予期しないエラーが発生した際、エラーダイアログから直接フィードバックを送信できます。エラーの詳細情報が自動的に添付されます。

---

## 5. ワーキングセット

A/B ペイン全体の状態（タブのパス・ロック・表示モード・ソート、選択項目、スクロール位置）を「ワーキングセット」として保存し、一つの「プロジェクト」として瞬時に切り替えられる強力な機能です。ナビペインのブリーフケースアイコン（標準: Ctrl+Shift+5）で表示します。ビューの上部には、機能の目的を端的に示すガイドテキストが表示されます。

### 5-1. 保存
ナビペイン上部の「現在の状態を保存」ボタンをクリックし、名前を入力すると現在の A/B ペインの全状態が保存されます。データは `settings.json` に永続化され、アプリを終了・再起動しても一覧はすべて保持されます。

### 5-2. プレビューと確定（ロールバック機能）
一覧から保存済みのセットをクリックすると、即座に A/B ペインの内容がそのセットの状態に切り替わります。この機能の最大の特徴は、**「確定させるまで元の状態を汚さない」**点にあります。

- **プレビュー状態**: セットをクリックすると一時的な「プレビュー」状態となり、画面下部にブランドカラーであるチャコールブラック（#545B64）の専用フッターバーが表示されます。
- **適用**: フッターの「✔ このセットを適用する」ボタンを押すと、その状態を現在の作業状態として確定します。
- **キャンセル（ロールバック）**: フッターの「✗ 元の状態に戻す」ボタンを押すか、ナビペインで他のビュー（お気に入り等）に切り替えると、**ワーキングセットを読み込む直前の状態（すべてのタブ、選択位置、スクロール状況）に自動的に復元**されます。これにより、「プロジェクト A の作業中に、プロジェクト B の資料をちょっと確認してすぐに戻る」といったコンテキストスイッチが極めてスムーズに行えます。

### 5-3. 管理
- **名前の変更**: セットを右クリックして「名前の変更」を選択すると、セット名を編集できます。
- **削除**: セットを右クリックして「削除」を選択、または項目を選択して削除ボタン（ゴミ箱アイコン）を押すと、そのセットを削除します。

### 5-4. クイックジャンプ
`Ctrl+P` でクイックジャンプダイアログを開きます。お気に入り・よく使うフォルダ・最近のフォルダを横断的にインクリメンタル検索し、選択した項目にワンクリックで移動できます。

- **検索**: テキストを入力すると、名前・パス・説明を対象にリアルタイムで候補が絞り込まれます。名前の前方一致が最も高くスコアリングされます。
- **ソースバッジ**: 各候補の右側に「お気に入り」「よく使う」「最近」のソースが表示されます。
- **キーボード操作**: ↑↓ で候補を移動、Enter で決定、Escape で閉じます。
- **新規タブ／上書き切替**: スライド式トグルで、選択したフォルダを新規タブで開くか現在のタブを上書きするかを切り替えられます。デフォルトは新規タブです。
- **枠外クリック**: ダイアログ外をクリックすると自動的に閉じます。
- ダイアログはマウスカーソル付近に表示されます。

---

## 6. キーボードとマウスの連携

- **ペイン・ナビのフォーカスはクリックで切り替え**: **ナビペイン**（お気に入り・ツリー・参照履歴）や **Aペイン／Bペイン** にキーボードフォーカスを移すには、該当領域を**マウスでクリック**するか、キーボードで `Tab` や `←`／`→` を使って切り替えます。ホバー（マウスを載せるだけ）ではフォーカスは移動せず、意図したペインに対して確実に操作できます。
- **一覧へのフォーカス**: Aペイン・Bペインにフォーカスがあるがファイル一覧にフォーカスがないとき（起動直後やタブ・ツールバーをクリックした直後など）、矢印キー・Enter・Delete・F2 などのキーを押すと、一覧にフォーカスが移り、押したキーがそのまま有効になります。パス入力欄や検索ボックスにフォーカスがあるときは、キー入力は従来どおりそれらに使われます。
- **キーボード操作中のマウス干渉排除**: 矢印キー・Enterキー・ショートカットなどでキーボード操作を開始すると、自動的に「キーボード操作モード」に入り、マウスカーソルが非表示になります。この間は、マウスカーソルがリストやナビペインの上にあっても、ホバーだけで選択やフォーカスが移動することはありません（誤ってマウスの下の項目にフォーカスが飛ぶことを防ぎます）。
- **マウス操作への自動復帰**: キーボード操作モード中にマウスを物理的に動かすと、前回位置からおよそ3ピクセル以上移動したタイミングでマウスカーソルが自動的に再表示され、通常どおりマウス操作に復帰します。わずかな振動では復帰しないようデッドゾーンを設けています。名前の変更ダイアログなどモーダルダイアログを開いた場合も、ウィンドウのフォーカスが移るタイミングでカーソルが自動復元され、ダイアログ内でマウス操作が可能です。

---

## 7. キーボードショートカット一覧

> 以下は標準（デフォルト）のキー割り当てです。**設定 → ショートカットキー** から変更できます。

| キー | 動作 |
| :--- | :--- |
| `Tab` | AペインとBペインのフォーカスを切り替え |
| `←` | Bペインにフォーカスがあるとき、Aペインへ切り替え |
| `→` | Aペインにフォーカスがあるとき、Bペインへ切り替え（2ペイン表示時） |
| `Ctrl + Tab` | 次のタブへ切り替え |
| `Ctrl + T` | 新しいタブを開く |
| `Ctrl + W` | 現在のタブを閉じる |
| `Space` | **Quick Preview**: 選択中のファイルの中身をオーバーレイ表示（テキスト系・画像・PDF・HTML・Excel/CSV・Office 文書に対応。再度 Space または Esc で閉じる） |
| `←` / `→` (プレビュー中) | Quick Preview 表示中に前後のファイルへ切り替え（ディレクトリはスキップ、リスト端で停止） |
| `Enter` | フォルダを開く / ファイルを実行 / フォルダショートカット（.lnk）はリンク先フォルダを新しいタブで開く |
| `Backspace` | 上の階層へ移動 |
| `Alt + ←` | 前のフォルダに戻る |
| `Alt + →` | 次のフォルダに進む |
| `F2` | 名前の変更 |
| `Ctrl + Shift + N` | 新規フォルダを作成（作成後にフォーカスし、名前の変更可能な状態になる） |
| `F5` | フォルダ内容の更新 |
| `Ctrl + C` | コピー |
| `Ctrl + X` | 切り取り |
| `Ctrl + V` | 貼り付け |
| `Ctrl + Z` | 元に戻す（リネーム、移動、コピー、新規作成など） |
| `Delete` | 削除（ごみ箱へ） |
| `Ctrl + Shift + E` | アクティブなファイルペインにフォーカスを強制移動 |
| `Ctrl + Shift + 1` | サイドバーを「お気に入り」に切り替え |
| `Ctrl + Shift + 2` | サイドバーを「ツリービュー」に切り替え |
| `Ctrl + Shift + 3` | サイドバーを「参照履歴」に切り替え |
| `Ctrl + Shift + 4` | サイドバーを「インデックス検索設定」に切り替え |
| `Ctrl + Shift + 5` | サイドバーを「ワーキングセット」に切り替え |
| `Esc` (検索バー内) | **多段リセット**: 1回目はキーワード消去、2回目はサイズ・日付・スコープのフィルタも全消去して検索解除 |
| `Ctrl + F` | アクティブなペインの検索バーにフォーカス（インデックス検索モード中は通常モードに戻る） |
| `Ctrl + Shift + F` | 検索バーにフォーカスし、インデックス検索モードに入る |
| `Ctrl + Shift + G` | ファイル内容検索（grep）モードに切り替え |
| `Ctrl + Shift + Q` | 1画面モード（Aペインのみ）に切り替え |
| `Ctrl + Shift + W` | 2画面モード（Aペイン＋Bペイン）に切り替え |
| `` Ctrl + Shift + ` `` | 1画面モード⇔2画面モードをトグル切替 |
| `Ctrl + Shift + 6` | サイドバーを「最近開いたフォルダ」に切り替え |
| `Ctrl + Shift + 7` | サイドバーを「最近開いたファイル」に切り替え |
| `Ctrl + Shift + 8` | サイドバーを「プロパティ」に切り替え |
| `Ctrl + Shift + D` | タブを複製 |
| `Ctrl + L` | アドレスバーにフォーカス |
| `Ctrl + Shift + A` | タブ一覧を表示 |
| `Ctrl + Shift + Tab` | 前のタブへ切り替え |
| `Ctrl + P` | クイックジャンプ |
| `Ctrl + 1` | 1画面モード |
| `Ctrl + 2` | 左右2画面モード |
| `Ctrl + Shift + 2` | 上下2画面モード |
| `Ctrl + A` | 全選択 |
| `A`〜`Z` / `0`〜`9` | **インクリメンタルサーチ**: 詳細ビューで押したキーで始まるファイル/フォルダへ選択を移動。同じキーを連打すると同頭文字の次の候補へサイクル。500ms 以内に異なるキーを続けると先頭文字列で絞り込みジャンプ（Ctrl / Alt との組み合わせは除く） |
| `Ctrl + Alt + F4` | 常駐モードで完全終了 |
| `Esc` | パンくずのドロップダウンメニューを閉じる／更新履歴・マニュアルなどのサブウィンドウを閉じる |

---

## 8. チャレンジ・実績システム

Zenith Filer の使い込み度を可視化するゲーミフィケーション機能です。設定の「チャレンジ」ページから確認できます。

### 8-1. チャレンジの仕組み
日常のファイル操作が自動的にトラッキングされ、15の区分ごとに実績が記録されます。各区分には10段階の Tier が設定されており、条件を達成すると次の Tier に進みます（合計150チャレンジ）。

**チャレンジ15区分**: ファイル操作、検索、テーマ変更、AI活用、お気に入り、タブ操作、設定カスタマイズ、ワーキングセット、テキスト比較、ターミナル、インデックス検索、ドラッグ＆ドロップ、キーボード操作、プレビュー、時間利用

### 8-2. レベルとXP
チャレンジの達成で経験値（XP）を獲得し、レベルが上がります。現在のレベルはタイトルバーのレベルバナーに表示されます。レベルアップ時にはバナーがグロー演出でパルスします。

### 8-3. 二つ名
チャレンジを達成すると AI が「二つ名」（称号）を生成します。獲得した二つ名はタイトルバーの二つ名バナーに表示されます。各二つ名には AI が生成したバックストーリーが付与されており、バナーをホバーすると読むことができます。起動時にはウェルカムグリーティングとして二つ名が表示されます。

**二つ名履歴**: 実績履歴ダイアログに「二つ名履歴」タブが追加されており、過去に生成された二つ名を取得日・合成元バッジ・バックストーリー付きで一覧表示できます（最大200件保存）。タイトルバーの二つ名バナーをクリックすると、二つ名履歴を直接開けます。

### 8-4. チャレンジカード
各チャレンジは専用のカードUIで表示されます。進捗バー、現在の Tier、達成条件、バックストーリーが確認できます。各チャレンジには AI が生成した物語風のバックストーリーが付与されています（140件×10言語対応）。カードをクリックすると全文を読めます。最高 Tier（Tier 10）に到達したチャレンジのアイコンには王冠が付き、緩やかに明滅するパルスアニメーションが表示されます。

### 8-5. 機能推薦システム（Just-in-time Tips）
使用パターンを分析し、まだ試していない機能をタイミングよく推薦するシステムです。プロパティペインに定期的にヒントが表示されます。

---

## 9. インストール・ビルド構成

ビルド後（または配布パッケージ）のフォルダ内には、以下のファイルとフォルダが含まれます。

### 9-1. フォルダ構成
- **apps/**: 外部連携プログラムや関連ツールが格納されるフォルダです。EULA（ソフトウェア使用許諾契約書）の Markdown ファイルもここに配置されます。
- **backups/**: 設定ファイル (`settings.json`) の自動バックアップが保存されます。アプリ終了時に自動生成され、30日経過で自動削除されます（ロック済みバックアップは除く）。
- **index/**: 検索インデックス（Lucene）と履歴データベース（SQLite）が格納されます。このフォルダと `settings.json` をバックアップすることで、すべての設定とデータを移行できます。
- **logs/**: アプリケーションの動作ログおよびエラー発生時の詳細情報（例外型・メッセージ・スタックトレース・HResult）が保存されます。起動時にはアプリバージョン・OS・.NET ランタイム・アーキテクチャ・PID の診断情報が自動記録されます。不具合報告の際などに参照します。
- **runtimes/**: OSやプラットフォーム固有のシステムライブラリ（DLL）が格納されています。
- **lang/**: 表示言語の JSON ファイル（10言語）が格納されます。日本語 (ja) 以外は AI による機械翻訳です。カスタム言語ファイルを追加する場合もこのフォルダに `.json` ファイルを配置すると自動検出されます。
- **themes/**: テーマの JSON ファイル（50種類）が格納されます。カスタムテーマを追加する場合もこのフォルダに `.json` ファイルを配置します。
- **scripts/**: 配布パッケージの作成スクリプト (`pack.ps1`) やコード署名スクリプト (`sign.ps1`) が格納されます。開発者・配布担当者向けです。

### 9-2. 主なファイル
- **ZenithFiler.exe**: アプリケーションの実行ファイルです。
- **ZenithDocViewer.exe**: マニュアルと更新履歴を閲覧するための単体ドキュメントビューアです。本体を起動せずにドキュメントのみを確認したいときに使用します。
- **settings.json**: お気に入り、タブの状態、ウィンドウ配置、キーバインド、検索プリセットなどのユーザー設定が保存されます。
- **.zenith_license**: ライセンスキーファイルです（ライセンス適用時に生成）。
- **ZenithFiler.pdb**: デバッグ情報ファイルです。実行には必須ではありません。
- **依存ライブラリ (.dll)**: アプリケーションの動作に必要な部品群です。
  - `e_sqlite3.dll`: 履歴や検索インデックスの管理に使用するデータベースエンジンです。
  - `WebView2Loader.dll`: マニュアルや更新履歴の表示に使用するブラウザコンポーネントです。
  - `wpfgfx_cor3.dll` / `PresentationNative_cor3.dll` など: WPF の描画エンジンに関連するライブラリです。

### 9-3. 自動アップデート

Zenith Filer は GitHub Releases を利用した自動アップデート機能を搭載しています。

- **自動チェック**: アプリ起動 30 秒後に初回チェック、以後 4 時間間隔でバックグラウンドチェックを実行します（Control Deck → このアプリについて → 「自動アップデートを有効にする」で ON/OFF 可能）。
- **手動チェック**: Control Deck → このアプリについて → 「アップデートを確認」ボタンで即座に確認できます。
- **ダウンロードと適用**: 新バージョンが検出されると自動的に ZIP をダウンロード・展開します。ダウンロード中はグロウバーで進捗を表示します。ダウンロード完了後、「再起動して適用」ボタンで即座に適用するか、次回アプリ終了時に自動適用されます。
- **スキップ**: 特定のバージョンをスキップすることも可能です。スキップしたバージョンは以後の自動チェックで通知されません。
- **適用のしくみ**: バッチスクリプトにより、アプリ終了後にファイルを上書きコピーして再起動します。更新適用後の起動時には「アップデートが完了しました」とトースト通知が表示されます。
- **アップデートタイプ選択**: 自動アップデート時に「差分パッチ」（最小サイズ）、「パッチ」、「フル」（完全パッケージ）の3種類からダウンロードタイプを選択できます。

### 9-4. EULA（ソフトウェア使用許諾契約書）

初回起動時はウェルカムウィンドウ内の EULA ページで同意を求められます。チェックボックスを ON にすると「次へ」ボタンが有効になり、準備完了ページへ進めます。既存ユーザーで未同意の場合は従来通り個別の EULA ダイアログが表示されます。同意済みバージョンは `settings.json` に記録され、2回目以降の起動では表示されません。

---

*Zenith Filer — 効率と美しさを両立したファイル管理を。*
