分步操作
复制错误日志
在失败任务卡片上点「复制错误」,记录原始提示。
按提示登录
提示需要登录/Cookies 时,到「偏好设置 > 下载 > 账号登录环境检测」用内置浏览器登录抖音或 B站,刷新页面后重新检测。
检查工具组件
提示 ffmpeg 缺失或 yt-dlp 偏旧时,在「偏好设置 > 下载 > 下载环境检测」和「高级 > 工具诊断」中检查、修复、更新。
重试任务
处理完成后在任务卡片点「重试」,任务会重新排队。
预期结果
任务重新进入队列并完成下载;工具诊断面板显示 yt-dlp / ffmpeg / ffprobe 状态正常。
异常与解决
提示「自动安装 yt-dlp 失败」
可能原因:自动下载失败且内置兜底也不可用
解决方法:检查网络后重试,或手动把对应平台的 yt-dlp 放到 tools 目录。
B站提示分离音视频流失败
可能原因:B站返回 DASH 分离流,需要 ffmpeg 合并
解决方法:安装或修复 ffmpeg;如为合集或多分 P,请逐条下载。
抖音任务显示「等待防限流冷却」
可能原因:连续失败较多,软件自动进入冷却
解决方法:等待冷却结束后自动重试,或稍后手动点重试。
YouTube 提示没有可用的 JavaScript runtime
可能原因:yt-dlp 需要 Node.js 或 Deno 解析 YouTube
解决方法:安装 Node.js 或 Deno,或在「高级 > 工具诊断」更新 yt-dlp 后重试。
注意事项
- yt-dlp、ffmpeg、ffprobe 是下载组件,缺失时软件会尝试自动安装;自动失败不代表网络或账号问题,先看工具诊断。
- SunGet 不会自动突破平台登录墙、验证码或付费内容;这类提示按「平台登录限制」处理。