HHostingByteSoftware
Ctrl K
ComunidadGuías…

RELEASE_POLICY.md

Rama main · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
# 发行与兼容性说明

**简体中文** · [English](./RELEASE_POLICY.en.md)

> 核对日期：2026-11-03。各平台独立发布，系统要求与安装事项以对应发行页为准。

## 已发布稳定版

| 产品 | 稳定版 | 下载资产 | 发行页 |
| --- | --- | --- | --- |
| macOS Server | 0.5.0 | arm64 DMG、SHA-256 / 手动安装 | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-server-macos/releases/tag/v0.5.0) |
| Windows Server | 0.5.0 | x64 EXE、更新包、SHA256SUMS；另有商店渠道 | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-server-windows/releases/tag/v0.5.0) · [商店](https://apps.microsoft.com/detail/9N83B6RSWG01) |
| Linux Server | 0.5.0 | glibc Linux amd64 原生安装包、SHA256SUMS | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-server-linux/releases/tag/v0.5.0) |
| Android Server | 0.5.0 | arm64-v8a 签名 APK、更新清单、SHA256SUMS | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-server-android/releases/tag/v0.5.0) |
| Linux Client | 0.5.0 | x64 deb、AppImage、SHA256SUMS | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-client-linux/releases/tag/v0.5.0) |
| macOS Client | 0.5.0 | arm64 DMG、SHA-256 / 手动安装 | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-client-macos/releases/tag/v0.5.0) |
| Windows Client | 0.5.0 | x64 EXE、更新文件、SHA256SUMS；另有商店 APPX | [v0.5.0](https://github.com/HaoweiLi97/scrapefun-client-windows/releases/tag/v0.5.0) · [商店](https://apps.microsoft.com/detail/9NM3HPS675QH) |
| Android Client | 0.5.1 | arm64-v8a / armeabi-v7a APK、SHA256SUMS | [v0.5.1](https://github.com/HaoweiLi97/scrapefun-client-android/releases/tag/v0.5.1) |

Docker 0.5.0 已发布，稳定版通过 [`haoweil/scrapefun:latest`](https://hub.docker.com/r/haoweil/scrapefun/tags) 分发，测试版通过 `:beta` 分发；updater 使用独立的 `haoweil/scrapefun-updater` 镜像。当前 0.5.0 镜像为 linux/amd64，固定版本使用 `:0.5.0`，app 与 updater 应保持同一版本。

Windows GitHub 发行提供 x64 EXE 安装包和自动更新文件；Microsoft Store 继续作为独立 APPX/MSIX 渠道，可用版本以商店为准。GitHub EXE 未签名，Windows 可能显示未知发布者提示，请用 SHA256SUMS 核对下载。可继续使用原安装渠道，切换渠道前请备份数据。

macOS Server 0.5.0 需要 Apple Silicon / macOS 27.0 或更新系统，Client 0.5.0 需要 Apple Silicon / macOS 26.5 或更新系统。两者采用 ad-hoc 完整性签名，未经 Developer ID 签名和 Apple 公证；本版只提供手动下载安装，不提供应用内自动升级，首次安装按各自 Release 说明操作。

Linux 原生 Server 0.5.0 支持网页安装更新。从旧版升级时，先重新运行一键安装命令，或执行一次 `sudo scrapefun update`；自定义实例保留 `--config-dir`。完成后可从网页手动安装更新。Linux Client 0.5.0 默认通过 X11 / XWayland 启动，Wayland 桌面需安装 XWayland。

## 频道与版本号

新发布采用[标准 SemVer](https://semver.org/)：正式修复使用三段版本，如 0.5.0 → 0.5.1；只有预发布使用 -beta.N、-rc.N 等后缀。旧版说明中的 -patch.N 命名计划已取消，仅保留历史版本的升级读取兼容。各平台可以独立递增，商店数字安装身份与公开版本分别维护。

- **stable**：默认部署频道；GitHub 通常使用 `v<version>`，Docker 使用版本标签和 `latest` 别名。
- **beta**：用于试用测试版本；GitHub 预发布通常带 `-beta`，Docker 使用版本标签和 `beta` 别名。
- 各平台独立发布，Server 与 Client 的版本号可以不同。版本号相同也不能单独证明功能或协议完全一致。
- 本地源码、打包配置和计划中的包格式不代表它们已经发布。可下载范围以 Release Assets 为准。

## 更新方式

| 安装方式 | 更新方式 |
| --- | --- |
| Docker 一键部署 | 应用内 updater 或重跑一键脚本；不指定频道时保留现有频道 |
| NAS 手动 Compose | 更新镜像并重建服务；app 与 updater 频道保持一致 |
| macOS Server | 0.5.0 手动下载 DMG 并替换应用；先备份并退出旧服务 |
| Windows Server | GitHub EXE 使用内置更新，商店安装由 Microsoft Store 更新；切换渠道前请备份 |
| Linux AppImage Client | AppImage 更新，或手动下载替换 |
| Linux deb Client | 使用系统包管理器安装新版包 |
| macOS / Windows Client | macOS 0.5.0 手动覆盖安装；Windows 继续使用原安装渠道的更新方式 |
| Android Client | 应用校验更新信息后交由系统安装器安装，或手动安装同签名新版 APK |

## 升级与兼容性

升级 Server 前导出备份、暂停写入任务，并为重启预留时间。升级后实际检查登录、媒体库、播放、阅读及 Pro 状态。涉及数据库或配置迁移时，以该版发行说明为准。

切换 beta 或回到 stable 前均应备份。较新版本写入的数据不保证能被旧版本读取；回退时使用与目标版本兼容的备份。不要把替换旧二进制当作完整恢复流程。

本项目未在本文中承诺统一的 LTS 周期、全部第三方播放器兼容或跨任意版本无损降级。部署步骤见[文档中心](./docs/README.md)，异常报告见[支持说明](./SUPPORT.md)。