> ## 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/docs/desktop/session.md)》。


## 下一篇

[登录与会话](https://supastack.dev/zh/docs/desktop/session.md)