足球盘口情报站-Python

## 足球盘口情报站

项目描述
面向世界杯等主流赛事的足球盘口情报与预测系统。通过持续抓取全球博彩公司赔率快照，结合球队近况、伤停、xG 等数据，生成盘口解析报告并发布为暗黑霓虹风网页，附带模拟下注与模型校准闭环验证策略效果。

项目功能
1. 赔率抓取：The Odds API 为主源（1X2/亚盘/大小球三家以上赔率），OddsPortal 为降级备源（Playwright 爬虫，可拿 bet365）；按距开赛时间智能调度（远端每 6h、临场 1.5h 内每 30min）
2. 球队数据：ESPN 拉球队近 N 场战绩，FBref 补 xG 数据，懂球帝抓伤停
3. 赛果回填：完赛后从 ESPN 取终场比分，结算模拟注单
4. 盘口解析：analyze.py 综合赔率、球队数据生成单场 HTML 报告（含推荐注额、EV、波胆预测）
5. 模型校准：calibrate.py 对历史预测与赛果对账，输出校准 JSON 反馈给分析逻辑
6. 总览主页：build_index 生成 docs/index.html 作为系统唯一入口，自动刷新
7. 公网发布：publish.sh 推送到 GitHub Pages（docs/ 目录即站点根）

运行环境
– 操作系统：原设计 macOS（launchd 每 30 分钟调度 + osascript 系统通知），Windows 下可手动跑 scrape.py，但 publish.sh 与 osascript 会失败（已 try/except 兜底）
– Python 3.9+（实测 3.11 可用）
– 数据库：SQLite（app/football.db，schema 由 db.py 维护）
– 外部依赖：The Odds API key（必填，写入 app/.env）；可选 Playwright + Chromium 启用 OddsPortal 降级源
– 网络：需访问 api.the-odds-api.com、espn.com、fbref.com、dongqiudi.com、oddsportal.com；国内访问 ESPN/FBref/OddsPortal 可能不稳

项目技术
– 语言：Python 3
– HTTP 客户端：requests
– HTML 解析：beautifulsoup4 + lxml
– 浏览器自动化：Playwright（降级源专用）
– 数据库：SQLite 标准库
– 前端：原生 HTML + 内联 CSS + SVG（无框架，无构建），Rajdhani 字体，暗黑霓虹风设计
– 部署：GitHub Pages 托管静态报告；GitHub Actions workflows 三条流水线（scrape / calibrate / results）
– 调度：macOS launchd（生产）或 GitHub Actions cron（CI）

以上系统源码经过技术整理与调试，确保能正常运行