MinimaRun 一般ユーザー向けガイド
==============================

v0.7.2 の変更:
- フッター表記を `FTF Flow` に統一しました。
- 旧v0.6.1および2026年5月のローカルブリッジは、正規の構成と完全一致する5ファイルのハッシュを確認してから安全に更新できます。Windowsのフォルダー・ファイルは、ローカルブリッジ利用可能時だけ開きます。

v0.7.0 の変更（履歴）:
- 設定形式は `schemaVersion: 2` です。旧Web形式、schema 1、配列形式は自動移行し、既存データを削除しないまま互換コピーを保持します。
- JSONとCSVは取込前にプレビューを表示します。タブ名変更、追加、更新、削除、除外数を確認でき、キャンセルした場合は現在の設定を変更しません。
- 設定はIndexedDBへ保存し、変更前の自動バックアップを最大10世代保持します。選択した履歴は確認後に復元でき、復元前の状態もバックアップされます。
- `http://` / `https://` URLはブラウザーで直接開きます。Windows絶対パスと通常のUNCパスはローカルブリッジが利用できる場合だけ開き、未導入時は案内を表示します。カスタムURLスキームへフォールバックしません。
- Helpは日本語・英語の7項目をサイトと同一オリジンで表示します。サイト自体を読み込めない状況ではHelpも利用できず、オフライン専用の説明書ではありません。
- 診断には登録名、URL、パスを含めません。WebホストやCDNには一般的なアクセスログが残る場合があります。
- ランチャー幅は180〜420px、設定画面は300 x 900を基準にしています。ブラウザーの制約により外枠を完全固定できない場合があります。

v0.6.1 の変更:
- ライトテーマの背景色はそのままに、設定のまとまり、入力欄、境界線を見分けやすくしました。
- 成功、警告、エラーのお知らせを、左端の色と薄い背景色で見分けられるようにしました。
- 紫の枠は、キーボードで現在選んでいる位置だけに表示します。

v0.6.0 の変更:
- JSON は、テーマ、ウィンドウ幅、URL テンプレート、メタデータを含む完全な設定バックアップです。
- CSV は、3つのタブ名とボタン一覧を表計算ソフトで移すために使います。「Site URL」列には Web サイト URL、フォルダ、ファイルパスを入力できます。
- CSV 読込で置き換わるのはタブ名と項目だけです。テーマ、ウィンドウ幅、URL テンプレート、メタデータは変わりません。確認後に読み込み、最後に「保存して戻る」を押してください。
- キャンセルした場合や CSV に不正な行がある場合は変更しません。各タブは最大15件です。
- CSV は Excel 互換の UTF-8 BOM 付きで書き出され、数式として解釈される可能性がある値も保護されます。

v0.5.11 の変更:
- ランチャーは開いた直後から矢印キーでタブとボタンを選べます。
- 設定画面の編集タブは Left / Right / Home / End で選択できます。Up / Down は引き続き画面スクロールです。
- 入力欄以外では Backspace で前のフォーカスへ戻れます。入力欄では従来どおり文字を削除します。
- Tab / Shift+Tab と Enter の標準操作はそのままです。

v0.5.10 の変更:
- 選択中のタブ、表示言語、テーマが緑の枠と太字で分かりやすくなりました。紫の枠はキーボードで現在選んでいる位置です。
- メイン画面では、左右キーでタブ、上下キーでボタンを選び、Enterで開けます。
- Homeキーで最初、Endキーで最後のボタンへ移動します。

v0.5.9 の変更:
- 設定画面上部に、フォルダ・ファイルを開ける状態を短く表示します。開けない場合は「対処方法」と「もう一度確認」を選べます。
- 詳細設定の開閉方向と、現在編集中のタブが分かりやすくなりました。

v0.5.8 の変更:
- ランチャーボタンと「詳細設定・バックアップ」の紫色選択枠が切れずに表示されるようになりました。

v0.5.7 の変更:
- 設定画面の登録済み項目は、編集する1件だけを開く短い一覧になりました。
- 標準設定へ戻す前に確認が表示されます。
- ライトテーマの文字と選択枠を見やすくしました。

配布者向け:
1. `config\distribution.json` を開きます
2. `hostedUrl` に公開済みの `/?windowed=1` URL を入れます
3. 次のどちらかを実行します
   `Prepare-MinimaRun-End-User-Package.cmd`
   `powershell -ExecutionPolicy Bypass -File scripts\prepare-end-user-package.ps1`
4. 出力された配布フォルダ、または zip を利用者へ渡します

ローカルファイル・フォルダー・NAS 用 Windows 連携ブリッジを使う利用者向け:
1. ZIP を展開してから `Install-MinimaRun-Web.cmd` をダブルクリックします
2. Windows の確認が出たら許可します
3. 初期設定画面は、ライトテーマ / タブ1〜3 / ボタン未登録の状態です
4. インストール完了後は、デスクトップに作成された `MinimaRun` ショートカットで起動します
5. 展開したフォルダから直接開きたい場合だけ `Launch-MinimaRun-Web.cmd` を使います
6. ボタンを追加・変更したいときは、右上の歯車から設定を開き `保存して戻る` を押します
7. バージョンアップするときは、新しい ZIP を展開して `Install-MinimaRun-Web.cmd` をもう一度実行します
8. 削除したいときは `Uninstall-MinimaRun-Web.cmd` を実行します

補足:
- Microsoft Edge から初回の確認が表示されたら、ローカルネットワークアクセスを許可してください
- フォルダやNASパスのボタンはローカルブリッジが利用できる場合だけ開きます。カスタムURLスキームへフォールバックしません
- `保存して戻る` の変更は、そのPCの同じ Windows ユーザー / 同じブラウザープロファイルに保存されます
- 再インストールでショートカットや橋渡しは更新されますが、通常は保存済みの設定を消しません
- ブラウザの `アプリとしてインストール` や `このサイトをインストール` は使わず、同梱のインストーラーを使ってください
