ching/dota2-match-calendar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
dota2-match-calendar/CHANGELOG.md
Ching L 2b813c1ece 修复TBD事件重复问题 v4.1 
- 修复TBD事件匹配逻辑，支持部分TBD事件更新
- 增强TBD事件清理，删除所有同时间的TBD事件
- 防止创建重复事件，确保TBD被更新而非新建

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-13 09:51:12 +08:00

10 KiB
Raw Blame History

Changelog

v4.1 - 2025-09-13 - 修复TBD事件重复问题

  • 🐛 修复TBD事件匹配逻辑：
    • 修复了 find_existing_event() 方法中的TBD匹配逻辑
    • 原问题：只匹配 "TBD_TBD" 事件键，不匹配 "TBD_NGX" 或 "PV_TBD" 等部分TBD事件
    • 现在可以正确识别并更新所有包含TBD的事件（"TBD vs Team" 和 "Team vs TBD"）
    • 防止创建重复事件，确保TBD事件被更新而非创建新事件
  • 🔧 增强TBD事件清理：
    • 修复了 clean_duplicate_and_expired_events() 方法的清理逻辑
    • 原问题：只删除 "TBD vs TBD" 格式的事件，导致部分TBD事件无法被清理
    • 现在删除所有与确认比赛同时间的TBD事件，不再限于特定格式
    • 成功清理了9月13日的3个重复TBD事件
  • 🎯 问题根源分析：
    • 发现问题：同一时间存在 "TBD vs NGX" 和 "XG vs NGX" 重复事件
    • 根本原因：TBD事件没有被正确更新，而是创建了新的确认事件
    • 解决方案：改进事件匹配算法，支持部分TBD匹配和时间窗口匹配

v4.0 - 2025-09-12 - 代码结构重构与错误处理优化

  • 🏗️ 代码结构重构：
    • 使用 @dataclass 替代字典存储比赛数据，提高类型安全性
    • 拆分大函数 sync_matches_to_calendar() 为多个专门的方法
    • 新增 process_upcoming_matches() 处理即将进行的比赛
    • 新增 process_completed_matches() 处理已完成的比赛
    • 新增 clean_duplicate_and_expired_events() 清理重复和过期事件
    • 提取 find_existing_event() 统一事件查找逻辑
  • 🔄 增强错误处理：
    • 实现 retry_on_exception 装饰器，提供指数退避重试机制
    • 所有网络请求（Liquipedia 和 Google Calendar API）都支持自动重试
    • 单个比赛处理失败不影响整体同步流程（优雅降级）
  • 📝 专业日志系统：
    • 使用 Python logging 模块替代 print 语句
    • 支持多级别日志（DEBUG, INFO, WARNING, ERROR）
    • 添加时间戳和详细的异常堆栈信息
    • 支持通过命令行参数调整日志级别
  • ⚡ 性能和可维护性：
    • 提取重复代码为独立方法（_extract_score(), _extract_format(), _extract_tournament()）
    • 改进的错误报告和调试信息
    • 更好的代码组织和模块化设计

v3.9 - 2025-09-12 - 增强TBD事件清理功能

  • 自动删除已结束的TBD事件：
    • 检查事件的结束时间，如果已过且仍包含TBD则自动删除
    • 避免日历中保留已过期但未更新的TBD占位符
    • 例如：删除已结束的 "BB vs TBD"、"Tidebd vs TBD" 等事件
  • 智能删除TBD vs TBD占位符：
    • 当同一时间段（30分钟窗口）存在确认的比赛时，自动删除TBD vs TBD事件
    • 解决了TBD vs TBD与确认比赛重复的问题
    • 例如：9月11日的多个TBD vs TBD事件被正确清理
  • 改进的事件分组逻辑：
    • 按30分钟时间窗口分组事件，更准确地识别同时间的比赛
    • 优化了TBD事件与确认比赛的匹配算法

