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/troubleshooting.md (or send Accept: text/markdown).
桌面應用故障排除
在阻塞構建之前解決缺少工具鏈、空白視窗和釋出簽名失敗。
安裝與配置
在 Windows 上安裝帶 Windows SDK 的 C++ 生成工具和 WebView2 執行時。在 macOS 上安裝 Xcode 命令列工具。在 Linux 上安裝適用於你的發行版的 WebKitGTK、編譯器、托盤和系統包。用 rustup 安裝 Rust，重新開啟終端，並在啟動 Tauri 前執行 cargo check。
空白視窗通常意味著 SUPASTACK_APP_URL 無法訪問或指向已停止的開發伺服器；當已載入頁面失去網路時會顯示離線橫幅。確認該 URL 能在同一臺機器的瀏覽器中開啟，並且你使用了預期的值構建。
實現流程
釋出失敗通常來自簽名、公證或更新器塊。檢查 macOS 上的證書和鑰匙串、Windows 上的簽名證書和時間戳伺服器、更新器公鑰和端點路徑，以及產品識別符號。重新執行釋出配置檢查，然後在乾淨機器上安裝產物，而不是覆蓋開發構建。
驗證與排障
應用啟動、連線後端並順利安裝。