> ## 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 包之外。

## 安裝與配置

`SUPASTACK_APP_URL` 選擇外殼載入的 Web 應用。執行時值優先於構建時值，因此同一安裝程式可以指向預釋出環境；生產構建應編譯 HTTPS 源。視窗只在該源內導航，其他連結在預設瀏覽器中開啟。

三個視窗偏好也以選單核取方塊形式存在，並持久化在應用配置目錄中。`SUPASTACK_DESKTOP_HOTKEY` 設定全域性喚起快捷鍵，`SUPASTACK_DESKTOP_*` 布林值在一次執行中覆蓋已儲存的選擇。最小化啟動在建立視窗時生效；關閉到托盤在每次關閉時重新讀取。

```
SUPASTACK_APP_URL=https://app.example.com
SUPASTACK_DESKTOP_HOTKEY=CommandOrControl+Shift+Space
```


## 實現流程

`tauri.conf.json` 儲存產品名稱、版本、識別符號、深連結方案、更新器哨兵和打包目標。`capabilities/default.json` 將 WebView 限制為核心服務和開啟 URL。切勿把提供商金鑰放進外殼；它載入同一個 Web 應用，伺服器仍是信任邊界。


## 驗證與排障

使用執行時 `SUPASTACK_APP_URL` 啟動，確認視窗載入該源。從應用選單切換每個視窗偏好，重啟並檢查持久化選擇仍然有效。之後移除環境變數覆蓋，讓選單狀態重新成為權威。


如果你想繼續完成設定，可以閱讀《[登入與會話](https://supastack.dev/zh-tw/docs/desktop/session.md)》。


## 下一篇

[登入與會話](https://supastack.dev/zh-tw/docs/desktop/session.md)