feat(python/launcher): host 起動修正 + prefix/proton 設定

[Geson-anko]

背景

resoio launch はコンテナでは動くが、ホストの $HOME 配下 Steam install では --vanilla でも renderer が起動せず engine がハングしていた。

根本原因: umu/Proton の game-drive 機能が $HOME を Wine ドライブ文字にマップし、起動 cwd (= install_dir) が Z: 以外のドライブに乗る。その結果 renderer exe / /dev/shm IPC の絶対 Unix パスが誤解決され、renderer が起動せず engine が無限待機する。コンテナは install が /opt/resonite (= $HOME=/home/dev の外) なので発症しなかった。

確定修正 (GE-Proton / UMU-Proton 両方で実機確認): 起動 env に PROTON_SET_GAME_DRIVE=0 を渡すと dosdevices が c: / z: のみになり (Steam prefix と同レイアウト)、$HOME 配下 install でも renderer が即起動する。

変更

Fixed

• ホスト $HOME install の game-drive ハングを PROTON_SET_GAME_DRIVE=0 で修正。GAMEID=umu-default / PROTONPATH=GE-Proton を既定化 (umu-run は GAMEID 必須、GE-Proton はスプラッシュ描画崩れ回避の規約)。
• 相対 mod profile が BepInEx に相対 --bepinex-target として渡り BepisLoader が "not an absolute path" で落ちる問題を _resolve_mod_path の abspath で修正。

Added

• resoio launch --prefix (WINEPREFIX) / --proton-path (PROTONPATH) で Wine prefix と Proton を設定可能に。

撤回 (旧版から削除)

• 当初含めていた多重インスタンス対応 (already-running ガード撤去 + PID 集合差分 _wait_for_new + terminate --all / terminate_all) は、既に起動済みの状態では正しく動かないことが判明したため撤回。launch は従来どおり二重起動を拒否し、単一インスタンス前提 (_wait_for_single) に戻した。本 PR は prefix/proton 設定 + umu-run バグ修正のみに絞る。

テスト・検証

• _build_command の env 既定 / 優先順位 (PROTON_SET_GAME_DRIVE 強制 0 の回帰防止含む)・相対 profile 絶対化・already-running ガード・CLI フラグ配線を real OS プロセスで pin。
• コンテナ内検証: pytest (python 全体) 968 passed / ruff check / ruff format --check / pyright strict 0 errors。
• 実機 e2e (ホスト): PROTON_SET_GAME_DRIVE=0 で $HOME install から engine + renderer 起動を確認済み。

補足

• 本変更は Python + docs のみ (proto / C# 不変)。完全な just run は CI に委ねる。
• CHANGELOG は [Unreleased] に記載 (次 0.7.0 想定)。

🤖 Generated with Claude Code