故障排除

先记录应用版本、操作系统、出现问题的功能区、操作步骤和错误提示。重试前确认不会重复创建同一批任务。

快速检查

1. 在 设置 → 关于 确认应用版本。
2. 在 设置 → 下载 校验 yt-dlp、FFmpeg 与 Bun。
3. 在 设置 → 网络 检查代理。
4. 需要账号时，在 资源库 → 应用会话 验证登录。
5. 回到出错页面刷新或重新创建任务。

按症状处理

症状	优先检查
下载或转码的开始按钮不可用	下载检查 yt-dlp 与 FFmpeg；转码检查 FFmpeg。
链接无法解析	链接完整性、账号权限、yt-dlp 与网络；必要时改用嗅探。
下载速度慢或频繁失败	降低下载并发；HLS 或 m3u8 再降低分片并发。
转码失败	校验 FFmpeg，确认输入文件可访问且格式受支持。
嗅探浏览器打不开	重新打开“新建嗅探”以再次检测；Chrome “浏览器默认”还应检查远程调试与连接授权。
嗅探没有资源	点击播放、滚动页面、扩大嗅探范围或重新打开会话。
YouTube /音乐要求登录	验证或重新连接 YouTube 应用会话。
在线页面一直加载	检查代理、目标服务状态与账号地区。
RSS 不更新	手动刷新订阅，检查来源地址和网络。
本地音乐无法播放	检查文件是否被移动、删除或位于离线磁盘。
资源库项目标为缺失	挂载磁盘后重新检查，或重新导入现有文件。

查看日志

在 设置 → 常规 打开日志目录。复现一次问题后，找到对应时间附近的记录。

日志可能包含本地路径、站点地址或错误上下文。提交前请删除或遮盖这些信息。不要上传应用会话、配对链接、令牌或完整资源库数据库。

仍未解决

前往 GitHub Issues，提供：

• 下蛋版本与系统版本。
• 出问题的功能区和页面。
• 可以稳定复现的步骤。
• 脱敏后的错误提示或日志片段。
• 不含账号、私人内容和本地路径的截图。