BilibiliDown项目中的日期条件配置问题解析

BilibiliDown项目中的日期条件配置问题解析

BilibiliDown (GUI-多平台支持) B站 哔哩哔哩 视频下载器。支持稍后再看、收藏夹、UP主视频批量下载|Bilibili Video Downloader 😳 项目地址: https://gitcode.com/gh_mirrors/bi/BilibiliDown

问题背景

在使用BilibiliDown工具进行批量下载UP主视频时，用户希望通过配置日期条件来精确控制下载范围。具体需求是只下载2024年6月1日之后发布的视频。然而在实际操作中发现，配置的日期条件并未按预期生效，反而下载了不符合条件的视频。

日期条件配置原理

BilibiliDown提供了灵活的配置选项来控制视频下载行为，其中关键的两个配置项是：

1. stop.condition：定义停止查询视频列表的条件
2. download.condition：定义哪些视频应该被下载

关于日期条件的比较逻辑：

• 时间比较基于时间戳概念，越早的时间数值越小
• 格式应为"YYYY-MM-DD"或"YYYY-MM-DD HH:mm:ss"
• 条件表达式支持>、<、>=、<=等比较运算符

常见配置误区

1. 条件方向混淆：用户经常混淆"大于"和"小于"的时间含义。例如，想下载6月1日之后的视频，应该使用cTime>2024-06-01而非cTime<2024-06-01

2. 条件位置错误：应该将日期条件放在download.condition而非stop.condition中，除非确实需要用它来停止查询

3. 格式错误：不正确的格式如_:cTime>2024-06-01会导致条件解析失败

正确配置示例

要实现"下载2024年6月1日之后发布的视频"，推荐配置如下：

[url:https://space.bilibili.com/UP主ID]
start.page = 1
download.condition = cTime>2024-06-01
stop.condition = page:30  # 作为安全限制，防止无限查询
stop.alert = false

技术细节说明

1. 查询顺序：BilibiliDown默认按发布时间倒序查询UP主视频，最新的视频最先被获取

2. 条件组合：多个条件之间可以用逗号分隔表示"与"关系，用多行表示"或"关系

3. 时间解析：早期版本存在时间解析bug，会将"2024-06-01"错误解析为"2023-12-31"，这已在最新版本修复

最佳实践建议

1. 总是为查询设置一个页数限制作为安全措施
2. 测试配置时先用小范围数据验证条件是否生效
3. 结合_!downloaded条件可以避免重复下载已存在的视频
4. 对于大批量下载，考虑分时间段多次执行以降低失败风险

通过理解这些配置原理和注意事项，用户可以更精准地控制BilibiliDown的下载行为，实现各种复杂的视频筛选需求。

BilibiliDown (GUI-多平台支持) B站 哔哩哔哩 视频下载器。支持稍后再看、收藏夹、UP主视频批量下载|Bilibili Video Downloader 😳 项目地址: https://gitcode.com/gh_mirrors/bi/BilibiliDown