下载历史与日志排查错误时的关键信息

Downloads 页面是什么

底部导航栏第三个 Tab（Downloads 图标）是下载历史——所有已完成、已取消、已出错的条目都在这里（除了开了 Incognito 的隐身下载）。每条显示标题、类型（视频/音频/命令）、状态、保存位置。

日志有什么用

点开任意一条条目 → 顶部有个文件图标，点进去就是这条下载的完整日志——YTDLnis 实时记录的 yt-dlp 输出，包括：

• 请求了哪些 URL
• 选了什么格式
• 用了哪些参数
• ffmpeg 处理过程中的输出
• 最终错误信息（如果失败了）

排查下载问题时日志是第一参考——官方 Troubleshooting 文档也要求先看日志再提交 Bug。

日志常见模式

模式一：Extractor 错误

ERROR: youtube: Failed to extract <视频ID>

最常见原因：yt-dlp 版本太旧，YouTube 刚改了提取逻辑。第一件事是更新 yt-dlp（设置 → Updating），90% 的情况搞定。

模式二：403 / 需要登录

ERROR: HTTP Error 403: Forbidden

需要 Cookies。目标网站要求登录才能访问内容，在 Cookies 页面创建对应域名的 Cookie 并打开主开关。

模式三：格式不可用

ERROR: Requested format is not available

你选的格式 ID 当前视频不提供（比如某视频没有 4K 格式、或者 Premium 格式需要 Cookie）。回去换个格式重新下。

模式四：ffmpeg 错误

ERROR: ffmpeg version <版本号>

FFmpeg 版本太旧或缺少组件。去 Packages 页面升级 FFmpeg。

历史里批量操作

Downloads 页面也支持长按多选模式。批量操作包括：

• Delete：从历史记录里删掉（不删实际下载文件）
• Redownload：批量重新下载选中的条目
• Share URLs：把链接批量分享出去
• Copy URLs：批量复制到剪贴板

批量重新下载在 Changelogs（v1.9.0）里是新功能——之前只能手动逐条下，现在一键搞定。

清理策略

历史记录默认不自动清理，会越积越多。你可以：

• 手动多选删除
• 在「更多 → 设置 → Downloads → Auto cleanup old items」里打开自动清理（按天数或条数）
• 注意：清理历史不会删实际下载的文件，只是删记录。想连文件一起删需要手动去文件管理器处理。