トラブルシューティング

アプリが画面を開かずJSONを出力する

app.start()の既定は標準入出力なので正常です。omochi-ui dev -- COMMANDで包み、別途Viteプレビューを起動して5173を開きます。最初のUIに手順があります。

5555が使用中

devとhubが同じ既定ポートを使います。既存プロセスを停止するか--portを指定します。ブリッジ側を変えたらプレビューの接続先も合わせます。

サービスが見つからない

検出可能モード（同梱exampleならOMOCHI_SERVICE）で起動しているか、Gatewayと同じユーザー・実行時ディレクトリか確認します。0700の権限を緩めず、所有者と設定を確認してください。HubはSDKアプリを自動起動しません。

更新しても入力が変わらない

ブラウザの入力途中の値は再描画で保持されます。意図的に上書きするときはLocalのリセットAPIを使います。

Action内の更新で停止する

Action内でruntime.update()をawaitせず、Contextの更新を使います。進捗を公開してもActionは直列です。

リモートにつながらない

statusとtrust listで登録と役割を確認します。期限切れなら招待を作り直してください。招待は一回限りで180秒です。--offlineは公開検索・リレーを停止します。旧信頼は再ペアリングで置き換えます。

メディアを読めない

再生が終わるまで登録を保持します。サイズ上限とMIME型を確認してください。コーデック変換はしません。独自Transportは要求元の接続へリソース応答を返す必要があります。