核心功能与用法
Baseball技能是一个命令行工具，通过调用MLB官方Stats API提供全面的美国职业棒球大联盟数据服务。核心功能涵盖四大模块：赛程查询（games）、实时赛况（live）、比分详情（score）和球员数据（player/stats）。
典型工作流：
- 每日赛程：
python baseball.py games默认展示当日所有比赛，支持--date指定历史日期、--days 7查看未来一周、--team PHI筛选特定球队 - 实时追踪：
python baseball.py live PHI动态显示当前局数、球数、跑垒状态、打者/投手对决及最新play描述，更新频率建议≥15秒 - 历史回溯：
python baseball.py score 718415通过Game PK或球队缩写+日期查询任意比赛的完整line score - 球员分析：
python baseball.py player Judge模糊搜索活跃球员，获取ID后调用stats查看详细打击/投球数据，支持--season跨赛季对比
输出支持text（表格化终端友好）和JSON（结构化数据）两种格式，适合脚本自动化。
显著优点
1. 官方数据源：直接对接MLB Stats API，数据权威性高，无第三方中转延迟
2. 零认证门槛：无需注册API key，开箱即用，降低开发者接入成本
3. 语义化查询：支持球队昵称（"Phillies"）、球员姓名模糊匹配，交互自然
4. 跨时间维度：覆盖实时、历史、未来赛程， offseason可通过 --season 回溯历年数据
5. 轻量化部署：纯Python脚本依赖，无复杂运行时要求
潜在局限与风险
功能局限：
- 仅覆盖MLB大联盟，不含小联盟（MiLB）、春训或国际赛事数据
- 球员搜索仅限"active"名单，退役球员需通过Game PK间接查询历史box score
- 无赔率、伤病报告、交易流言等衍生数据
使用风险：
- 速率限制：文档明确警示高频请求（<15秒间隔、批量爬取）可能导致IP封禁
- 稳定性依赖：MLB API为免费开放服务，无SLA保障，赛季外或重大事件时可能调整端点
- 时区处理：
start_time为ISO 8601格式含时区偏移，需客户端自行转换 - offseason衰减：实时功能在休赛期失效，需依赖
--season参数切换至历史数据模式
适用人群
- 棒球数据分析师与fantasy sports玩家
- 体育媒体/播客作者需快速获取结构化比赛数据
- 开发者构建MLB相关自动化工具（如Discord/Telegram比分机器人）
- 海外球迷需追踪特定球队赛程与战绩