v3.8 - 2025-09-08 - 修复重复比分显示问题

  • 修复标题中重复比分的问题：
    • 修复了在更新比赛比分时可能出现重复比分的bug（如 "0-2 0-1"）
    • 改进了 update_event_with_score 方法，使用更强的正则表达式清理多个比分
    • 改进了 update_event_with_result 方法，先清理所有旧比分再添加最终比分
  • 增强比分更新逻辑：
    • 进行中比分更新时会正确移除之前的所有比分
    • 完成比赛更新时会先清理进行中的比分，再添加最终结果
    • 确保标题中始终只显示一个比分

v3.7 - 2025-09-08 - 增强重复事件处理和TBD管理

  • 改进TBD比赛ID生成：
    • TBD vs TBD比赛现在使用时间戳生成唯一ID，避免重复创建
    • 普通比赛继续使用队伍+锦标赛组合生成ID
  • 自动删除被取代的TBD事件：
    • 当同一时间段存在确定的比赛时，自动删除对应的TBD占位符
    • 例如：XG vs Tundra确定后，自动删除XG vs TBD事件
    • 使用30分钟时间窗口匹配相近时间的事件
  • 重复比赛清理功能：
    • 自动检测同一天同队伍的重复比赛
    • 优先保留已完成的比赛，删除未完成的重复事件
    • 修复了NGX vs Liquid等比赛的重复问题
  • 增强的重复事件检测：
    • 按30分钟时间窗口分组事件
    • 自动删除同时间的重复TBD事件
    • 改进了过期TBD事件的清理逻辑
  • 改进TBD事件更新逻辑：
    • 只在队伍确定时才尝试更新TBD事件（避免TBD vs TBD互相匹配）
    • 保持1小时的时间窗口用于TBD事件匹配

v3.6 - 改进TBD比赛处理机制

  • 放宽TBD比赛时间匹配条件：
    • 将TBD事件匹配的时间窗口从5分钟扩大到1小时
    • 更好地处理比赛时间调整的情况
    • 添加时间差异显示，方便调试
  • 自动删除过期TBD事件：
    • 新增 delete_calendar_event() 方法
    • 自动检测并删除超过2小时的过期TBD事件
    • 避免日历中积累无效的占位事件
  • 增强的TBD事件管理：
    • 跟踪已更新的TBD事件，避免误删
    • 在同步摘要中显示删除的TBD事件数量

v3.5 - 修复TBD比赛标记问题

  • 修复TBD比赛错误标记为完成：
    • 修改比分解析逻辑，只匹配破折号而不匹配冒号
    • 避免将时间(19:00)误识别为比分
    • 添加日期格式检查，防止误识别
  • TBD比赛保护机制：
    • 确保TBD vs TBD的比赛永远不会被标记为有比分或已完成
    • 如果错误解析了TBD比赛的比分，会自动删除
    • 增强比分验证逻辑

v3.4 - 修复重复事件问题

  • 修复进行中比赛更新创建重复的问题：
    • 改进事件匹配逻辑，增强基于队伍名称的查找
    • 即使比分变化也能正确识别同一场比赛
    • 避免在比分更新时（如从 1-0 到 1-1）创建新事件
  • 新增重复事件清理工具：
    • 添加 cleanup_duplicates.py 用于查找和删除重复事件
    • 添加 delete_duplicates.py 用于手动清理特定重复
  • 增强的事件查找机制：
    • 不仅通过 ID 查找，还通过 team+tournament 组合查找
    • 支持忽略比分差异的模糊匹配
    • 改进对时间变更和 TBD 更新的处理

v3.3 - 支持进行中比赛的实时比分

  • 使用 BeautifulSoup 解析 HTML 结构：
    • 重写了 _parse_match 方法，使用 DOM 结构而非正则表达式
    • 准确提取队名、比分、赛制和锦标赛信息
    • 解决了 "Aurora1:0(Bo3)YkBros" 格式的解析问题
  • 区分系列赛进行中和已完成状态：
    • 新增 has_score 标记，表示比赛是否有比分
    • Bo3 需要 2 胜才标记为完成，Bo5 需要 3 胜
    • 进行中的比赛显示当前比分（如 1-0），但不显示✓标记
  • 新增进行中比分更新功能：
    • 添加 update_event_with_score 方法处理进行中比赛
    • 在日历标题显示实时比分（如 "1-0 Team1 vs Team2"）
    • 在描述中添加 "📊 CURRENT SCORE" 标记
  • 扩展处理时间范围：
    • 处理最近 12 小时内的比赛，捕获正在进行的比赛
    • 确保进行中的比赛比分能及时同步

