トラブルシューティング
画面は開くがJEVが使えない
手動とローカルモードにはキー不要です。JEVを使う場合はプロジェクトの .env に AI_GATEWAY_API_KEY を置き、Nodeサーバーを再起動して GET /api/status を確認します。configured: true はキーがあることだけを示し、残量や上流の稼働までは保証しません。
通信失敗や429が出る
ブラウザは localDecision で飛行を継続し、補助状態を表示します。ゲートウェイ429をJEV成功に置き換えることはありません。ローカル /api/decide の制限もHTTP 429と再試行間隔を返します。待つか、呼び出しを減らしてローカル操縦を続けてください。
機体の挙動がおかしい
非表示タブでは一時停止します。ミッションやモードを変えた後は R で再出撃してください。モデルはアーケード仕様です。HUD高度は海抜、テレメトリ高度は地形相対で、地面接近や失速時は回復制御が優先されます。
3D画面が空白
WebGL対応のデスクトップブラウザを使い、コンソールを確認します。診断ページは独立した描画確認で、JEV APIは呼びません。
画面表示の読み方
JEV LIVE はJEVへ要求できるモードを示します。判断パネルには、受理した応答、レイテンシ、ローカル待機・失敗の表示が別々に現れます。
チェックアウトを確認
powershell
npm ci
npm test
npm run buildテスト成功とJEV成功は別の信号です。前者はネットワーク不要の物理・アダプターテスト、後者はローカルキー、応答形式、期限、レート制限、プロバイダー状態に依存します。