桌面更新¶

VoiceStudio 的桌面应用默认跟随稳定版（Stable）发布，除非你选择加入测试版（Beta）。它会在启动约 10 秒后检查更新，并在应用保持打开期间每六小时检查一次；设置 → 更新中也提供了手动检查。应用只会在你主动要求时下载更新，并且可用的更新仅作为提示提供，绝不会强制安装。

切换频道会立即生效，并在重启后保持记忆。当更新正在下载或等待重启时，切换会被锁定。

• 测试版会向前滚动至稳定版。 当有稳定版发布超过你当前的测试版时（例如 0.5.9 紧随 0.5.9-beta.3 之后发布），测试版会安装该稳定版，因此你不会一直停留在旧的测试版上。
• 切回稳定版绝不会降级。 如果你的测试版比最新稳定版更新，你会继续保持该版本，直到下一个稳定版发布。
• 测试版构建是 GitHub 预发布版本：它们永远不会成为 latest 发布版本，稳定版用户也永远不会看到它们。Microsoft Store、Snap Store 和 Mac App Store 的构建仅提供稳定版。
• 测试版 Linux AppImage 通过应用内更新器更新，而非 AppImageUpdate。

没有独立的预览版桌面更新源。若想尝试测试版之间的变更：

• 从源代码运行 main 分支 — 参见各平台的安装指南（macOS · Windows · Linux），或使用安装脚本的 --main 模式从 main 分支构建并安装软件包。
• Docker — ghcr.io/debpalash/voicestudio:latest 跟随 main 分支；参见镜像标签。

下载过程中会显示已传输大小、总大小、速度、百分比和预计剩余时间（ETA），并且可以在合成、转录或配音工作运行期间继续进行。VoiceStudio 只会在软件包下载完成并通过更新器的校验和验证后启用重启以更新，并且会阻止重启，直到进行中的工作完成且当前草稿已写入磁盘。

无需账户，也没有更新器遥测。 每次检查会从 github.com/debpalash/VoiceStudio/releases/latest/download/（稳定版）获取一个较小的平台/架构特定清单文件；或者，在测试版中，会通过公开的 GitHub 发布列表查找最新的测试版或稳定版发布。该清单携带软件包的 SHA-512 校验和，应用会拒绝未通过校验的软件包。在 Linux 上，应用内更新器使用 AppImage；更新 .deb 安装时，只需安装更新的 .deb 即可。源代码检出不会自我更新。

已归档的 Tauri 应用将其冻结并签名的 latest.json 更新源保持在不可变的 URL 上；它们永远不会提供 Electron 安装程序。请通过迁移指南迁移到 Electron。

更新期间的数据¶

你的声音、项目、历史记录和设置存储在应用包外部的 SQLite 数据库（omnivoice.db）中，因此替换应用绝不会影响它们。在首次启动更新后的版本时，如果新版本需要数据库架构升级，VoiceStudio 将：

1. 首先备份数据库 — 在任何迁移运行之前，会在数据库旁边写入一份一致性快照，命名为 omnivoice.db.backup-<version>-<n>。保留最新的 3 份备份；更旧的备份会自动清理。中断的复制会留下 .part-<pid> 临时文件。部分文件永远不会显示为备份，下一次快照会清理遗留的临时文件。（超过 500 MB 的数据库会跳过快照，并在日志中记录相应信息。）
2. 停止而非猜测 — 如果迁移中途失败，应用不会在迁移了一半的数据库上启动，也不会静默恢复任何内容。它会显示一条错误信息，指明备份路径，以便你（或支持帖）决定：重试、报告问题，或通过用备份替换 omnivoice.db 来回滚。

设置 → 更新会显示最新备份的时间戳、任何可用更新的发布说明，以及一个新增功能阅读器，用于查看随附的变更日志——全部在本地完成，无需额外的网络请求。

Python 环境（.venv）也会以非破坏性方式更新：应用更新后的依赖漂移会通过 uv sync 就地协调，即使同步失败，之前的环境也仍可继续使用。venv 只会在其解释器确认损坏（结构检查 + 直接探测）时，或在你明确使用清理并重试时才会被重建。