SK-league-nations

Files (1)

• SKILL.md

SKILL.md (first lines)

# 欧国联子模型（SK-league-nations）

> 🔴 **定位**：`Step4.5 联赛/赛事子模型` 的国家队分支。命中 → 输出 R1-R10 → **回归主模型 Step5-8 消费**（不替代主模型判定）。
> 🔴 **铁律**：**只调置信度 · 永不反转 L2 硬核方向 · 最多 ±1 档 · 未回测项仅提示 · 无数据三态标注**。

## 触发条件（N1 赛事识别）

```
league_id == 5 或 league_name 含 "Nations League"/"欧国联"
且 非 Women / U19 / U21 / U23 / U17     → ✅ 激活本子模型
league_name 含 "Friendlies"/"Friendly"  → ⚪ 不确定（走友谊赛口径·非 NL·三态标注）
其余                                    → ❌ 不激活（走原俱乐部流程·零改动）
```
调用：`python data/tmp/nl_model.py --league-id 5 --elo-h <主队Elo> --elo-a <客队Elo> --md <比赛日> --o-h --o-d --o-a [--n-books --spread]`

## 数据基础（658 场·四届全样本）

| 指标 | 值 |
|:--|--:|
| n | **658**（2018/19·2020/21·2022/23·2024/25） |
| 主/平/客 | **43.0% / 25.1% / 31.9%** |
| 场均进球 | **2.51** |
| O2.5 / BTTS | **45.3% / 45.1%** |

🔴 **禁用**：友谊赛（2.88/51%）· 世界杯（2.88/52%）· 欧洲杯（2.78/51%）口径 —— NL 是**独立偏小球赛事**。
⚠️ 样本边界：`tier`/`md` 字段仅 282/658 填充 → 级别梯度分析仅基于 282 场。

## R1-R10 规则集

| 规则 | 内容 | 状态 |
|:--:|:--|:--|
| **R1** | 赛事识别 + 三态标注（见上） | ✅ 直接做 |
| **R2** | 主/平/客先验 **43.0 / 25.1 / 31.9** | ✅ n=658 |
| **R3** | 场均 **2.51** · O2.5 **45.3%** · BTTS **45.1%**（禁跨赛事套用） | ✅ n=658 |
| **R4** | Elo 分档表（9 档·**raw 口径 = eh−ea**·实测）：`<−300` **13/16/71**(n=38)｜`−300~−200` **8/40/52**(n=52)｜`−200~−100` **20/28/52**(n=106)｜`−100~−50` **40/26/34**(n=58)｜`−50~50` **45/31/24**(n=146)｜`50~100` **53/23/23**(n=60)｜`100~200` **55/22/24**(n=102)｜`200~300` **73/16/12**(n=51)｜`>300` **87/9/4**(n=45) | ✅ 实测 |
| **R5** | 🔴 **客队热门平局泄漏**（**raw 口径**）：客中浅热门（**raw −135~+15**·n=197）→ 实际客胜 **35%** · 平 **31%** · **未胜 65%** → **禁当稳胆·平局按 27-31% 评估·串关降 1 档**；中深（raw −235~−135·n=86）平 27%·超深（raw <−235·n=67）平 **28%（非零·保留 0:0/1:1 出口）**。该档最常见比分 **1:1 14.2% / 1:2 12.2% / 0:0 11.2%** | ✅ 实测（本子模型最值钱规则） |
| **R6** | **主客进球不对称**（🔴 实测·**raw 口径**）：主强 **raw>300** → **场均 3.51 · O2.5 69% · BTTS 31%**（零封大胜 3:0/4:0）；客强 **raw<−300** → **场均 2.53 · O2.5 47% · BTTS 39%**（窄胜偏小球·🔴程度温和·弱于旧口径 37% 的表述）；→ **同档实力下主热门偏大球、客热门偏小球** | ✅ 实测（修正参考材料的拟合值混用） |
| **R7** | **均势场**（**raw −50~50**·n=146）→ **主 45 / 平 31 / 客 24 · 场均 2.29 · O2.5 40%**（🔴 **修正**参考材料"均势小球 40%"——均势场**平局被系统低估**，非单纯小球） | ✅ 实测 |
| **R8** | **主场参数**：保留主场 Elo 加成 **≈60.7**（国际赛事常规 60-65）·🔴 **不归零/不下调** —— 主胜率 43.0% 偏低源于中档平局多+客热门赢不下来，**非无主场** | ✅ 拟合 |
| **R9** | **战意分级**：MD1-2 **全部 MOT_HIGH**（积分清零·无人出局）→ 🔴 **禁用死球淡化**；MD3-4 按实时积分判 MOT_MIXED；MD5-6 才启用升级/保级/死球。战意只调置信度（≤0.5 档） | ✅ 直接做 |
| **R10** | **公平赔率 edge**：`log λ = base + slope×Elo差`，base=0.800 / slope主=0.00050 / slope客=0.00172 / adv=60.7。**edge = 公平概率 − 市场去水概率**；🔴 **仅 edge>0 且公平置信 ≥0.60 才进串关**（分档实测：**≥0.60 → 78.6%** / 0.50-0.60 → 51.5% / 0.40-0.50 → **36.8%（不进串关）**） | ✅ 时间分割验证（后 20% n=132·方向 53.8% vs 基准 40.9% = **+12.9pp**·单调递增） |

