feat(updater): manual-download Beta opt-in in Settings → About

[appergb]

Summary

PR-B-2 / 客户端 + 文档收尾。和 PR-B-1（CI 端，#330）一起完成 Beta opt-in 闭环。

Base = `chore/branching-workflow`（PR-A，#327）——这样能一次性替换 PR-A 文档里的 "尚未接入" 占位。PR-A merge 后本 PR 的 base 会自动指向 `beta`。与 PR-B-1 解耦、可独立 review / merge。

为什么不走 auto-update 切 endpoint

调研发现 `tauri-plugin-updater` 2.10 的 `Builder` 不暴露 `endpoints()` 运行时 API——endpoints 只能从 `tauri.conf.json` 编译期读，不能跑时切。

可选路径：

• A. 手动下载式 opt-in（本 PR 采用）：plugin 永远只读正式版 manifest，Beta 在 Settings 展示下载入口，用户跳浏览器手动装。~80 行，零风险，物理隔离。
• B. fork plugin / 自实现 update flow：~500 行，高风险，一个 session 做不完。
• C. 只做 plumbing，opt-in 不真生效：违背用户要求。

最终选 A：plugin 自带 "检查更新" 路径完全不动，stable 用户行为零变化；Beta 用户主动 opt-in 后看到独立的下载入口。

改动

Rust 端

• `types.rs`：`UpdateChannel` enum (Stable | Beta) + `UserPreferences::update_channel` 字段；`UserPreferencesWire` / `Default` / `Deserialize` 全套兼容，旧 prefs 反序列化默认 Stable
• `commands.rs`：`get_update_channel` / `set_update_channel` / `fetch_latest_beta_release`（reqwest 调 GitHub API，过滤 `prerelease=true && tag 以 -beta-tauri 结尾`）
• `lib.rs`：3 个命令注册到 `invoke_handler`

前端

• `ipc.ts`：类型 + invoke 包装
• `SettingsModal.tsx` AboutMini 末尾加 `BetaChannelControl`：
  • Toggle off = stable（默认）
  • Toggle on = beta，自动 fetch 一次最新 prerelease，展示 `最新 Beta：v1.x.x-beta-tauri` + `前往下载` 按钮（`openExternal` 跳 GitHub release 页）+ 重新查询按钮
• `Settings.tsx`：把 `Toggle` 组件 export，让 SettingsModal 复用相同样式
• i18n 五个 locale（zh-CN / zh-TW / en / ja / ko）补齐 `settings.about.betaChannel*` 9 个 key

文档

• `README.md` / `README.zh.md`：把 PR-A 的 "opt-in，尚未接入" 占位换成 manual-download 路径说明 + tag 约定
• `CLAUDE.md`：`Channel distribution` 段落重写为已接入状态，含 tag 约定 / wiring 位置 / 5 条 release verification checklist（发版后必跑）

本地验证

```
cargo check --manifest-path openless-all/app/src-tauri/Cargo.toml ✅ 0 新 warnings
npm run build ✅ tsc + vite build 干净
```

与现有自动更新的关系

谁触发	调谁	看哪个 manifest	能拉到 Beta 吗
「检查更新」按钮（已存在）	`@tauri-apps/plugin-updater` 的 `check()`	tauri.conf.json 里的 stable URL	不能（endpoint 永远是 stable）
「加入 Beta 渠道」+「前往下载」（本 PR 新加）	GitHub API + `openExternal`	不读 manifest，直接拉 release JSON	能（且只能）

两条路径互不干扰，stable 用户即使误点 Beta toggle 又关回去也不会被推 Beta 包。

Test plan

• PR-A (docs: introduce Beta/Stable two-channel branching workflow #327) merge 后本 PR 可独立 review；merge 后客户端真正具备 opt-in 能力
• PR-B-1 (feat(release): split updater manifest by channel from tag suffix #330) merge 后第一次发 `v-beta-tauri` tag 时，Beta release 才会出现在 GitHub
• 全部 merge 后跑 `CLAUDE.md` 里新加的 5 步 release verification checklist
• 切换 Beta toggle：旧 `preferences.json` 不会丢字段（serde 默认 Stable）；切了之后再启动还能保持选择
• 当前没 Beta release 时打开 toggle：UI 显示 `暂无已发布的 Beta 版`，不报错

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.