Releases: JetQiao/football-prediction-skill
Releases · JetQiao/football-prediction-skill
Release list
v0.5.1 · 方向与价值双轨结论
v0.5.1：方向判断与价值判断分离
这个版本修复了 v0.5.0 中“有概率方向，但因为缺少独立价值证据而整场显示弃权”的问题。
核心变化
- 每场比赛分别输出方向判断和价值判断。
- 方向状态：
strong / moderate / slight / unavailable。 - 价值状态：
candidate / watch / no_edge / unverified / unavailable。 - 目标竞彩市场共识可以支持方向研究，但不会再被用来循环证明自身价格价值。
- 兼容保留旧版
decision_state，每日报告协议升级至2.1。 - 报告新增方向/价值双列、双卡详情、组合筛选和更紧凑的移动端布局。
- Node 启动器会在包升级后自动刷新持久化 Python 运行源码，避免继续执行旧版本。
- README、Skill 指令、架构和数据契约已同步更新，项目支持收款码完整保留。
真实赛单回归
2026-07-16 的 10 场赛单得到：
- 明确方向：5 场
- 中等方向：4 场
- 轻微方向：1 场
- 方向不可用：0 场
- 价值未独立验证：10 场
这意味着报告会给出可解释的概率方向，同时诚实说明当前价格价值尚未获得独立验证。
验证
- Python 3.10 / 3.12 GitHub Actions 全部通过。
- 55 项单元与契约测试通过。
- Ruff、Python compileall、Skill quick validation、JavaScript 语法检查全部通过。
- HTML 离线资源、内联 JSON、交互和响应式结构验证通过。
- Python wheel 与 npm tarball 安装运行验证通过。
- npm 包确认包含
docs/assets/wechat-pay.jpg。
安装 / 升级
npx -y github:JetQiao/football-prediction-skill install安装后验证：
football-predict --version
football-predict daily --date todayv0.5.0 · 事件时间预测与概率研究台
v0.5.0：事件时间可追溯的足球概率研究系统
本版本重构了预测、回测、价值判断和报告 UI 的核心链路。重点不是承诺更高命中率，而是让每个概率都具备赛前时间边界、独立市场角色、样本外验证和明确弃权能力。
重点更新
- 日常预测与历史回放统一使用同一个
PredictionPipeline。 - 新增 DuckDB/Parquet 不可变赛前快照，记录
as_of、observed_at、来源和快照 ID。 - 强制隔离参考市场、目标竞彩与历史基准市场，禁止同源循环证明价值。
- 新增模型注册表、同日无泄漏 OOF 训练、Power/Shin 去水、融合器与温度校准。
- 新增
candidate / lean / no_edge / abstain四态决策和严格模型晋级门槛。 - 阵容情报升级为结构化事实，再由确定性模型映射为有界 xG 调整。
- 报告重构为高密度概率与价格工作台，支持筛选、排序、详情抽屉和移动端紧凑卡。
- README、Skill 工作流、示例、数据契约和架构文档全部更新。
首轮回放结果
五大联赛三个赛季共 3,436 场：
- v0.5 production：Brier
0.1950，Log-loss0.9818。 - 市场基线：Brier
0.1923，Log-loss0.9696。 - 相比 v0.4 审计的
0.2001 / 1.0057已改善，但仍未稳定击败市场。 - 独立价值模式候选数为
0；未通过校准门槛时系统会真实弃权。
安装或升级
npx -y github:JetQiao/football-prediction-skill#v0.5.0 install验证
- Python 3.10 / 3.12 GitHub Actions 全部通过。
- 本地 51 项单元与契约测试通过。
- Ruff、compileall、Skill 校验和离线 HTML 校验通过。
- Chrome 真实渲染通过：1280×900 首屏完整赛单；375px/320px 无横向溢出。
- wheel、sdist、npm tarball 构建并独立运行通过。
概率不是承诺。本项目不提供下注通道、不代客操作，也不保证命中率或收益。
v0.4.0 · 全赛单与多玩法联合校准
重点更新
- 修复普通胜平负未开售时整场比赛被过滤的问题，官方赛单多少场就解析多少场。
- 支持仅让球在售及全部玩法待开售的通用场景，不包含日期、场号或球队硬编码。
- HAD、HHAD、比分、总进球、半全场联合校准为统一比分矩阵，消除固定中性期望进球。
- 明确区分独立统计模型、多玩法市场基线和数据不足占位，避免伪精确与循环价值判断。
- 新增
football-predict evaluate-daily，按联赛、置信度、分析模式评估赛后表现。
验证
- Python 3.10 / 3.12 CI 全部通过。
- 本地 36 项测试全部通过。
- 2026-07-03 实时赛单验证：源 4 场、解析 4 场。
- 深色 HTML 报告通过离线资源、脚本和桌面/移动端布局检查。
升级后重新执行安装即可：
npx -y github:JetQiao/football-prediction-skill#v0.4.0 installv0.3.0 · 真实数据比赛日 Match Center
v0.3.0：真实数据比赛日 Match Center
这一版重点解决报告数据来源不透明、缺失输入边界不清，以及安装包资源不完整的问题。
新增与改进
- 重构现代暗色足球比赛日 UI：首屏指挥中心、赛程卡与单场 Match Center。
- 增加官方赛程、竞彩 SP、实力特征、外部市场、赛前情报五层来源追踪。
- 官方 SP 去水概率加入模型融合；关键输入不足时强制低置信并暂停价值信号。
- 修正中文球队名称归一化和 Elo 实力差缩放。
- 新增 119 面可离线内联的国家队国旗，俱乐部继续使用字母徽标。
- 竞彩官方接口在代理出口受限时自动尝试直连，并保留缓存降级。
安装 / 升级
npx -y github:JetQiao/football-prediction-skill#v0.3.0 install生成离线演示报告：
football-predict daily --demo --date today校验
- Python 3.10 / 3.12 主分支 CI 全部通过。
- 32 项单元与契约测试通过。
- npm tarball、Python Wheel、119 面国旗资源、真实赛单报告、桌面与手机交互均已验证。
v0.2.0 · 完整玩法与赛事数据台 UI
v0.2.0：完整玩法与赛事数据台 UI
这一版重点解决报告“难看、难懂、信息不全”的问题。
新增
- WORLD CUP AI HUB 风格的深色赛事数据台：紧凑导航、赛程滚动条、首屏概览、焦点比赛和直观概率条。
- 单场四个可交互页签：核心结论、五类玩法、比分分布、依据与风险。
- 完整支持五类竞彩官方 SP：胜平负、让球胜平负、比分、总进球、半全场。
- 半全场 3×3、让球赛果、总进球、双方进球、大小球和比分热力图模型推演。
- 官方玩法数据覆盖状态；缺少 SP 时明确标注“仅模型推演”。
- 390px 手机布局，不再隐藏平局或客胜概率。
可读性
EV改为“长期期望”。Edge改为“概率优势”。- 报告内直接解释模型概率、市场概率和长期期望的含义。
安装 / 升级
npx -y github:JetQiao/football-prediction-skill#v0.2.0 install生成离线演示报告：
football-predict daily --demo --date today校验
- Python 3.10 / 3.12 GitHub Actions 全部通过。
- 21 项单元与契约测试通过。
- npm tarball、Python Wheel、Skill 结构、离线 HTML、桌面与手机视觉及核心交互均已验证。
v0.1.2 — 自动注册全局命令
修复 npx install 完成后 football-predict 未注册的问题。安装器现在会持久化运行包，在 npm 全局 bin 目录创建安全启动器，并在 CI 中验证 football-predict --version 与报告生成。
v0.1.1 — 安装器网络降级修复
修复 npx 安装时 pip 隔离构建依赖 setuptools 导致的失败。安装器现在直接复制 Python 运行包，并在 PyPI、清华和阿里云镜像间自动降级；新增安装器端到端 CI。