## R10 公平模型的验证证据

| 项 | 结果 |
|:--|:--|
| 训练/验证 | 前 526 场（2018-09-06~2024-09-10）/ 后 **132 场**（2024-10-10~2025-06-08） |
| 验证方向 | **71/132 = 53.8%**（基准 恒押主 **40.9%** → **+12.9pp**） |
| 分档单调性 | 36.8% → 51.5% → **78.6%** ✅ |
| **O2.5** | 🔴 **53.0%（≈基准）→ 未复现参考材料声称的 60.9% → O2.5 不接入公平模型** |
| 参数可辨识性 | base 与 adv 共线 → 采用**固定 adv=60.7** 的可辨识形式 |

## N7 资金盘口径（复用主模型模块）

- 复用 `sharp_baseline.py`（Pinnacle ~2% margin 作方向锚）+ `bookmaker_spread.py`
- ⚠️ **NL 机构池更小（9-13 家）→ spread 阈值须按机构数标准化·待 NL 样本重标** → **当前仅标注 n_books + 分歧·不降档**
- 沿用已验证结论：**全盘 vig 无方向信息**（高 margin 场不做方向双确认·只用于去水）


## 🔴 规则优先级（与主模型既有规则的冲突处理·补）

| 冲突场景 | 优先级 | 处理 |
|:--|:--|:--|
| R6（主客进球分流）vs **goal_bins 量级** | **量级优先** | 量级以「O25 市场 + goal_bins 校准分布」为主·R6 仅作**锚方向分流参考**·🔴不覆盖量级中心 |
| R10（公平 edge）vs **市场源优先铁律** | **市场优先** | edge 仅作**独立参考**·仅 edge>0 且公平≥0.60 才进串关·🔴不覆盖市场判定 |
| R5（客热门平局）vs **修正53/R20 平局序列** | **叠加** | 修正53 是信号计数（≥2.5 并列）·R5 是**场次级先验**·两者叠加不替代 |
| R8（主场 60.7）vs **HAF 主客场因子** | **HAF 优先** | NL 无 HAF 档案时才用 R8 替代值（60.7） |
| R9（战意）vs **F7 情境因子** | **叠加** | R9 = 赛事级（MD1-2 禁死球）·F7 = 场次级 |
| **所有 NL 规则 vs L2 硬核方向** | 🔴 **L2 优先** | NL 只调置信度（**≤±1 档**）·**永不反转方向** |

## 🔴 既有口径的超域边界（NL 场必须标注·补）

> 🔴 **核心原则**：本子模型**只替代五类口径**（先验/主场/档表/进球分流/公平 edge）；
> **以下既有口径源自五大联赛/Matches（俱乐部）**，在 NL 场属「**超域**」→ **必须标注·禁直接套用**。

