v2.2.0：新增日期筛选

本次版本更新适配 PC 端 4.1.13.8，并对任务调度、主页窗口操作、日期筛选和采集流程等进行了更新。

主要更新

任务调度

• 引入 Huey 任务调度框架，用于管理文章详情获取、评论采集、离线缓存、初始内容存储和窗口读取诊断等后台任务。
• 使用任务队列统一提交、执行、状态记录和停止流程，减少长流程任务之间的阻塞和状态混乱。
• 窗口读取诊断等任务支持独立任务 ID、运行状态、执行日志和结果记录，便于排查主页识别问题。
• 优化任务结束后的资源释放流程，降低后台任务退出后仍占用队列文件或运行资源的风险。

UIA 树识别修复

• 修复新版主页结构下，文章卡片识别不稳定的问题。
• 优化 UIA tree 读取方式：先通过 BFS 对控件树进行快照，再结合 DFS 处理文章卡片。
• 改进文章卡片和点击坐标的绑定逻辑，减少跨卡片误合并、重复识别、误识别等问题。
• 增强图片类文章、标题弱暴露文章和滚动过渡状态下的候选过滤逻辑，避免把无效控件误当作文章处理。

日期筛选

• 新增主页文章日期筛选功能。
• 支持四种筛选方式：
  • 不限日期
  • 指定日期范围
  • 截止日期
  • 起始日期
• 前端任务配置区新增日期筛选入口和日期选择控件，任务启动时会将日期筛选条件传递给后端。
• 当主页文章按日期倒序展示时，可根据日期条件自动跳过、采集或提前停止，提高指定时间范围采集的效率。

修复问题

• 修复新版主页 UIA 结构变化后，单纯 BFS 遍历容易导致文章卡片识别时间过长的问题。
• 修复部分文章标题、日期和阅读指标绑定不准确的问题。
• 修复滚动过渡状态下可能识别到残缺文章卡片的问题。
• 修复日期筛选条件缺失或格式不正确时任务行为不明确的问题。
• 修复窗口读取诊断任务运行状态、停止状态和结果记录不够清晰的问题。

兼容性说明

本版本基于 PC 端 4.1.13.8 进行适配。其他版本的 UIA 控件结构可能存在差异，若出现文章无法识别、识别数量异常或点击位置不准确，建议优先切换到该版本后再运行。

升级注意

• 本版本新增 Huey 依赖，建议重新同步 Python 环境。
• 如从较早版本升级，建议执行一次完整环境同步后再启动程序。
• v2 系列当前主要面向 Windows 10 / 11 桌面环境使用。

安装方式

完整安装说明请看：

• 安装说明
• 功能说明

基础启动流程：

uv sync
uv run python main.py