> ## 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

# 自动更新与发布频道

签名的更新源、stable/beta 频道，以及出厂的发布工作流。

## 一次性生成更新器密钥对

更新器会校验下载产物的 minisign 签名。用 Tauri 签名工具生成密钥对，把私钥存入 TAURI_SIGNING_PRIVATE_KEY、口令存入 TAURI_SIGNING_PRIVATE_KEY_PASSWORD，两者都放进密钥存储 —— 绝不进仓库。产出更新器产物的构建会在每个安装包旁生成 .sig 旁车文件；公钥分发给客户端，私钥留在 CI。

```
corepack pnpm --filter @supastack/desktop exec tauri signer generate -w ~/.tauri/product.key
```


## 在构建期配置更新器

tauri.conf.json 附带一个哨兵更新器块，endpoints 与 pubkey 留空 —— 请保留它，因为缺少这些键更新器插件就无法初始化。真实值在构建期通过 --config JSON 覆盖层或 TAURI_CONFIG 环境变量深合并进去；设置了 SUPASTACK_UPDATER_ENDPOINT 与 SUPASTACK_UPDATER_PUBKEY 时，check:release-config 会打印可直接粘贴的覆盖层。

要么两个都设、要么都不设：只覆盖 endpoints 会让 pubkey 留空，检查看似正常而每次安装都卡在签名校验。端点 URL 携带 {{target}}、{{arch}} 与 {{current_version}} 占位符 —— 版本槽为必填 —— 外加一个可选的 {{channel}} 路径段，用于启用发布频道。

```
# check:release-config prints this overlay for tauri build --config:
# {"plugins":{"updater":{"endpoints":["https://releases.example.com/{{channel}}/{{target}}/{{arch}}/{{current_version}}"],"pubkey":"<base64 public key>"}}}
# SUPASTACK_UPDATER_ENDPOINT=
# SUPASTACK_UPDATER_PUBKEY=
```


## 发布 latest.json 更新源

每个端点应答一份 latest.json 清单 —— version、notes、pub_date，以及覆盖 darwin-aarch64、darwin-x86_64、windows-x86_64、windows-aarch64、linux-x86_64、linux-aarch64 的 platforms 映射 —— 每个条目把安装包 URL 与其签名配成一对。

用 release:manifest 脚本生成它：脚本扫描打包目录中的 .app.tar.gz、-setup.exe（优先于 .msi）与 .AppImage 产物 —— 每个都必须带 .sig 邻居 —— 然后写入或合并清单。可用标志包括 --version、--base-url、--bundle-dir 加 --platform、跨多次运行累积平台的 --merge、--notes、--pub-date 与 --out。

```
corepack pnpm --filter @supastack/desktop release:manifest -- \
  --version 1.2.0 \
  --base-url https://releases.example.com/stable \
  --bundle-dir src-tauri/target/release/bundle \
  --platform windows-x86_64 \
  --merge latest.json
```


## stable 与 beta 频道

端点包含 {{channel}} 占位符时，应用菜单会启用 Beta Updates 复选框，在 stable 与 beta 源之间切换。选择持久化在应用配置旁的 update-channel 文件中；SUPASTACK_UPDATE_CHANNEL 可按次覆盖 —— 无法识别的值带警告忽略 —— 默认为 stable。没有该占位符时开关保持禁用，只检查 stable 源。


## 何时检查更新

启动时跑一次静默后台检查，只有发现更新才弹对话框；Check for Updates… 菜单项会报告每种结果。检查是串行的 —— 并发的第二个请求被丢弃。有可用更新时提供 Install and Restart，它会下载、安装并重启应用；未配置的构建回答更新未配置，失败以对话框呈现而非自动重试。


## 出厂的发布工作流

.github/workflows/desktop-release.yml 在 desktop-v* 标签或带版本与频道的手动触发上构建矩阵 —— 两种架构的 macOS、Windows 与 Ubuntu。它用标签写入清单版本（跳过这步的发布会永远把自己当作更新推出去）、合并各平台清单，并创建携带 latest.json 及全部安装包与签名的 GitHub 草稿发布 —— beta 频道标记为 prerelease。

它需要 SUPASTACK_APP_URL 与 SUPASTACK_UPDATER_ENDPOINT 作为仓库变量，SUPASTACK_UPDATER_PUBKEY 以及签名私钥与其口令作为 secrets；Apple 签名凭据是可选附加项。完整操作手册在仓库的 `docs/desktop-updates.md`。


## 验证与排障

安装一个构建，把更新的清单发布到测试源，确认下一次检查弹出更新对话框且应用重启进入新版本。然后切到 beta，确认频道源的应答发生变化。

[打包和发布](https://supastack.dev/zh/docs/desktop/release.md)

[代码签名](https://supastack.dev/zh/docs/desktop/signing.md)


## 下一篇

[桌面外壳内部](https://supastack.dev/zh/docs/desktop/internals.md)