| 既有口径 | 来源 | NL 场处理 |
|:--|:--|:--|
| **Step6 大小球信号强度三档**（强≥58% 实测 65.0% / 中 55-58% 57.0% / 弱 53-55% 54.8%） | Matches **148,397 场五大联赛** | 🔴 **超域** → NL 用 **R3 先验 O2.5 45.3%** + 本场 O25 去水判方向；三档阈值**仅参考**（NL 基线 45.3% ≠ 五大 53%+） |
| **Step7 比分深度表**（净胜档 × O25 九档 45 单元格） | Matches **23 万场五大联赛** | 🔴 **超域** → NL 用 **R4 Elo 九档实测** + `calc_poisson` + **R6 主客进球分流**；查表结果**仅作谱系参考** |
| **Step5 修正53 / R20 平局序列**（S1-S12） | Matches **23 万场五大联赛** | 🔴 **超域** → NL 平局以 **R2 先验 25.1%** + **R5 客热门平局 27-31%** 为主；S 信号**仅叠加参考**（禁以 ≥2.5 并列门槛直接裁定） |
| **Step5 skew 强共识铁律**（≥200% → 可单押·源自五大 64.6%） | Matches **22.7 万场五大联赛** | 🔴 **超域**（🔴 NL 无赔率库 → **无法回测**）→ NL 场**禁用该阈值**·方向以 **R2 先验 + R4 Elo 档位 + R10 edge** 为主|
| **Step5 弱共识并列铁律**（skew<150% → 市场首选+平局并列） | Matches **22.7 万场五大联赛** | 🔴 **超域** → NL 场并列须**覆盖第三方向**（见下方「三向覆盖纪律」）·禁只补平局|
| **置信度五档概率映射**（HIGH≥70% / MID 55-70% / MID-LOW 45-55% / LOW<45%） | 案例库 strict 口径（**五大联赛为主**） | 🔴 **超域**（无 NL 案例验证）→ NL 场置信度**整体降 1 档标注** |
| **Step4.6 HAF 主客场因子** | `homeaway_table.json` **139 队俱乐部档案** | 🔴 **无 NL 档案** → 用 **R8 主场 Elo 60.7** 替代（已明示） |
| **Step4.5 联赛子模型**（5 大联赛） | 各联赛 8-9 千场 | ⚪ **不触发**（NL 非五大联赛） |
| **Step1 硬核层 12 项** | 欧盘口径（去水/凯利/赔率档） | ✅ **适用**（不依赖联赛先验） |
| **Step2 变动层 V1-V6** | 赔率/盘口水位/形态学 | ✅ **适用** |
| **Step7 泊松 λ 反推** | 欧盘 1x2 + O25 | ✅ **适用** |
| **Step3 场景 44/45/46** | 欧战专用 | ⚪ **不适用**（NL 非欧战） |

🔴 **执行铁律**：NL 场分析时，凡引用上表**标 🔴 超域** 的口径 → **必须在输出中标注「超域·仅参考」**；
**禁将五大联赛口径的概率/阈值直接当作 NL 的判定依据**（例：禁说"NL 大球 65%"——NL 基线仅 45.3%）。

## 服务主模型的消费点

| 规则 | 主模型消费位置 |
|:--|:--|
| R2/R4 | Step5 方向判定（先验参考·不改写硬核档位） |
| R3/R6/R7 | Step6 大球深度 + Step7 比分量级（大小球/锚方向分流） |
| R5 | Step5 置信度（客热门档降 1 档·**不反转**）+ Step7 锚保留 0:0/1:1 出口 |
| R8 | Step4.6 HAF（国家队无 HAF 档案时报「国家队主场 Elo 60.7」） |
| R9 | Step3.5 情境因子 F7（战意） |
| R10 | **Step5 方向判定（≤ −10pp 禁单押+强制并列 / ≥ +10pp 可升权）+ Step8 交叉验证（≥0.60 才进串关）** |

## 🔴 2026-09-27 加固（case206/207 根因修复·用户确认固化 A+B+C）

> 背景：（冰岛 1:1 爱沙尼亚·单押主胜 ✗）与 case206（保加利亚 1:2 卢森堡·漏客胜 ✗）暴露三条缺口。

### A. R10 edge 必须进 Step5（禁只作串关门禁）
- **edge ≤ −10pp**（市场显著高估该方向·如 case207 主 **−17.09pp**）→ 🔴 **该方向不得单押**：置信度**降 1 档** + **强制并列**（并入次优方向 / 平局）
- **edge ≥ +10pp**（市场低估）→ 该方向可**升 0.5 档**；**|edge| < 10pp** → 仅标注·不调整
- ⚠️ 诚实标注：edge 的「分方向用法」**暂无 NL 全样本回测**（NL 无赔率库）→ 仅作**降档/并列提示**·**永不反转 L2 硬核方向**

### B. 超域清单已补两条方向类规则（见上表末两行）
- NL 场**禁用**五大 skew 阈值（强共识 ≥200% 单押 / 弱共识 <150% 只补平局）
- 方向以 **R2 先验（主 43.0 / 平 25.1 / 客 31.9）+ R4 Elo 档位实测 + R10 edge** 为主

### C. 三向覆盖纪律（NL 弱共识场）
- skew <150%（弱共识）→ **必须把三个方向都写进「预测方向」字段**（例「主胜+平局+客胜并列」）

From MENG-COOLMAN/PitchQuant, MIT.

More from MENG-COOLMAN/PitchQuant