一款面向竞彩足球「让球胜平负」玩法的让平概率量化分析工具(v1.0)。它不卖料、不预测比分,而是把“两队历史交锋同档让球线的让平比例、同联赛同档位让平率基线、今日监控盘口的让平赔率特征”三部分摆在一起,帮助开赛前快速筛出值得进一步研究的场次。
一、这是什么 / 适用场景
- 让平概率量化:针对整数让球盘,计算目标让球线下历史交锋的让平率,并用同联赛同档位基线做贝叶斯收缩,得到综合分排行。
- 赔率画像(特征 N/3):从主软件监控会话提炼 3 项让平特征(低期望进球 / 高平局概率 / 让平赔率波动),命中数对应历史让平率:0/3→21.6%、1/3→23.2%、2/3→23.7%、3/3→32.3%(943 场样本)。
- 共振/分歧提示:单场详情展示历史交锋、同档明细、综合分、时间衰减影响、市场基准让平率,以及历史与市场的分歧/共振。
- 回测验证:一键查后自动留记录,次日拉赛果对照让平候选(让平率≥35% 且样本≥3,或特征 3/3)的命中率。
二、环境准备与安装启动
依赖
- Python ≥ 3.10(实际运行用
python3.13.exe);tkinter、sqlite3(标准库)。 - 让平画像必需:
numpy、scipy。 - 可选:
duckdb(诊断)、cryptography(注册)、requests(复用主软件抓取器)。
启动方式
- 双击
启动软件.bat:预检依赖(tkinter/duckdb/numpy/scipy/cryptography),齐全则用pythonw main.py无控制台启动,否则退回带控制台运行并提示 pip 安装命令。 - 命令行:
python main.py。
本机数据位置:授权、试用、日志、缓存保存在 %LOCALAPPDATA%\让平分析王\,日志为 logs\app.log(界面报错时看这里)。
三、快速上手(第一次怎么用)
- 完成注册激活(首次 7 天试用):状态栏显示授权/试用状态;试用结束强制弹注册窗口,关闭即退出。
- 点「刷新在售场次」:从竞彩官网拉取当前全部在售场次(主客队中文简称 + 让球线),后台线程执行,随后自动叠加今日赔率画像。
- 点「一键查所有场次」:逐场计算同档让平率、同联赛基线、综合分并排行;完成后再次叠加赔率画像。
- 点表头按综合分/让平率/样本/联赛排序;联赛下拉 + 队名搜索实时过滤。
- 点任意一行看详情,重点看「特征 N/3」与历史/市场是否共振。
- 需要留档时「文件 → 导出结果」;次日用「数据 → 回测让平预测」对照赛果。
四、核心功能详解
4.1 让平口径与综合分
- 让平定义:主队让 |gl| 球后,让球后比分与实际相同(
home + gl == away)。 - 同档判定:方向一致(同为主让或同为主受让)且档位差 ≤1(
-1与-2同档,-1与+1不同档)。 - 综合分(时间衰减加权 + 贝叶斯收缩):
score = (let_draw_w + K × prior) / (n_w + K) # K=4.0
单场权重 w = decay_factor^years_ago(默认每年 ×0.85,UI 可切 0.90/0.92/1.00);prior 为同联赛同档位基线(样本 ≥50 才采纳,否则回退默认 25%)。样本 <3 视为样本不足(UI 标 *)。
4.2 让平赔率画像(特征 N/3)
- 阈值(943 场历史监控样本):期望总进球 ≤3.035、非让球盘平局概率 ≥0.2475、让平赔率波动 ≥0.0145,命中数 N 对应历史实际让平率 0/3→21.6%、3/3→32.3%。
- 市场基准让平率:用总进球盘 + 非让球盘反推比分分布(泊松拟合 + 单参数校准),AUC≈0.50,区分度弱,仅作参照;赔率侧主信号是「特征 N/3」。
- 「数据 → 重建让平特征库」可全量重建
cache/feature_dataset.json。
4.3 在售场次表与详情
- 表格列:排名、场次、联赛、主队(排名)、客队(排名)、让球线、交锋、主/平/客、让平率、样本、基线、市场基准、特征、综合分。
- 主/客队直接拼排名前缀(如
[澳超9]布里斯班);高让平率(样本≥3 且 rate≥35%)标红,样本不足/无交锋标灰。 - 已移除单场手工选让球线面板,一律用官网在售接口返回的
hhad.goalLine。
4.4 注册激活
- 设备 ID 与「统一注册管理工具」同一套
production_registration_core.py;授权 RSA-PSS(SHA256) 签名,每软件独立密钥对。 - 授权文件保存到
registration/licenses/license_<device_id>.json;签发流程:用户复制设备 ID → 作者用注册管理器选「让平分析王」生成 json → 用户导入。
五、近期更新功能
文档停留在 2026-10-23,2026-05 之后的更新依据文件时间戳与代码结构推断:
- 2026-11-04 启动脚本更新:
启动软件.bat更新(11-04)。推断为依赖预检/启动流程调整——对用户的影响:双击即可自动判断依赖是否齐全并给出明确 pip 安装提示,启动更省心。依据文件时间戳。 - 2026-11-03 交锋与基线模块更新:
h2h_db.py(33KB,11-03)与新增league_baseline.py(11-03)时间戳较新。推断方向:历史交锋让平率查询与同联赛基线/综合打分逻辑调整——对用户的影响:榜单综合分与基线可能与 v1.0 文档示例有差异,以当前程序计算为准。依据文件时间戳,非文档明确记载。 - 2026-11-18 新增联赛统计文件:目录出现
竞彩近3年分联赛让球胜平负统计.xlsx(11-18),为近 3 年分联赛让球胜平负统计参考数据——对用户的影响:可作为同联赛基线的外部参照。依据文件时间戳。
注:readme.txt 与软件技术参数文档.md 均为 v1.0(2026-10-21~23),上述为时间戳推断,非文档明确说明的功能变更。
六、常见问题与排错(FAQ)
- 界面弹出错误:详细原因在
%LOCALAPPDATA%\让平分析王\logs\app.log。 - 某队交锋 0 场:软件给出结构化诊断(首次交锋 / 队名映射失败 / 欧战资格赛未进 JCW 等),并非故障。
- 今日监控数据显示
?:监控会话今日不存在或 hhad 键缺失,Δ 显示?不抛异常,不影响其他分析。 - 注册模块不可用/公钥未加载:安装
cryptography并检查registration/keys/public_key.pem;分发包不应含私钥。 - 授权失败:常见“签名无效 / 设备ID不匹配 / 已过期”,授权与设备绑定,换机需重新签发。
七、补充信息
- 数据来源:
jcw_history.db(竞彩历史赛果,带精确让球线,约 8.9 万场)、football_analytics.duckdb(欧洲赛事历史,诊断/补充)、exports/monitor_session_*.json(盘口棱镜逐场赔率快照)、webapi.sporttery.cn(在售接口)。历史库都在主软件「体彩足球竞彩」目录,本软件不自带。 - 零网络独立模式:主软件历史库与抓取器齐全时,除“刷新在售场次”外均可离线运行。
- 模块结构:
main.py(入口)、config.py(路径/常量)、onsale.py(在售拉取薄封装)、h2h_db.py(交锋查询+基线+排行)、league_baseline.py、diagnose.py(0 场诊断)、feature_extractor.py(画像 ETL)、gui.py(Tkinter 界面)、registration/。 - 风险提示:仅用于数据统计与研究,不构成投注建议;彩票有风险,理性购彩、量力而行。