feat(updater): add stable and preview release channels

Publish signed preview packages from successful main CI runs and keep stable updates isolated to formal releases. Reject unsupported architectures and installer formats before checking the preview endpoint.

Author: demogest

.github/workflows/ci.yml

@@ -94,18 +94,14 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          previous_tag="$(git describe --tags --abbrev=0 "${GITHUB_SHA}^" 2>/dev/null || true)"
-          arguments=(
-            --to "${GITHUB_SHA}"
-            --version "${GITHUB_REF_NAME}"
-            --repository "${GITHUB_REPOSITORY}"
-            --output "${NOTES_PATH}"
+          node scripts/generate-changelog.mjs \
+            --auto-from \
+            --auto-from-ref "${GITHUB_SHA}^" \
+            --to "${GITHUB_SHA}" \
+            --version "${GITHUB_REF_NAME}" \
+            --repository "${GITHUB_REPOSITORY}" \
+            --output "${NOTES_PATH}" \
             --strict
-          )
-          if [[ -n "${previous_tag}" ]]; then
-            arguments+=(--from "${previous_tag}")
-          fi
-          node scripts/generate-changelog.mjs "${arguments[@]}"
 
       - name: Create or reuse one draft
         id: release

.github/workflows/release.yml

@@ -135,6 +135,8 @@ chore(release): bump version to 1.4.10
 
 版本标签使用对应的 `v<version>`，例如 `v1.4.10`。标签本身不替代符合规范的提交标题。
 
+`main` 的成功 CI 会自动创建下一补丁版本的测试标签，例如 `v1.4.10-beta.123.1`。这些标签和 `ci-latest` 滚动通道由工作流维护，不应手动创建、移动或用于正式发布；正式 Changelog 查找起点时只识别 `v<major>.<minor>.<patch>` 稳定标签，避免测试标签截断正式版本的变更记录。
+
 ## 本地检查
 
 格式化前端、配置、文档和 Rust 代码：

CONTRIBUTING.md

@@ -24,7 +24,7 @@
 - 房间独立设置：自动录制、录制模式、分段、弹幕、画质、封面和标题过滤
 - 房间详情：分别读取房间信息、录制统计和 IO 统计，并显示 objectId
 - 文件名模板工具：提供标准、按月、按分区和后期友好预设，并使用真实房间上下文预览路径
-- 应用内更新：自动或手动检查 GitHub Releases，显示版本说明与下载进度，签名验证通过后安装并重启
+- 应用内更新：可选择稳定版或测试版通道，显示版本说明与下载进度，签名验证通过后安装并重启
 
 ## 通讯边界
 
@@ -50,7 +50,7 @@ Rust 后端命令
 
 ## 下载与平台支持
 
-Pull Request 会自动执行格式化、Changelog、前端构建、测试和 Rust Clippy 检查。每次推送 `main` 在完整检查通过后，都会构建并上传 Windows x64、Linux x64 和 macOS Universal 三组临时 CI 包；也可在 GitHub Actions 中手动运行。带 `v` 前缀的版本标签仍会使用完整平台矩阵，自动发布带 Tauri 更新签名的正式 Release。
+Pull Request 会自动执行格式化、Changelog、前端构建、测试和 Rust Clippy 检查。每次推送 `main` 在完整检查通过后，都会构建 Windows x64（NSIS）、Linux x64（AppImage、DEB）和 macOS Universal 三组 CI 包，同时使用 Tauri 更新密钥签名并发布经过匿名下载验证的测试版。带 `v` 前缀的正式版本标签仍会使用完整平台矩阵，自动发布稳定 Release。
 
 | 系统    | 架构                           | 安装包             | 便携包       |
 | ------- | ------------------------------ | ------------------ | ------------ |
@@ -60,7 +60,7 @@ Pull Request 会自动执行格式化、Changelog、前端构建、测试和 Rus
 | macOS   | Intel x64、Apple Silicon ARM64 | APP、DMG           | APP ZIP      |
 | macOS   | Universal                      | APP、DMG           | APP ZIP      |
 
