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/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 启动,确认窗口加载该源。从应用菜单切换每个窗口偏好,重启并检查持久化选择仍然有效。之后移除环境变量覆盖,让菜单状态重新成为权威。
如果你想继续完成设置,可以阅读《登录与会话》。