核心用法
CPBL Skill 是专为台湾中华职棒设计的综合数据查询系统，整合官方站点 API 与维基馆历史资料，涵盖以下核心功能：
即时赛事：通过 cpbl_live.py 获取今日赛况、指定日期比分，支援队伍筛选与文字/JSON 双输出格式。 赛程管理：cpbl_schedule.py 查询月度赛程，搭配记忆体快取机制（memory/cpbl_schedule_YYYY.md）避免重复调用。 战绩排名：cpbl_standings.py 即时呈现一军例行赛、二军、热身赛、总冠军赛等多层级排名。 球员统计：cpbl_stats.py 提供打击/投球排行榜，支援年度筛选与 TOP N 查询。 历史资料：自动衔接「台湾棒球维基馆」补足官方未公开的 MVP、新人王、球员生涯纪录等深度内容。
显著优点
1. 多源整合：官方即时数据 + 维基馆历史档案 + 新闻搜索三轨并行，覆盖从「现在发生」到「三十年前」的完整时间轴。 2. 赛事类型完整：内建 9 种赛事代码（A-H、X），例行赛、明星赛、总冠军赛、二军、未来之星邀请赛、国际交流赛一网打尽。 3. 延赛智能侦测：Live 脚本自动识别 0:0 且无胜败投手的比赛，标注为延赛状态。 4. 弹性输出：指令列支援 --output text/json，便于直接阅读或程式串接。
潜在缺点与局限性
- 延迟性：即时比分采轮询非推播，API 可能落后实际赛况数分钟。 - 格式不稳定：官方部分端点回传 HTML 片段而非 JSON，需额外解析。 - standings 脆弱性：战绩与赛程流程依赖 AJAX + CSRF，结构变动易导致失效。 - 缺赛常态：周一通常无赛事（除非补赛或国定假日调整），易产生「今日无数据」的预期落差。 - 历史缺口：1990 年代早期部分球员数据、年度奖项细节需依赖维基馆，存在资料完整性风险。
适合人群
- 需要即时追踪中华职棒赛事的球迷与运动记者 - 进行球队战绩、球员数据分析的部落客、数据工作者 - 研究台湾棒球历史的学术或文化工作者 - 开发棒球相关应用、需要结构化赛事资料的工程师
常规风险
- 资料延迟决策风险：依赖即时比分进行博彩或交易决策可能因数分钟延迟导致误判。 - API 变动风险：官方站点结构改版可能导致脚本失效，需持续维护。 - 维基馆版权与准确性：历史资料取自社群编辑的维基馆，存在事实误差或授权灰色地带。 - 个人资料边界：虽未直接处理球员个资，但若未来扩展至球员联络方式或私下资讯，需符合个资法规范。