> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# デスクトップ概要

同じ 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/` ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

[始める前に](https://supastack.dev/ja/docs/web/before-you-start.md)

【端末の基本】(/docs/web/terminal-basics)

[デスクトップローカルセットアップ](https://supastack.dev/ja/docs/desktop/ship-in-5-minutes.md)

[エージェント プロンプトとプロジェクト メモリ](https://supastack.dev/ja/docs/web/agents.md)

```
# 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 dev
```


## 1 つの製品 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 とデスクトップを一緒に実行し、プラットフォームの前提条件を備えたネイティブ ターゲットを構築して検証します。ストアの署名、インストーラー、および物理デスクトップの動作には、個別の承認が必要です。

[Tauri デスクトップを 5 分でセットアップ](https://supastack.dev/ja/docs/desktop/ship-in-5-minutes.md)

[ウィンドウ、トレイ、ホットキーの動作](https://supastack.dev/ja/docs/desktop/run.md)

[デスクトップのビルドと配布](https://supastack.dev/ja/docs/desktop/release.md)


## 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の起動と設定](https://supastack.dev/ja/docs/desktop/run.md)をご覧ください。


## 次へ

[デスクトップアプリを5分で起動](https://supastack.dev/ja/docs/desktop/ship-in-5-minutes.md)