Tube Archivist 下载队列添加失败问题分析与解决方案

问题描述

在使用Tube Archivist时，当用户尝试将视频添加到下载队列时，如果系统中配置了cookies，则会出现添加失败的情况。而如果系统中没有cookies配置，视频则可以正常添加到队列并下载。值得注意的是，这个问题不仅影响年龄限制视频，也影响普通视频的下载。

问题表现

当用户通过浏览器扩展或手动方式添加cookies到Tube Archivist后，尝试将任何视频（包括非年龄限制视频）添加到下载队列时，系统会报错并无法完成添加操作。错误信息显示为"Requested format is not available"（请求的格式不可用）。

错误分析

从日志信息可以看出，系统在尝试获取视频信息时遇到了格式识别问题。具体表现为：

1. 多次尝试提取视频格式信息失败
2. 最终报告只有图片格式可用下载
3. 错误提示请求的格式不可用

这些问题表明yt-dlp（Tube Archivist使用的下载后端）在解析视频信息时遇到了障碍，特别是在有cookies存在的情况下。

解决方案

经过技术分析，这个问题通常是由于yt-dlp版本过旧导致的。Tube Archivist项目维护者提供了以下解决方案：

1. 手动更新yt-dlp版本
2. 进入Tube Archivist容器环境
3. 执行特定的更新命令

更新后，系统应该能够正确处理带有cookies的视频下载请求，包括年龄限制内容。

技术背景

这个问题揭示了Tube Archivist与YouTube交互机制的一个重要方面：当使用cookies进行身份验证时，YouTube可能会返回不同的视频格式信息。较旧版本的yt-dlp可能无法正确处理这些变化，导致格式识别失败。

最佳实践建议

1. 定期检查并更新Tube Archivist及其依赖组件
2. 在添加cookies后，先测试一个普通视频的下载功能
3. 关注项目文档中关于yt-dlp版本兼容性的说明
4. 遇到类似问题时，首先考虑组件更新而非复杂配置调整

通过保持系统组件的最新状态，用户可以确保Tube Archivist能够处理各种视频下载场景，包括需要身份验证的内容。