# Portability: WINDOWS
# Last validated: 2026-05-17
# Next review: 2027-05-17
# 最終検証日: 2026-05-17
# 次のレビュー: 2027-05-17

INSTALLER.EXE / START.EXE 評価
-------------------------------------

ステータス: 評価完了 (2026-05-17)
推奨: はい、便利ですが、安定版リリース後のフェーズ 2 機能として使用します。


PRO (利点)
--------------

1。ユーザーフレンドリーさ
   - ターミナル知識の代わりにダブルクリック
   - 手動の Python/npm セットアップは必要ありません
   - スタートメニューの統合（Windows標準）
   - Windows の「プログラムの削除」によるアンインストール

2.携帯性
   - 埋め込み Python: システム依存性なし
   - 付属のホイール: 取り付け中にインターネットは必要ありません
   - 確定的な環境: すべてのシステムで同じバージョン

3。プロフェッショナルとしての印象
   - .exe ダウンロード付きの GitHub リリース (Windows ツールの標準)
   - プログレスバー付きの自己解凍アーカイブ
   - アイコン、ブランディング、ライセンス表示可能

4.エラーの回避
   - PATH の問題や「Python が見つかりません」の問題は発生しません
   - Virtualenv の自動分離
   - プリフライトチェック内蔵 (メモリ、権利、ポート)


CONTRA (欠点)
------------------

1。努力
   - 約 40 ～ 60 時間の開発 + テスト
   - bach.bat の 20 以上の起動モードはインストーラー パスで動作する必要があります
   - すべてのアップデートには新しい .exe ビルド (または自動アップデータ)

2 が必要です。サイズ
   - 組み込み Python + Deps: ~200 ～ 400 MB インストーラー
   - Python が埋め込まれていない場合: ~50 MB、ただし Python 要件

3。複雑さ
   - PyInstaller/Nuitka/cx_Freeze には Windows の特性があります
   - 不明な .exe ファイルに対するウイルス対策の誤検知
   - 信頼にはコード署名証明書が必要です (~100 ～ 400 ユーロ/年)

4.メンテナンス
   - すべての依存関係の更新 → 新しいビルド
   - Windows Defender SmartScreen は署名なしでブロックします
   - OneDrive シナリオ (マルチシステム) は、.exe-Install

5 とは一致しません。バッハ特有の問題
   - OneDrive 同期: .exe はローカルにインストールされ、BACH は OneDrive に存在します
   - MCP サーバーには npm が必要です (.exe にはバンドルできません)
   - クロード コード フックには claude-cli (外部) が必要です
   - 柱 2/3 (LLM タスク、ユーザー構成) は自動化できません


アーキテクチャの推奨事項
----------------------

フェーズ 1 (現在): 「スマート バッチ ランチャー」 — ラッパーとして start.exe
  - bach.bat のみを呼び出す PyInstaller 単一ファイル .exe
  - Python の可用性をチェックし、存在しない場合はエラー メッセージを表示します
  - オプションでスタート メニュー/タスクバーに固定します
  - 作業時間: ～ 4 時間
  - 利点: すぐに実装でき、メンテナンスの手間が最小限

フェーズ 2 (リリース後): 完全なインストーラー
  - Inno Setup または NSIS (実績のある Windows インストーラー フレームワーク)
  - 付属のホイールからの組み込み Python + pip インストール
  - DB の完全な初期化
  - スタートメニュー + デスクトップショートカット
  - 作業時間: ~40 時間 (すべてのモードのテストを含む)

フェーズ 3 (オプション): 自動アップデーター
  - GitHub がバージョンチェック用の API をリリース
  - デルタ更新 (変更されたファイルのみ)
  - 作業時間: ～ 20 時間


技術オプション
-------------------

A) PyInstaller (start.exe に推奨)
   - 1 ファイル モード (--onefile)
   - 十分に文書化された広範なコミュニティ
   - 欠点: 起動が遅い (一時フォルダーを解凍する)

B) Inno Setup (installer.exe を推奨)
   - Windows インストーラーの事実上の標準
   - 複雑なロジックのための Pascal スクリプト
   - 圧縮、アンインストール、レジストリ
   - 無料、オープンソース

C) Nuitka (代替)
   - Python を C → 本物の .exe にコンパイルします
   - PyInstallerよりも起動が速い
   - 欠点: ビルドがより複雑になり、コンパイル時間が長くなります

D) cx_Freeze (代替)
   - PyInstaller に似ていますが、単一ファイルではなくフォルダーです
   - PyInstallerよりも起動が速い
   - 欠点: シングル ファイル モードがありません


次のステップ
----------------

1。 [ ] 決定: フェーズ 1 をすぐに実行するか、それともリリース後に待つか?
2. [ ] フェーズ 1 の場合: start.exe の PyInstaller 仕様を作成します。
3. [ ] フェーズ 2 の場合: 埋め込み Python を使用して Inno セットアップ スクリプトを準備する
4. [ ] コード署名証明書を取得します (オプション、SmartScreen に対して)


関連項目
----------
  start/bach.bat ブート メニュー (現在のランチャー)
  docs/help/install.txt インストール手順
  setup.py Python インストーラー (柱 1)
  ENT-45_INSTALLER_3D_MODELL.md コンセプト ドキュメント (.dev/ 内)
