自动更新（GitHub Releases）

Aurevoy 桌面端使用 Tauri updater，以 GitHub Releases 上的 latest.json 作为更新源。

用户侧

1. 应用启动约 4 秒后静默检查更新；有新版本时 toast 提示。
2. 打开 设置 → 常规 → 关于与更新，可手动 检查更新 / 下载并安装。
3. 安装完成后应用会重启。
4. macOS 二次及以后更新：安装成功后、重启前会自动对 .app 执行 xattr -cr，减轻「更新后又提示无法验证 / 已损坏」。首次从网上下载仍需用户右键打开或手动 xattr 放行一次。

仅桌面壳（Tauri）支持；浏览器开发模式会显示「仅桌面可用」。

更新链路

GitHub Release (tag vX.Y.Z)
  ├── Aurevoy_*.dmg / *.exe / *.deb / *.AppImage   # 安装包
  ├── Aurevoy.app.tar.gz (+ .sig)                 # macOS 热更新包
  ├── *.exe.sig / *.AppImage.sig                  # 签名
  └── latest.json                                 # updater 清单
          ▲
          │  GET .../releases/latest/download/latest.json
Tauri 客户端 (plugins.updater.endpoints)

端点配置在 apps/desktop/src-tauri/tauri.conf.json：

"plugins": {
  "updater": {
    "pubkey": "<minisign public key>",
    "endpoints": [
      "https://github.com/nullskymc/Aurevoy/releases/latest/download/latest.json"
    ]
  }
}

releases/latest 不会指向 prerelease（版本号含 - 时 workflow 会标 prerelease）。

维护者：签名密钥

更新包必须用 minisign 私钥签名；公钥写在 tauri.conf.json，私钥只进 CI Secrets。

生成密钥（仅首次 / 轮换时）

cd apps/desktop
npx tauri signer generate -w ~/.tauri/aurevoy.key
# 或无密码（CI 更简单，安全性略低）:
npx tauri signer generate -w ~/.tauri/aurevoy.key --ci

将 公钥内容 写入 tauri.conf.json → plugins.updater.pubkey。

GitHub Secret 配置（最容易踩坑）

Secret	说明
TAURI_SIGNING_PRIVATE_KEY	~/.tauri/aurevoy.key 文件的整行原文（一条 base64，约 300+ 字符）
TAURI_SIGNING_PRIVATE_KEY_PASSWORD	仅在生成密钥时设了密码才创建；无密码则不要建这个 Secret

正确复制：

# 预览：应是单行、以 dW50… 开头、以 == 结尾、无空格无引号
wc -c ~/.tauri/aurevoy.key    # 本仓库生成的密钥约为 348
cat ~/.tauri/aurevoy.key
# macOS 一键拷贝到剪贴板后粘贴进 Secret：
pbcopy < ~/.tauri/aurevoy.key

不要这样配：

错误	后果
再 base64 编一层	解码失败或签出无效签名
加引号 "dW50…"	base64 非法字符
填本地路径 ~/.tauri/…	runner 上没有该文件
填公钥 .pub	无法签名
粘贴解码后的多行 untrusted comment:…	Invalid symbol 58（冒号）等
无密码却建了空的/错的 …_PASSWORD	解密失败

本地校验密钥可用：

export TAURI_SIGNING_PRIVATE_KEY="$(cat ~/.tauri/aurevoy.key)"
# 不要 export 空密码变量，除非真的设了密码
echo test > /tmp/t.bin
cd apps/desktop && npx tauri signer sign /tmp/t.bin
# 成功会生成 /tmp/t.bin.sig

CI 里 workflow 会把 Secret 写成临时文件，再把 TAURI_SIGNING_PRIVATE_KEY 设为文件路径（Tauri 支持 path 或内容），避免环境变量里夹换行导致
failed to decode base64 secret key: Invalid symbol 61。

丢失私钥 = 无法再给已安装客户端推送可验证更新，需重新生成密钥并发布强制换钥版本。

本地带签名构建

export TAURI_SIGNING_PRIVATE_KEY="$(cat ~/.tauri/aurevoy.key)"
# export TAURI_SIGNING_PRIVATE_KEY_PASSWORD='...'
npm run prepare-desktop-bundle
cd apps/desktop && npx tauri build --bundles dmg

未设置私钥时，createUpdaterArtifacts: true 会导致 tauri build 失败。临时关更新产物：

npx tauri build --config '{"bundle":{"createUpdaterArtifacts":false}}'

发布流程

1. 版本号对齐：package.json / apps/desktop / src-tauri（当前 monorepo 惯例）。
2. 打 tag：git tag v0.6.5 && git push origin v0.6.5
3. .github/workflows/release.yml：
   • 多平台 tauri build（注入签名密钥）
   • 上传安装包 + updater 产物 + .sig
   • scripts/generate-latest-json.mjs 生成 latest.json
   • softprops/action-gh-release 创建 Release

手动触发 workflow_dispatch 时，版本取自 tauri.conf.json。

与 Apple 代码签名的关系

层	用途	状态
Tauri updater 签名	验证更新包来源（minisign）	已接入
Apple Developer 签名/公证	Gatekeeper / 无「未知开发者」提示	仍需证书与 Secrets，见 ROADMAP

无 Apple 签名时自动更新仍可用，但用户首次打开可能被系统拦截。

相关文件

路径	作用
apps/desktop/src-tauri/tauri.conf.json	endpoints / pubkey / createUpdaterArtifacts
apps/desktop/src-tauri/src/lib.rs	注册 updater + process 插件
apps/desktop/src/platform/tauriPlatformAdapter.ts	check / install
packages/web-ui/.../GeneralSettings.tsx	设置页 UI
scripts/generate-latest-json.mjs	Release 清单
.github/workflows/release.yml	CI 发布