核心用法
Sports Ticker 是一款基于免费 ESPN API 的跨平台体育比分追踪工具，主打"零配置成本、多源整合"的体验。首次运行通过交互式向导完成：选择运动项目 → 指定球队 → 设置告警偏好（实时/终场/每日摘要）→ 配置免打扰时段。所有设置持久化到本地 config.json，支持随时重新配置。
主要功能矩阵
| 功能 | 命令示例 | 说明 |
|------|---------|------|
| 交互式配置 | `python3 scripts/setup.py` | 5 步向导完成初始化 |
| 球队搜索 | `setup.py find "Lakers" basketball` | 模糊匹配获取 ESPN ID |
| 实时比分 | `python3 scripts/ticker.py` | 多球队聚合展示 |
| 联赛看板 | `ticker.py league nba basketball` | 全联盟实时积分榜 |
| 赛程预览 | `schedule.py --days 30 --json` | 未来 14-30 天赛程，支持 JSON 输出 |
| 自动化 cron | `auto_setup_crons.py` | 按比赛日自动生成定时任务（v3 新增）|
| ESPN 原生接口 | `espn.py scoreboard/search` | 底层 API 直接调用 |
告警类型
涵盖赛事全生命周期：开球提醒、实时得分（进球/达阵/三分/本垒打）、红黄牌/驱逐、中场休息、终场结果，并支持赛前 30 分钟提醒与夜间静音模式。
---
显著优点
1. 零 API 成本：直接调用 ESPN 公开端点，无需注册、无调用限额焦虑，对业余开发者极度友好。
2. 多维度覆盖：单工具整合足球（30+ 联赛）、NFL、NBA、WNBA、NHL、MLB、F1，避免为不同运动安装多个 App。
3. 自动化友好：v3 新增的 auto_setup_crons.py 可将赛程转化为系统级定时任务，适合服务器/树莓派长期挂机。
4. 输出格式灵活：除终端表格外，支持 --json 与 --compact 模式，易于对接下游自动化流程或消息推送（如企业微信/钉钉机器人）。
5. 本地化配置：球队 emoji、告警偏好、静音时段均本地持久化，隐私数据不出境。
---
潜在缺点与局限性
1. 数据源单一性：完全依赖 ESPN API，若 ESPN 调整接口或增加反爬策略，工具可能瞬间失效；无备用数据源（如 Sportradar、Opta）作为 fallback。
2. 地域覆盖盲区：对 ESPN 权重较低的联赛（如中超、J1 部分场次、非欧洲主流足球联赛）支持可能不完整或延迟较高。
3. 实时性天花板：免费 API 通常有 15-30 秒延迟，不适合高频套利或博彩场景；无 WebSocket 推送，依赖轮询（cron/script 触发）。
4. 告警触达局限：仅生成终端输出或 cron 命令，需用户自行对接通知渠道（邮件/短信/推送），对非技术用户有额外门槛。
5. 长期维护风险：ESPN 公开 API 无 SLA，随时可能变更或关闭；项目若停止维护，配置迁移成本较高（ ESPN ID 体系与其他平台不互通）。
---
适合人群
- 技术型体育迷：希望通过脚本/自动化追踪多球队，厌倦商业 App 广告与推送骚扰。
- 服务器/Homelab 玩家：利用 cron + 机器人钩子实现"静默监控"，整合到个人仪表盘。
- 开发者/数据分析师：需要结构化体育数据（JSON）进行下游分析，但不愿承担商业 API 费用。
- 多球队/跨联赛球迷：同时关注英超某队 + NBA 某队 + NFL 某队的"跨界"用户，商业 App 通常需要多 App 切换。
---
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 服务中断 | ESPN API 突发关闭或限流 | 设置监控脚本检测 `ticker.py` 返回码，异常时切换至备用信息源 |
| 数据漂移 | 球队更名、联赛改制导致 ESPN ID 失效 | 每年重新运行 `setup.py --force` 校验配置有效性 |
| 自动化误报 | cron 任务堆积导致服务器资源耗尽 | `auto_setup_crons.py` 生成任务时添加互斥锁（flock）|
| 隐私泄露 | config.json 含个人偏好，误提交至 Git | 将配置路径移至 `~/.config/sports-ticker/` 并加入 `.gitignore` |