程式碼簽名

初學者演練

先決條件：完成桌面本地設定，包括 Rust 和作業系統構建工具。在構建安裝程式之前停止 Tauri 開發過程；讓 Web 後端保持執行。從儲存庫根目錄執行下面的每項檢查，並等待其完成，然後再執行下一項。過濾後的包命令適用於僅桌面版和所有平臺簽出。

簡而言之：工作區是一個團隊的單獨使用者、資料和設定。伺服器是可信後端；讓提供商金鑰遠離瀏覽器和電話程式碼。遷移是建立或更新表的版本化資料庫更改。人工智慧模型是回答的引擎；型號目錄是伺服器上可用型號 ID 和價格的列表。提供商是一種外部服務，例如人工智慧、電子郵件或計費服務。權利是允許工作區使用某項功能的授權。 Webhook 是一個服務傳送到另一個服務的 URL 的訊息。

1. 在本地分支機構，請您的編碼代理檢查 apps/desktop/src-tauri/tauri.conf.json 並將產品識別符號、應用程式名稱、圖示和後端 URL 設定為您擁有的值。使用公共 HTTPS 後端 URL 進行釋出版本。

2. 從儲存庫根目錄執行下面的桌面包檢查。在check:release-config之前，使用桌面本地設定中的作業系統命令在此終端中設定SUPASTACK_APP_URL；公共 HTTPS 後端必須正在執行，並且應用程式識別符號必須是您自己的。

3. 成功的構建不會簽署、公證或釋出安裝程式；如果 Rust 或系統庫丟失，請完成桌面本地設定。

對於自定義程式碼，請從提供的 prompts/README.md 開始，然後複製最接近的提示：對於應用程式螢幕為 prompts/new-app-screen.md，對於公共頁面為 prompts/new-landing-page.md。對於伺服器、資料庫或提供商工作，請為您的編碼代理提供本指南的任務，並要求其讀取 AGENTS.md、.ai/PROJECT_CONTEXT.md 和匹配的 .ai/ 映象；檢查此處指定的確切原始檔；列出檔案並在編輯前進行檢查；保留工作區所有權和僅限伺服器的機密；並向您展示差異。告訴它您想要的行為、輸入和輸出欄位、允許的角色、預期的成功和錯誤以及測試帳戶、提供程式或裝置。使用樣本值；永遠不要貼上真正的秘密。

• 開始之前
• 終端基礎知識
• 桌面本地設定
• 座席提示和專案記憶體

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

配置產品外殼

檢視 src-tauri/tauri.conf.json、Cargo 後設資料、功能和平臺識別符號。通過共享資產流程替換應用程式圖示，並在構建/執行時設定預期後端 URL。託管 Web 應用程式必須已部署且可訪問。

執行本機構建門

這些包命令執行 Rust 型別檢查和測試、驗證釋出設定並構建 Tauri 安裝程式。簽名和分發配置取決於目標平臺和您的帳戶/證書；不要將簽名材料儲存在源中。

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

驗證目標作業系統上的安裝程式

檢查全新安裝、啟動、後端可訪問性、身份驗證、選單/托盤、熱鍵註冊、第二例項、深連結、離線重試與解除安裝。每個受支援的作業系統分別驗證。本地構建不能證明經過簽名或公證的商業分發；簽名配置由你自行準備，出廠的釋出工作流與更新器源見“自動更新”篇。

• 本機驗收清單
• 自動更新與釋出頻道
• 部署共享後端

安裝與配置

1. 未簽名的安裝包可以在自己的電腦上安裝，但其他使用者會看到 Gatekeeper 和 SmartScreen 警告；釋出前需要簽名。

2. macOS 需要加入 Apple Developer Program 並獲取 Developer ID 證書，然後在 src-tauri/tauri.conf.json 的 bundle 部分配置簽名和公證，並從 CI 金鑰庫向 Tauri 提供 APPLE_CERTIFICATE、APPLE_CERTIFICATE_PASSWORD、APPLE_SIGNING_IDENTITY，以及公證所需的 APPLE_API_KEY 和 APPLE_API_ISSUER。

3. Windows 需要配置 bundle 簽名，可用證書 thumbprint 或自定義 signtool 命令；證書同樣應由執行器的金鑰庫提供。

# tauri.conf.json ships unsigned today:
#   "bundle": { "active": true, "targets": "all", "icon": [...] }
# Add signing under bundle > macOS / bundle > windows
# and keep every certificate and password in your secret store,
# never in the repo.
# Auto-updater & release channels (stable / beta via {{channel}}):
# SUPASTACK_UPDATER_ENDPOINT=https://releases.example.com/{{channel}}/{{target}}/{{arch}}/{{current_version}}
# SUPASTACK_UPDATER_PUBKEY=…
# SUPASTACK_UPDATE_CHANNEL=stable

實現流程

通過自己的金鑰庫配置證書，並在構建時注入環境變數。證書一旦提交到倉庫，就應視為需要吊銷。

在同一釋出構建中設定生產環境 SUPASTACK_APP_URL，確保安裝後的外殼指向已部署應用，而不是 localhost。

驗證與排障

將安裝包安裝到另一臺電腦上進行驗證：不再出現 Gatekeeper 或 SmartScreen 警告，應用可以啟動，登入狀態能夠保留。僅僅 tauri build 成功而未測試簽名安裝，不足以證明具備釋出條件。

接下來：Web 欄中的《部署檢查清單》介紹伺服器上線前的準備。