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/tech-stack.md (or send Accept: text/markdown).
Desktop 技术栈
Tauri 外壳内部的技术以及各自的角色。
开始之前
Desktop 应用刻意保持精简：Rust 核心掌管原生窗口，webview 加载您的 web 应用。下面的一切都已在 checkout 中锁定——本页解释每个部分的作用，便于理解后面的指南。
产品界面、认证、计费和 AI 都位于窗口所加载的 web 代码库中。仅含 Desktop 的 checkout 只有外壳——这正是此技术栈刻意保持精简的原因。
Tauri 2 + 系统 webview
Tauri 2 用操作系统自带的 webview 渲染应用——Windows 上的 WebView2、macOS 上的 WebKit、Linux 上的 WebKitGTK——因此外壳保持精简，不捆绑浏览器运行时。frontendDist 指向 apps/desktop/ui，即 web 应用加载期间显示的启动页，冷启动绝不会渲染空白窗口。
Rust + TypeScript
外壳的行为由 Rust 实现——src-tauri/src，edition 2021，最低 Rust 1.90——由 cargo 构建。用 TypeScript 编写的小型 Node 脚本负责发布预检和更新器清单。
通过插件提供原生功能
窗口状态、单实例、deep link、全局快捷键、托盘、开机自启、更新器、外部链接打开、对话框和进程控制都来自 tauri-plugin-* crate——外壳没有自定义 IPC 命令。新增原生能力意味着再注册一个插件或接线已有的插件。
tauri.conf.json + capabilities
包标识符 com.supastack.desktop、窗口列表、插件选项和更新器端点位于 src-tauri/tauri.conf.json。Webview 权限在 src-tauri/capabilities/default.json 中——目前是 core:default 加上用于系统浏览器链接的 opener:allow-open-url——只有在原生功能需要时才扩大。
验证工具
cargo test 覆盖 Rust 逻辑——URL 解析、导航门禁、deep-link 映射、更新器通道、缩放和窗口偏好——node --check 校验启动页，check:release-config 守住发布构建。CI 会构建全部三个操作系统。
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop check:release-config