核心用法
CPBL Skill 是专为台湾棒球爱好者设计的中华职棒数据查询工具，支援一军例行赛、总冠军赛、二军、热身赛、明星赛等多种赛事类型。用户可通过指令查询即时比分、赛程安排、球队战绩排名、球员打击/投球数据，以及历年奖项与历史纪录。
主要功能模块
- 即时比分 (
cpbl_live.py)：查询今日赛况或指定日期赛事，自动侦测延赛 - 赛程查询 (
cpbl_schedule.py)：支援月份筛选、全年度赛程，含缓存机制 - 战绩排名 (
cpbl_standings.py)：即时球队排名与胜率统计 - 球员数据 (
cpbl_stats.py)：打击、投球排行榜，可筛选年度与名次 - 历史查询：整合台湾棒球维基馆资料，查询MVP、新人王、球员生涯纪录
显著优点
1. 数据源多元：优先采用官方站点数据，辅以台湾棒球维基馆补完历史资料缺口
2. 赛事类型完整：涵盖一军、二军、热身赛、明星赛、总冠军赛及国际交流赛
3. 智能缓存机制：赛程资料自动缓存，减少重复查询负担
4. 延赛自动侦测：通过比分与投手资料判断赛事状态
潜在缺点与局限性
- 即时数据采用轮询机制，非即时推播，可能存在数分钟延迟
- 部分官方端点回传HTML片段而非标准JSON，解析稳定性受限
- 战绩与赛程功能依赖AJAX与CSRF机制，偶有脆弱性
- 历史资料若官方未收录，需人工确认维基馆资料正确性
适合人群
- 中华职棒球迷、运动记者、数据分析师、Fantasy Baseball玩家
- 需要快速查询赛程、战績、球员表现的一般观众
常规风险
- 数据源延迟或异常时可能回传部分资料，需人工判断完整性
- 官方站点结构变更可能导致脚本失效
- 维基馆资料为社群编辑，权威性需交叉验证