10.10.0 版本发布路线图

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

我们很高兴地宣布，10.10.0 版本的发布流程现已启动，计划发布日期为 2024 年 10 月 26 日星期六（已更新，详见下文）！我们在 10.9.0 的发布公告中提到过 6 个月的发布周期，这次我们依然坚守承诺！正式功能冻结将于下周开始，今天起实施软性"新 PR 冻结"。以下是时间线详情以及如何协助我们在发布前测试 10.10.0 的说明。请记住，参与预发布测试的人越多，正式发布后发现的漏洞就越少。请立即启动你们的备用服务器并告知用户：10.10.0 即将到来！

开发人员/贡献者以及需要更多信息的用户，请继续阅读！

—— Joshua

版本发布

本次有何不同？

基本没有变化！我们延续了 10.9.0 版本的发布流程，仅对时间线进行了微调并增加了更明确的阶段划分。

发布日程表

• 2024 年 9 月 9 日星期一（不稳定版 20240909）：功能 PR 最后征集期，首个测试版。任何新功能 PR 请立即提交以免错过功能冻结。这是为期 1 周的预警！开发人员/贡献者请务必及时处理 PR 审阅反馈，否则您的 PR 可能错过后续截止时间，需等待至 10.11.0 版本。

• 2024 年 9 月 16 日星期一（不稳定版 20240916）：功能冻结，第二个测试版。此后任何新功能 PR 必须等待 10.11.0 版本（约 6 个月后）。进行中的功能 PR 若能在 API 冻结前解决所有反馈，仍可被纳入。再次强调开发人员/贡献者请及时处理 PR 审阅反馈。此后新 PR 应仅限错误修复。用户可安全开始正式测试此不稳定版。

• 2024 年 9 月 23 日星期一（不稳定版 20240923）：API 冻结，第三个测试版。所有功能 PR 应在此时间点前完成合并。未合并的 PR 将移至 10.11.0 项目，仅在 10.10.0 发布后才合并至 master。API 现已软冻结，以便客户端开发人员可放心开展适配 10.10.0 所需的客户端修改。

• 2024 年 9 月 30 日星期一（不稳定版 20240930）：API 锁定，首个候选发布版。主要错误修复 PR 应在此时间点前完成合并或基本就绪。此后仅接受不涉及 API 变更的错误修复。我们应在此时间点前完成功能概述博文草稿。

• 2024 年 10 月 7 日星期一（不稳定版 20241007）：最终计划不稳定版，第二个候选发布版。版本应已基本就绪，所有剩余错误修复 PR应在此不稳定版发布前完成合并。

• 2024 年 10 月 12 日星期六：10.10.0 正式发布！

可能的日程调整

编辑于 2024-10-12：由于 Web 端关键变更必须纳入，我们决定延期两周。当前计划发布日期为 10 月 26 日。

由于本次发布（10.10.0）的规模比 10.8.0 或 10.9.0 要小得多，节奏也更快，希望这段时间足够我们完成所有准备工作。但如果我们发现时间不够，我们保留在以下一处或两处位置额外增加一周的权利：

• 在功能冻结之后，如果我们发现还有任何重大 bug 修复需要在 API 冻结前合并，且需要额外时间。

• 在 API 锁定之后，如果我们发现还有任何不破坏 API 的 bug 修复需要在最终不稳定版本前合并，且需要额外时间。

如果上述两种情况均未发生，发布将按计划进行；否则，我们将在上述时间点后增加一个与前一阶段相同的额外步骤。这可能会将最终不稳定版本推迟至 10 月 14 日或 10 月 21 日，而最终版本则可能推迟至 10 月 19 日或 10 月 26 日。如果此事与您相关，请关注我们的公告 Matrix 频道以获取最新消息。

第三方客户端信息

在 API 冻结之后，我们的 API 应该会保持稳定，但直到 API 锁定阶段之前仍可能有细微变更。现在即可开始测试兼容性并向我们报告问题，同时请留意这些日期以获取最终 API 规范。

贡献者信息

如果您正在为 Jellyfin 贡献代码，但您的功能 PR 错过了截止日期，请不要担心。我们致力于在未来保持这种较短的主版本发布周期，因此 10.11.0 最多还有大约 6 个月就会发布。您的功能最终应该会被纳入。

如果您希望通过提交 bug 修复来提供帮助，请尽快操作，因为我们希望在 API 锁定之前合并并测试尽可能多的修复，以便在发布前至少进行两周的最终测试。请确保在 PR 中明确注明为 bug 修复，并确保您的改动仅限于修复 bug 所需的最小范围。在最终版本发布之前，bug 修复 PR 的目标分支均为 master；发布之后，它们将针对 release-10.10.z 分支，用于后续的点版本发布。

如何参与测试

测试此版本非常简单，与 10.9.0 相同。由于我们的预发布版本在这里"就是"不稳定版本，这意味着您只需遵循常规的"不稳定"版本安装流程即可。

具体操作：访问我们的主服务器下载页面，在顶部中央选择您需要的平台，然后在右上角选择"Unstable"。此时显示的说明和链接将对应不稳定版本。您还可以在文档中找到额外的测试指南。

对于 Docker，这仅意味着拉取镜像的 unstable 标签。对于 Debian 和 Ubuntu 仓库，这意味着在您现有的 jellyfin.sources 条目中添加 unstable。对于其他平台，请查阅提供的说明，因为并非所有平台都支持不稳定版本。

接下来，在安装不稳定版本之前，请确保备份现有服务器配置。由于存在数据库变更，无法原地降级。只需在停止 Jellyfin 服务后，简单复制配置目录即可，具体目录位置取决于平台。

Next, if you use plugins, install the unstable plugin repository. Due to compatibility issues, we distribute plugins for unstable in a separate manifest, so this must be added manually, and on first start all incompatible plugins (i.e. all existing plugins on an upgrade) will be upgraded. To add the repository, navigate to the Administration Dashboard, Advanced, Plugins, then click the Repositories tab at the top. Click the "+" Add button, and enter "Unstable" for the name and "https://repo.jellyfin.org/files/plugin-unstable/manifest.json" for the Repository URL. We also recommend that you disable/remove the Stable repository at this time, as it's possible they will conflict. After the initial update you may need to manually restart your Jellyfin instance one further time to ensure all plugins are activated properly.

最后，安装不稳定版本并运行。升级将在后台无缝完成，之后您即可正常登录Jellyfin实例。请务必在浏览器执行硬刷新（hard refresh），并重启所有客户端应用。

10.10.0正式发布后，您可通过重新安装新稳定版本并切换回稳定插件清单 (URL "https://repo.jellyfin.org/files/plugin/manifest.json") 轻松回退。不稳定版本将在发布后暂停至少两周，为您留出充足切换时间。

如何报告错误

运行不稳定预发布版本时，报告错误至关重要。毕竟如果我们不知道问题存在，就无法着手修复！

首先，遇到错误时请确认您运行的是最新不稳定版本，并尝试复现几次。若无法复现，可能是偶发情况；但若重复出现，请务必报告！

错误可报告至我们的GitHub issues页面或论坛。

报告中除基本描述外，请务必包含两项关键信息：第一，提供主仪表盘显示的"构建版本"（Build Version），这能精确定位您使用的不稳定构建，对排查问题至关重要——尤其当后续不稳定构建出现新错误时。第二，明确说明您运行的是不稳定构建而非稳定版，并注明这是升级安装还是全新安装，这些信息往往具有重要参考价值。

提交报告后，请及时查看是否有额外信息请求，我们将全力争取尽快修复。

感谢您的支持，祝您观影愉快！