构建与分发

桌面发布比 Web 发布多几个环节：前端 bundle、Rust 编译、安装包、代码签名、平台安全检查和下载分发。先在本机构建成功，再考虑 CI 和自动更新。

正式分发前的凭证清单

AI 或 CI 可以自动执行构建、签名和上传，但前提是账号、证书和 secret 已经准备好。

凭证或配置	用途	没有它会怎样
Developer ID Application	macOS 面向用户下载的签名	用户打开时会遇到 Gatekeeper 风险提示
Apple notarization 凭据	把 macOS app 或 DMG 提交公证	只有签名，没有完整公证状态
Windows code signing certificate	Windows 安装包签名	SmartScreen 和安全软件更容易拦截
`TAURI_SIGNING_PRIVATE_KEY`	生成 updater 签名产物	自动更新无法验证下载包
发布存储	存放 `.dmg`、`.msi`、`.AppImage` 等安装包	用户没有稳定下载地址
更新端点	返回版本、下载 URL 和签名	应用内“检查更新”不可用
生产 API / Web 地址	桌面应用连接后端	安装包可能连到本地或 staging

这些凭证不提交到仓库。放进本机安全位置、CI secret 或平台后台。AI 可以检查变量是否存在，但不能替用户购买开发者账号、完成双重验证或接受平台协议。

先跑桌面端代码检查：

vpr @01mvp/desktop#type-check
vpr @01mvp/desktop#lint
vpr @01mvp/desktop#test
vpr @01mvp/desktop#build
vpr @01mvp/desktop#tauri:check

如果这些命令失败，不要直接跑打包。先修基础问题。

运行：

vpr @01mvp/desktop#tauri:build

Tauri 会先构建前端，再编译 Rust，最后生成平台安装包。

常见输出位置：

products/01mvp/apps/desktop/src-tauri/target/release/bundle

target 和 dist 都不提交到 git。

模板里配置：

{
  "bundle": {
    "targets": "all"
  }
}

开发阶段可以保留 all。发布阶段建议按平台明确构建，避免 CI 产物太散：

不同平台的产物、签名和用户安装习惯都不一样。不要只在 macOS 打过包，就认为 Windows 和 Linux 已经可发布。

桌面版本号在：

{
  "version": "0.1.0"
}

发布时要保持：

macOS 正式分发通常需要：

开发阶段可以用 ad-hoc 签名：

{
  "bundle": {
    "macOS": {
      "signingIdentity": "-"
    }
  }
}

ad-hoc 只适合本机开发，不能替代正式分发签名。

Windows 正式分发通常需要代码签名证书。没有签名的安装包更容易触发 SmartScreen 风险提示。

新产品早期可以先做内部测试包，但面向真实用户下载时，要规划：

Linux 用户常见接受方式包括 AppImage、deb、rpm。你要根据目标用户选择：

Linux 桌面环境差异比较大，发布前至少在一个干净环境里安装测试。

稳定发布前，把本地流程固化成 CI：

不要只验证 git tag。真正的发布验收是安装资产存在、签名有效、下载可用、更新端点返回正确版本。