v3.2.1 - 修复比分识别问题

  • 修复错误的比分解析：
    • 修复了将日期时间误识别为比分的问题（如 "19-00"）
    • 改进比分识别逻辑，只在包含 "vs" 的上下文中查找比分
    • 添加比分范围验证（0-5），排除不合理的数值
    • 增强时间模式识别，避免将时间戳识别为比分

v3.2 - TBD 比赛优化

  • 智能去重机制：
    • 相同时间、相同轮次的多个 TBD 比赛只保留一个代表
    • 避免日历中出现大量重复的 TBD 条目
  • TBD 比赛自动更新：
    • 当 TBD 比赛的队伍确定后，自动更新对应的日历事件
    • 通过时间和锦标赛信息智能匹配 TBD 事件
    • 新增 update_event_with_teams 方法专门处理队伍更新
  • 改进的事件匹配逻辑：
    • 三层匹配机制：ID 匹配 → 队伍+锦标赛匹配 → 时间+锦标赛匹配
    • 确保 TBD 比赛更新后仍能正确跟踪

v3.1 - 格式优化更新

  • 新的标题格式:
    • 之前: Dota 2 - The International 2025: Team1 vs Team2
    • 现在: Team1 vs Team2 [The International 2025]
  • 简化的完成标记:
    • 之前: [COMPLETED] Dota 2 - Tournament: Team1 vs Team2
    • 现在: ✓ 2-0 Team1 vs Team2 [Tournament]
  • 移除了 "Dota 2" 字样，让日历更简洁
  • 比分紧跟在✓后面，更加紧凑

v3.0 - 时间变更检测

  • 新增比赛时间变更自动检测
  • 当赛程调整时自动更新日历
  • 支持 --no-time-updates 参数跳过时间更新

v2.0 - 比赛结果更新

  • 自动获取已完成比赛的结果
  • 更新日历事件显示比分和获胜队伍
  • 支持 --no-results 参数跳过结果更新

v1.0 - 基础同步

  • 从 Liquipedia 获取 Tier 1 比赛
  • 同步到 Google Calendar
  • 避免重复添加
  • 支持 dry-run 模式

功能对比

版本 同步比赛 更新结果 时间变更 新格式 TBD优化 实时比分
v1.0 ✓ ✗ ✗ ✗ ✗ ✗
v2.0 ✓ ✓ ✗ ✗ ✗ ✗
v3.0 ✓ ✓ ✓ ✗ ✗ ✗
v3.1 ✓ ✓ ✓ ✓ ✗ ✗
v3.2 ✓ ✓ ✓ ✓ ✓ ✗
v3.3 ✓ ✓ ✓ ✓ ✓ ✓
v3.4 ✓ ✓ ✓ ✓ ✓ ✓
v3.5 ✓ ✓ ✓ ✓ ✓ ✓
v3.6 ✓ ✓ ✓ ✓ ✓ ✓
v3.7 ✓ ✓ ✓ ✓ ✓ ✓
v3.8 ✓ ✓ ✓ ✓ ✓ ✓
v3.9 ✓ ✓ ✓ ✓ ✓+ ✓
v4.0 ✓ ✓ ✓ ✓ ✓+ ✓
v4.1 ✓ ✓ ✓ ✓ ✓++ ✓

使用建议

推荐使用最新的 v4.1 版本，它修复了TBD事件重复问题并提供更好的错误处理：

python sync_dota2_matches.py --calendar-id "YOUR_CALENDAR_ID"

调试模式：

python sync_dota2_matches.py --calendar-id "YOUR_CALENDAR_ID" --log-level DEBUG