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 /zh-tw/docs/desktop/configuration.md (or send Accept: text/markdown).
配置桌面外殼
讓視窗指向你的應用,設定喚起快捷鍵和視窗偏好,並將原生設定留在 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 啟動,確認視窗載入該源。從應用選單切換每個視窗偏好,重啟並檢查持久化選擇仍然有效。之後移除環境變數覆蓋,讓選單狀態重新成為權威。
如果你想繼續完成設定,可以閱讀《登入與會話》。