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.md (or send Accept: text/markdown).
デスクトップ概要
同じ Web アプリを包む Tauri webview シェル —— もう一つの製品ではなく、存在を届ける層です。
初心者向けのウォークスルー
前提条件: 以下の 2 つの初心者向けガイドを読み、Rust およびオペレーティング システムの前提条件を含むデスクトップのローカル セットアップを完了してください。コード ブロックは、モノリポジトリ内の Web アプリと Tauri の両方を開始します。デスクトップのみのチェックアウトでは、到達可能な Web バックエンドを個別に起動した後でのみ、フィルターされたコマンドを使用してください。 Tauri はそのバックエンドをロードします。
簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。
1. デスクトップのローカル設定に従って、Tauri ウィンドウでアプリを開き、ブラウザーで使用しているのと同じ Web アカウントにサインインします。
2. ワークスペース ページにアクセスし、トレイでウィンドウを非表示/表示し、呼び出しショートカットを試します。
3. Tauri は構成されたバックエンドをロードするため、画面は Web アプリと一致する必要があります。空白の場合は、SUPASTACK_APP_URL がアクセス可能な実行中の Web アプリを指していることを確認します。
カスタム コードの場合は、提供された 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 dev1 つの製品 UI、ネイティブ シェル
apps/desktop は、Web アプリ上の Tauri Web ビューです。製品の UI、認証、チャットを Web と共有します。ネイティブのウィンドウ/トレイの動作は src-tauri/src/lib.rs にあります。到達可能な Web バックエンドが必要ですが、独立した製品インターフェイスはバンドルされていません。
ネイティブシェル機能を使用する
シェルには、トレイ メニュー、トレイに近い、単一インスタンス フォーカス、グローバル召喚ホットキー、ネイティブ ナビゲーション/ビュー メニュー、システム ブラウザの外部リンク、supastack:// ディープリンク召喚、記憶されたウィンドウ状態、およびオフライン再試行オーバーレイが付属しています。
SUPASTACK_APP_URL はバックエンドを選択します（有効な実行時値、次にビルド時値、最後に localhost）。SUPASTACK_DESKTOP_HOTKEY は CmdOrCtrl+Shift+Space を上書きします。署名付きリリースビルドでは SUPASTACK_UPDATER_ENDPOINT と SUPASTACK_UPDATER_PUBKEY が注入され、エンドポイントのパスに {{channel}} が含まれる場合はアプリメニューで Beta Updates（stable と beta の切り替え、実行時は SUPASTACK_UPDATE_CHANNEL で上書き可能）が有効になります。
デスクトップのパスを選択してください
ローカル作業用に Web とデスクトップを一緒に実行し、プラットフォームの前提条件を備えたネイティブ ターゲットを構築して検証します。ストアの署名、インストーラー、および物理デスクトップの動作には、個別の承認が必要です。
2 つ目のアプリではなく webview シェル
apps/desktop は Tauri 2.x のシェルです。src-tauri の Rust コアがウィンドウ、システムトレイ、グローバルショートカットを所有し、webview が Web アプリをロードします。インターフェース、認証、課金、AI はすべて同じ Next.js コードベースから来ます —— デスクトップ面が追加するのは存在感であり、並行する製品ではありません。
シェルには apps/desktop/ui のプレースホルダーページが同梱され、Web アプリのロード中に表示されるため、コールドスタートでも空白のウィンドウにはなりません。
シェルをデプロイ先に向ける
ウィンドウのターゲットはこの順で解決されます：実行時の SUPASTACK_APP_URL 環境変数、次にコンパイル時に焼き込まれた SUPASTACK_APP_URL、最後に http://localhost:3000。http と https の URL のみ受け付けられ、空や Web 以外の値は次の候補にフォールバックします。
開発の場合、これはシェルが corepack pnpm dev が機能するものに接続されることを意味します。運用環境の場合は、ビルド時に変数を設定して、デプロイされた Web アプリをベイクします。
シークレットはサーバー側に
シェルはプロバイダーの認証情報を持ちません。webview はブラウザと同じ認証済み API 面と通信するため、プロバイダーキー、セッションシークレット、課金設定はサーバーに残ります。
バンドル識別子 com.supastack.desktop とデフォルトの capability セット（core:default）が webview をサンドボックスに保ちます。ネイティブ機能が必要な場合のみ src-tauri/capabilities の権限を広げてください。
設定を続けるには、shellの起動と設定をご覧ください。