-CI 的临时产物保留 7 天；正式版本可从 [GitHub Releases](https://github.com/demogest/BiliRecControl/releases) 长期下载。便携包不等于完全不写本机数据，限制与运行要求见 [PORTABLE.md](PORTABLE.md)。
+Actions 中的临时产物保留 7 天；签名测试版保留 14 天（当前滚动通道指向的版本不会被清理），正式版本可从 [GitHub Releases](https://github.com/demogest/BiliRecControl/releases) 长期下载。便携包不等于完全不写本机数据，限制与运行要求见 [PORTABLE.md](PORTABLE.md)。
 
 Windows 和 macOS 的操作系统级可信代码签名需要购买相应开发者证书，目前 CI 生成的是未做系统证书签名的包，首次运行可能出现安全提示。应用内更新使用独立的 Tauri 签名机制，下载内容被篡改时客户端会拒绝安装。
 
@@ -119,15 +119,26 @@ npm run changelog
 
 ## 应用内更新
 
-桌面程序启动 4 秒后会静默检查稳定更新通道，也可点击顶栏的下载图标手动检查。发现新版本后，先由用户下载并完成签名校验，再由用户确认“安装并重启”，避免下载完成后立即打断当前操作。检查、下载、校验、安装和重启错误会分别提示；下载失败时也可直接前往 Release 页面手动安装。
+桌面程序启动 4 秒后会静默检查用户选择的更新通道，也可点击顶栏的下载图标手动检查。更新窗口提供两个持久化选项：
 
-更新源固定为：
+- 稳定版：只读取正式 Release，适合日常使用。
+- 测试版：读取 `main` 最新成功 CI 生成的签名测试包，版本采用下一补丁的 `beta.<run>.<attempt>` SemVer。
+
+测试版仅支持 Windows x64 的 NSIS 安装、Linux x64 的 AppImage/DEB 安装，以及 Intel/Apple Silicon 均可运行的 macOS Universal 包。客户端会在 Rust 原生层同时检查编译目标和当前安装格式；Windows ARM64、Linux ARM64、musl、Windows GNU、i686，以及 Windows MSI、Linux RPM 等没有兼容测试包的客户端无法选择或请求测试版，但仍可正常使用稳定版。
+
+发现新版本后，先由用户下载并完成签名校验，再由用户确认“安装并重启”，避免下载完成后立即打断当前操作。切换通道会释放旧更新资源并重新检查；下载或安装期间会锁定通道，避免混用不同来源。
+
+更新清单分别为：
 
 ```text
+稳定版
 https://github.com/demogest/BiliRecControl/releases/latest/download/latest.json
+
+测试版
+https://github.com/demogest/BiliRecControl/releases/download/ci-latest/latest.json
 ```
 
-Tauri 会校验更新元数据和安装包签名。私钥一旦丢失，现有客户端将无法验证以后使用新密钥发布的版本，因此必须另行做好安全备份，且不能提交到 Git。
+测试包不会直接使用需要登录且会过期的 GitHub Actions artifact；CI 会先将签名安装包发布为公开 prerelease，验证匿名下载后才更新滚动测试清单。稳定版和测试版都使用同一 Tauri 公钥校验，私钥一旦丢失，现有客户端将无法验证以后使用新密钥发布的版本，因此必须另行做好安全备份，且不能提交到 Git。
 
 如果已发布版本的 `latest.json` 出现元数据错误，可手动运行 [Repair updater manifest](.github/workflows/repair-updater-manifest.yml) 并填写版本标签。该工作流只会依据现有签名资产重建、替换和匿名验证更新清单，不会重新构建安装包；只有明确勾选时才会将该版本设为最新版本。
 

README.md

@@ -2203,8 +2203,141 @@ main {
   overflow-y: auto;
 }
 
+.update-channel-selector {
+  display: flex;
+  flex-direction: column;
+  gap: 9px;
+  padding: 11px;
+  border: 1px solid var(--line);
+  border-radius: 12px;
+  background: rgba(5, 10, 16, 0.48);
+}
+
+.update-channel-selector > header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+}
+
+.update-channel-selector > header > div {
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.update-channel-selector > header strong {
+  color: var(--text-soft);
+  font-size: 9px;
+}
+
+.update-channel-selector > header span {
+  color: #657489;
+  font-size: 8px;
+}
+
+.update-channel-badge {
+  padding: 3px 7px;
+  flex: 0 0 auto;
+  border: 1px solid rgba(62, 231, 211, 0.16);
+  border-radius: 100px;
+  color: #7bded2;
+  background: rgba(62, 231, 211, 0.05);
+  font-family: 'Space Grotesk', sans-serif;
+  font-size: 7px;
+  letter-spacing: 0.08em;
+}
+
+.update-channel-badge.is-preview {
+  color: #b6aaff;
+  border-color: rgba(155, 134, 255, 0.2);
+  background: rgba(155, 134, 255, 0.06);
+}
+
+.update-channel-selector > div {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 8px;
+}
+
+.update-channel-selector > div > button {
+  display: flex;
+  min-width: 0;
+  align-items: center;
+  gap: 9px;
+  min-height: 48px;
+  padding: 8px 10px;
+  border: 1px solid rgba(157, 176, 202, 0.1);
+  border-radius: 9px;
+  color: #6d7c90;
+  background: rgba(255, 255, 255, 0.018);
+  cursor: pointer;
+  text-align: left;
+  transition: 150ms ease;
+}
+
+.update-channel-selector > div > button:hover:not(:disabled) {
+  color: #a7b7ca;
+  border-color: rgba(157, 176, 202, 0.2);
+  background: rgba(255, 255, 255, 0.035);
+}
+
+.update-channel-selector > div > button.is-active {
+  color: #72ded2;
+  border-color: rgba(62, 231, 211, 0.25);
+  background: rgba(62, 231, 211, 0.055);
+  box-shadow: inset 0 0 0 1px rgba(62, 231, 211, 0.035);
+}
+
+.update-channel-selector > div > button.is-active.is-preview {
+  color: #b6aaff;
+  border-color: rgba(155, 134, 255, 0.27);
+  background: rgba(155, 134, 255, 0.065);
+  box-shadow: inset 0 0 0 1px rgba(155, 134, 255, 0.04);
+}
+
+.update-channel-selector > div > button:disabled {
+  cursor: not-allowed;
+  opacity: 0.42;
+}
+
+.update-channel-selector > div > button > svg {
+  flex: 0 0 auto;
+}
+
+.update-channel-selector > div > button > span {
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  gap: 3px;
+}
+
+.update-channel-selector > div > button strong {
+  color: currentColor;
+  font-size: 9px;
+}
+
+.update-channel-selector > div > button small {
+  overflow: hidden;
+  color: #5d6b7f;
+  font-size: 7px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.update-channel-selector > p {
+  margin: 0;
+  padding: 7px 9px;
+  border-radius: 7px;
+  color: #98757d;
+  background: rgba(255, 84, 113, 0.035);
+  font-size: 8px;
+  line-height: 1.55;
+}
+
 .update-modal .update-state {
-  min-height: 230px;
+  min-height: 180px;
 }
 
 .update-state {

app/globals.css

@@ -4,9 +4,11 @@ import { Code2, ExternalLink, Info, MonitorCog, ShieldCheck, Sparkles, X } from
 import { useCallback, useEffect, useState } from 'react';
 import { createPortal } from 'react-dom';
 import { openExternalUrl } from '@/lib/api';
+import { updateChannelLabel, type UpdateChannel } from '@/lib/update-channel';
 import type { ToastItem } from '@/lib/types';
 
 type Props = {
+  updateChannel: UpdateChannel;
   notify: (message: string, tone?: ToastItem['tone']) => void;
 };
 
@@ -17,7 +19,7 @@ function runningInTauri() {
   return typeof window !== 'undefined' && '__TAURI_INTERNALS__' in window;
 }
 
-export default function AboutCenter({ notify }: Props) {
+export default function AboutCenter({ updateChannel, notify }: Props) {
   const [portalReady, setPortalReady] = useState(false);
   const [open, setOpen] = useState(false);
   const [appName, setAppName] = useState('BiliRec Control');
@@ -156,7 +158,7 @@ export default function AboutCenter({ notify }: Props) {
                 <section className="about-meta">
                   <div>
                     <span>更新通道</span>
-                    <strong>正式版</strong>
+                    <strong>{updateChannelLabel(updateChannel)}</strong>
                   </div>
                   <div>
                     <span>开源许可</span>

components/AboutCenter.tsx

@@ -43,6 +43,11 @@ import StreamerAvatar from '@/components/StreamerAvatar';
 import UpdateCenter from '@/components/UpdateCenter';
 import { useRoomAvatars } from '@/lib/use-room-avatars';
 import { parseBilibiliRoomId } from '@/lib/room-input';
+import {
+  readStoredUpdateChannel,
+  storeUpdateChannel,
+  type UpdateChannel
+} from '@/lib/update-channel';
 import {
   finiteNumber,
   formatBytes,
@@ -414,6 +419,7 @@ export default function Dashboard() {
   const [confirmBusy, setConfirmBusy] = useState(false);
   const [toasts, setToasts] = useState<ToastItem[]>([]);
   const [clock, setClock] = useState<Date | null>(null);
+  const [updateChannel, setUpdateChannel] = useState<UpdateChannel>('stable');
   const logCursor = useRef(0);
   const toastSequence = useRef(0);
   const connectionAttempted = useRef(false);
@@ -432,6 +438,11 @@ export default function Dashboard() {
     }, 3600);
   }, []);
 
+  const changeUpdateChannel = useCallback((channel: UpdateChannel) => {
+    setUpdateChannel(channel);
+    storeUpdateChannel(channel);
+  }, []);
+
   useEffect(() => {
     const saved = localStorage.getItem(STORAGE_KEY);
     let restored = DEFAULT_SETTINGS;
@@ -444,6 +455,7 @@ export default function Dashboard() {
     }
     setSettings(restored);
     setDraftSettings(restored);
+    setUpdateChannel(readStoredUpdateChannel());
     setSettingsOpen(!isConfigured(restored));
     setHydrated(true);
   }, []);
@@ -814,8 +826,12 @@ export default function Dashboard() {
           <button className="top-icon-button" type="button" onClick={toggleFullscreen} title="全屏">
             <Maximize2 size={18} />
           </button>
-          <UpdateCenter notify={pushToast} />
-          <AboutCenter notify={pushToast} />
+          <UpdateCenter
+            channel={updateChannel}
+            onChannelChange={changeUpdateChannel}
+            notify={pushToast}
+          />
+          <AboutCenter updateChannel={updateChannel} notify={pushToast} />
           <button className="connection-button" type="button" onClick={openSettings}>
             <span className={connected ? 'online' : ''} />
             <div>