For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/desktop/run.md (or send Accept: text/markdown).
shellの起動と設定
Tauri開発shellを起動し、Webアプリへ接続します。
初心者向けのウォークスルー
前提条件: 以下の 2 つの初心者向けガイドを読み、Rust およびオペレーティング システムの前提条件を含むデスクトップのローカル セットアップを完了してください。コード ブロックは、モノリポジトリ内の Web アプリと Tauri の両方を開始します。デスクトップのみのチェックアウトでは、到達可能な Web バックエンドを個別に起動した後でのみ、フィルターされたコマンドを使用してください。 Tauri はそのバックエンドをロードします。
簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。
1. apps/desktop/src-tauri/src/lib.rs を開きます。指定されたウィンドウ/トレイ/ホットキーの動作のみを変更し、Web アプリ内の製品 UI を維持するようエージェントに依頼してください。
2. シェルを実行し、トレイに近い、終了、CmdOrCtrl+Shift+Space をテストします。 supastack:///settings/appearance?preview=1#mainをテストします。
3. 既存のウィンドウにフォーカスし、パス/クエリ/フラグメントを保持する必要があります。間違ったページが開いた場合は、設定された起点と正確なルートを比較してください。
カスタム コードの場合は、提供された prompts/README.md から始めて、最も近いプロンプト (アプリ画面の場合は prompts/new-app-screen.md、パブリック ページの場合は prompts/new-landing-page.md) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディング エージェントにこのガイドのタスクを与え、AGENTS.md、.ai/PROJECT_CONTEXT.md、および一致する .ai/ ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。
【端末の基本】(/docs/web/terminal-basics)
# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop
# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop devRustでシェルの動作を維持する
src-tauri/src/lib.rs は、1200×800 のメイン Web ビュー ウィンドウを作成します。閉じるとトレイに隠れます。出口をやめる。ネイティブ メニューには、ホーム/戻る/進む/リロード、ズーム/全画面、およびウィンドウのアクションが用意されています。ウィンドウ状態の復元では、サイズ/位置が保持されます。
プラットフォーム固有の動作を確認する
挿入されたオフライン オーバーレイは、再試行を提供し、オンラインで非表示にし、Web アプリをリロードします。すべてのターゲット OS でフォーカス、ショートカット、メニュー ズーム、トレイ、ディープリンクの呼び出しをテストします。ユニット URL チェックだけでは、これらのネイティブ インタラクションを証明することはできません。
【デスクトップ受付】(/docs/desktop/release)
インストールとセットアップ
ワークスペースの依存関係と Rust ツールチェーンに加えて、Tauri の OS ごとの前提条件をインストールします (WebView2 は Windows に同梱されています。macOS と Linux には文書化されたパッケージが必要です)。 corepack pnpm --filter @supastack/desktop dev は tauri dev を実行します。Rust コアをビルドし、プレースホルダー UI を表示し、解決されたアプリ URL をロードします。
実行時SUPASTACK_APP_URLを優先し、次にbuild時の値を使います。資格情報のないHTTP(S)だけを受け付け、無効なら次の候補を試します。SUPASTACK_DESKTOP_HOTKEYはCmdOrCtrl+Shift+Spaceを上書きします。無効値は既定値に戻り、起動を妨げません。
corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck
SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop dev実装ワークフロー
メインwindowはschemeとportを含む設定済みorigin完全一致の範囲だけを移動します。資格情報のないHTTP(S)、mailto、telはシステムbrowserで開けます。それ以外のschemeはキャンセルします。
登録済みsupastack:// linkはpath、query、fragmentを設定済みapp originへ対応付けます。初回起動、platformのopen-url event、second-instance callbackは同じ検証を使い、別hostへのredirectを防ぎます。
trayとglobal shortcutで唯一のメインwindowを表示・フォーカスします。登録できない場合は別のアプリがshortcutを使っている可能性があります。SUPASTACK_DESKTOP_HOTKEYを変更してください。
検証とトラブルシューティング
src-tauri変更後はpackage scriptでcargo checkとcargo testを実行します。origin一致、許可された外部URL、設定済みoriginに留まるsupastack:// link、tray、hotkey、再起動後のログイン状態を確認してください。