如何为yt-dlp的--download-archive条目添加注释？

yt-dlp对下载存档文件的解析逻辑很严格：它只会识别每行开头的youtube <视频句柄/ID>格式内容，如果直接在条目行里加第三列注释（不管带不带#），会被当成条目的一部分，导致无法匹配视频ID，这条排除规则就会失效，对应视频仍然会被下载。

下面是两种可行的注释方式：

方式一：单独一行写注释（推荐） #

在需要注释的条目上方，单独写一行以#开头的注释，yt-dlp会自动忽略所有#开头的行。示例存档文件：

# 排除该视频：属于授权内容，禁止下载
youtube urlhandle1
# 排除该视频：已手动下载并保存，无需重复抓取
youtube urlhandle2

# Usage is like `yt-dlp https://www.youtube.com/somepath  --download-archive DOWNLOAD_ARCHIVE_FILE1`

方式二：行尾加注释（需配合命令参数） #

yt-dlp提供了--archive-comment参数，允许在条目行尾用//添加注释。使用时必须在调用命令里加上这个参数：

yt-dlp https://www.youtube.com/somepath --download-archive DOWNLOAD_ARCHIVE_FILE1 --archive-comment

对应的存档文件写法：

youtube urlhandle1 // 排除原因：授权内容，不能下载
youtube urlhandle2 // 排除原因：已手动保存，重复内容无需下载

# Usage is like `yt-dlp https://www.youtube.com/somepath  --download-archive DOWNLOAD_ARCHIVE_FILE1 --archive-comment`

⚠️ 注意：如果不添加--archive-comment参数，行尾的//和注释会被视为条目内容的一部分，导致规则失效，所以必须配合参数使用。

内容的提问来源于stack exchange，提问作者Nikita Fedyashev