本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
报告问题
本页将介绍如何提交问题（issue），包括 Jellyfin 项目处理问题的策略和流程。
问题（issue）应仅用于详细描述软件错误报告。
所有其他讨论（包括初步故障 排除）应转至我们的帮助渠道。
功能请求
请注意，功能及改进请求应转至我们的 Fider 平台进行跟踪、投票和报告。请将所有功能请求保留在此页面，不要提交到 GitHub 问题中。
搜索与投票
在提交问题前，请先搜索现有问题，确认是否已有类似问题或功能请求被报告过。重复提交会使仓库变得杂乱，请尽量避免。
若找到与您问题匹配或高度相关的问题，请使用 👍 反应（reaction）确认该问题也影响您，或表示支持该功能请求。您也可添加评论描述具体问题场景或功能用例。
若现有问题已关闭，请阅读其中提供的解决方案是否适用于您的情况。如不适用，请留言说明，问题将被重新打开。请注意：由于 PR 先合并到 dev 分支，而正式版本从 master 构建，修复不会立即出现在官方版本中，但会包含在下一版更新。
提交问题
准备好提交问题时，请访问此页面！
报告错误
编写错误报告时，请务必提供尽可能多的相关细节——这对问题排查和分类至关重要。关键信息包括：
-
Jellyfin 安装方式（升级或全新安装）
-
使用的平台和操作系统（如 Debian、Arch、Docker 等）
-
触发问题的操作步骤
-
相关日志输出
-
使用的非标准配置
错误报告应在标题开头添加 [bug] 标签（Jellyfin 团队后续分配正式标签时会移除）。若知晓其他适用的标签，请将其添加在 [bug] 之后以协助分类。
错误应当是可复现的。也就是说，您应能通过故障排除确定如何复现问题。虽然不应忽视偶发性错误，但如果难以或无法复现，修复工作很可能极其困难。请在提交问题前尝试复现错误，并提供能演示问题的最小测试用例。
若需故障排除或提交问题方面的帮助，请联系社区，我们将尽力协助！
问题标签
Jellyfin 提供多种标签辅助问题分类管理。因 GitHub 权限限制，用户无法自行添加这些标签，团队会在分类过程中进行分配。
分类
这些标签表示代码库的受影响范围：
-
backend：主要涉及服务器后端代码的问题 -
build：主要涉及构建过程的问题
严重性
这些标签有助于确定问题的严重程度。
-
regression: 由于最近构建版本中的功能退化而需要立即关注的问题。 -
bug: 影响正常使用功能的代码缺陷。
管理类
这些标签有助于项目管理和发展方向的规划。
-
good first issue: 非常适合新手上手且非常容易完成的任务。 -
help wanted: 当前项目内没有明确专家负责，需要外部协助解决的问题。 -
roadmap: 与项目未来路线图相关的元问题。 -
investigation: 针对代码库的调查类问题。
拉取请求
这些标签仅用于管理拉取请求（PR）的目的。
requires testing: 尚未在真实环境中测试过的PR。任何对后端有重大影响的PR在合并前 都应经过测试，以避免功能退化。