更新与版本选择:启动检查、安装、固定某个构建

Senzoukria 桌面端在启动时检查新版本并询问是否安装。账户页的「版本」卡片列出每一个已发布的构建,允许安装其中任意一个,还可以固定某个构建,让自动更新不再把你往前推。

Senzoukria · 文档 · 更新于 2026 年 9 月


位置

位置
启动时的更新对话框;账户 → 版本卡片用于手动选择;设置 → 关于 显示当前版本
何时跳过
从源码运行(开发版构建),或已经固定了某个版本时
安全
任何东西运行之前都会校验签名;没有已发布签名的构建被标记为「不可用」

它做什么

启动时,会话恢复之后,应用会向更新服务器询问是否有更新的版本。如果有,「有可用更新」对话框会显示新版本、当前运行的版本和发布说明,并给出两个按钮:「立即安装」和「稍后提醒我」。安装过程带进度条下载,完成后重启应用。网络错误、服务中断或最新发布缺少签名都不会阻塞启动:检查只是被记为已完成。

「版本」卡片是同一套机制的手动一面。它列出已发布的构建及其日期和体积,把正在运行的那个标为「运行中」,并允许你安装其他任意一个。所有敏感环节都留在 Rust 侧:地址解析、签名校验、安装程序启动。

版本卡片

控件与状态
控件状态或默认作用
安装显示在每一个可安装且非运行中的构建上打开一个含三个选项的确认框
安装并固定确认框选项安装该构建并固定它:在你恢复自动更新之前,自动更新关闭
仅安装确认框选项安装该构建;下次启动时自动更新可能再次把你往前推
取消确认框选项关闭确认框
已固定 {version} 徽标默认不存在存在固定时显示在卡片头部,并附注「固定版本期间自动更新处于关闭状态。」
恢复自动更新固定说明中的链接移除固定
不可用没有已发布签名的构建无法从应用内安装
进度下载过程中的百分比下载循环每 512 KB 更新一次

怎么用

要在一次糟糕的发布之后回退,打开 账户 → 版本,在上一个构建上点击「安装」,并选择「安装并固定」。应用会关闭,Windows 安装程序运行,下次启动时由于存在固定,启动检查会被跳过。修复版本发布后,点击「恢复自动更新」或直接安装更新的构建。

如果卡片显示正在运行的构建不是被固定的那个,说明安装没有完成;请重新执行一次,或恢复自动更新。

已安装版本会打印在欢迎页脚、账户页脚和关于页面上;发布说明在欢迎界面的「新变化」链接后面。

限制与易错点

安装前需要知道的事:

  • 安装会关闭应用:安装程序必须替换那些在运行期间被锁定的二进制文件。
  • 从源码启动的开发版构建从不检查更新;工作分支总是落后于已发布版本,否则每次启动都会弹出提示。
  • 空的固定值等同于没有固定,因此一个空白偏好无法悄悄冻结更新。
  • 如果读取固定值失败,检查照常继续:一个损坏的偏好不该阻断所有人的更新。
  • 选择器只把一个版本字符串传给 Rust 侧;下载地址在服务端解析。

其他语言版本

常见问题

我回退了,应用却又自己更新了,为什么?
你选的是「仅安装」。请使用「安装并固定」,这样在你恢复自动更新之前,启动检查都会被跳过。
为什么某个构建被标为不可用?
它没有发布签名。应用拒绝安装无法校验的构建。
为什么我本地的开发版构建总是要求更新?
现在不该再这样了:自 2026-09-10 起,开发版构建会跳过检查。如果提示仍然出现,请更新你的代码检出。