上报问题前要准备哪些信息

开源项目的修复速度取决于报告质量——一份「放不出来啊」帮不上任何人，一份可复现的报告可能当天就有回应。它的社区文档把报告要求写得非常细，这里整理成通用清单。

报告前的三个动作

对照最新版本：确认问题在最新稳定版仍存在（更新渠道见四个更新渠道哪个更适合日常追新）；
复现一次并记录：出错时间、受影响的地址或搜索词、所选的 YouTube 提取端点；
对准一个分支：WebView、播放、搜索、下载是不同的代码路径，一个症状一份报告，别把 WebView、播放、搜索三个问题塞进同一个报告——哪怕它们同时出现。

最小播放报告模板

社区文档给的播放问题报告骨架，逐项填空：

视频地址与服务：
应用版本 / 安卓版本：
失败前后各选的端点：
登录还是未登录：
网络所在地区 / VPN 或代理状态：
视频类型与所选画质/编码：
Private DNS / 拦截工具状态与被拦域名（如有）：
失败发生的时点（开头 / 某时间点 / 拖动 / 切画质 / 回到应用）：
确切的可见提示与应用生成的报告：
单变量重试与结果：

下载问题有对应的模板（失败阶段、存储余量等），见下载到一半失败或文件不完整怎么办。

各分支的证据重点

WebView：带上确切的报错原文，别概括；
播放：端点记录前后值、登录与否、一次只改一个变量的对照结果；
机器人验证：网络出口地区、失败是立即还是几条之后、同视频跨网络的对照；
账号与 Cookie：说清服务名、清的是 reCAPTCHA cookie 还是 WebView cookies、有没有确认弹窗；
订阅与列表：频道页里有没有那条更新、feed 模式、刷新是否改变结果。

安全红线

以下内容永远不要放进任何公开报告：Cookie、令牌、账号邮箱、登录过程录屏、完整订阅导出、完整数据库备份。「已登录 / 未登录」加上可见报错就是报告需要的全部账号信息。

报好问题等修复的同时，关注发布页的版本动态即可（最近的变化见最近三个版本更新了哪些值得升级的功能）。