MatchScope 2026

2026 世界杯 90 分钟赛前情报与比分概率工作台。

MatchScope 2026 把球队实力、赛程条件、伤病可用性、预测首发、历史交锋、赔率参考和赛后复盘放在同一个轻量服务里，用于判断常规时间内的胜 / 平 / 负概率、期望进球、比分分布和高比分尾部风险。

当前版本：1.0.0
预测口径：只包含 90 分钟常规时间，不包含加时赛和点球。
项目性质：研究与演示用途，不构成投注建议。

适合谁

• 想快速搭一个足球预测 Dashboard 的开发者。
• 想研究世界杯赛前概率、阵容、伤病和赛后校准的数据爱好者。
• 想把泊松比分模型、赔率参考和实时赛程数据组合成产品 Demo 的产品/技术同学。

功能亮点

• 赛前情报台 UI：选择比赛后展示胜平负概率、期望进球、最可能比分、大小球倾向、3 球以上风险和模型信号。
• 自动比赛条件：根据赛程生成日期、北京时间、场馆、城市、气温、海拔、休息天数、旅行距离和场地优势。
• 48 队与赛程检查：内置 2026 世界杯 48 支球队与小组赛赛程，并提供完整性接口。
• 实时数据源适配：预留懂球帝赛程、积分榜、阵容、球队成员、球员详情，以及中国体彩网赔率接口的归一化入口。
• 阵容与伤病展示：展示预测首发、替补名单、球员中文名、俱乐部、估值、伤病与可用性说明。
• 赛后复盘资产：保存每日复盘、近期球队走势、战术与伤病观察，供后续淘汰赛分析使用。
• 轻量部署：纯 Python 标准库服务，云端可用 systemd + Nginx 部署。

快速启动

python server.py

打开浏览器访问：

http://127.0.0.1:8765

默认服务端口是 8765。当前项目不依赖第三方 Python 包，适合快速复制和演示。

项目结构

world-cup/
  server.py                 # HTTP 服务、预测接口和静态资源服务
  world_cup_data.py          # 球队、赛程、场馆和模型基础数据
  data_sources.py            # 懂球帝 / 体彩网等数据源适配器
  player_profiles.py         # 二层球员资料读取与归一化
  snapshot_store.py          # 预测快照存储
  static/                    # 前端页面
  scripts/                   # 数据采集、复盘和战术伤病分析脚本
  data/                      # 球员资料与分析输出
  deploy/                    # 云服务器部署脚本
  docs/                      # GitHub 文档

API 摘要

接口	方法	说明
/api/health	GET	服务健康检查、模型版本和预测口径
/api/teams	GET	48 支球队、中文名、分组和基础评分
/api/matches	GET	小组赛赛程
/api/world-cup/completeness	GET	检查参赛队完整性
/api/analysis/latest	GET	最新赛后复盘、球队走势、战术伤病观察
/api/sources	GET	当前可用数据源适配器
/api/source-preview	POST	生成或测试数据源请求
/api/predict	POST	生成 90 分钟预测
/api/predictions	GET	最近预测快照

示例预测请求：

{
  "team_a": "Brazil",
  "team_b": "Haiti"
}

数据刷新与复盘

快速回测模式只拉赛程/赛果，不逐场等待阵容接口：

python scripts\collect_tournament_data.py --fast

完整复盘命令：

python scripts\daily_recap.py 2026-06-21
python scripts\recent_recap.py 2026-06-20 2026-06-21
python scripts\tactical_injury_review.py

这些脚本会更新 data/analysis/ 下的最新比赛、球队趋势、每日复盘和战术伤病观察。前端会通过 /api/analysis/latest 读取部分结果。

云端部署

上传代码包：

powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -HostName <server-ip> -User ubuntu

服务器安装或更新服务：

ssh -t ubuntu@<server-ip> "chmod +x /tmp/worldcup_server_setup.sh && sudo bash /tmp/worldcup_server_setup.sh"

部署后会运行：

• worldcup.service
• Nginx 反向代理
• 可选 Basic Auth 访问保护

更多说明见 docs/DEPLOYMENT.md。

文档

• GitHub 发布文案
• 产品与界面说明
• 模型说明
• 数据源策略
• 部署指南
• 运维与复盘流程
• GitHub 发布清单

历史基线见 VERSION_1.0.md，后续变更见 CHANGELOG.md。

免责声明

本项目仅用于足球数据建模研究、产品 Demo 和赛前分析练习。赔率、伤病、首发和赛程信息都可能变化，模型输出不是确定结果，也不构成任何投注或投资建议。